Manual:Upgrading to 1.11/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.41.1 si possible. Des instructions en ce sens sont disponibles sur la page Mise à jour . |
Version stable (MediaWiki 1.41 )
- mediawiki-1.41.1.tar.gz
- mediawiki-1.41.1.zip
- Branche Git: REL1_41
Anciennes versions (MediaWiki 1.40 )
- mediawiki-1.40.3.tar.gz
- mediawiki-1.40.3.zip
- Branche Git : REL1_40
Version Alpha (MediaWiki 1.43 )
Autres informations :
Survol[edit]
PremiĂšrement, lire le fichier UPGRADE inclut avec MediaWiki 1.11.
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.11 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.11. â Vous pouvez aussi les lire sur Release notes/1.11.
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.11, 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 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.11. 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.