@ -87,41 +82,29 @@ Chamilo is mainly a LMS running (the so called <span style="font-weight: bold;">
<li><spanstyle="font-weight: bold;">PHP 5.4+ (5.6 recommended for greater efficiency) (support for PHP7 seems OK but not evaluated on high load setups just yet)</span></li>
</ul>
<br/>
All these pieces of software are free software and freely available. <br/>
<br/>
All these pieces of software are free software and freely available. <br/><br/>
To run Chamilo <spanstyle="font-weight: bold;">LMS</span> on your server, you need to install WAMP, LAMP or MAMP:
<ul>
<li>To install <spanstyle="font-weight: bold;">WAMP</span> (AMP on Windows), we recommend the <ahref="http://www.apachefriends.org/en/xampp.html">XAMPP</a> .exe installer<ahref="http://www.apachefriends.org/en/xampp.html"></a></li>
(AMP on Linux), use the Package manager of your favourite distribution (Synaptic, RPMFinder etc.).
For instance, on a Ubuntu server, use Shell or Synaptic following the
<ahref="http://ubuntuguide.org/wiki/Ubuntu:Feisty#Apache_HTTP_Server">Ubuntuguide on Apache</a> and the following sections</li>
<ahref="http://ubuntuguide.org/wiki/Ubuntu:Feisty#Apache_HTTP_Server">Ubuntuguide on Apache</a> and the following sections
</li>
<li>To install <spanstyle="font-weight: bold;">MAMP</span> (AMP on Mac OS X), refer to the <ahref="http://www.mamp.info/en/index.php">MAMP</a> dedicated website<ahref="http://www.mamp.info/en/index.php"></a></li>
<li>Make sure you check the <ahref="dependencies.html"title="Dependencies">Dependencies page</a> if you need to know the requirements in more precise way.
</ul>
<br/>
<h3><spanstyle="font-weight: bold;">MySQL or MariaDB database server</span></h3>
You will need a login and password allowing you to manage and create a database. Usually, the default configuration on local computers is
to allow you to connect as root with an empty password. It is <b>HIGHLY RECOMMENDED</b> to change the password and define a user with access to
only a specific database. Please refer to the MySQL or MariaDB documentation in order to do this.<br/>
<br/>
<spanclass="text-muted">Chamilo versions prior to 1.9.0 required to choose between multiple databases and a deprecated single-database mode.
This has been cleaned up and simplified to one single database.</span><br/>
<hrstyle="width: 100%; height: 2px;"/>
<h2><aname="2._Installation_of_Chamilo_LMS"></a><spanstyle="font-weight: bold;">2. Installation of Chamilo LMS</span></h2>
<p>
Before you start installing Chamilo LMS, you must understand that, because we provide Chamilo as free software, many services providers
have been able to develop extensions of Chamilo, which have made it possible to install Chamilo in many ways:<br/>
<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>
<h2><aname="3._Upgrade"></a>3. Upgrade</h2>
Before upgrading, we <b>heavily</b> recommend you do a full backup of the previous
Chamilo directories and databases. If you are unsure how to achieve this
please ask your hosting provider for advice <b>before</b> you continue further.<br/><br/>
<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 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 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/><br/>
<divclass="text-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 much faster. If this is the kind of thing you
need, we highly recommend you contact them (see reference below).</div>
<br/>
<br/>
<divclass="text-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
from earlier versions of Chamilo 1.9.*. 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>
<h3>3.1 Upgrading from Chamilo 1.10.x (minor upgrade)</h3>
As this is only a minor version change from previous 1.10.* versions of Chamilo, the only thing you need to do is:
<h3>3.1 Upgrading from Chamilo 1.11.x (Minor version)</h3>
As this is only a minor version change from previous 1.11.* versions of Chamilo, the only thing you need to do is:
<ul>
<li> check that you haven't left any customised stylesheet or image <spanclass="text-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
<li> download the Chamilo 1.11 install package from the <ahref="http://www.chamilo.org/download">Chamilo download page</a></li>
<li> unzip the new files of Chamilo 1.11 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> clean your app/cache/twig directory: 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> you're done! No other upgrade procedure is required</li>
</ul>
<h3>3.2 Upgrading from Chamilo 1.10.x</h3>
<ul>
<li> check that you haven't left any customised stylesheet or image <spanclass="text-muted">(if you have, make sure you keep a copy on the side*)</span></li>
<li> download the Chamilo 1.11 install package from the <ahref="http://www.chamilo.org/download">Chamilo download page</a></li>
<li> unzip the new files of Chamilo 1.11 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). Note that you should remove the "home" and
"searchdb" directories from the package before you overwrite the previous
files.</li>
<li> edit the app/config/configuration.php file: at the en of the file, locate the previous version number (e.g. '1.10.4') and change it to this new version (e.g. '1.10.8')</li>
<li> clean your app/cache/twig directory: 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> you're done! No other upgrade procedure is required</li>
<li>Go to your portal install page (main/install/) and follow the upgrade procedure</li>
</ul>
Please note that if you (unluckily) upgraded from any of the 1.9 versions to 1.10.0 against our recommendations, we
provide a patch script that should get most of it in order. The script is available here:<br/>
<ahref="https://raw.githubusercontent.com/chamilo/chamilo-lms/1.10.x/tests/scripts/fix_migrations_1.9.x_1.10.0.php">https://raw.githubusercontent.com/chamilo/chamilo-lms/1.10.x/tests/scripts/fix_migrations_1.9.x_1.10.0.php</a> or, if
@ -326,7 +300,6 @@ Please note that if you (unluckily) upgraded from any of the 1.9 versions to 1.1
This script is provided without warranty. Please *always* take a backup before you use it.
<br/>
<h3>3.2 Upgrading from Chamilo 1.9.x</h3>
<ul>
<li> make sure you don't have tables from previous versions of Chamilo still hanging around. These can cause the upgrade to fail. In particular, tables from versions 1.8.* could have multiple tables for each course, resulting in many tables with the same prefix. Only tables without prefix or with a "c_" prefix exist in 1.9 and superior versions. Make sure none of these tables persist. Take a backup of your database (just in case) and delete these prefixed tables (drop table ...).</li>
@ -781,7 +754,7 @@ If you have issues with files taking a long time to download, make sure you reco
<hrstyle="width: 100%; height: 2px;"/>
<h2><aname="17._Git_Upgrade"></a>Upgrading from Git</h2>
<p>If you have sufficient experience with Git and have installed your initial Chamilo portal
from the Git version, you might want to upgrade from 1.9.x to 1.10.x using Git directly.<br/>
from the Git version, you might want to upgrade from 1.9.x to 1.11.x using Git directly.<br/>