Manual:Upgrading to 1.12/fr
Cette page contient des information pour une mise à jour vers une ancienne version de MediaWiki. Il vous est recommandé de faire une mise à jour vers 1.42.3 si possible. Des instructions en ce sens sont disponibles sur la page Mise à jour . |
Version stable (MediaWiki 1.42 )
- mediawiki-1.42.3.tar.gz
- mediawiki-1.42.3.zip
- Branche Git: REL1_42
Anciennes versions (MediaWiki 1.41 )
- mediawiki-1.41.4.tar.gz
- mediawiki-1.41.4.zip
- Branche Git : REL1_41
Version Alpha (MediaWiki 1.44 )
Autres informations :
Survol
[edit]Premièrement, lire le fichier UPGRADE inclut avec MediaWiki 1.12.
Comme avec toutes les mises à jour, vérifier les choses suivantes :
- Vérifier les prérequis
- Lire les notes de version
- Sauver les fichiers et la base de données
- Mettre en place les nouveaux fichiers
- Faire tourner le script de la mise à jour de la base données
- Mettre à jour les extensions
- 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
etplpgsql
sont également requis
- Les modules
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
etAdminSettings.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 :
- Renommer
LocalSettings.php
enLocalSettings.old.php
- Faire en sorte que le dossier
config
soit accessible en écriture par le serveur web - Être sûr que l'utilisateur de la base de données ait un accès complet à celle-ci
- 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é.
- Supprimer ce nouveau fichier
- Renommer
LocalSettings.old.php
enLocalSettings.php
- 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.