From ClarolineDoc

Note: Make a backup of your current Claroline directory before proceeding. 
And don't forget to make a backup of your Claroline database. Use the tool mysqldump from MySQL.

mysqldump -ulogin -p -Q --add-drop-table claroline-database > claroline-dump.sql

You can also make database backups via most administration tools such as MySQL Administrator (http://www.mysql.com/products/administrator), phpMyAdmin (http://www.phpmyadmin.net).

Table of contents

1 Upgrade from 1.7.* to 1.8 1.1 Download the most stable version of Claroline 1.2 Uncompress the archive 1.3 Replace your previous Claroline directory and index.php by the new one 1.4 Check the files permission 1.5 Open web browser and go to 1.6 Follow the instructions of the upgrade process in your browser 1.6.1 Login 1.6.2 Confirm backup of the data 1.6.3 Step 1 of 3: platform main settings 1.6.4 Step 2 of 3 Main platform tables upgrade 1.6.5 Step 3 of 3: courses upgrade 1.6.6 Upgrade process achieved 2 FAQ 2.1 Upgrade main settings of claroline : Upgrade file xxx Failed 2.2 Upgrade of main database, we have this error message "Db version unknown : " 2.3 Upgrade of courses : Course version unknown : 2.4 Upgrade of courses : Course version unknown : NEVER_SET 2.5 External Authentication in 1.8 (LDAP, ...) 2.6 Others problems 3 Upgrade from 1.4.* to 1.5 4 Upgrade from 1.5.* to 1.6 5 Upgrade from 1.5.*, 1.6.* to 1.7

Upgrade from 1.7.* to 1.8

Download the most stable version of Claroline

In order to upgrade from Claroline 1.7.* to 1.8, you must first update your current installation to 1.7.

Download Claroline 1.8.* from the claroline.net downloads page (http://www.claroline.net/download.htm)

Uncompress the archive

Linux : Open a shell, go to download directory and type tar -xzvf claroline180.tar.gz

Windows : Use the archiving utility of your choice and unzip 'claroline180.zip'

Replace your previous Claroline directory and index.php by the new one

There are two solutions :

1.

1. Don't delete the previous directory before installing the new one. You will loose your previous configuration files (from 'claroline/inc/conf').
2. Simply replace the old directory with a new one with a 'copy' command. That way, the new file versions will overwrite the old ones and leave the others intact.
3. Launch upgrade

or

2.

1. Rename mysite/claroline folder in mysite/claroline-old.
2. Copy files from archive to the folder mysite/ of your platform.
3. Copy mysite/claroline-old/inc/conf in mysite/claroline/inc/conf.
4. Copy mysite/claroline-old/inc/currentVersion.inc.php in mysite/claroline/inc.
5. Launch upgrade
6. Test claroline upgraded and if no problems remove claroline-old

Check the files permission

These following folders should be writable

1. mysite/mydir/claroline/admin/upgrade
2. mysite/mydir

chmod 777 mysite/mydir
chmod 777 mysite/mydir/claroline/admin/upgrade

Open web browser and go to

http://www.mydomain.org/mysite/mydir/claroline/admin/upgrade

If you are using Windows with easyPhp locally, open: http://localhost/mydir/claroline/admin/upgrade

Follow the instructions of the upgrade process in your browser

The Claroline Upgrade Tool will retrieve the data of your previous Claroline installation and set them to be compatible with the new Claroline version. This upgrade proceeds in three steps:

• It will get your previous platform main settings and put them in new configuration files
• It will set the main Claroline tables (user, course categories, course list, ...) to be compatible with the new data structure.
• It will update one by one each course data (directories, database tables, ...)

Note : According to the speed of your server or the amount of data stored on your platform,
the operations like upgrade main database and courses may take some time.

To avoid any error in the execution of the upgrade because of a timeout problem, you can increase the maximum execution time of your php scripts 
in the php.ini configuration file.

max_execution_time = 300     ; Maximum execution time of each script, in seconds

Login

Authentication with your login and password of administrator

Confirm backup of the data

Before proceeding to this upgrade. Make a backup of your current claroline directory before proceeding. Also, don't forget to make a backup of your claroline database. Use the tool mysqldump from MySQL.

How to backup mysql database ?

mysqldump -ulogin -p -Q --add-drop-table claroline-database > claroline-dump.sql

You can also make database backups via most administration tools such as MySQL Administrator (http://www.mysql.com/products/administrator), phpMyAdmin (http://www.phpmyadmin.net)

You won't be allowed to start the upgrade process before this point is marked as 'done'.

Step 1 of 3: platform main settings

The Claroline Upgrade Tool is going to proceed to the main setting upgrade.

These settings were stored in folder claroline/inc/conf in your previous platform version.

Click on the button to launch platform main settings upgrade.

You see the results of the main settings upgrade.

To continue the upgrade, click on the next button

Step 2 of 3 Main platform tables upgrade

Now, the Claroline Upgrade Tool is going to upgrade the data stored into the main Claroline tables (users, course categories, tools list, ...) and set it compatible with the new Claroline version.

Click on the button to launch main platform tables upgrade

You see the results of the main tables upgrade.

To continue the upgrade, click on the next button.

Step 3 of 3: courses upgrade

Now the Claroline Upgrade Tool is going to update course data (directories and database tables) one by one.

Click on the button to launch course data upgrade.

The Claroline Upgrade Tool proceeds to the courses data upgrade

You can see the number of courses upgraded.

After that click on next to finish the upgrade.

Upgrade process achieved

The Upgrade process is achieved. Go to your Claroline 1.7.x.

If you see a wrong display, it's a problem with the css in the cache of your browser. (Force reload of the page : press keys ctrl+r)

FAQ

Upgrade main settings of claroline : Upgrade file xxx Failed

Check the write permission in root folder.

Upgrade of main database, we have this error message "Db version unknown : "

Which version of claroline did you use ?

Claroline 1.7 :

Create a file platform/currentVersion.inc.php with this content :

<?php
$clarolineVersion = "1.8";
$versionDb = "1.7";
?>

Upgrade of courses : Course version unknown :

Check the version of course in 'cours' table

select versionClaro, count(*)
from cl_cours
group by versionClaro;

Execute this query to see the number of courses by version on your platform.

If you upgrade from 1.5 :

update cl_cours
set versionClaro = "1.5"
where versionClaro = "";

If you upgrade from 1.6 :

update cl_cours
set versionClaro = "1.6"
where versionClaro = "";

Upgrade of courses : Course version unknown : NEVER_SET

If you upgrade from 1.5 :

update cl_cours
set versionClaro = "1.5"
where versionClaro = "NEVER_SET";

I did upgrade from 1.5 on a multi database version.  For this error, I had to do:
mysql -u username -p 
connect claroline;
update cours set verionClaro = "1.5" where versionClaro = "NEVER SET"

If you upgrade from 1.6 :

update cl_cours
set versionClaro = "1.6"
where versionClaro = "NEVER_SET";

External Authentication in 1.8 (LDAP, ...)

If you use an external authentication system with claroline, you need to update manually the file :

platform/conf/auth.drivers.conf.php

Others problems

Post a message on http://www.claroline.net/forum

Upgrade from 1.4.* to 1.5

In order to upgrade from Claroline 1.4.* to 1.5.*, you must first update your current installation to 1.4. Download Claroline 1.5.* from the claroline.net downloads page (http://www.claroline.net/download.htm) and follow the upgrade instructions :

• Claroline Upgrade 15

Upgrade from 1.5.* to 1.6

In order to upgrade from Claroline 1.5.* to 1.6.*, you must first update your current installation to 1.5. Download Claroline 1.6.* from the claroline.net downloads page (http://www.claroline.net/download.htm) and follow the upgrade instructions :

• Claroline Upgrade 16

Upgrade from 1.5.*, 1.6.* to 1.7

In order to upgrade from Claroline 1.5.*, 1.6.* to 1.7, you must first update your current installation to 1.5. Download Claroline 1.7.* from the claroline.net downloads page (http://www.claroline.net/download.htm) and follow the upgrade instructions :

• Claroline Upgrade 17