Mettre à jour Claroline
Un article de Claroline Documentation.
Avant de mettre à jour, nous vous conseillons vivement de réaliser une sauvegarde complète du dossier Claroline et des bases de données.
ATTENTION : cette procédure ne vaut que pour les mises à jours majeures, celle ou le 2eme numero de version change (Claroline 1.x à Claroline 1.y) Pour effectuer une mise à jour mineure (Claroline 1.8.x à Claroline 1.8.y) il suffit de remplacer les fichiers de Claroline par les nouveaux (En 1.8 il suffit de remplacer le fichier index.php à la racine et le répertoire claroline) Quoi qu'il arrive prévoyez toujours un backup.
Télécharger la dernière version stable de Claroline
Pour pouvoir mettre à jour votre plate-forme vers la version 1.8, vous devez d'abord mettre à jour votre plate-forme actuelle vers la version 1.7.
Téléchargez Claroline 1.8.* sur la page de téléchargement (http://www.claroline.net/download/stable.html).
Décompresser l'archive
Linux : ouvrez une console, allez dans le dossier où vous avez téléchargé l'archive et tapez en ligne de commande tar -xzvf claroline18x.tar.gz
Windows : décompressez claroline18x.zip (avec 7zip (http://www.7-zip.org/fr/) par exemple)
Remplacer la version précédente du dossier Claroline par la nouvelle
Il y a 2 solutions :
-
- N'effacez pas le dossier précédent, sinon vous allez perdre votre ancien fichier de configuration (par exemple claroline/inc/conf).
- Copiez simplement le nouveau dossier sur l'ancien.
- Lancez la mise à jour
ou
-
- Renommez le dossier monsite/claroline en monsite/claroline-old
- Copiez les fichiers de l'archive 1.8 vers le dossier monsite/
- Copiez les fichiers *.conf.php du dossier monsite/claroline-old/inc/conf vers le dossier monsite/claroline/inc/conf.
- Copiez le fichier monsite/claroline-old/inc/currentVersion.inc.php vers le dossier monsite/claroline/inc.
- Lancez la mise à jour
- Si la mise à jour est réussie, vous pouvez supprimer le dossier monsite/claroline-old
Vérifier la permission sur les fichiers
Les dossiers suivants doivent être accessibles en écriture
1. monsite/claroline/admin/upgrade 2. monsite
chmod 777 monsite/ chmod 777 monsite/claroline/admin/upgrade
Ouvrir un navigateur et aller à
http://www.mydomain.org/mysite/mydir/claroline/admin/upgrade
Si vous utilisez Windows avec easyPhp localement : http://localhost/mydir/claroline/admin/upgrade
Suivre les instructions de mise à jour
L'outil de mise à jour retrouve les données de la version précédente de Claroline et les modifie pour la nouvelle version. Cette mise à jour s'effectue en 3 étapes :
- Récupération des anciens paramètres et configuration des nouveaux
- Conversion des tables principales vers la nouvelle structure
- Conversion de chaque cours
Note:En fonction de la vitesse du serveur et de la quantité de données stockées, les opérations de mise à jour peuvent prendre un certain temps. Vous pouvez augmenter les temps d'exécution des scripts php dans le fichier configuration 'php.ini' max_execution_time = 300 ; Maximum execution time of each script, in seconds
Confirm backup of the data
Avant de procéder à la mise à jour :
- Faites une sauvegarde complète des fichiers et bases de données.
Vous ne pourrez procéder à la mise à jour tant que done n'est pas coché.
Comment sauvegarder la base de données ?
mysqldump -ulogin -p -Q --add-drop-table claroline-database > claroline-dump.sql
Vous pouvez aussi réaliser la sauvegarde à l'aide d'autres outils d'administration comme MySQL Administrator (http://www.mysql.com/products/administrator), phpMyAdmin (http://www.phpmyadmin.net)
Step 1 of 3: platform main settings
L'outil de mise à jour procède à la mise à jour de la configuration.
Les paramètres des versions antérieures à la 1.7 sont stockés dans claroline/inc/conf/claro_main.conf.php .
Cliquez pour lancer l'upgrade.
Contrôlez la mise à jour de la configuration.
Pour continuer, cliquez next.
Step 2 of 3 Main platform tables upgrade
L'outil de mise à jour convertit les données stockées dans les tables principales de Claroline (utilisateurs, catégories de cours, liste d'outils,...). Cliquez pour lancer la conversion.
Contrôlez le résultat.
Pour continuer, cliquez next.
Step 3 of 3: courses upgrade
L'outil de mise à jour convertit chaque cours un par un (dossiers et tables des bases de données).
Cliquez pour lancer la conversion des cours.
L'outil de mise à jour procède à la conversion des cours.
Vous pouvez voir le nombre de cours convertis.
Pour terminer la mise à jour, cliquez next.
Upgrade process achieved
La mise à jour est achevée.
Si vous avez un mauvais fonctionnement, il s'agit d'un problème avec le css dans votre navigateur (appuyez sur : ctrl+r).
FAQ
Upgrade main settings of claroline : Upgrade file xxx Failed
Vérifier les permissions d'écriture sur le dossier monsite/
Upgrade of main database, we have this error message "Db version unknown : "
Créez un fichier platform/currentVersion.inc.php avec ceci :
<?php $clarolineVersion = "1.8"; $versionDb = "1.7"; ?>
Upgrade of courses : Course version unknown :
Vérifier la version des cours dans la table de cours
select versionClaro, count(*) from cl_cours group by versionClaro;
Exécutez cette requête :
update cl_cours set versionClaro = "1.7" where versionClaro = "";
Upgrade of courses : Course version unknown : NEVER_SET
Exécutez cette requête :
update cl_cours set versionClaro = "1.7" where versionClaro = "NEVER_SET";
External Authentication in 1.8 (LDAP, ...)
Si vous utilisiez l'authentification externe, vous devez modifier manuellement ce fichier : platform/conf/auth.drivers.conf.php
Autres problèmes
Postez un message sur le forum http://www.claroline.net/forum
