eZ Publish : mise à jour de 3.9.x vers 3.9.y

Date de publication: le dimanche 20 novembre 2011 à 17h38
Dernière modification: par Pascal BOYER le dimanche 20 novembre 2011 à 20h26

12/09/2008 12:55

This section describes how to upgrade your existing eZ Publish 3.9.x installation to version 3.9.y, for example from 3.9.0 to 3.9.5. If you are upgrading from a version prior to eZ Publish 3.9.0, you should first upgrade to 3.9.0 as described in this section.
Cet article décrit la mise à jour d'une version courante 3.9.x d'eZ Publish vers une version 3.9.y. Par exemple, d'une version 3.9.0 vers une version 3.9.5. Si vous souhaitez faire une mise à jour à partir d'une version antérieure à la version 3.9.0, alors vous devez préalablement faire une mise à jour vers la version 3.9.0 .

Important note / Note importante

Before continuing, note that it is strongly recommended to upgrade directly to the latest stable release in the 3.9 branch (3.9.5 at the time of writing), which contains all important bug fixes. Refer to the changelogssecurity advisories for more information about the issues that were fixed in the latest releases or view the short list of changes below.
Avant de poursuivre, retenez qu'il est grandement recommandé de procéder à une mise à jour directement vers la dernière version stable de la branche 3.9 (la version 3.9.5 à l'heure d'écrire ces lignes) contenant toutes les corrections importantes de bugs. Référez-vous aux liens changelogs et avis de sécurité pour de plus amples informations sur les problèmes qui ont été résolus ou jetez un oeil ci-dessous à la courte liste des modifications.

• There is a significant problem with eZ Publish 3.9.0 - 3.9.2. More precisely, the discount functionality of the shop module contains a security vulnerability. The same bug exists in eZ Publish 3.8.0 - 3.8.8. This issue was fixed in eZ Publish 3.8.9, 3.9.3 and 3.10.0. Refer to the announcement for details.
  Il y a un problème sérieux dans les versions 3.9.0 à 3.9.2 d'eZ Publish. Il s'agit plus précisément d'une vulnérabilité de sécurité dans la fonctionnalité de remise/rabais du module shop. Le même problème existe dans les versions 3.8.0 à 3.8.8 mais a été résolu dans les versions 3.8.9, 3.9.3 et 3.10.0. Pour plus de détails, référez-vous à cette annonce .
• eZ Publish versions 3.9.0 - 3.9.3 contain a security vulnerability that can be used to show hidden content on a public siteaccess. The same bug exists in eZ Publish 3.8.0 - 3.8.9. This issue was fixed in eZ Publish 3.8.10, 3.9.4 and 3.10.0. Refer to the announcement for details.
  Les versions 3.9.0 à 3.9.3 d'eZ Publish contiennent une vulnérabilité de sécurité pouvant être exploitée pour afficher sur un siteaccess public du contenu caché. Le même bug affecte les versions 3.8.0 à 3.8.9 mais est corrigé par les versions 3.8.10, 3.9.4 et 3.10.0. Référez-vous au lien announcement pour de plus amples informations.
• The "updatetipafriendpolicy.php" upgrade script in eZ Publish 3.9.3 - 3.9.4 contains a bug. The same bug exists in eZ Publish 3.10.0. It prevents the script from granting access to the "Tip a friend" feature to users. The problem occurs when the script is run on Windows. This issue was fixed in eZ Publish 3.9.5, 3.10.1 and 4.0.0. Refer to http://issues.ez.no/11663 for more information.
  Le script de mise à jour updatetipafriendpolicy.php des versions 3.9.3 et 3.9.4 contient un bug affectant également la version 3.10.0 d'eZ Publish. Ce bug empêche le script d'accorder aux utilisateurs l'accès à la fonctionnalité Envoyer à un ami. Ce problème, qui apparaît lorsque le script est exécuté sur une plate-forme windows, est corrigé par les versions 3.9.5, 3.10.1 et 4.0.0 d'eZ Publish. Référez-vous au lien http://issues.ez.no/11663 pour de plus amples informations.
