Claroline Upgrade 16

From ClarolineDoc

Table of contents

Download the most stable version of Claroline

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)

Uncompress the archive

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

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

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

Don't delete the previous directory before installing the new one. You will loose your previous configuration files (from 'claroline/inc/conf'). 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.

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


Confirm backup of the data

Confirm backup
Enlarge
Confirm backup

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.

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

Launch platform main settings upgrade
Enlarge
Launch platform main settings upgrade

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.


Upgrade main settings failed
Enlarge
Upgrade main settings failed
Upgrade main settings succeed
Enlarge
Upgrade main settings succeed

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

Launch main platform tables upgrade
Enlarge
Launch 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


Upgrade main platform tables succeed
Enlarge
Upgrade main platform tables succeed

You see the results of the main tables upgrade.

To continue the upgrade, click on the next button.


Step 3 of 3: courses upgrade

Launch course data upgrade
Enlarge
Launch course data 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.


Results
Enlarge
Results

The Claroline Upgrade Tool proceeds to the courses data upgrade

You can see the number of courses upgraded.


Results
Enlarge
Results

After that click on next to finish the upgrade.


Upgrade process achieved

Upgrade process achieved
Enlarge
Upgrade process achieved

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