You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
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>
415
415
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>
416
416
417
417
<h4>6.4.1. MariaDB</h4>
418
418
<aid="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>
421
421
Once installed, open the database client and create a user through the interface or issuing the following query (adapted to your needs):<br>
422
422
<pre>mariadb> GRANT ALL PRIVILEGES ON chamilo.* TO chamilo@localhost IDENTIFIED BY 'some-password';</pre>
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>
429
429
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>
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 > Add roles and features > pass screens until "Server roles". Select "CGI" under "Web Server (IIS) > Web Server > 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: <ahref="https://aka.ms/vs/16/release/VC_redist.x64.exe">x64</a> or <ahref="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 > System > About > Advanced system settings > 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 > Add roles and features > pass screens until "Server roles". Select "CGI" under "Web Server (IIS) > Web Server > 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: <ahref="https://aka.ms/vs/16/release/VC_redist.x64.exe">x64</a> or <ahref="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 > System > About > Advanced system settings > 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>
440
440
Enable the following PHP extensions (look for ";extension=" and remove the ";" from the beginning of the line):<br>
441
441
<ul>
442
442
<li>curl</li>
@@ -455,19 +455,19 @@ <h4>6.4.3. IIS, CGI and PHP</h4>
455
455
<li>ldap</li>
456
456
<li>redis (optional)</li>
457
457
</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>
459
459
Set (or wait for the install wizard to tell you) the settings suggested by Chamilo's install wizard.<br>
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>
471
471
Follow the instructions to complete the installation.<br>
472
472
473
473
@@ -477,7 +477,7 @@ <h3>6.5. Redis</h3>
477
477
want to install the PHP Redis extension from the official PHP website, for example (adapt PHP and Redis version numbers)
0 commit comments