Manuel:Faire une copie de secours d'un wiki

From mediawiki.org
Jump to navigation Jump to search
This page is a translated version of the page Manual:Moving a wiki and the translation is 100% complete.
Other languages:
English • ‎français • ‎日本語
Si vous cherchez simplement à déplacer votre wiki, par exemple de /var/www/html/ à /var/www/html/mywiki/, les instructions sont ici.

Cette page explique comment déplacer un wiki vers un autre serveur. Ceci est souvent nécessaire lors du passage à un autre serveur Web ou domaine (ou les deux).

Le moyen le plus sûr de le faire est d'utiliser la même version de MediaWiki sur les deux wikis. Cependant, il est possible d'installer une version plus récente de MediaWiki sur le nouveau serveur et d'effectuer une upgrade directement sur le nouveau serveur. En fait, cela peut être votre seule option si vous souhaitez mettre à niveau votre wiki vers une nouvelle version qui a des exigences plus élevées que celles disponibles sur votre ancien serveur (comme la version php).

Les étapes sont essentiellement expliquées dans d'autres pages :

  1. Faites une sauvegarde de votre wiki.
  2. Transférez les sauvegardes de l'ancien serveur vers le nouveau.
  3. Restaurez la sauvegarde sur le nouveau serveur.
Avant de commencer à sauvegarder votre wiki, vous voudrez peut-être le mettre en mode "lecture seule" afin que personne ne puisse le modifier pendant que vous le déplacez. Si vous ne le faites pas, vous risquez de perdre les modifications/téléchargements/journaux, etc. qui ont été effectués pendant le processus de migration. Pour ce faire, utilisez $wgReadOnly dans LocalSettings.php. Par exemple :
$wgReadOnly = 'Down for maintenance: access will be restored shortly';

Mise à jour du nouveau serveur

Si vous effectuez une mise à niveau vers une version plus récente de MediaWiki sur le nouveau serveur, au lieu de copier l'ancien répertoire et les extensions MediaWiki sur le nouveau serveur, vous devez suivre la procédure de mise à jour. Vous allez télécharger une nouvelle version de MediaWiki sur le nouveau serveur et de nouvelles versions des extensions que vous utilisez, correspondant à la nouvelle version de MediaWiki. N'oubliez pas de exécuter le script de mise à jour.

Notes

  • If the URL has changed (for example, a new domain), be sure to update all references to it in LocalSettings.php. If using VisualEditor, you'll need to update Parsoid configuration too.
    • Links on cached pages may still point to the old domain. You may need to bump $wgCacheEpoch to discard cached pages prior to that time.
  • Check that the upload/ directory has the correct permissions set if using uploads; it must be writable by the web server.
  • Make sure any extension directories have the correct permissions as well (e.g., if linux: chmod -R o=rx extensions)
  • When manually transferring a wiki from a windows platform to a Linux platform the best method is to:
  1. Manually install MediaWiki on the Linux platform from a tar file as outlined here: Manual Install of Wiki (i.e., try not to use install from an automated package)
  2. Replace the newly installed MediaWiki folder (e.g., /var/www/mediawiki...) on your Linux machine with the MediaWiki base folder from your windows machine
  3. Update your Linux machine's MySQL Database (e.g. wikidb) with the wiki database from your windows machine (i.e., use the backup and restore features of mysql as outlined above)
  • After importing a wiki database, even if the database can work, some minor problems may arise:
  1. You might need to repair Searchindex: In phpMyAdmin, enter "REPAIR TABLE wikidb.searchindex; " for rebuilding the search index. wikidb is your database's name.
  2. The collation of some rows may be changed. Cross-check it with the original database.

Test

À ce stade, essayez d'utiliser le wiki sur le nouveau serveur. Connectez-vous en tant que sysop et utilisateur régulier et vérifiez que l'affichage, la création et l'édition de pages et le téléchargement de fichiers fonctionnent toujours. Résolvez tous les problèmes signalés par PHP ou MediaWiki lui-même.

Vous pouvez faire tout le processus pour tester si le déplacement fonctionnera sans problème, avant de mettre l'ancien wiki en lecture seule. Une fois que vous savez que votre wiki sur le nouveau serveur fonctionne comme prévu, vous pouvez mettre votre ancien wiki en mode lecture seule et effectuer à nouveau le déplacement.

Problèmes fréquents

Inaccessible files after the changing the domain

The column md_deps in the module_deps table contains absolute file paths, which are used to locate the images and LESS files that CSS depends on. These paths break when the wiki is, e.g., moved to another folder or another server. After your move, you might see PHP warnings that certain files could not be accessed. In current versions of MediaWiki, this can be solved by running update.php, thus clearing caches.

In versions older than MediaWiki 1.25 (where phabricator:T37472 is not implemented), update.php does not delete the contents of the module_deps table. For these versions, the workaround is to manually fix wrong entries in the module_deps table:

-- Update entries in module_deps table
SET @old='wiki.old-domain.org';
SET @new='wiki.new-domain.org';

UPDATE `module_deps` SET `md_deps` = REPLACE( `md_deps`, @old, @new );

This can be used to update wrong path segments and to fix the error.

A similar issue can happen when MediaWiki tries to read resource loader messages. In this case the solution is to truncate the according tables:

-- Truncate message related caches
TRUNCATE TABLE `msg_resource`;
TRUNCATE TABLE `msg_resource_links`;

Voir aussi

Liens externes

Notes