<h2><aname="3._Upgrade_from_a_previous_version_of"></a>3. Upgrade from a
previous version of Chamilo LMS (1.*) or Dok€os (<2.0)</h2>
Before upgrading, we <b>heavily</b> recommend you do a full backup of the previous
Chamilo or Dok€os directories and databases. If you are unsure how to achieve this
Chamilo directories and databases. If you are unsure how to achieve this
please ask your hosting provider for advice.<br/>
<em>Chamilo LMS 1.10 comes with a new database structure in comparison to 1.9, and so between 1.9 and 1.8.
<em>Chamilo LMS 1.10 comes with a new database structure in comparison to 1.9,
as was the case between 1.9 and 1.8.
Although the upgrade script takes the migration in charge, it might be generating
a very heavy load on your server during the upgrade, and will change your
database completely, preserving the data as well as possible (we have tested
database considerably, preserving the data as well as possible (we have tested
the procedure many times, but remember this is GNU/GPLv3 and we cannot be held
responsible for what would happen to your data without professional supervision).
This is why we *really* recommend you take a full backup of your system before
you upgrade.</em>
<br/>
<br/>
Also note that Chamilo LMS 1.10 removes some deprecated language files from the
main/lang/ directory. If you have changed language files directly (instead of
using the recommended way of sublanguages), you should take a backup copy of
Also note that Chamilo LMS 1.10 unites all language files from the
main/lang/ directory into one single file by language.
If you have changed language files directly (instead of
using the recommended way: sub-languages), you should take a backup copy of
these changed translations before you upgrade. Sublanguages might also require
som manual work, but the upgrade procedure will not touch sublanguages directly.
<br/>
<divclass="muted"> NOTE: For very heavy Chamilo databases, some of our official
providers have developed improved migration procedures that use more memory but
process the upgrades up to 20 times faster. If this is the kind of thing you
process the upgrades much faster. If this is the kind of thing you
need, we highly recommend you contact them (see reference below).</div>
<divclass="muted"> NOTE: This version of Chamilo can only be used to upgrade from earlier versions of Chamilo or Dok€os. For example, you cannot use the normal
upgrade scripts from Chamilo 1.9 to upgrade from Dok€os 2.0 (which was born after the split with Chamilo). If you need this, please contact one of the Chamilo Association's <ahref="https://chamilo.org/providers">official providers</a>)</div>
<divclass="muted"> NOTE: This version of Chamilo can only be used to upgrade
from earlier versions of Chamilo 1.9.*. For example, you cannot use the normal
upgrade scripts from Chamilo 1.10 to upgrade from Chamilo 1.8.* or even Dok€os 2.0
(which was born after the split with Chamilo). If you need this, please contact one
of the Chamilo Association's <ahref="https://chamilo.org/providers">official providers</a>)</div>
<p></p>
@ -377,36 +382,20 @@ As this is only a minor version change from previous 1.10.* versions of Chamilo,
<br/>
<h3>3.2 Upgrading from Chamilo 1.8.x or 1.9.x</h3>
<ul>
<li> check that you haven't left any customised stylesheet or image <spanclass="muted">(if you have, make sure you keep a copy on the side*)</span></li>
<li> download the Chamilo 1.10 install package from the <ahref="http://www.chamilo.org/download">Chamilo download page</a></li>
<li> unzip the new files of Chamilo 1.10 over the files of the older version (or unzip the files in one folder and then copy the files from there to the older version's directory)</li>
<li> point your browser on your portal URL + main/install/</li>
<li> choose your language and click <spanstyle="font-style: italic;">Upgrade from 1.8.x/1.9.x</span></li>
<li> clean your archive/ directory: take a temporary copy of index.html, delete all the contents *in* this directory (do NOT remove the directory itself, only its contents!). It will all be re-generated. You can also delete the contents of this directory through the "Archive directory cleanup" option in the "System" box of the Administration page.</li>
<li> make sure "AllowOverride All" is present in your Apache configuration, as interpreting the .htaccess files is very important for Chamilo to work</li>
</ul>
<br/>
<h3>3.3 Upgrading from Dok€os 1.8.x</h3>
<h3>3.2 Upgrading from Chamilo 1.8.x</h3>
To upgrade from version of Chamilo prior to 1.9.0, you will need to first upgrade them to 1.9.10.2, then upgrade again (separately) to 1.10.x
<em>If you upgrade from Dok€os 1.8.x</em> :
<h3>3.2 Upgrading from Chamilo 1.9.x</h3>
<ul>
<li> check that you haven't left any customised stylesheet or image <spanclass="muted">(if you have, make sure you keep a copy on the side*)</span></li>
<li> download the Chamilo 1.10 install package from the <ahref="http://www.chamilo.org/download">Chamilo download page</a></li>
<li> unzip the new files of Chamilo 1.10 over the files of the older version (or unzip the files in one folder and then copy the files from there to the older version's directory)</li>
<li> make *absolutely sure* that the .htaccess file of version 1.10 is copied as well</li>
<li> make sure "AllowOverride All" is present in your Apache configuration, as interpreting the .htaccess files is very important for Chamilo to work (note that Order-Allow directives have been replaced by "Require all granted" in Apache 2.4)</li>
<li> point your browser on your portal URL + main/install/</li>
<li> choose your language and click <spanstyle="font-style: italic;">Upgrade from 1.8.x/1.9.x</span></li>
<li> clean your archive/ directory: take a temporary copy of index.html, delete all the contents *in* this directory (do NOT remove the directory itself, only its contents!). It will all be re-generated. You can also delete the contents of this directory through the "Archive directory cleanup" option in the "System" box of the Administration page.</li>
<li> click <spanstyle="font-style: italic;">Install</span>, then choose <spanstyle="font-style: italic;">Upgrade from 1.9.*</span></li>
</ul>
A bunch of Chamilo administrators have reported minor issues with the migration between versions considerably apart (like from Dok€os to Chamilo).
This might include loosing some assignments or forum posts. To avoid any ugly effect on your users, we recommend you first establish a checklist
of all the content that is critical to you, and that you keep a working copy of your previous site on the side. This way, it will be easier to
manage the transition by letting your users get access to their contents from the previous site and making it easier for you to compare the two.
If you are experiencing difficulties, consider asking for help from a PHP developer or hiring an <ahref="http://www.chamilo.org/en/providers"target="_blank">official Chamilo provider</a>. They will make sure
you get the best our of your Chamilo migration.
<br/>
<spanclass="muted">* Styles and images are located in the main/css or main/img
@ -423,52 +412,11 @@ to the old ones which will be deprecated shortly (not maintained).</span>
<p></p>
<h3>3.4 Upgrading from Dok€os 1.6.x</h3>
<em>If you upgrade from a lower version of Dok€os (1.6.x)</em>, the first
and most important thing to do is to *move* your current directory to another
place.<br/>
An easy way to do that is to create a subdirectory called "old_version"
in your current Chamilo/Dok€os directory and move everything in there using a
simple "move" command (i.e. under Linux: mkdir old_version; mv *
old_verion/), then make the old_version/ directory writeable by the web
server so that courses/ and upload/ directories can be moved from the
old to the new installation.<br/>
<br/>
The complete process is as follow:
<ul>
<li> move the current Dok€os directory contents to a subdirectory called
<em>old_version</em> and make it writeable by the web server. This
is important to allow the move of the courses/ and upload/ directories
to the new install</li>
<li> download the Chamilo 1.10 install package from the
<li> unzip the new files of Chamilo 1.10 in the main Chamilo/Dok€os directory. The
new directory <em>main</em> should be located directly inside your
Chamilo/Dok€os root folder</li>
<li> point your browser on your portal URL</li>
<li> choose your language and click <spanstyle="font-style: italic;">Upgrade from 1.6.x</span> and confirm the
current directory of the old version</li>
<li> clean your archive/ directory: take a temporary copy of index.html, delete all the contents *in* this directory (do NOT remove the directory itself, only its contents!). It will all be re-generated. You can also delete the contents of this directory through the "Archive directory cleanup" option in the "System" box of the Administration page.</li>
</ul>
<br/>
<pclass="muted"> NOTE: The upgrade from 1.6.x to 1.8.x implies a revision of
the customised graphics and styles. The new version uses a complete new
set of icons and styles, which means the ones from version 1.6 cannot be
simply reused. The good news is the version 1.8.x allows you to create
your own style in a separate css folder, that you can then reuse through
all the 1.8.x versions
</p>
<p>
<b>WARNING:</b><br/>
Do not delete the previous Chamilo/Dok€os installation directory before installing
the new one. When the update is successfully finished, you can remove
the old path.</p>
Do not delete the previous Chamilo installation directory before installing
the new one. The upgrade process should take care of (=delete) all unrequired folders.</p>
<pclass="muted">
@ -482,19 +430,16 @@ choose "Configure the homepage" in the Chamilo administration section.</p>
The following directories need to be readable, writeable and executable for the web server:
<ul>
<li>[chamilo]/app/config/</li>
<li>[chamilo]/app/upload/users/</li>
<li>[chamilo]/app/upload/sessions/</li>
<li>[chamilo]/app/upload/courses/</li>
<li>[chamilo]/app/cache/</li>
<li>[chamilo]/app/courses/</li>
<li>[chamilo]/app/home/</li>
<li>[chamilo]/app/logs/</li>
<li>[chamilo]/main/lang/ (in order to delete unnecessary language files)</li>
<li>[chamilo]/courses/ (in order to move the courses files to the app/courses folder)</li>
<li>[chamilo]/archive/ (in order to remove unnecessary files or move them to app/cache/)</li>
<li>[chamilo]/home/ (in order to move files to app/home)</li>
Yannick Warnier
10 years ago