Mise à jour

Moodle est conçu pour être mis à jour sans problème de toute version antérieure à toute version ultérieure. Il n'est donc pas nécessaire de passer par l'installation des versions intermédiaires (exception faite du passage 1.5 ou inférieur vers 1.8 ou supérieur, qui ne sera pas possible). Pour le cas particulier d'une mise à jour d'une version de Moodle inférieure à 1.6, vers une version 1.6 ou supérieure, merci de consulter la page Mise à jour à Moodle 1.6.

Pour mettre à jour une installation de Moodle, vous devez suivre les étapes suivantes.

Relire la documentation d'installation

Prenez le temps de relire la documentation d'installation. Regardez en particulier d'éventuels changements nécessaires pour le serveur web, la base de données et PHP en fonction de la version de Moodle vers laquelle vous voulez évoluer.

Sauvegarder les données importantes

Quoique cela ne soit pas strictement nécessaire, c'est toujours une excellente idée de faire une sauvegarde d'un système en production avant toute mise à jour, au cas où vous devriez revenir à l'état antérieur. En fait, il est toujours judicieux de faire effectuer automatiquement des sauvegardes quotidiennes de Moodle par votre serveur.

Voici les trois zones que vous devez sauvegarder :

Le dossier contenant le logiciel Moodle proprement dit

Effectuez une copie de ces fichiers avant la mise à jour, afin que vous retrouviez vos réglages (fichier config.php) et toutes les parties que vous avez ajoutées, à savoir les modules, blocs, thèmes, langues, etc.

Le dossier de données (moodledata)

C'est là que se trouvent les contenus déposés dans le Moodle (par exemple les ressources des cours ou les devoirs remis par les étudiants), c'est pourquoi il est essentiel d'avoir une copie de sauvegarde de ces fichiers (même si vous ne faites pas de mise à jour). Les mises à jour déplacent ou renomment parfois les dossiers à l'intérieur du dossier de données.

La base de données

La plupart des mises à jour de Moodle modifient la structure des tables de la base de données, en ajoutant ou modifiant des champs. Chaque base de données peut être sauvegardée de différentes manières. Une des façons de sauvegarder une base de données MySQL est de la transférer (dump) dans un fichier SQL. La commande Unix suivante transfère ainsi la base de données appelée moodle :

mysqldump -u username -p -C -Q -e -a moodle > moodle-backup-2006-06-26.sql

À la place de username, mettez-y le nom d'utilisateur de votre base de données. Le commutateur -p indique que vous devrez taper votre mot de passe pour cet utilisateur.

Si l'hôte de votre base de données n'est pas le même que celui sur lequel vous lancez la commande de sauvegarde, vous devrez le spécifier en outre dans la commande mysqldump, à l'aide du commutateur -h :

mysqldump -u username -p -h databasehost -C -Q -e -a moodle > moodle-backup-2006-06-26.sql 

Une autre possibilité est l'utilisation de la fonction Exporter de l'interface web optionnelle MySQL Admin de Moodle pour effectuer la même opération. Cette interface peut être téléchargée ici. Il s'agit d'une intégration de PHPMyAdmin pour l'interface d'administration de Moodle.

Installer le nouveau logiciel Moodle

Utilisation d'une version compressée

Ne décompressez pas votre version téléchargée dans une ancienne installation, à moins que vous ne sachiez vraiment ce que vous faites : les anciens fichiers restant en place posent parfois des problèmes dans de nouvelles installations. La meilleure façon de procéder est de renommer le dossier Moodle actuel, puis de décompresser l'archive téléchargée dans un dossier portant le nom de l'ancienne version.

mv moodle moodle.backup
tar xvzf moodle-1.5.tgz

Copiez ensuite votre config.php et les autres ajouts que vous avez faits, par exemple

cp moodle.backup/config.php moodle
cp -pr moodle.backup/theme/mytheme moodle/theme/mytheme

Utilisation de CVS

Vous pouvez utiliser CVS pour mettre à jour votre Moodle. Vous devrez d'abord effectuer un premier téléchargement CVS (checkout) dans votre dossier Moodle (vide !).

Pour les machines Mac OS X, Linux et autres Unix

Pour effectuer ce premier checkout CVS de Moodle, vous devez vous connecter au serveur CVS de Moodle :

 cvs -d:pserver:anonymous@cvs.sourceforge.net:/cvsroot/moodle login
 Aucun mot de passe n'est nécessaire pour le compte anonymous, tapez Retour.

Allez dans le dossier désiré (vide !) et effectuez ensuite le checkout de la version de Moodle voulue :

 cvs -z3 -d:pserver:anonymous@cvs.sourceforge.net:/cvsroot/moodle co -r MOODLE_15_STABLE moodle 
 (ici MOODLE_15_STABLE est la version désirée)

Pour mettre à jour ultérieurement cette version, allez simplement dans votre dossier Moodle et tapez :

 cvs update -dP

Pour mettre à jour vers une nouvelle version, tapez ce qui suit (en changeant 17 en fonction de la nouvelle version vers laquelle vous évoluez)

 cvs -Q update -dP -r MOODLE_17_STABLE

Assurez-vous d'inclure le paramètre -d pour créer les nouveaux dossiers nécessaires et le paramètre P pour supprimer les dossiers vides.

Pour les serveurs Windows

Vous pouvez utiliser le programme Tortoise CVS pour effectuer le checkout initial et les mises à jour.

Si vous avez modifié des fichiers de Moodle, lisez attentivement les messages pour voir si des conflits existent. Tous vos thèmes personnalisés et les ajouts non-standards ne seront pas modifiés.

Après la mise à jour CVS, n'oubliez pas de visiter la page d'administration du Moodle pour terminer le processus de mise à jour.

Terminer la mise à jour

La dernière étape consiste à lancer le processus de mise à jour dans Moodle.

Pour cela, il suffit de visiter la page d'administration de votre Moodle : http://example.com/moodle/admin

Il n'est pas nécessaire d'être connecté en tant qu'administrateur.

Moodle détectera automatiquement la nouvelle version et effectuera toutes les mises à jour nécessaires dans la base de données et dans le système de fichiers. S'il est incapable d'effectuer quelque opération par lui-même (très rarement), des messages seront affichés, vous expliquant les actions à faire manuellement.

Si tout se passe bien (aucun message d'erreur ne s'affiche), vous pouvez commencer à utiliser votre nouvelle version de Moodle et profiter de ses nouvelles fonctionnalités !

Si la mise à jour génère des problèmes, visitez le site moodle.org et laissez un message sur le forum Installation Support (en anglais) ou Assistance technique (en français).

À savoir

Les nouvelles versions de Moodle amènent leur lot de nouveautés. Parfois, certaines fonctionnalités existantes sont modifiées, voir supprimées. Le mode de fonctionnement de certains éléments peut également changer. Il faut donc se renseigner avant la mise à jour d'un serveur en production, pour ne pas risquer de perdre des fonctionnalités utiles.

Voir aussi

• Mise à jour à Moodle 1.6
• Mise à jour à Moodle 1.7
• Installation de Moodle
• FAQ d'installation
• Installation d'Apache, MySQL et PHP
• Step by Step Installation Guide for Windows (en anglais)
• Step by Step Installation Guide for RedHat (en anglais)
• Step by Step Installation Guide for Debian GNU/Linux (en anglais)
• Discussion de forum Using cvs (en anglais)