Manual:Upgrading/fr



Survol
Tout d'abord, lisez le fichier texte UPGRADE inclus dans MediaWiki.


 * 1) Vérifier les prérequis
 * 2) Lire les notes de version
 * 3) Sauver les fichiers et la base de données
 * 4) Mettre en place les nouveaux fichiers
 * 5) Faire tourner le script de la mise à jour de la base données
 * 6) Mettre à jour les extensions
 * 7) Vérifier la mise à jour

Vérifier les prérequis
MediaWiki requiert :

PHP

 * PHP 5.2.3 ou ultérieur
 * Plusieurs versions précédentes supportaient PHP 5.2.3 et ultérieur, à l'exception de la version 5.3.1, qui a des bogues empêchant MediaWiki de fonctionner correctement.

SGBD

 * MySQL ou ultérieur
 * La version 3.x n'est plus supportée depuis MediaWiki 1.6.x
 * La version 4.x n'est plus supportée depuis MediaWiki 1.19

Ou


 * PostgreSQL 8.3 ou ultérieur
 * Voir aussi Mise à jour de Postgres

Lire les notes de version
Dans le fichier compressé qui contient MediaWiki, ou les fichiers exportés depuis Git, il y a un certain nombre de fichiers nommés avec des lettres capitales, un de ceux-là contient les Notes de version (wiki). C'est le moment de l'ouvrir et de découvrir tout ce qui a changé dans cette version.

Sauvegarder les fichiers et la base de données

 * Instructions complètes : Manuel sur la sauvegarde de wiki

Bien que les scripts de mise à jour soint bien maintenus et robustes, les choses peuvent malgré tout tourner au vinaigre. Avant de procéder à la mise à jour du script de base de données, faites une sauvegarde du wiki qui comprendra la base de données et les fichiers :


 * le contenu du wiki, depuis la base de données. C'est une bonne idée de créer un dump XML en plus du dump SQL de la base de données.
 * MySQL :
 * dump SQL : mysqldump --user=xxx --password=xxx --all-databases > fichier.sql
 * dump XML : mysqldump --user=xxx --password=xxx --all-databases --xml > fichier.xml
 * PostgreSQL :
 * sortie pour pg_restore : pg_dump --create -Fc -i votrewiki > votrewiki.db.dump
 * SQLite :
 * php maintenance/sqlite.php --backup-to nomfichier
 * les images et les autres fichiers média (tout le contenu du répertoire images)
 * les fichiers de configuration LocalSettings.php et AdminSettings.php (si présent)
 * les fichiers programme de MediaWiki, y compris tous les habillages et extension, surtout si vous les avez modifiés.

Utilisation d'un package tarball
Si vous utilisez un package tarball, décompressez le fichier sur le serveur où tourne l'ancienne version de MediaWiki. Il se peut que vous ayez besoins de taper les lignes de commande en tant que sudo si vous n'avez pas les pleins privilèges de gestion des répertoires d'installation du wiki sous votre compte courant. Quand vous décompressez le package tarball, normalement un nouveau répertoire pour la nouvelle version du wiki sera créé et vous devrez copier les nouveaux fichiers et répertoires dans votre répertoire wiki actuel. Si vous voulez tout faire en une seule fois, faites plutôt ceci :

$ tar xvzf mediawiki-.tar.gz -C /chemin/de/votre/wiki/ --strip-components=1

Sur les anciennes distributions Linux (par exemple RHEL/CentOS 4.x), faites ceci :

$ tar xvzf mediawiki-.tar.gz -C /chemin/de/votre/wiki/ --strip-path=1

Les personnes qui utilisent une ancienne version de tar (par exemple GNU tar 1.13.x) qui ne dispose pas des drapeaux --strip-components</tt> ou --strip-path</tt> peuvent décompresser l'archive sans l'option -C</tt> puis copier de façon récursive le contenu du dernier package dans la structure précédente du répertoire wiki, comme suit :

