Date de publication: le jeudi 2 septembre 2010 à 00h26
Dernière modification: par Pascal BOYER le dimanche 3 avril 2011 à 18h14
« Article précédent: eZ Publish : généralités sur la procédure de mise à jour

06/04/2010 3:41

Upgrading from 4.2.x to 4.3.x / Mise à jour de 4.2.x vers 4.3.x

This section describes how to upgrade your existing eZ Publish 4.2.x 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 version 4.2.x vers une version 4.3. La procédure de mise à jour décrite ci-dessous étant générique, elle ne couvre aucun cas spécifique (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 votre 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.2.x to 4.3 consists of the following steps:
La procédure de mise à jour directe d'une version 4.2.x vers une version 4.3 se compose des étapes suivantes:

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

Check for requirements / Contrôler les prérequis

The eZ Components 2009.1 requirements / Prérequis eZ Components 2009.1

With eZ Publish 4.2, eZ Components 2009.2.1 is the minimum version required. When downloading eZ Publish 4.3 it is possible to choose between a package bundled with eZ Components 2009.2.1, or a package without eZ Components. If you choose the latter, you must install eZ Components separately. For more information see http://ezcomponents.org/docs/install
eZ Components 2009.2.1 constitue la version minimale requise pour eZ Publish 4.3. Lorsque vous téléchargez eZ Publish 4.3, il vous est possible de choisir entre une archive intégrant eZ Components 2009.2.1 et une archive ne l'intégrant pas. Si vous choisissez cette dernière, alors vous devrez installer eZ Components séparément. Pour de plus amples informations reportez-vous au document eZ Publish 4.0 : installer eZ Components

The PHP requirements / Prérequis PHP

eZ Publish 4.3 is now also compatible with PHP version 5.3. For more information regarding system requirements check out http://ez.no/ezpublish/requirements
eZ Publish 4.3 est à présent compatible avec la version 5.3 de PHP. Pour de plus amples informations sur les prérequis du système, reportez-vous au document http://ez.no/ezpublish/requirements

Step 1: Upgrading the distribution files / Etape 1: Mise à jour des fichier de la distribution

The easiest way to upgrade the distribution files is to unpack eZ Publish 4.3 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.3 dans un répertoire dédié 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 bonnes permissions pour le serveur web:

cd  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 connaissances concernant le serveur web utilisé.

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

Step 2: Custom extensions / Etapes 2: 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 Online Editor (5.x), eZ OpenOffice.org (2.x) and eZ JSCore (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 Online Editor (5.x), eZ OpenOffice.org (2.x) et eZ JSCore (1.x). Retenez que la mise à jour des fichiers de la distribution remplaceront les tableaux d'autochargement des extensions; vous devrez donc regénérer ultérieurement les tableaux pour les extensions activées.

See below for dedicated upgrade instructions for eZ Flow and eZ Webin.
Voir ci-dessous les instructions de mise à jour spécifiques à eZ Flow et eZ Webin.

The updated versions of eZ Flow and eZ Website Interface will also install the following extensions:
Les versions mises à jour de eZ Flow et de eZ 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 .

Step 3: Upgrading the database / Etape 3: 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:

/update/database//4.3/dbupdate-4.2.0-to-4.3.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.

Step 4: Regenerate the autoload array for extensions / Etape 4: Regé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 regé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

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

Run the following command from the root of your eZ Publish directory:
Exécutez la commande suivante à partir du répertoire racine de votre installation de eZ Publish:

php update/common/scripts/4.3/updatenodeassignment.php

Step 6: [optional] Enable admin2 design for backend / Eape 6: [optionnelle] Activer l'interface d'administration Admin2

To enable admin2 open site.ini for your admin site access. For an ezflow site this would for instance be:
Afin d'activer l'interface Admin2, éditez le fichier site.ini lié à votre siteaccess d'administration. Dans le cas d'un site utilisant eZ Flow, ce fichier est situé dans:

settings/siteaccess/ezflow_site_admin/site.ini.append.php

In this file include AdditionalSiteDesignList[]=admin2 to your [DesignSettings]. It is important that you add the admin2 design before the admin design, in order to let extensions that have admin templates to continue to work. On an eZ Flow site, it would mean changing the settings from:
Dans ce fichier, ajoutez, sous la section [DesignSettings] le paramètre AdditionalSiteDesignList[]=admin2. Il est important que vous ajoutiez le design admin2 avant le design admin afin que les extensions usant des templates de ce dernier continuent à fonctionner. Pour un site basé sur eZ Flow, cela revient à modifier les paramètres suivants:

[DesignSettings]SiteDesign=ezflow_site_adminAdditionalSiteDesignList[]=adminAdditionalSiteDesignList[]=ezflow

to
par:

[DesignSettings]SiteDesign=ezflow_site_adminAdditionalSiteDesignList[]=admin2AdditionalSiteDesignList[]=adminAdditionalSiteDesignList[]=ezflow

When using a plain or eZ Webin install you should make the same changes. In this case you will of course have a different SiteDesign setting and no AdditionalSiteDesignList[]=ezflow line.
Dans le cas d'un site basé sur le type plain ou sur eZ Webin, les modifications à apporter sont identiques. Cependant, dans ces deux cas le paramètre SiteDesign sera différent et vous ne trouverez pas de ligne AdditionalSiteDesignList[]=ezflow

To enable users to change their Administration Interface preferences (for example their preview tab preferences), add the following line to the [Toolbar_admin_right] block in settings/siteaccess/<siteaccess_name>/toolbar.ini.append.php:
Afin d'autoriser les utilisateurs à modifier leurs préférences relatives à l'interface d'administration (par exemple leurs préférences relatives aux onglets de prévisualisation), ajoutez la ligne suivante à la section [Toolbar_admin_right] du fichier settings/siteaccess/<siteaccess_name>/toolbar.ini.append.php:

Tool[]=admin_preferences

So the block will then look like this:
La section ressemblera donc à ceci: 

[Toolbar_admin_right]Tool[]Tool[]=admin_current_userTool[]=admin_bookmarksTool[]=admin_preferences

Step 7: Clearing the caches / Etape 7: 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.3 directory.
   Placez-vous à la racine du répertoire d'installation de eZ Publish 4.3
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 sans être pour autant 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.

Upgrading eZ Flow and/or Website Interface separately / Mettre à jour séparément eZ Flow et/ou Website Interface

Please visit the eZ Flow and eZ Webin upgrade documentation for more info.
Reportez-vous à la documentation propre à la mise à jour de eZ Flow  et de  eZ Webin .

Commentaires