Add fontawesome add directory recommendations sections

pull/2487/head
jmontoyaa 9 years ago
parent b093287dc6
commit a0d1b29a05
  1. 96
      documentation/installation_guide.html

@ -3,6 +3,7 @@
<meta charset="utf-8" />
<title>Chamilo Installation Guide</title>
<link rel="stylesheet" href="../web/assets/bootstrap/dist/css/bootstrap.css" type="text/css" media="screen,projection" />
<link rel="stylesheet" href="../web/assets/fontawesome/css/font-awesome.min.css" type="text/css" media="screen,projection" />
<link rel="stylesheet" href="default.css" type="text/css" media="screen,projection" />
<link rel="shortcut icon" href="../favicon.ico" type="image/x-icon" />
</head>
@ -121,25 +122,42 @@ This guide only covers these 2 last methods. For other methods, you can always a
<li><a href="https://chamilo.org/chamilo-lms/">Download Chamilo LMS</a></li>
<li>Unzip it</li>
<li>Copy the Chamilo directory in your web server's root directory. This can be
<span style="font-weight: bold;">C:\xampp\htdocs\</span> on a Windows server or <span style="font-weight: bold;">/var/www/html/</span> (or /var/www/chamilo/) on a Linux server</li>
<span style="font-weight: bold;">C:\xampp\htdocs\</span> on a Windows server or <span style="font-weight: bold;">/var/www/html/chamilo</span> (or /var/www/chamilo/) on a Linux server (You need to create the folder "chamilo")</li>
<li>Verify your web server supports .htaccess files (see Rewrite section below)</li>
<li>Open your web browser (Internet Explorer, Firefox...) and type
<span style="font-weight: bold;">http://localhost/chamilo/</span> if you install locally or
<span style="font-weight: bold;">http://www.domain.com/chamilo/</span> if you install remotely*
<li>Open your web browser and type
<span style="font-weight: bold;">http://localhost/chamilo/</span> if you install locally for test purposes or
<span style="font-weight: bold;">http://www.your-chamilo-domain.com</span> if you install remotely*
</li>
<li>Follow the web installation process. You can accept all default values. Consider changing the admin password to remember it.&nbsp;</li>
</ol>
<span class="text-muted">* We recommend defining a specific Virtual Host for this installation if you have the skills to do so</span>
<br /><br />
<h3>Recommendations</h3>
<ul>
<li>We recommend defining a specific Virtual Host for this installation.</li>
<li>If you have to install multiple Chamilo instances, avoid the installation of Chamilo in a inside a folder, instead prefer the use of different domains or using subdomains examples:
<ol>
<li>http://www.my-domain.com/ (<i class="fa fa-check" aria-hidden="true"></i> recommended)</li>
<li>http://chamilo.my-domain.com (<i class="fa fa-check" aria-hidden="true"></i> recommended)</li>
<li>http://chamilo2.my-domain.com (<i class="fa fa-check" aria-hidden="true"></i> recommended)</li>
<li>http://www.my-domain.com/chamilo (<i class="fa fa-times" aria-hidden="true"></i> not recommended)</li>
<li>http://www.my-domain.com/chamilo2 (<i class="fa fa-times" aria-hidden="true"></i> not recommended)</li>
<li>http://chamilo.my-domain.com/my-chamilo/ (<i class="fa fa-times" aria-hidden="true"></i> not recommended)</li>
</ol>
</li>
</ul>
<br />
<span class="text-muted">
Note: if installing Chamilo locally using localhost or the IP address of your computer during the installation, you might get issues
while accessing from another computer. To avoid this, you can
<a href="https://beeznest.com/blog/2013/01/15/answering-to-different-addresses-with-chamilo/">apply a little change to your configuration file</a>.
</span>
<br /><br />
The following directories need to be <b>readable, writeable and executable</b> by your web server.
<span class="text-muted">This usually requires no specific action on Windows servers, but will require a "chmod" under Linux and Mac. See instructions below.</span><br /><br />
<h3>Permissions</h3>
<p>The following directories need to be <b>readable, writeable and executable</b> by your web server.
This usually requires no specific action on Windows servers, but will require a "chmod" under Linux and Mac. See instructions below.</p>
Replace [chamilo] with the directory where your Chamilo installation is located):
<ul>
<li>[chamilo]/app/</li>
@ -152,12 +170,11 @@ enable sub-languages definition:
<ul>
<li>[chamilo]/main/lang/</li>
</ul>
<br />
<span class="text-muted">If you find a tests/ directory at the root of your package, please delete it.
<p>
If you find a tests/ directory at the root of your package, please delete it.
This is a development directory that has not been checked for security issues,
an it should *never* be accessible to final users on a production server.</span>
<br /><br />
an it should *never* be accessible to final users on a production server.
</p>
<p><span class="text-muted">On Linux, Mac OS X and BSD operating systems you can use the <em>chmod 0775</em> command for this (although we recommend you seek advice from an
experienced system administrator to avoid security issues). On Windows, you may need to check the properties of the folders (by right-clicking on them).</span></p>
@ -198,25 +215,24 @@ To get the best out of Chamilo, you need to finetune your PHP settings. Consider
<li>search the word "_max" and increase the following values to optimise the server</li>
</ul>
<div class="code">
max_execution_time = 300 ;Maximum execution time of each script, in seconds<br />
max_input_time = 600 ;Maximum amount of time each script may spend parsing request data<br />
memory_limit = 256M ;Maximum amount of memory a script may consume (128MB)<br />
post_max_size = 100M<br />
upload_max_filesize = 100M;<br />
short_open_tag = Off<br />
safe_mode = Off<br />
magic_quotes_gpc = Off<br />
magic_quotes_runtime = Off<br />
</div>
<br />
<pre>
max_execution_time = 300; Maximum execution time of each script, in seconds
max_input_time = 600; Maximum amount of time each script may spend parsing request data
memory_limit = 256M; Maximum amount of memory a script may consume (128MB)
post_max_size = 100M
upload_max_filesize = 100M;
short_open_tag = Off
safe_mode = Off
magic_quotes_gpc = Off
magic_quotes_runtime = Off</pre>
<p><strong>Important:</strong> You need to set
your <em>date.timezone</em> setting to whatever your server's timezone is. For example, if your server is in the 'America/New_York' timezone,
set the date.timezone parameter to this value in your php.ini:</p>
<div class="code">
<pre>
date.timezone = 'America/New_York'
</div>
</pre>
<br />
<p><strong>Note:</strong> <span class="text-muted">PHP 5.3.9 introduces a new setting "max_input_vars", which limits the number of elements you can send in one single form. If you are dealing with numerous users or very long learning paths (many items), make sure you set this setting higher than its default value of 1000.</span></p>
@ -381,14 +397,10 @@ In Windows, you may need to check the properties of the folders.
<h2><a name="4._Troubleshooting"></a>4. Troubleshooting</h2>
<p>If you have&nbsp;problems, go to the <a href="https://chamilo.org">Chamilo website</a> and ask a question on the
<p>If you have problems, go to the <a href="https://chamilo.org">Chamilo website</a> and ask a question on the
<a href="https://chamilo.org/forum">support forum</a>. Please read the previous messages first to see if there is
already an answer to your question.</p>
<h2></h2>
<hr style="width: 100%; height: 2px;" />
<h2><a name="5._Administration_section"></a>5. Administration section</h2>
@ -417,16 +429,16 @@ Newer distributions also allow downloading rpms for additional packages.</p>
<p class="text-muted">Note: Please check
the LDAP configuration settings inside Chamilo to learn the details.</p>
<p>
In [Chamilo folder]/app/config/configuration.php, around line 93, you'll find settings like the following: <br />
// -> Uncomment the two lines below to activate LDAP AND edit main/inc/conf/auth.conf.php for configuration<br />
// $extAuthSource["extldap"]["login"] = $_configuration['root_sys'].$_configuration['code_append']."auth/external_login/login.ldap.php";<br />
// $extAuthSource["extldap"]["newUser"] = $_configuration['root_sys'].$_configuration['code_append']."auth/external_login/newUser.ldap.php";<br />
<br />
In [Chamilo folder]/app/config/configuration.php, around line 93, you'll find settings like the following: <br />
<pre>
// -> Uncomment the two lines below to activate LDAP AND edit main/inc/conf/auth.conf.php for configuration
// $extAuthSource["extldap"]["login"] = $_configuration['root_sys'].$_configuration['code_append']."auth/external_login/login.ldap.php";
// $extAuthSource["extldap"]["newUser"] = $_configuration['root_sys'].$_configuration['code_append']."auth/external_login/newUser.ldap.php";
</pre>
remove the // from the last two lines to activate LDAP.<br />
</p>
<h3><b>Settings</b></h3>
@ -767,8 +779,7 @@ If you have issues with files taking a long time to download, make sure you reco
You cannot, however, only allow .htaccess files in the main httpd.conf file, as OS X will override it with the
domain-specific configuration file.
</p>
<hr style="width: 100%; height: 2px;" />
<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.11.x using Git directly.<br />
@ -792,7 +803,6 @@ If you have issues with files taking a long time to download, make sure you reco
<br />
</p>
<hr />
</div>
<hr />

Loading…
Cancel
Save