Attention : vous consultez actuellement la documentation dédiée aux versions 1.x de Moodle. La documentation pour les versions 2.x de Moodle est consultable ici : Mise à jour, celle pour les versions 3.x de Moodle est consultable ici : Mise à jour et celle pour Moodle 4.x est consultable là : Mise à jour.

Mise à jour

De MoodleDocs
Aller à :navigation, rechercher

Moodle est conçu pour être mis à jour sans problème de toute version antérieure à toute version ultérieure.

Consultez également la page Mise à jour à Moodle 1.6, Mise à jour à Moodle 1.8 ou Mise à jour à Moodle 1.9 ou Mise à jour à Moodle 2.0 ou Mise à jour à Moodle 2.1 ou Mise à jour à Moodle 2.2 en fonction de la version que vous voulez installer.

Il n'est pas nécessaire de passer par l'installation des versions intermédiaires (exception faite du passage direct de 1.5.x ou inférieur vers 1.8 ou supérieur, qui n'est pas possible).

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

Avant de mettre à jour

Les nouvelles versions de Moodle amènent leur lot de nouveautés. Parfois, certaines fonctionnalités existantes sont modifiées, voire 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. Une bonne idée est de tester la mise à jour sur une copie de votre site en production.

Mise à jour de plusieurs versions

En général, il est possible de mettre à jour sans passer par chaque version de Moodle, et en "sautant" des versions. Vous pouvez par exemple évoluer de 2.0 -> 2.1 ou 1.9 -> 2.2. Mais il y a des exceptions, et de trop larges "sauts" ne sont pas possibles (passer de 1.6 à 2.2 par exemple).

Il y a par contre des versions par lesquelles il est obligatoire de "passer", tout en "sautant" les versions intermédiaires (comprendre mettre à jour directement vers cette version avant de passer à une version supérieur). Ainsi, et en fonction de votre version d'origine, vous pourrez évoluer de la sorte (les versions entre parenthèses peuvent être "sautées") :

1.3 (ou 1.4 ou 1.5) -> 1.6 (1.7 ou 1.8) -> 1.9 (2.0 ou 2.1) -> 2.2 (2.3)

Les raisons principales :

  • Moodle 1.6 apportait le support de l'UTF8
  • les définitions de rôles par défaut obtenues avec la version 1.7 ne sont pas idéales pour les versions suivantes, et la version 1.8 comporte des soucis avec les groupes

Relire la documentation d'installation et vérifier les prérequis

Prenez le temps de relire la documentation d'installation. Avant de faire la mise à jour, assurez vous que votre serveur respecte tous les prérequis nécessaires pour installer cette nouvelle version de Moodle, via Administration > Serveur > Environnement.

Placer votre site en mode de maintenance

Avant de commencer la mise à jour de votre site, vous devriez le placer en Mode de maintenance afin d'éviter que les non administrateurs ne se connectent, et modifient des choses.

Sauvegarder les données importantes

Bien que cela ne soit pas strictement nécessaire, faire avant toute mise à jour une sauvegarde d'un système en production est toujours une excellente idée, au cas où il faudrait revenir à l'état précédent. En fait, il est toujours judicieux de mettre en place un système automatique de sauvegardes périodiques - par exemple : quotidiennes - de Moodle sur 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.

Les fichiers de sessions ./moodledata/sessions ne sont pas à sauvegarder, semble-t-il.

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 --create-options moodle > moodle-backup-2011-07-15.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 --create-options moodle > moodle-backup-2011-07-15.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.9.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 !).

Vous pouvez utiliser un des miroirs CVS mis en place, si possible proche de vous géographiquement. Remplacez dans les instructions suivantes SERVER.cvs.moodle.org par le nom du serveur que vous aurez choisi.

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@SERVER.cvs.moodle.org:/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@SERVER.cvs.moodle.org:/cvsroot/moodle co -r MOODLE_19_STABLE moodle 
 (ici MOODLE_19_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 19 en fonction de la nouvelle version vers laquelle vous évoluez)

 cvs -Q update -dP -r MOODLE_19_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.

Utilisation de Git

Vous pouvez utiliser Git pour mettre à jour votre Moodle. Vous devez d'abord faire une extraction Git dans votre répertoire racine Moodle (vide).

Voyez Git pour administrateurs pour plus de détails.

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).

Vérifier la mise à jour (optionnel)

Si vous souhaitez vérifier que le schéma de la base de données mise à jour correspond à celle d'une nouvelle installation (ce qui devrait être le cas), vous devriez consulter la page Vérifier le schéma de la base de données (en anglais).

Voir aussi