Manual:Upgrading to 1.12/fr

From mediawiki.org


Survol[edit]

Premièrement, lire le fichier UPGRADE inclut avec MediaWiki 1.12.

Comme avec toutes les mises à jour, vérifier les choses suivantes :

  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[edit]

MediaWiki 1.12 requiert :

PHP[edit]

  • PHP 5.0.x ou ultérieur
    PHP 5.1.x ou 5.2.x. est recommandé
    Note : PHP 5.0.x sous certaines plateformes 64-bit contient des bugs qui causent des erreurs majeures avec MediaWiki. Si vous êtes sous x86_64 (AMD64, EMT64) ou d'autres plateformes 64-bit touchées, PHP 5.1.x ou 5.2.x est requis.

SGBD[edit]

  • MySQL 4.0.x ou ultérieur
    La version 3.x n'est plus supportée depuis MediaWiki 1.6.0

Ou

  • PostgreSQL 8.1 ou ultérieur
    Les modules tsearch2 et plpgsql sont également requis

Lire les notes de version[edit]

Dans le fichier compressé qui contient MediaWiki, ou les fichiers exportés depuis SVN, il y a un certain nombre de fichier nommés avec des lettres capitales, un de ceux-là contient les RELEASE-NOTES (ou notes de version, en anglais). Il faut les ouvrir et les lire pour voir ce qui a été changé dans la version 1.12. Vous pouvez aussi les lire sur Release notes/1.12.

Sauver les fichiers et la base de données[edit]

Bien que le script de mise à jour soit à jour et robuste, il peut toutefois y avoir des ratés. Avant de procéder à la mise à jour du schéma de la base de données, il faut faire une sauvegarde complète du wiki, incluant la base de données ainsi que les fichiers suivants :

  • le contenu du wiki, de la base de données. Ce peut aussi être une bonne idée de créer un fichier XML en plus du fichier SQL.
  • les images et les autres media (le contenu du dossier images)
  • les fichiers de configuration, i.e. LocalSettings.php et AdminSettings.php (si présent)
  • les fichiers de MediaWiki, incluant toutes les apparences et les extensions, fortement recommandé si elles ont été modifiées

Voir Manual:Backing up a wiki (en anglais) pour les instructions.

Mettre en place les nouveaux fichiers[edit]

Si vous utilisez un fichier compressé, décompressez-le; si vous utilisez Subversion, exportez les fichier dans un nouveau dossier. Remplacez les fichiers existant par les nouveaux de la version 1.12, en conservant la structure du répertoire. Le code de MediaWiki est maintenant à jour.

Faire tourner le script de la mise à jour de la base de données[edit]

Note : Il faut être sur qu'il existe un fichier AdminSettings.php 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[edit]

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

$ php update.php

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[edit]

Si l'accès shell n'est pas disponible, voir des options comme phpShell, qui émule une ligne de commandes, en utilisant les fonctions PHP, il peut ne pas marcher chez certains hébergeurs.

En utilisant une telle solution, il est souvent désiré de passer le compte à rebours au début du script, il faut alors passer l'option --quick au script de la manière suivante :

$ php update.php --quick

Alternative 2 : Refaire tourner l'installeur[edit]

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

  1. Renommer LocalSettings.php en LocalSettings.old.php
  2. Faire en sorte que le dossier config 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 va être généré.

  1. Supprimer ce nouveau fichier
  2. Renommer LocalSettings.old.php en LocalSettings.php
  3. Restaurer les permissions du dossier config.

Mettre à jour les extensions[edit]

Certaines extensions ont été mises à jour pour fonctionner avec MediaWiki 1.12. 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[edit]

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.