Skip to content

Commit a4045f3

Browse files
committed
Minor: Documentation spacing for better readability
1 parent 5b82dd1 commit a4045f3

File tree

1 file changed

+22
-22
lines changed

1 file changed

+22
-22
lines changed

public/documentation/installation_guide.html

Lines changed: 22 additions & 22 deletions
Original file line numberDiff line numberDiff line change
@@ -411,32 +411,32 @@ <h4>6.3.7. Installation wizard</h4>
411411

412412
<h3>6.4. Windows install with IIS</h3>
413413
<a id="windows-install-iis" class="anchor"></a>
414-
For performance reasons, you might want to install Chamilo on Windows using IIS as a web server.<br>
414+
For performance reasons, you might want to install Chamilo on Windows using IIS as a web server.<br><br>
415415
The procedure described below is experimental, so if you believe you can improve this, please open an issue on Github for us with the proposed changes.<br><br>
416416

417417
<h4>6.4.1. MariaDB</h4>
418418
<a id="windows-install-iis-db" class="anchor"></a>
419-
First install MariaDB from the official website (https://mariadb.org/download/) and follow the default installation options (Next, Next, Install).<br>
420-
Make sure you have a database Windows client at hand as we will have (preferrably) to define permissions for a Chamilo-specific user.<br>
419+
First install MariaDB from the official website (https://mariadb.org/download/) and follow the default installation options (Next, Next, Install).<br><br>
420+
Make sure you have a database Windows client at hand as we will have (preferrably) to define permissions for a Chamilo-specific user.<br><br>
421421
Once installed, open the database client and create a user through the interface or issuing the following query (adapted to your needs):<br>
422422
<pre>mariadb> GRANT ALL PRIVILEGES ON chamilo.* TO chamilo@localhost IDENTIFIED BY 'some-password';</pre>
423423
Exit the SQL client.<br><br>
424424

425425
<h4>6.4.2. IIS and URL Rewrite</h4>
426426
<a id="windows-install-iis-rewrite" class="anchor"></a>
427-
If you are working on a Windows server, you should have IIS installed already. If not, you can download it from the official website (https://www.iis.net/downloads).<br>
428-
With IIS, you will need the URL Rewrite module. You can download it from the official website (https://www.iis.net/downloads/microsoft/url-rewrite).<br>
427+
If you are working on a Windows server, you should have IIS installed already. If not, you can download it from the official website (https://www.iis.net/downloads).<br><br>
428+
With IIS, you will need the URL Rewrite module. You can download it from the official website (https://www.iis.net/downloads/microsoft/url-rewrite).<br><br>
429429
Once installed, you will need to restart IIS, close the network manager window if open, and possibly reboot the whole Windows machine for it to appear in the Site management (not the server management section).<br>
430430

431431
<h4>6.4.3. IIS, CGI and PHP</h4>
432432
<a id="windows-install-iis-php" class="anchor"></a>
433-
Once you have installed IIS and the URL Rewrite module, you will need to configure the CGI and PHP settings.<br>
434-
CGI is an IIS module to enable (it's already present but needs activating) in the server manager. Open the server manager, click Manage &gt; Add roles and features &gt; pass screens until "Server roles". Select "CGI" under "Web Server (IIS) &gt; Web Server &gt; Application Development, then confirm the installation.<br>
435-
Download PHP 8.3 for Windows from the official website (https://windows.php.net/download#php-8.3) (simple Zip version).<br>
436-
This might require (depending on your setup) to install the VC++ libraries in version 14, which come from VStudio v16 (between others). If you don't have them yet on the Windows Server, you can download them from here depending on your architecture: <a href="https://aka.ms/vs/16/release/VC_redist.x64.exe">x64</a> or <a href="https://aka.ms/vs/16/release/VC_redist.x86.exe">x86</a>.<br>
437-
Add PHP to the PATH environment variable (e.g. C:\php): Settings &gt; System &gt; About &gt; Advanced system settings &gt; Environment variables, then select "Path", click "Modify", click "New" and introduce "C:\PHP", then validate twice.<br>
438-
In the IIS manager window, when the server is selected and you click on the Mappings manager, click on the "Add module mapping..." in the right panel and make sure request path "*.php" is mapped to the FastCgiModule. If not, add it.<br>
439-
Find the C:\php\php.ini file (or any other place you might have given the PHP installer script to register to).<br>
433+
Once you have installed IIS and the URL Rewrite module, you will need to configure the CGI and PHP settings.<br><br>
434+
CGI is an IIS module to enable (it's already present but needs activating) in the server manager. Open the server manager, click Manage &gt; Add roles and features &gt; pass screens until "Server roles". Select "CGI" under "Web Server (IIS) &gt; Web Server &gt; Application Development, then confirm the installation.<br><br>
435+
Download PHP 8.3 for Windows from the official website (https://windows.php.net/download#php-8.3) (simple Zip version).<br><br>
436+
This might require (depending on your setup) to install the VC++ libraries in version 14, which come from VStudio v16 (between others). If you don't have them yet on the Windows Server, you can download them from here depending on your architecture: <a href="https://aka.ms/vs/16/release/VC_redist.x64.exe">x64</a> or <a href="https://aka.ms/vs/16/release/VC_redist.x86.exe">x86</a>.<br><br>
437+
Add PHP to the PATH environment variable (e.g. C:\php): Settings &gt; System &gt; About &gt; Advanced system settings &gt; Environment variables, then select "Path", click "Modify", click "New" and introduce "C:\PHP", then validate twice.<br><br>
438+
In the IIS manager window, when the server is selected and you click on the Mappings manager, click on the "Add module mapping..." in the right panel and make sure request path "*.php" is mapped to the FastCgiModule. If not, add it.<br><br>
439+
Find the C:\php\php.ini file (or any other place you might have given the PHP installer script to register to).<br><br>
440440
Enable the following PHP extensions (look for ";extension=" and remove the ";" from the beginning of the line):<br>
441441
<ul>
442442
<li>curl</li>
@@ -455,19 +455,19 @@ <h4>6.4.3. IIS, CGI and PHP</h4>
455455
<li>ldap</li>
456456
<li>redis (optional)</li>
457457
</ul>
458-
Make sure the <em>[opcache]</em> section has <em>opcache.enable=1</em> *and* <em>opcache.memory_consumption=256</em> or any higher value so that OpCache can be used. Otherwise it is present but not used. Save the file.<br>
458+
Make sure the <em>[opcache]</em> section has <em>opcache.enable=1</em> *and* <em>opcache.memory_consumption=256</em> or any higher value so that OpCache can be used. Otherwise it is present but not used. Save the file.<br><br>
459459
Set (or wait for the install wizard to tell you) the settings suggested by Chamilo's install wizard.<br>
460460

461461
<h4>6.4.4. Chamilo</h4>
462462
<a id="windows-install-iis-chamilo" class="anchor"></a>
463-
Once you have installed IIS, the URL Rewrite module and PHP, you can download Chamilo from the official downloads page (https://github.com/chamilo/chamilo-lms/releases).<br>
464-
Unzip the package in the "wwwroot" folder of your IIS installation (e.g. C:\inetpub\wwwroot).<br>
465-
Chamilo 2+ need you to configure the web server so the root path is the "public/" folder of Chamilo.<br>
466-
Create an empty ".env" file at the root of the chamilo folder (e.g. C:\inetpub\wwwroot\chamilo\.env).<br>
467-
Change permissions so the web server user is able to write to var/, config/ and .env during the installation. These permissions can be removed later on, to the exception of var/ which has to remain writable by the webserver. These permissions need to be set in a way that the owner of the IIS service (possibly "System" or "IIS_IUSRS") can read and write to those files and folders, otherwise the installation script (which needs to write some files) will not be able to proceed.<br>
468-
This is a specific change for IIS: edit the config\packages\monolog.yaml file and change all <em>path: php://stderr</em> for <em>path: "%kernel.logs_dir%/%kernel.environment%.log"</em> . This is due to an issue with file management for PHP on Windows with Symfony. Please note that until we find a portable solution, this will need to be modified again after each Chamilo update.<br>
469-
After this, load the URL in your browser, as you have defined it in the ISS site configuration.<br>
470-
The Chamilo installation wizard should appear.<br>
463+
Once you have installed IIS, the URL Rewrite module and PHP, you can download Chamilo from the official downloads page (https://github.com/chamilo/chamilo-lms/releases).<br><br>
464+
Unzip the package in the "wwwroot" folder of your IIS installation (e.g. C:\inetpub\wwwroot).<br><br>
465+
Chamilo 2+ need you to configure the web server so the root path is the "public/" folder of Chamilo.<br><br>
466+
Create an empty ".env" file at the root of the chamilo folder (e.g. C:\inetpub\wwwroot\chamilo\.env).<br><br>
467+
Change permissions so the web server user is able to write to var/, config/ and .env during the installation. These permissions can be removed later on, to the exception of var/ which has to remain writable by the webserver. These permissions need to be set in a way that the owner of the IIS service (possibly "System" or "IIS_IUSRS") can read and write to those files and folders, otherwise the installation script (which needs to write some files) will not be able to proceed.<br><br>
468+
This is a specific change for IIS: edit the config\packages\monolog.yaml file and change all <em>path: php://stderr</em> for <em>path: "%kernel.logs_dir%/%kernel.environment%.log"</em> . This is due to an issue with file management for PHP on Windows with Symfony. Please note that until we find a portable solution, this will need to be modified again after each Chamilo update.<br><br>
469+
After this, load the URL in your browser, as you have defined it in the ISS site configuration.<br><br>
470+
The Chamilo installation wizard should appear.<br><br>
471471
Follow the instructions to complete the installation.<br>
472472

473473

@@ -477,7 +477,7 @@ <h3>6.5. Redis</h3>
477477
want to install the PHP Redis extension from the official PHP website, for example (adapt PHP and Redis version numbers)
478478
https://downloads.php.net/~windows/pecl/releases/redis/6.*.*/php_redis-6.*.*-8.3-ts-vs16-x64.zip
479479

480-
This is not necessary to install Chamilo (so you can do it afterwards).
480+
This is not necessary to install Chamilo (so you can do it afterwards or never at all if you don't experience session issues).
481481

482482
Download, unzip and place the .dll file into C:\wamp64\bin\php\php8.3.*\ext\
483483
then add "extension=php_redis.dll" at the end of C:\wamp64\bin\php\php8.3.*\php.ini

0 commit comments

Comments
 (0)