eZ Publish : Mise à jour de 4.4 vers 4.5

Date de publication: le dimanche 3 avril 2011 à 18h07
Dernière modification: par Pascal BOYER le dimanche 3 avril 2011 à 20h05

01/04/2011 11:43

Upgrading from 4.4 to 4.5 / Mise à jour de 4.4 vers 4.5

This section describes how to upgrade your existing eZ Publish 4.4 installation to version 4.3. The upgrade procedure described below is generic and does not cover any specific cases (for example, running eZ Publish in a clustered environment).
Cet article détaille la procédure de mise à jour de votre installation eZ Publish 4.4 courante vers la version 4.5. La procédure décrite ci-dessous étant générique, elle ne couvre aucun cas particulier (comme par exemple une installation eZ Publish s'exécutant dans un environnement clusterisé).

Make sure that you have a working backup of the site before you do the actual upgrade. 
Avant de commencer la procédure de mise à jour, assurez-vous d'être en possession d'une sauvegarde  fonctionnelle de votre site.

Important upgrade notes / Notes de mise à jours importantes

The procedure for upgrading directly from version 4.5 to 4.5 consists of the following steps:
La procédure de mise à jour directe d'une version 4.4 vers une version 4.5 se compose des étapes suivantes:

1. Upgrading the distribution files to 4.5
   Mise à jour des fichiers de votre installation vers ceux de la version 4.5
2. Upgrading custom extensions
   Mise à jour des extensions personnalisées
3. Upgrading the database to 4.5
   Mise à jour de la base de données vers la version 4.5
4. Regenerate the autoload array for extensions
   Régénération du tableau d'autochargement des extensions
5. Running the system upgrade scripts for 4.5
   Exécution des scripts de mise à jour du système de la version 4.5
6. Clearing the caches
   Vider les caches

Check for requirements / Contrôler les prérequis

The PHP requirements / Prérequis PHP

The minimum version required of eZ Components with eZ Publish 4.5 is "ezcomponents-ezp45", containing a fix to the package. eZ Publish 4.5 is compatible with PHP version 5.3 and above. For more information regarding system requirements check out http://ez.no/ezpublish/requirements
 Avec eZ Publish 4.5, le package de correction de bug ezcomponents-ezp45 constitue la version minimum de eZ Components à installer. eZ Publish 4.5 est à présent compatible avec la version 5.3 (et supérieure) de PHP. Pour de plus amples informations sur les prérequis du système, reportez-vous au document http://ez.no/ezpublish/requirements

Étape 1: Upgrading the distribution files / Mise à jour des fichier de la distribution

The easiest way to upgrade the distribution files is to unpack eZ Publish 4.5 to a separate 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 simple de mettre à jour les fichiers de la distribution consiste à extraire le contenu de l'archive eZ Publish 4.5 dans un répertoire à part puis d'y copier également les répertoires contenant les fichiers spécifiques à votre installation en production. Assurez-vous de bien copier les répertoires suivants:

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

Replace "example" and "example_admin" with the actual names of your site accesses.
Remplacez example et example_admin par les vrais noms de vos siteaccess.

Important note / Note importante

Because the new directory has replaced the original directory, the directory permissions need to be fixed. Use the following commands to do this.
Puisque les nouveaux répertoires remplacent les anciens, il est nécessaire de modifier les permissions qui leur sont associées. Pour cela, utilisez les commandes suivantes:

(You have the choice between Shell commands or Alternative shell commands):
(Vous avez le choix entre « Commandes Shell » ou « Commandes Shell Alternatives »):

• Shell commands
  Commandes Shell 

These shell commands will give proper permission to the web server:
Ces deux commandes Shell affectent les permissions nécessaires au serveur web:

cd </path/to/your/eZ/Publish/directory> 
chmod -R a+rwx design extension settings var

• Alternative shell commands
  Commandes Shell alternatives 

These commands will setup the permission more correctly, but require knowledge about the running web server.
Ces deux commandes affectent plus précisément les bonnes permissions mais requièrent certaines informations concernant le serveur web utilisé.

chmod -R og+rwx design extension settings var 
chown -R nouser:nouser design extension settings var

Étape 2: Custom extensions / Extensions personnalisées

If you are using custom extensions, the sub-directories inside the "extension" directory will also have to be copied. However, make sure that you do not overwrite any extensions that are included in eZ Publish, which currently are eZ Flow (2.x)eZ Online Editor (5.x), eZ OpenOffice Document format (2.x), eZ JSCore (1.x), eZ Image Editor (1.x), eZ Comments (1.x), eZ Multiupload (1.x), eZ MB Password Expiry (1.x), eZ Network (1.x), eZ REST API Provider (1.x), eZ Script Monitor (1.x), eZ SI, ), eZ Find (1.x). Note that upgrading the distribution files will overwrite the autoload arrays for extensions. You will need to re-generate the autoload arrays for active extensions later.
Si vous utilisez des extensions personnalisées, les sous-répertoires du répertoire extension doivent également être copiés. Assurez-vous cependant de ne remplacer aucune des extensions proposées par défaut par eZ Publish, à savoir: eZ Flow (2.x), eZ Online Editor (5.x), eZ OpenOffice Document format (2.x), eZ JSCore (1.x), eZ Image Editor (1.x), eZ Comments (1.x), eZ Multiupload (1.x), eZ MB Password Expiry (1.x), eZ Network (1.x), eZ REST API Provider (1.x), eZ Script Monitor (1.x), eZ SI, ), eZ Find (1.x). Retenez que la mise à jour des fichiers de la distribution remplaceront les tableaux d'autochargement des extensions; vous devrez donc régénérer ultérieurement les tableaux pour les extensions activées.

