Date de publication: le lundi 1 mars 2010 à 15h05
Dernière modification: par Pascal BOYER le mercredi 1 septembre 2010 à 16h11
» Article suivant: eZ Publish : généralités sur la procédure de mise à jour

26/05/2009 5:30  

Backup / Sauvegarde

Before you do anything else, you should make sure that the current solution is properly backed up. In other words, you should create a copy of the entire eZ Publish directory and the database. The following example shows how this can be done on a Linux/UNIX based system where eZ Publish is using a MySQL database called "example". Note that the system should be closed for access during backups and upgrades. 
Avant de faire quoi que ce soit d'autre (et surtout une mise à jour), vous devez vous assurer que la version en production de votre système est correctement sauvegardée. En d'autres termes, vous devez créer une copie et de l'intégralité du répertoire d'installation de eZ Publish et de la base de données. Les exemples qui suivent illustrent la procédure à suivre pour un système Linux/UNIX sur lequel tourne un site eZ Publish couplé à une base de données MySQL nommée « example». Retenez que votre système ne doit plus autoriser les accès lors des phases de sauvegarde et de de mise à jour.

1. Navigate into the eZ Publish directory:
   Placez-vous dans le répertoire d'installation de eZ Publish: 

   $ cd /path/to/ez_publish

2. Clear all caches:
   Videz tous les caches:

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

   If you have PHP CLI installed, you can also do the following (this script should also work on Windows): 
   Si PHP CLI  est installé, vous pouvez également lancer la commande suivante (ce script devrait fonctionner aussi sous windows):

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

   From 3.10, the "clearcache.sh" script has been disabled. This means that the file is still present but the code inside is removed. It outputs a message telling the user to use "bin/php/ezcache.php". In other words, you have to use "ezcache.php" instead. After running the script, make sure that all cache files have been cleared by inspecting the contents of the various cache subdirectories within the "var" directory (typically the "var/cache/" and "var/<name_of_siteaccess>/cache/" directories). If there are any cache files left, remove them manually. 
   Depuis la version 3.10, le script clearcache.sh est désactivé, ce qui signifie que le fichier est toujours présent mais que son code a été supprimé. L'exécution de ce script provoque donc l'affichage d'un message demandant à l'utilisateur d'utiliser le script bin/php/ ezcache.php. En clair, vous devez utiliser ce dernier script. Assurez-vous ensuite que les caches soient effectivement 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 cachés supprimez-les manuellement.

3. Create a dump of the database:
   Faites un dump (une sauvegarde) de la base de données:

   $ mysqldump -u root --add-drop-table example > db_backup.sql 
    

4. Go to the parent directory: 
   Placez-vous dans le répertoire parent (de niveau supérieur):

   $ cd .. 
    

5. Create a tape archive of the files (including the DB dump) using the "tar" command:
   Créez, avec la commande « tar», une archive de tous les fichiers (incluant le dump de la base de données): 

   $ tar cfz backup_of_ez_publish.tar.gz ez_publish

   At this point, the file "backup_of_ez_publish.tar.gz" should contain a backup of everything (both files and DB). 
   A ce stade, le fichier backup_of_ez_publish.tar.gz doit contenir une sauvegarde complète des fichiers et de la base de données.

Consistency checks / Contrôles de cohérence

The administration interface makes it possible to quickly check whether the current installation is in a consistent state or not. This can be done using the "Upgrade check" section of the "Setup" part. There are two checks that can be run:  
Il est possible, à partir de l'interface d'administration, de contrôler rapidement l'état de cohérence du système. Pour cela, cliquez, dans l'onglet Administration, sur le lien Vérifier la mise à jour situé dans le menu gauche puis exécutez les deux tests suivants (en cliquant respectivement sur les deux boutons suivants):

• File consistency check / « Vérification de la consistance des fichiers»
• Database consistency check / « Vérification de la consistance de la base de données»

File consistency check / Contrôle de la cohérence des fichiers

The file consistency tool checks if you have altered any of the files that came with the current installation. If this is the case, then the altered files should be backed up before the system is upgraded because they will most likely be overwritten by new versions. Make sure that you backup and then merge in your custom changes into the new versions of the files. 
L'outil de contrôle de cohérence des fichiers vérifie que vous n'avez apporté aucune modification aux fichiers installés par défaut par eZ Publish. Dans le cas contraire, les fichiers modifiés doivent être sauvegardés avant d'entamer la procédure de mise à jour du système qui remplacera ces fichiers par leur nouvelle version. Vous devez donc vous assurer d'avoir une sauvegarde de vos modifications que vous veillerez à repporter dans les nouvelles versions des fichiers.

Database consistency check / Contrôle de la cohérence de la base de données

The database consistency feature checks if the current database is consistent with the database schema that came with the eZ Publish distribution that is currently running. If there are any inconsistencies, the system will suggest the necessary SQL statements that should be ran in order to bring the database into a consistent state. Make sure that the database is backed up and run the suggested SQL statements before upgrading. 
Le contrôle de cohérence de la base de données vérifie que celle-ci est restée cohérente avec le schéma de base de données fourni par la distribution eZ Publish actuellement en production. En présence de la moindre incohérence, le système vous proposera la requête SQL à exécuter pour retrouver la cohérence initiale de la base de données. Assurez-vous donc d'en posséder une sauvegarde et exécutez les requêtes SQL proposées avant de procéder à la mise à jour de votre système.

The actual upgrade process / Le processus de mise à jour

An actual eZ Publish upgrade process is usually carried out in a few steps. First, the current eZ Publish files must be replaced with the files from the new distribution. Secondly, a couple of scripts must be run in order to bring the database (and possibly other things) into a state that is compatible with the upgraded files. In addition, it might be needed to change the system configuration (review some INI settings, add templates, etc.) Refer to the "How to proceed" section for general information about these steps. 
Un processus de mise à jour de eZ Publish se déroule généralement en quelques étapes. Premièrement, les fichiers de la version courante de eZ Publish doivent être remplacés par ceux de la nouvelle version. Deuxièmement, quelques scripts doivent être exécutés afin de faire évoluer la base de données (et d'éventuels autres éléments) vers un état compatible avec les nouveaux fichiers. Il sera de plus peut-être nécessaire de modifier la configuration du système (revoir certains paramètres INI, ajouter des templates, etc...). Référez-vous à l'article Comment procéder  pour de plus amples informations sur ces différentes étapes.

Commentaires