Migration de Moodle

Remarque : la traduction de cet article n'est pas terminée. N'hésitez pas à traduire tout ou partie de cette page ou à la compléter. Vous pouvez aussi utiliser la page de discussion pour vos recommandations et suggestions d'améliorations.

Parfois, vous devez déplacer votre site Moodle d'un emplacement à un autre. Cela s'appelle une migration, lorsque vous devez modifier la valeur de $CFG->wwwroot dans votre fichier config.php. La migration est découpée en plusieurs phases, détaillées ci-dessous :

Mise à jour de Moodle

Lorsque vous migrez Moodle, c'est souvent une bonne idée et l'opportunité de mettre à jour Moodle vers une version plus récente. Si vous gérez votre propre serveur, suivez les instructions de mise à jour, sinon, voyez si votre hébergeur peut le faire pour vous.

Restaurer un cours

You may need to restore a single course from an old site to a new one, especially if you are testing the migration. When restoring a Moodle backup file to Moodle on a different server than the one used to create the backup, the absolute referenced links to files maybe broken. To fix this problem open the backup-coursename.zip file and edit the moodle.xml file replacing links with $@FILEPHP@$.

For example, replace http://yourserver.com/file.php/243/ with $@FILEPHP@$

When the file is restored it will use the correct file path for the new course.

Migrer un site Moodle complet

This involves moving a whole site from one server to another. If you are changing the domain/IP address to the new server you need to do these steps:

• Place your current Moodle site in maintenance mode to prevent any further additions to the Moodle database. Don't let administrators login during the migration as they are not affected by the maintenance mode setting.
• Backup your current Moodle database by following the instructions in the upgrading Moodle page. This will give you a text file containing the mysql dump.
• Copy the Moodle software code itself to the new server - upgrade the code to the latest version if you can.
• In your (possibly new) Moodle directory, change the $CFG->wwwroot variable in the config.php file for the new server.
• Copy the contents of your data directory (check for the value in $CFG->dataroot) to the new server. Check also that permissions remain the same on the new dataroot folder and change the value if you have changed its location on the new server.
• Copy your current Moodle database to the new server. You may need to zip the file to reduce the time taken for this process.
• Change your Moodle database on the new server. This is needed as links to pictures, files, etc are stored as absolute links and will reference the old $CFG->wwwroot value. So when loading a mysql backup dump of the Moodle server into mysql on another server the absolute referenced links will be broken. This can be most easily fixed with the program replace.php. After uploading the mysql dump file point your browser to http://yourserver.com/admin/replace.php

Enter the url for your old server (http://oldserver.com/) and new server (http://newserver.com/) and it will fix the mysql tables. You will also need to clear out any cached links by restarting your webserver.

Warning: Before using replace.php make a backup of your Moodle database and test this this backup is OK by restoring it to a test install (say on a PC).

An alternative is to use the search and replace feature of your text editor (or use a unix tool like sed) to replace the old URL with the new one in the mysql backup file. Once you have done this, restore the database.

#sed -e 's/oldserver.com/newserver.com/' mysqldump.sql

Tip: You may want to check the mysqldump file to see how the old server was referenced.

• To test the new install, access Moodle using your browser and the new server's URL. When you have tested that a number of links in the courses work, take the new Moodle site out of maintenance mode.

Changements dans le DNS

Vous avez peut-être effectué des changements dans les entrées de DNS pour votre nouveau site Moodle. Si c'est le cas, il faudra un peu de temps pour que ces changements soient répercutés, soyez donc patient.

Accès interne et externe

Pour finir, vérifiez que l'accès à votre site est possible, autant en interne que depuis internet.

Voir aussi

• La discussion Changing Moodle URL sur les forums (en anglais)
• La discussion Changing site address sur les forums (en anglais)
• La discussion Upgrading whilst migrating sur les forums (en anglais)