Claroline Upgrade 15

From ClarolineDoc

The upgrade works only from Claroline 1.4.x. Older Claroline versions should upgrade first to Claroline 1.4.2 before upgrade to Claroline 1.5.

Before upgrading we heavily recommend you to do a full backup of the previous Claroline directories and databases. If you are unsure how to achieve this please ask your hosting provider for advice.

Note : people having already installed claroline 1.5.0 or 1.5.1. on their server just have to copy the new claroline archive on the old one to upgrade their system.

Table of contents

Download the most stable version of Claroline

Linux : 'claroline151.tar.gz'

Windows : 'claroline151.zip'. (archive are the same, they are just compressed differently)

Uncompress the archive

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

Windows : Use the archiving utility of your choice (i.e. www.7-zip.org) and unzip 'claroline151.zip'

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

 WARNING ! Don't delete the previous directory before installing the new 
one. You will loose your previous configuration files 
(eg 'config.inc.php'). 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/maintenance/upgrade.php

If you are using Windows with easyPhp locally, open:

http://localhost/mydir/claroline/admin/maintenance/upgrade.php

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.

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 of the data
Enlarge
Confirm backup of the data

Before proceeding to this upgrade:

  • Make a whole backup of all you platform data (files and databases)

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 into claroline/include/config.inc.php in your previous platform version.

Click on the button to launch platform main settings upgrade.


Results
Enlarge
Results

You see the results of the main settings upgrade.

To continue the upgrade, click on 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 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


Results
Enlarge
Results

You see the results of the main settings upgrade.

To continue the upgrade, click on next button.


Step 3 of 3: courses upgrade

Launch course data upgrade
Enlarge
Launch course data upgrade

Now the Claroline Upgrade Tool is going 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.

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.5.x.