• The "updatevatcountries.php" upgrade script in eZ Publish 3.9.3 - 3.9.4 contains a bug. The same bug exists in eZ Publish 3.10.0. This issue was fixed in eZ Publish 3.9.5, 3.10.1 and 4.0.0. Refer to http://issues.ez.no/11955 for more information.
  Le script de mise à jour updatevatcountries.php des versions 3.9.3 et 3.9.4 contient un bug affectant également la version 3.10.0 d'eZ Publish. Ce bug est corrigé dans les versions 3.9.5, 3.10.1 et 4.0.0 d'eZ Publish. Référez-vous au lien http://issues.ez.no/11955 pour de plus amples informations.
• In eZ Publish 3.9.0 - 3.9.4, there is a bug in the "File" datatype which may cause problems with binary file uploading via WebDAV. The same bug exists in eZ Publish 3.10.0. This issue was fixed in eZ Publish 3.9.5, 3.10.1 and 4.0.0. Refer to http://issues.ez.no/9450 for more information.
  Dans les versions 3.9.0 à 3.9.4 il y a un bug dans le datatype File pouvant créer des problèmes lors du téléchargement de fichiers binaires via WebDAV. Le même bug affecte la version 3.10.0 mais est corrigé dans les versions 3.9.5, 3.10.1 et 4.0.0 d'eZ Publish. Référez-vous au lien http://issues.ez.no/9450 pour de plus amples informations.
• In eZ Publish 3.9.4, some cache related settings in the "settings/site.ini" configuration file were changed by mistake. This issue was fixed in eZ Publish 3.9.5. Refer to http://issues.ez.no/11647 for more information.
  Dans dans le fichier de configuration settings/ site.ini de la version 3.9.4 d'eZ Publish, certains paramètres liés au cache ont été modifiés par mégarde. Ce problème est résolu par la version 3.9.5. Référez-vous au lien http://issues.ez.no/11647 pour de plus amples informations.
• In eZ Publish 3.9.4, the "register" view of the "user" module contains a bug. It prevents the system from registering new users when the "VerifyUserEmail" setting is enabled (it is enabled by default). The same bug exists in eZ Publish 3.8.10 and 3.10.0. This issue was fixed in eZ Publish 3.9.5 and 3.10.1. Refer to http://issues.ez.no/11598 for more information.
  Dans la version 3.9.4, la vue register du module user contient un bug qui empêche le système d'enregistrer de nouveaux utilisateurs lorsque le paramètre VerifyUserEmail est activé (il l'est par défaut). Le même bug affecte les versions 3.8.10 et 3.10.0 mais a été corrigé dans les versions 3.9.5 et 3.10.1. Référez-vous au lien http://issues.ez.no/11598 pour de plus amples informations.

Make sure that you have a working backup of the site before you do the actual upgrade. The upgrade procedure consists of the following steps:
Assurez-vous d'être en possession d'une sauvegarde correcte/fonctionnelle de votre site avant de vous lancer dans sa mise à jour dont la procédure suit les étapes suivantes:

1. Upgrading the distribution files to 3.9.5
   Mettre à jour les fichiers de la version 3.9.0 avec ceux de la version 3.9.5,
2. Upgrading the database to 3.9.5
   Mettre à jour la base de données pour la rendre compatible avec la version 3.9.5 d'eZ Publish,
3. Running the system upgrade scripts
   Exécuter les scripts de mise à jour du système,
4. Updating the system configuration
   Mettre à jour la configuration du système,
5. Clearing the caches
   Vider les caches.

Étape 1: Upgrading the distribution files / Mettre à jour les fichiers

The easiest way to upgrade the distribution files is to unpack eZ Publish 3.9.5 to a directory and then copy the directories that contain site-specific files from the existing installation. Make sure that you copy the following directories:
Le moyen le plus rapide de mettre à jour les fichiers de la version courante consiste à désarchiver la version 3.9.5 dans un répertoire dans lequel on copiera également les répertoires contenant les fichiers spécifiques au site devant être mis à jour. Assurez-vous de copier les répertoires suivants:

• design/example
• design/example_admin
• var
• settings/siteaccess
• settings/override

Replace "example" and "example_admin" with actual names used by your siteaccesses.
Remplacez example et example_admin par les vrais noms de vos siteaccess.

Custom extensions / Extensions particulières

If you are using custom extensions then the subdirectories inside the "extension" directory will also have to be copied. However, make sure that you do not overwrite any extensions that come with eZ Publish (for example the "PayPal" extension).
Si vous utilisez des extensions particulières, alors les sous-répertoires du répertoire extension/ doivent également être copiés dans le répertoire où a été désarchivé eZ Publish 3.9.5. Cependant, assurez-vous de ne pas écraser d'extensions fournies avec eZ Publish (comme par exemple l'extension PayPal).