See the dedicated upgrade instructions for eZ Flow and Website Interface below.
Voir plus bas les instructions de mise à jour spécifiques à eZ Flow et à l'interface Website.

The updated versions of eZ Flow and Website Interface will also install the following extensions:
Les versions mises à jour de eZ Flow et de Website Interface installeront également les extensions suivantes:

• eZ Website Toolbar
• eZ Star Rating
• eZ Google Maps Location

For eZ OE 5.x and eZ JS Core you will need to replace the following rewrite rules when using Virtual Hosts:
Si vous êtes en mode VirtualHost, vous devrez, pour eZ OE 5.x et eZ JS Core, remplacer les règles de réécriture suivantes:

RewriteRule ^/var/cache/texttoimage/.* - [L]
RewriteRule ^/var/[^/]+/cache/(texttoimage|public)/.* - [L]

with:
par:

RewriteRule ^/var/([^/]+/)?cache/(texttoimage|public)/.* - [L]

For more detailed instructions, see the dedicated eZ OE and eZ JS Core doc pages.
Pour de plus amples informations, reportez-vous aux pages de documentation eZ OE  et eZ JS Core .

Étape 3: Upgrading the database / Mise à jour de la base de données

The update script for the database is located in
Le script de mise à jour de la base de données est situé dans:

<eZP;root>/update/database/<mysql|postgresql>/4.5/dbupdate-4.4.0-to-4.5.0.sql

You can run this with the appropriate command line tool or application.
Vous pouvez exécuter ce script par le biais d'une ligne de commande ou d'une application appropriée.

Étape 4: Regenerate the autoload array for extensions / Régénérer le tableau d'autochargement des extensions

The autoload system also has some changes, for example the autoload array for extensions is now placed in var/autoload of your eZ Publish installation (along the class changes in extensions itself).
Le système d'autochargement fait également l'objet de quelques modifications comme par exemple le nouvel emplacement du tableau d'autochargement des extensions situé à présent dans le répertoire /var/autoload/ de votre installation eZ Publish (de même que les modifications des classes dans les extensions elles-même).

To regenerate the autoload array, execute the following script from the root of your eZ Publish directory:
Afin de régénérer le tableau d'autochargement, exécutez le script suivant à partir du répertoire racine de votre installation de eZ Publish:

php bin/php/ezpgenerateautoloads.php --extension

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

Run the following command from the root of your eZ Publish directory:
For eZ Publish 4.4 which was upgraded from 4.3, run the following command from the root of your eZ Publish directory:
Pour une version 4.4 de eZ Publish provenant de la mise à jour d'une version 4.3, veuillez exécutez la commande suivante à partir du répertoire racine de votre installation de eZ Publish:

php update/common/scripts/4.5/updatesectionidentifier.php -s $SITE_ACCESS

Note: Skip this step if this your 4.4 installation is not an upgrade from 4.3. If you are uncertain, please run the script.
Note: Passez cette étape si votre version 4.4 n'est pas une mise à jour d'une version 4.3 antérieure. En cas de doute, exécutez ce script.

Étape 6: Clearing the caches / Effacer 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'une installation eZ Publish est mise à jour, tous les caches doivent être correctement effacés. Ceci peut s'effectuer depuis une commande shell:

1. Navigate into the eZ Publish 4.5 directory.
   Placez-vous à la racine du répertoire d'installation de eZ Publish 4.5
2. Run the script using the following shell command: 
   Exécutez le script par le biais de la commande suivante:

php bin/php/ezcache.php --clear-all --purge

Purging ensures that the caches are physically removed. When the "--purge" parameter is not specified, the caches will be expired but not removed.
Cette purge des caches vous assure qu'ils seront physiquement supprimés. Lorsque le paramètre –purge n'est pas spécifié, les caches expireront mais ne seront pour autant pas supprimés.

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 sub directories within the "var" directory (typically the "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 soit pas en mesure de supprimer tous les caches en raison de permissions restrictives appliquées à certains répertoires et/ou fichiers. Assurez-vous donc que tous les fichiers cachés (mis en cache) ont bien été supprimés en inspectant le contenu des différents sous-répertoires de cache placés sous le répertoire /var (typiquement les répertoires /var/cache/ et /var/<nom du siteaccess>/cache/). S'il reste des fichiers, supprimez-les manuellement.

Étape 7: Upgrading extensions / Mise à jour des extensions

When using eZ Webin and eZ Flow, these extension will also need to be updated.
Lorsque vous utilisez eZ Webin et eZ Flow, alors ces deux extensions doivent être mises à jour.

The first thing to do is to change the extensions permissions.  An example on how this is done:
Modifier les permissions de ces extensions est la première chose à faire. Voici comment faire:

$chmod -R a+rwx extension

Next, depending on your own extensions, follow the steps mentioned in the eZ Webin and eZ Flow upgrade documentation.
Ensuite, et en fonction de vos extensions, suivez les étapes de mises à jour décrites dans les documentations de mise à jour de eZ Flow  et de  eZ Webin .

Commentaires