$ tar xvfz mediawiki-.tar.gz $ cp -r mediawiki-/* /chemin/de/votre/wiki/

Les utilisateur d'(Open)Solaris devront utliser gstar, ou :

$ gzip -dc mediawiki-.tar.gz | tar xf -

Faire tourner le script de la mise à jour de la base de données
Note : Il faut être sur qu'il existe un fichier AdminSettings.php</tt> dans le répertoire principal du wiki, et qu'il contient les informations correctes. L'utilisateur inscrit dans ce fichier doit avoir les permissions complètes sur la base de données.

La meilleure méthode est de faire tourner le script de mise à jour bien qu'il soit possible de réutiliser l'installeur.

Shell
Depuis un invite de ligne de commandes, ou un shell SSH ou similaire, changer le répertoire courant pour être dans le dossier maintenance</tt> et exécuter le script suivant :

$ php update.php

Il est parfois nécessaire de préciser l'emplacement du fichier AdminSettings.php ou AdminSettings.sample (ça fonctionne avec les 2). Lorsque vous êtes dans le dossier maintenance</tt> vos pouvez exécuter le script suivant :

$ php update.php --aconf ../AdminSettings.php

(ou bien en remplaçant AdminSettings.php par AdminSettings.sample si vous ne l'avez pas renommé)

MediaWiki va inspecter le schéma de la base de données, et le mettre à jour pour qu'il puisse être utilisable avec le nouveau code de MediaWiki, en ajoutant des tables et des colonnes si nécessaire.

Alternative 1 : phpShell
Si l'accès au shell n'est pas disponible, considérer des alternatives tel que phpShell, qui émule une ligne de commandes en utilisant les fonctions PHP. Il est possible que celui-ci ne fonctionne pas chez certains hébergeurs, selon la configuration du serveur web.

Lorsqu'un tel système est utilisé, il pourrait être désirable de sauter le compte à rebours au début du script. Pour ce faire, il faut passer l'option --quick</tt> au script de la manière suivante :

$ php update.php --quick

S'il y a différentes versions de PHP installées sur le système, il est possible d'avoir besoin d'utiliser "php5" à la place de "php". Avec phpShell, il sera peut-être nécessaire de modifier les fichiers commandLine.inc et LocalSettings.php afin d'éviter que le script se termine à cause du fait que phpShell s'exécute d'après le serveur web.

Alternative 2 : Refaire tourner l'installeur
Une alternative consiste à refaire tourner l'installeur utilisé pour l'installation du Wiki. Pour faire ceci, il faut :


 * 1) Renommer LocalSettings.php</tt> en LocalSettings.old.php</tt>
 * 2) Faire en sorte que le dossier config</tt> soit accessible en écriture par le serveur web
 * 3) Être sûr que l'utilisateur de la base de données ait un accès complet à celle-ci
 * 4) Aller au wiki via un navigateur web et répéter l'installation

Remplir les cases avec les mêmes valeurs que lors de la première installation. Lors de l'exécution, le script va détecter les tables existantes et les mettre à jour. Quand ceci sera fini, un nouveau fichier LocalSettings.php</tt> va être généré.


 * 1) Supprimer ce nouveau fichier
 * 2) Renommer LocalSettings.old.php</tt> en LocalSettings.php</tt>
 * 3) Restaurer les permissions du dossier config</tt>.

Mettre à jour les extensions
Certaines extensions ont été mises à jour pour fonctionner avec MediaWiki. Il faut être sûr de mettre à jour la dernière version de ces extensions. Il peut être nécessaire de faire des mises à jour manuelles avec certaines extensions personnalisées.

Vérifier la mise à jour
Une fois la mise à jour terminée, vérifier que tout fonctionne comme voir et éditer des pages pour être sûr que tout marche comme prévu.

Voir la page Special:Version et vérifier que la version affichée est correcte.