If you are using the Website Interface front-end, make sure you copied the "extension/ezwebin/" directory. It is also possible to upgrade the Website interface extension to a newer version (you can find more information and instructions in the "Upgrading the Website Interface" chapter of the Website interface installation guide).
Si vous utilisez l' Interface Website assurez-vous d'avoir une copie du répertoire extension/ezwebin/. Il est également possible de mettre à jour cette extension vers une nouvelle version (vous pouvez trouver plus d'informations et d'instructions au chapitre Upgrading the Website Interface du guide Website interface installation guide ).

Important bug fix for remote IDs / Correction importante du bug lié aux ID distants

Due to some bugs in previous versions of eZ Publish (3.9.0 and others), it might happen that not all content objects in your database have unique remote IDs. This basically means that the "remote_id" column of the "ezcontentobject" table in the database might contain duplicate values. In eZ Publish 3.9.5, a database schema change was introduced in order to ensure that only unique remote IDs can be stored in this table. Because of this, you need to make sure that there are no content objects with identical remote IDs before upgrading the database. This can be done by running the "fixobjectremoteid.php" upgrade script. (Note that both the database schema change and the upgrade script were added to eZ Publish 3.10.1 and 4.0.1 as well.)
En raison de bugs présents dans les précédentes versions d'eZ Publish (3.9.0 et autres), il pouvait arriver que tous les objets de contenu de votre base de données n'aient pas un ID distant unique. Cela signifie que la colonne remote_id de la table ezcontentobject de la base de données pouvait contenir plusieurs fois la même valeur. La version 3.9.5 apporte une modification du schéma de la base de données afin de s'assurer que cette table ne puisse enregistrer que des ID distants uniques. De ce fait, vous devez vous assurer, avant de mettre à jour votre base de données, qu'elle ne contienne pas d'objets ayant le même ID distant. Pour cela il faut exécuter le script de mise à jour fixobjectremoteid.php (Notez que la modification du schéma de la base de données et le script de mise à jour ont été ajoutés comme il se doit aux versions 3.10.1 et 4.0.1 d'eZ Publish).

This script should be run once for each database, specifying one siteaccess per database. If you only have a public and an administration siteaccess that share the same database (which is the most typical/usual case), you only need to run the script for one of the siteaccesses. If the siteaccess isn't specified, the default siteaccess will be used.
Ce script doit être exécuté une fois pour chaque base de données et en spécifiant un siteaccess pour chacune d'elles. Si vous n'avez qu'un siteaccess public et d'administration partageant la même base de données (ce qui reste le cas le plus fréquent), vous ne devez exécuter le script que pour l'un des deux siteaccess. Et si ce dernier n'est pas mentionné alors le siteaccess par défaut sera utilisé.

The following example shows how to run the script:
L'exemple suivant explique comment exécuter le script:

1. Navigate into the eZ Publish 3.9.5 directory.
   Placez-vous dans le répertoire d'installation de eZ Publish 3.9.5
2. Run the script (replace "example" with the actual name of your siteaccess):
   Exécutez le script (remplacez example par le vrai nom de votre siteaccess):

php update/common/scripts/3.9/fixobjectremoteid.php -s example

The script will search for objects with non-unique remote IDs. Every time such an object is found, the script will suggest to either display more detailed information or fix the problem automatically. If you choose the first option, the script will display the list of objects that have the same remote ID and let you decide which one should remain unchanged; all other objects in the list will get new remote IDs. Otherwise, the script will fix the problem automatically based on the objects' creation dates. This means that the script will generate new remote IDs for all objects in the list except the one that was created first.
Le script recherche les objets n'ayant pas un ID distant unique. Chaque fois qu'un tel objet est trouvé, le script suggère soit d'afficher une information plus détaillée soit de résoudre le problème automatiquement. Si vous choisissez la première option, le script affichera la liste des objets ayant le même ID distant et vous laissera choisir celui devant rester inchangé. Tous les autres objets de la liste se verront affecter un nouvel ID distant. Dans le cas de la deuxième option, le script corrigera automatiquement le problème en se basant sur la date de création des objets, ce qui signifie que le script génèrera de nouveaux ID distants pour tous les objets excepté pour celui ayant la date de création la plus ancienne.

