|
@@ -332,30 +332,35 @@ date.timezone = 'America/New_York'
|
|
|
<h2><a name="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 />
|
|
|
<div class="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>
|
|
|
-<div class="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 <a href="https://chamilo.org/providers">official providers</a>)</div>
|
|
|
+<div class="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 <a href="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 <span class="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 <a href="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 <span style="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 <span class="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 <a href="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 <span style="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 <span style="font-style: italic;">Install</span>, then choose <span style="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 <a href="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 />
|
|
|
|
|
|
<span class="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
|
|
|
- <a href="http://www.chamilo.org/download">Chamilo download page</a></li>
|
|
|
- <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 <span style="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 />
|
|
|
-
|
|
|
-<p class="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>
|
|
|
|
|
|
|
|
|
<p class="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>
|
|
|
+ <li>[chamilo]/app</li>
|
|
|
<li>[chamilo]/main/default_course_document/images/</li>
|
|
|
</ul>
|
|
|
On Linux, Mac OS X and BSD operating systems you can quick-fix this using the
|
|
|
<em>chmod 0777</em> command, but if you are unsure, we recommend you seek advice for
|
|
|
-your own OS on <a href="http://www.chamilo.org/forum">our forum</a>.
|
|
|
+your own OS on <a href="https://chamilo.org/forum">our forum</a>.
|
|
|
In Windows, you may need to check the properties of the folders.
|
|
|
<p></p>
|
|
|
<h3>3.6 Quick-upgrade from 1.9.x guide for Linux</h3>
|
|
@@ -518,11 +463,12 @@ On the command-line, type:
|
|
|
<li>mkdir /var/www/chamilo/old_version</li>
|
|
|
<li>mv /var/www/chamilo/* /var/www/chamilo/old_version/</li>
|
|
|
<li>chmod -R 0777 /var/www/chamilo/old_version/</li>
|
|
|
- <li>wget https://github.com/chamilo/chamilo-lms/archive/v1.9.10.tar.gz</li>
|
|
|
- <li>tar zxvf chamilo-lms-1.9.10.tar.gz</li>
|
|
|
- <li>sudo cp -ra chamilo-lms-1.9.10/* /var/www/chamilo/</li>
|
|
|
- <li>rm chamilo-lms-1.9.10.tar.gz</li>
|
|
|
- <li>sudo rm -r chamilo-lms-1.9.10/</li>
|
|
|
+ <li>wget https://github.com/chamilo/chamilo-lms/archive/v1.10.0.tar.gz</li>
|
|
|
+ <li>tar zxvf chamilo-lms-1.10.0.tar.gz</li>
|
|
|
+ <li>sudo cp -ra chamilo-lms-1.10.0/* /var/www/chamilo/</li>
|
|
|
+ <li>sudo cp -ra chamilo-lms-1.10.0/.* /var/www/chamilo/</li>
|
|
|
+ <li>rm chamilo-lms-1.10.0.tar.gz</li>
|
|
|
+ <li>sudo rm -r chamilo-lms-1.10.0/</li>
|
|
|
</ul>
|
|
|
|
|
|
<br />
|