Claroline Upgrade 17
From ClarolineDoc
Download the most stable version of Claroline
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)
Uncompress the archive
Linux : Open a shell, go to download directory and type tar -xzvf claroline170.tar.gz
Windows : Use the archiving utility of your choice and unzip 'claroline170.zip'
Replace your previous Claroline directory and index.php by the new one
There are two solutions :
1.
- 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.
- Launch upgrade
or
2.
- Rename mysite/claroline folder in mysite/claroline-old.
- Copy files from archive to the folder mysite/ of your platform.
- Copy mysite/claroline-old/inc/conf in mysite/claroline/inc/conf.
- Copy mysite/claroline-old/inc/currentVersion.inc.php in mysite/claroline/inc.
- Launch upgrade
- Test claroline upgraded and if no problems remove claroline-old
Check the files permission
These following folders should be writable
- mysite/claroline/admin/upgrade
- mysite/claroline/inc
- mysite/claroline/inc/conf
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
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 claroline/inc/conf folder.
Upgrade of main database, we have this error message "Db version unknown : 1.6.0"
It's a display problem in upgrade tool. The upgrade succeeded : you must reload the page.
Upgrade of main database, we have this error message "Db version unknown : "
Which version of claroline did you use ?
Claroline 1.5 :
Create a file claroline/inc/currentVersion.inc.php with this content :
<?php $clarolineVersion = "1.5"; $versionDb = "1.5"; ?>
Claroline 1.6 :
Create a file claroline/inc/currentVersion.inc.php with this content :
[Download the file here (http://www.claroline.net/dlarea/1.6/currentVersion.1.6.zip)]
<?php $clarolineVersion = "1.6"; $versionDb = "1.6"; ?>
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";
Others problems
Post a message on http://www.claroline.net/forum