The optional "--mode" parameter makes it possible to run the script in either "auto-fix" or "manual-fix" mode as shown below.
Le paramètre optionnel --mode permet d'exécuter le script en mode auto-fix (correction automatique) ou manual-fix (correction manuelle) comme indiqué ci-dessous:

php update/common/scripts/3.9/fixobjectremoteid.php -s example --mode=value

If you replace "value" with "a" in the command above, the script will automatically fix all non-unique remote IDs that are found in the database based on the objects' creation dates. In this case, no further input is required from the user. If you specify "--mode=d", the script will display the list of objects for each non-unique remote ID so that you can manually choose which objects should keep their remote IDs.
Si vous remplacez, dans la commande ci-dessus, « value» par « a», le script corrigera alors automatiquement tous les IDs distants identiques trouvés dans la base de données en se basant sur la date de création des objets. Dans ce cas, aucune autre saisie n'est requise de votre part. A l'inverse, si vous précisez --mode=d alors le script affichera la liste des objets n'ayant pas un ID distant unique afin que vous puissez manuellement choisir celui dont il faudra conserver le ID.

Étape 2: Upgrading the database / Mettre à jour la base de données

To upgrade a 3.9.0 database to 3.9.5, you should navigate into the eZ publish 3.9.5 directory and run the following database upgrade scripts one after another:
Pour une mise à jour de la base de donnée d'une version 3.9.0 vers la version 3.9.5 vous devez vous placer dans le répertoire d'installation d'eZ Publish 3.9.5 et exécuter, l'un après l'autre, les scripts de mise à jour de la base de données suivants:

1. dbupdate-3.9.0-to-3.9.1.sql
2. dbupdate-3.9.1-to-3.9.2.sql
3. dbupdate-3.9.2-to-3.9.3.sql
4. dbupdate-3.9.3-to-3.9.4.sql
5. dbupdate-3.9.4-to-3.9.5.sql

MySQL

The database upgrade scripts are located in the "update/database/mysql/3.9/" directory of your eZ publish installation. Each of these scripts can be launched using the following shell command:
Les scripts de mise à jour de la base de données sont placés dans le répertoire update/database/mysql/3.9/ du répertoire d'installation d'eZ Publish. Chacun des scripts peut être lancé avec la commande shell suivante:

mysql -u <username> -p <password> <database> <update/database/mysql/3.9/dbupdate-3.9.x-to-3.9.y.sql

PostgreSQL

The database upgrade scripts are located in the "update/database/postgresql/3.9/" directory of your eZ publish installation. Each of these scripts can be launched using the following shell command:
Les scripts de mise à jour de la base de données sont placés dans le répertoire update/database/postgresql/3.9/ du répertoire d'installation d'eZ Publish. Chacun des scripts peut être lancé avec la commande shell suivante:

psql -d <database> -U <dbowner> <update/database/postgresql/3.9/dbupdate-3.9.x-to-3.9.y.sql

Étape 3: Running the system upgrade scripts / Exécuter les scripts de mise à jour du système

The 3.9.1 - 3.9.5 versions of eZ Publish introduce a couple of important bug fixes and functionality changes. In order to make sure that your site is compatible with these changes, you may need to run a few upgrade scripts.
Les versions 3.9.1 à 3.9.5 d'eZ Publish introduisent un certain nombre de corrections importantes de bugs et de modifications de fonctionnalités. Pour vous assurer que votre site est compatible avec toutes ces modifications vous devez exécuter quelques nouveaux scripts de mise à jour.

Changes to roles and policies / Modifications des rôles et permissions

From 3.9.3, users (typically those to which the anonymous role applies) need to have access to the "tipafriend" function of the "content" module in order to use the "Tip a friend" feature. Because of compatibility reasons, you need to run the "updatetipafriendpolicy.php" script.
Depuis la version 3.9.3, les utilisateurs (généralement les utilisateurs appartenant au rôle anonymous) doivent pouvoir accéder à la fonction Envoyer à un ami ( Tip a friend) du module content. Pour des raisons de compatibilité vous devez exécuter le script updatetipafriendpolicy.php.

