Date de publication: le mardi 26 mai 2009 à 21h37
Dernière modification: par Pascal BOYER le jeudi 2 septembre 2010 à 00h55
« Article précédent: eZ Publish : faire une sauvegarde
» Article suivant: eZ Publish : mise à jour de 4.0.x vers 4.1.y

26/05/2009 5:17  

This section describes how to upgrade your existing eZ Publish 4.1.x installation to version 4.1.y. If you are upgrading from a version prior to eZ Publish 4.1.0, refer to the "Upgrading from 4.0.x to 4.1.y" section for upgrade instructions. 
Cet article décrit la procédure de mise à jour de votre version 4.1.x vers une version 4.1.y de eZ Publish. Si vous procédez à la mise à jour d'une version antérieure à  eZ Publish 4.1.0, référez-vous alors à l'article Upgrading from 4.0.x to 4.1.y  pour les instructions de mise à jour.

In order to benefit from the latest bug fixes, you should upgrade directly to the latest stable release in the 4.1 branch (4.1.2 at the time of writing). Refer to the changelogs and security advisories for more information about the issues that were fixed in the latest releases. 
Afin de bénéficier des dernières corrections de bugs, vous devez réaliser la mise à jour directement vers la dernière version stable de la branche 4.1 (4.1.2 au moment d'écrire ces lignes). Référez-vous aux document changelogs  et Avis de sécurité  pour plus d'informations sur les problèmes ayant été résolus par la dernière version stable.

Important upgrade notes / Notes importantes à propos de la mise à jour

• updateimagesystem.php needs to be run before the dbupdate scripts, otherwise the tables being upgraded will be removed. 
  Le script updateimagesystem.php doit être exécuté préalablement aux scripts de mise à jour de la base de données pour que les tables mises à jour ne soient pas supprimées.

Please make a backup of your files and your database before proceeding. 
Pensez à faire une sauvegarde de vos fichiers et de votre base de données avant de démarrer la mise à jour.

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

1. Check eZ Components version 
   Contrôle de la version des composants eZ
2. Update distribution files 
   Mise à jour des fichiers de la distribution
3. Transfer custom extensions 
   Transferts des extensions personnalisées
4. Check updateimagesystem.php 
   Contrôle du script updateimagesystem.php
5. Upgrade database 
   Mise à jour de la base de données
6. Regenerate autoload data for extensions 
   Régénération des données autochargées des extensions
7. Run system upgrade scripts 
   Exécution des scripts de mise à jour du système
8. Run eZ OE update script 
   Exécution du script de mise à jour de l'extension eZ OE
9. Clear caches 
   Nettoyage des caches

Étape 1: Check the eZ Components 2008.2.x requirements / Contrôle des composants eZ 2008.2.x requis

With eZ Publish 4.1.1 and later, eZ Components 2008.2.2 is the minimum version required. If you installed a previous version with PEAR, please upgrade to version 2008.2.2. For more information about installing eZ Components see also http://ezcomponents.org/docs/install 
Les versions 4.1.1 et suivantes de eZ Publish requièrent au minimum la version 2008.2.2 de eZ Components. Si vous avez installé une version antérieure avec PEAR, procédez à la mise à jour vers la version 2008.2.2. Pour de plus amples informations sur l'installation de ces composants, reportez-vous également à la page http://ezcomponents.org/docs/install 

Étape 2: Updating the distribution files / Mise à jour des fichiers de la distribution

The easiest way to upgrade the distribution files is to unpack eZ Publish 4.1.1 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: 
La méthode la plus simple pour mettre à jour les fichiers de la distribution consiste à extraire le contenu de l'archive eZ Publish 4.1.1 dans un répertoire à part puis d'y copier les répertoires contenant les fichiers spécifiques à votre installation courante (celle devant être mise à jour). Assurez-vous d'y copier entre autres 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 siteaccesses. 
Remplacez example et example_admin par les vrais noms de vos siteaccess.

Étape 3: Custom extensions / Les 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 come with eZ Publish (currently "ezoe", "ezodf"). 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 late. See below for dedicated upgrade instructions for ez flow and ez webin. 
Si vous mettez à jour des extensions personnalisées, les sous-répertoires du répertoire extension doivent aussi être copiés. Cependant, assurez-vous de n'écraser aucune des extensions livrées avec eZ Publish (actuellement ezoe et ezodf). Retenez que la mise à jour des fichiers de la distribution surchargeant les tableaux autochargés des extensions, vous devrez régénérer ces derniers pour les extensions (???). Voir ci-dessous pour les instructions de mise à jour spécifiques à ezflow et ez webin.

Note that ezdhtml is now replaced by ezoe, so you should not copy it over. 
Retenez que ezdhtml étant à présent remplacé par ezoe il n'est plus nécessaire de copier ezdhtml.

For eZ OE 5.0.x, you will need to have the following rewrite rule if using Virtual Hosts: 
Vous devez, pour eZ OE 5.0.x, et si vous vous utilisez un hôte virtuel, ajouter la règle de réécriture suivante:

RewriteRule ^/var/[^/]+/cache/public/.* - [L]

For more detailed instructions, see the dedicated doc page: http://ez.no/doc/extensions/online_editor/5_x/installation 
Pour des instructions plus détaillées, reportez-vous à la page de documentation http://ez.no/doc/extensions/online_editor/5_x/installation .

Étape 4: updateimagesystem.php

(If your upgrading from 4.1.0 and not directly from 4.0.x) First of all, if you don't have image data from before version 3.3 of eZ Publish, you don't have to do anything, you can skip running the updateimagesystem.php scrip. 
Si vous procédez à une mise à jour depuis une version 4.1.0 et non directement depuis une version 4.1.x et si vous n'avez aucune donnée image antérieure à la version 3.3 de eZ Publish, vous n'avez alors rien à faire et vous pouvez donc ignorer l'exécution du script updateimagesystem.php.

If you do have old data or you suspect you might (installation is based on eZ Publish < 3.3), which you want to upgrade, then you have to import the tables ezimage and ezimagevariation from a database backup, as these tables were unfortunately removed in the dbupdate scripts of 4.1.0. After the tables have been restored, the updateimagesystem.php script needs to be run. 
En revanche, si vous avez d'anciennes données ou suspectez d'en avoir (l'installation est basée sur une version de eZ Publish inférieure à la version 3.3) et que vous souhaitez les mettre à jour, vous devez alors importer les tables ezimage  et ezimagevariation  depuis une sauvegarde de la base de données puisque ces tables ont été malheureusement supprimées des scripts de mise à jour de la base de données de la version 4.1.0 de eZ Publish. Une fois les tables restaurées, exécutez le script updateimagesystem.php.

Étape 5: 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 se situe dans:

<eZP root>/update/database/<mysql|postgresql>/4.1/dbupdate-4.1.x-to-4.1.y.sql

You can run this with the appropriate command line tool or application. 
Exécutez ce script avec la ligne de commande ou l'application appropriée.

Étape 6: Regenerate the autoload array for extensions / Régénérer, pour les extensions, le tableau d'autochargement

The autoload system has also some changes, for example the autoload array for extensions is now placed in var/autoload of your eZ Publish installation. 
Le système d'autogargement a également fait l'objet de quelques changements. Pour les extensions, par exemple, le tableau d'autochargement est à présent situé dans le répertoire var/autoload de votre installation eZ Publish.

To regenerate the autoload array, execute the following script:  
Pour régénérer le tableau d'autochargement, exécutez le script suivant:

php bin/php/ezpgenerateautoloads.php --extension

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

The update scripts are located in:  
Les scripts de mise à jour se situent dans:

<eZP root>/update/common/scripts/4.1

Please note, that if these scripts were executed as part of the initial upgrade in 4.1.0, they do not have to be executed again this time.  
Retenez que si ces scripts ont été exécutés lors de la mise à jour initiale vers eZ Publish 4.1.0, alors vous ne devez pas les exécuter à nouveau.

• addlockstategroup.php (Used for creating locked states, part of the object states functionality. Updated in 4.1.1) 
  addlockstategroup.php (utilisé pour créer les états bloqués faisant partie de la fonctionnalité états d'objet. Mis à jour dans eZ Publish 4.1.1)
• fixclassremoteid.php (Fixing remote IDs of classes. Updated in 4.1.2 for PostgreSQL compatibility.) 
  fixclassremoteid.php (corrige les id distants des classes. Mis à jour dans eZ Publish 4.1.2 pour rester compatible avec PostgreSQL).
• fixobjectremoteid.php (Fixes non-unique usage of content object remote IDs. Updated in 4.1.2 for PostgreSQL compatibility.) 
  fixobjectremoteid.php (corrige l'usage des id distants non-unique des objets de contenu. Mis à jour dans eZ Publish 4.1.2 pour rester compatible avec PostgreSQL).

Étape 8: Run the eZ OE upgrade database script / Exécuter le script de mise à jour de l'éditeur OE

(If you upgrade ezoe from 5.0.0 or earlier beta versions of the 5.0.x version) One of the bugs ( #14670) fixed in OE 5.0.1 caused object relations to be stored with wrong relation type id, so they where not removed as relation when you removed them from editor area (ezxmltext). In order to fix the problem on existing relations created with OE 5.0.0 (also affected all prior beta- and rc-releases), apply the following: 
Si vous procédez à ue mise à jour depuis d'une version 5.0.0 ou de toute autre version beta antérieure de la branche 5.0.x: l'un des bugs ( #14670 ) corrigés par la version 5.0.1 de OE était responsable du fait que les rélations d'objets étaient stockées avec un mauvais ID. Elles n'étaient donc pas supprimés en tant que relation lorsque vous les supprimiez à partir de l'éditeur ( ezxmltext). Afin de corriger ce problème pour les relations existantes créées avec OE 5.0.0 (toutes les versions beta et rc antérieures sont affectées), exécutez le script suivant:

<eZP root>/extension/ezoe/update/database/5.0/dbupdate-5.0.0-to-5.0.1.sql

Étape 9: Clearing the caches / Nettoyer 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 nettoyés. Ceci peut être réalisé à partir d'un shell:

Navigate into the eZ Publish 4.0.y directory. 
Placez-vous à la racine du répertoire d'installation de eZ Publish.

Run the script using the following shell command:  
Exécutez ce script par le biais de la ligne de commande suivante:

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

Commentaires