Browse Source

Update upgrade section.

jmontoyaa 8 years ago
parent
commit
57cfd39683
1 changed files with 27 additions and 54 deletions
  1. 27 54
      documentation/installation_guide.html

+ 27 - 54
documentation/installation_guide.html

@@ -7,8 +7,7 @@
     <link rel="shortcut icon" href="../favicon.ico" type="image/x-icon" />
     <link href="js/prettify.css" type="text/css" rel="stylesheet" />
     <script src="js/prettify.js" type="text/javascript"></script>
-
-    </head>
+</head>
 <body>
 <nav class="navbar navbar-default navbar-fixed-top">
     <div class="container">
@@ -21,7 +20,6 @@
             </button>
             <a class="navbar-brand" href="#">Chamilo - Documentation</a>
         </div>
-
         <div class="collapse navbar-collapse">
             <ul class="nav navbar-nav">
                 <li class="active"><a href="index.html">Home</a></li>
@@ -47,14 +45,11 @@
 <p>French: Vous pouvez aussi lire <a href="installation_guide_fr_FR.html">ce guide d'installation en français</a>.</p>
 <p>Italian: You can also read <a href="installation_guide_it_IT.html">this guide in Italian</a>.</p>
 
-
 <h2><b>Contents</b></h2>
-
 <ol>
-
   <li><a href="#1._Pre-requisites">Pre-requisites</a></li>
   <li><a href="#2._Installation_of_Chamilo_LMS">Installation of Chamilo LMS</a></li>
-  <li><a href="#3._Upgrade_from_a_previous_version_of">Upgrade from a previous version of Chamilo/Dok€os</a></li>
+  <li><a href="#3._Upgrade">Upgrade</a></li>
   <li><a href="#4._Troubleshooting">Troubleshooting</a></li>
   <li><a href="#5._Administration_section">Administration section</a></li>
   <li><a href="#6._LDAP">LDAP&nbsp;</a></li>
@@ -87,41 +82,29 @@ Chamilo is mainly a LMS running (the so called <span style="font-weight: bold;">
 <li><span style="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 <span style="font-weight: bold;">LMS</span> on your server, you need to install WAMP, LAMP or MAMP:
 <ul>
-
   <li>To install <span style="font-weight: bold;">WAMP</span> (AMP on Windows), we recommend the <a href="http://www.apachefriends.org/en/xampp.html">XAMPP</a> .exe installer<a href="http://www.apachefriends.org/en/xampp.html"></a></li>
-
   <li>To install <span style="font-weight: bold;">LAMP</span>
 (AMP on Linux), use the Package manager of your favourite distribution (Synaptic, RPMFinder etc.).
 For instance, on a Ubuntu server,&nbsp;use Shell or Synaptic following the
-    <a href="http://ubuntuguide.org/wiki/Ubuntu:Feisty#Apache_HTTP_Server">Ubuntuguide on Apache</a> and the following sections</li>
-
+    <a href="http://ubuntuguide.org/wiki/Ubuntu:Feisty#Apache_HTTP_Server">Ubuntuguide on Apache</a> and the following sections
+  </li>
   <li>To install <span style="font-weight: bold;">MAMP</span> (AMP on Mac OS X), refer to the <a href="http://www.mamp.info/en/index.php">MAMP</a> dedicated website<a href="http://www.mamp.info/en/index.php"></a></li>
   <li>Make sure you check the <a href="dependencies.html" title="Dependencies">Dependencies page</a> if you need to know the requirements in more precise way.
 </ul>
-
-
 <br />
 
-
 <h3><span style="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 />
 <span class="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 />
-
 <hr style="width: 100%; height: 2px;" />
 <h2><a name="2._Installation_of_Chamilo_LMS"></a><span style="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 />
@@ -265,58 +248,49 @@ date.timezone = 'America/New_York'
 
 
 <hr />
-<h2><a name="3._Upgrade_from_a_previous_version_of"></a>3. Upgrade from a
-previous version of Chamilo LMS (1.*) or Dok€os (&lt;2.0)</h2>
+<h2><a name="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 />
+
 <div class="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 />
 <div class="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 <a href="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 <span class="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 <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
+  <li> download the Chamilo 1.11 install package from the <a href="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 <span class="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 <a href="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 />
     <a href="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
     <hr style="width: 100%; height: 2px;" />
     <h2><a name="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 />
     Here are a few tips that might help you:<br />
     <ul>
     <li>Get into your Chamilo Git repository</li>