Note for Linux/UNIX users: there is no need to run the script if you previously upgraded to 3.8.9 or a later version in the 3.8.x branch.
Note à l'attention des utilisateurs de plates-formes Linux/UNIX: il n'est pas nécessaire d'exécuter le script si vous avez préalablement procédé à la mise à jour vers une version 3.8.9 ou plus récente de la branche 3.8.

Note for Windows users: in eZ Publish 3.9.3 - 3.9.4 the "updatetipafriendpolicy.php" script contains a bug that prevents it from granting access to the "Tip a friend" feature to the users. The same bug exists in eZ Publish 3.8.9 - 3.8.10 and 3.10.0 (refer to http://issues.ez.no/11663 for more information). The updated version of the script is available in eZ Publish 3.9.5, 3.10.1 and 4.0.0. Windows users that previously upgraded to 3.8.9 - 3.8.10 or 3.9.3 - 3.9.4 using the original version of the script are encouraged to re-run this script when upgrading to 3.9.5.
Note à l'attention des utilisateurs de plates-formes windows: le script updatetipafriendpolicy.php des versions 3.9.3 et 3.9.4 d'eZ Publish contient un bug empêchant le script d'accorder aux utilisateurs l'accès à la fonctionnalité Envoyer à un ami. Ce bug, affectant les versions 3.8.9, 3.8.10 et 3.10.0 d'eZ Publish (Référez-vous au lien http://issues.ez.no/11663 pour de plus amples informations), est corrigé par les versions 3.9.5, 3.10.1 et 4.0.0. Les utilisateurs de plates-formes windows ayant préalablement procédé à une mise à jour vers une version 3.8.9 ou 3.8.10 ou 3.9.3 ou 3.9.4 en utilisant la version originale du script sont encouragés à exécuter à nouveau ce script lors de la mise à jour vers la version 3.9.5 d'eZ Publish.

The following example shows how to run the script:
L'exemple qui suit explique comment réaliser cela:

1. Navigate into the eZ Publish 3.9.5 directory.
   Placez-vous dans le répertoire contenant la version 3.9.5 d'eZ Publish,
2. Run the script using the following shell command:
   Exécutez le script avec la commande suivante:

php update/common/scripts/3.9/updatetipafriendpolicy.php -s example_admin -l login -p password

Replace "example_admin" with the actual name of your admin siteaccess, use the administrator's login and password instead of "login" and "password".
Remplacez example_admin par le nom de votre siteaccess d'administration puis login et password par l'identifiant et le mot de passe de l'administrateur de votre site.

The script will add a new role that grants access to the "Tip a friend" feature and ask for confirmation about assigning this role to each user or user group located one level beneath the "Users" top level node.
Le script ajoutera un nouveau rôle accordant les droits d'accès à la fonctionnalité Envoyer à un ami et demandera confirmation avant d'assigner ce rôle à chaque utilisateur ou groupe d'utilisateurs situé sous le noeud de plus haut niveau Users.

Improved handling of country dependent VATs / Gestion améliorée de la TVA en fonction des pays

In eZ Publish version 3.9.3 - 3.9.5, the handling of country dependent VATs has been improved. In order to make sure that your site is compatible with the changes, you need to run the "updatevatcountries.php" script.
Dans les versions 3.9.3 à 3.9.5 d'eZ Publish, la gestion de la TVA en fonction des pays a été améliorée. Afin de vous assurez que votre site est compatible avec ces modifications, vous devez exécuter le script updatevatcountries.php.

Note that the "updatevatcountries.php" upgrade script in eZ Publish 3.9.3 - 3.9.4 contains a bug. The same bug exists in eZ Publish 3.10.0 (refer to http://issues.ez.no/11955 for more information). The updated version of the script is available in eZ Publish 3.9.5, 3.10.1 and 4.0.0. If you previously upgraded to 3.9.3 or 3.9.4 using the original version of the script, you need to run the updated version of the script when upgrading to 3.9.5.
Retenez que le script de mise à jour updatevatcountries.php des versions 3.9.3 et 3.9.4 d'eZ Publish contient un bug affectant également la version 3.10.0 (Référez-vous au lien http://issues.ez.no/11955 pour de plus amples informations) mais est corrigé par les versions 3.9.5, 3.10.1 et 4.0.0. Si vous avez préalablement procédé à une mise à jour vers une version 3.9.3 ou 3.9.4 en utilisant la version originale du script vous devez alors exécuter la version à jour de celui-ci lors de la mise à jour vers la version 3.9.5 d'eZ Publish.

The "updatevatcountries.php" script should be run once for each database, specifying one siteaccess per database. If you only have a public and an administration siteaccess that share the same database, you only need to run the script for one of the siteaccesses. If the siteaccess isn't specified, the default siteaccess will be used.
Le script updatevatcountries.php doit être exécuté pour chaque base de données en spécifiant un siteaccess pour chacune d'elles. Si vous ne possédez qu'un siteaccess public et un siteaccess d'administration partageant la même base de données, alors vous ne devez exécuter le script que pour un seul de ces deux siteaccess. Si aucun siteaccess n'est spécifié alors le siteaccess par défaut est utilisé.

The following example shows how to run the script:
L'exemple qui suit explique comment exécuter ce script:

1. Navigate into the eZ Publish 3.9.5 directory.
   Placez-vous dans le répertoire contenant la version 3.9.5 d'eZ Publish,
2. Run the "updatevatcountries.php" script (replace "example" with the actual name of your siteaccess):
   Exécutez le script updatevatcountries.php en remplaçant example par le nom de votre siteaccess:

php update/common/scripts/3.9/updatevatcountries.php -s example

The script will go through all the VAT rules in the database and make them compatible with the newly introduced changes.
Le script va parcourir toutes les règles de TVA présentes dans la base de données et les rendre compatibles avec les changements nouvellement apportés.

Binary files uploaded via WebDAV (optional) / Fichiers binaires uploadés via WebDAV (optionnel)

In eZ Publish 3.9.0 - 3.9.4, there is a bug in the "File" datatype which may cause problems with binary file uploading via WebDAV. The typical symptoms are that the file extension of the uploaded file is missing and that you may not be able to download the file once it is uploaded (refer to http://issues.ez.no/9450 for more information). The same bug exists in eZ Publish 3.8.6 - 3.8.10 and 3.10.0. This issue was fixed in eZ Publish 3.9.5, 3.10.1 and 4.0.0.
Les versions 3.9.0 à 3.9.4 d'eZ Publish contiennent un bug dans le datatype File pouvant entraîner des problèmes lors du téléchargement de fichiers binaires via WebDAV. L'absence de l'extension du fichier uploadé rendant impossible son téléchargement une fois uploadé (référez-vous au lien http://issues.ez.no/9450 pour de plus amples informations) en est le principal symptôme. Ce bug, affectant les versions 3.8.6 à 3.8.10 et 3.10.0, est corrigé dans les versions 3.9.5, 3.10.1 et 4.0.0.

If your site has objects that were created by uploading files via WebDAV and you have configured MIME-type-to-class mapping using the "MimeClassMap[]" directive in an override for "upload.ini", you need to run the "updatebinaryfile.php" script in order to fix the file extensions. (If a content class does not have any attributes that make use of the "File" datatype, instances of this class are not affected.)
Si votre site contient des objets créés suite au upload de fichiers via WebDAV et que vous avez configuré MIME-type-to-class mapping en utilisant le tableau MimeClassMap[] dans une surcharge du fichier upload.ini, alors vous devez exécuter le script updatebinaryfile.php afin de corriger les extensions des fichiers. Si une classe de contenu ne possède aucun attribut basé sur le datatype File, alors les instances de cette classe ne sont pas affectées.

The "updatebinaryfile.php" script should be run once for each database, specifying one siteaccess per database. If you only have a public and an administration siteaccess that share the same database, you only need to run the script for one of the siteaccesses. If the siteaccess isn't specified, the default siteaccess will be used.
Ce script doit être exécuté une fois pour chaque base de données et en spécifiant un siteaccess pour chacune d'elles. Si vous n'avez qu'un siteaccess public et un siteaccess d'administration partageant la même base de données, alors vous ne devez exécuter ce script que pour un seul de ces deux siteaccess. Si aucun siteaccess n'est spécifié alors c'est le siteaccess par default qui sera utilisé.

The following example shows how to run the script:
L'exemple qui suit explique comment exécuter ce script:

1. Navigate into the eZ Publish 3.9.5 directory.
   Placez-vous dans le répertoire contenant la version 3.9.5 d'eZ Publish,
2. Run the script (replace "example" with the actual name of your siteaccess):
   Exécutez le script en remplaçant example par le vrai nom de votre siteaccess:

php update/common/scripts/3.9/updatebinaryfile.php -s example

The script will go through all the binary files and fix their extensions. The filename entries stored in the "ezbinaryfile" database table will be changed accordingly.
Le script va parcourir tous les fichiers binaires et corriger leur extension. Les entrées des noms des fichiers stockées dans la table ezbinaryfile seront modifiées en conséquence.

Étape 4: Updating the system configuration / Mettre à jour la configuration du système

You are not required to do any configuration changes when upgrading from 3.9.0 to 3.9.5.
Vous n'êtes tenu à aucun changement de configuration lors de la mise à jour d'une version 3.9.0 vers 3.9.5.

Default configuration of caches (optional) / Configuration par défaut des caches (optionnel)

In eZ Publish versions prior to 3.9.4, the default configuration enables view caching, template caching and template compiling. (This configuration of caches is recommended for live sites. During development, these features can be turned off by disabling the "ViewCaching", "TemplateCache" and "TemplateCompile" directives within an override for "site.ini".) However, this default configuration was accidentally changed in eZ Publish 3.9.4 (refer to http://issues.ez.no/11647 for more information). The change is reverted in eZ Publish 3.9.5.
Dans les versions antérieures à la version 3.9.4 d'eZ Publish, la configuration par défaut autorise la mise en cache des vues, des templates et la compilation des templates. (Cette configuration des caches est recommandée pour les sites en production. Durant le développement du site, ces fonctionnalités peuvent être désactivées grâce aux paramètres ViewCaching , TemplateCache et TemplateCompile d'une surchage du fichier site.ini). Cependant, cette configuration par défaut a été accidentellement modifiée dans la version 3.9.4 (référez-vous au lien http://issues.ez.no/11647 pour de plus amples informations) mais corrigées par la version 3.9.5 d'eZ Publish.

Default configuration of unique user emails (optional) / Configuration par défaut des e-mail utilisateur unique (optionnel)

In eZ publish versions prior to 3.8.0, the default configuration does not allow different users to be registered with the exact same email address. This is just a built-in precaution mechanism which can be easily turned off by setting the "RequireUniqueEmail" directive within the [UserSettings] block of a configuration override for "site.ini" to "false". However, this default configuration was accidentally changed in eZ Publish version 3.8.0 (refer to http://issues.ez.no/9643 for more information). The change is reverted in eZ Publish versions 3.8.7 and 3.9.1.
Dans les versions antérieures à la version 3.8.0, la configuration par défaut ne permet pas à différents utilisateurs ayant la même adresse e-mail de s'enregistrer. Cela n'est qu'une mesure de précaution par défaut pouvant facilement être désactivée en positionnant à false le paramètre RequireUniqueEmail de la section [UserSettings] du fichier de configuration site.ini (ou de l'une de ses surcharges). Cependant, cette configuration par défaut a été accidentellement modifiée dans la version 3.8.0 de eZ Publish (Référez-vous à ce lien http://issues.ez.no/9643 pour de plus amples informations) mais est revenue à la normale dans les versions 3.8.7 et 3.9.1.

Étape 5: Clearing the caches / Vider les caches

Whenever an eZ Publish solution is upgraded, all caches must be cleared in a proper way. This should be done from within a system shell:
Chaque fois qu'un site eZ Publish est mis à jour, tous les caches doivent être correctement vidés avec la commande suivante:

1. Navigate into the eZ Publish 3.9.5 directory.
   Placez-vous dans le répertoire contenant la version 3.9.5 d'eZ Publish,
2. Run the clear cache script:
   Exécutez le script pour vider les caches:

bin/shell/clearcache.sh --clear-all

Sometimes the script is unable to clear all cache files because of restrictive file/directory permission settings. Make sure that all cache files have been cleared by inspecting the contents of the various cache subdirectories within the "var" directory (typically "var/cache/" and "var/<name_of_siteaccess>/cache/" directories). If there are any cache files left, you need to remove them manually.
Il arrive parfois que le script ne puisse effacer correctement tous les fichiers de cache en raison de droits d'accès restreints sur des fichiers et répertoires. Assurez-vous que tous les fichiers de cache soient vidés en contrôlant le contenu des nombreux sous-répertoires de cache du répertoire var/ (typiquement les répertoires var/cache/ et var/<nom_du_siteaccess>/cache/). S'il reste des fichiers, vous devez les effacer à la main.

Commentaires