Page de téléchargement : Index of /releases
Claroline Connect est un LMS (Learning management system) Open Source sous licence GPLv3 permettant de créer et d’administrer des formations et des espaces de collaboration en ligne. Il est écrit en PHP et développé par le Centre de Recherche et de Développement de l’ECAM et l’Université Catholique de Louvain. Sa version actuelle est la 12.4 suite à une nouvelle numérotation des versions, mais nous installerons ici une version antérieure, la 7.0.0 (ou 16.05 dans l’ancienne numérotation) car elle est la dernière version s’installant sans problèmes via l’archive. Toutefois elle nécessite PHP ≤ 7.1, c’est pourquoi nous resterons sur Debian 9 Stretch où PHP est installé en version 7.0, contrairement à Debian 10 Buster où PHP est installé par défaut en version 7.3. Il est évidemment possible d’installer plusieurs versions de PHP sur un système, ou d’installer un dépôt spécifique d’une version antiérieure, mais nous n’aborderons pas cette procédure ici.
Alternatives Open Source à Claroline Connect :
CE COURS EST DISPONIBLE EN VIDÉO
(VERSION DÉTAILLÉE ET PLUS COMPLÈTE)
Version Française
Comment installer un LMS Open Source – Part 1
Comment installer un LMS Open Source – Part 2
Version Anglaise
How to install an Open Source LMS – Part 1
How to install an Open Source LMS – Part 2
OBJECTIF
L’objectif de cet article est l’installation et la configuration d’un serveur LAMP7 (Linux Apache 2.4 MariaDB 10.1 PHP 7.0) auto-hébergé Claroline en version 16.05 sur une distribution Linux Debian Stretch 9.9 64bits (LAMP 1/4).
SCHEMA LOGIQUE
PRÉREQUIS
1. Prérequis avant réalisation
- Un serveur Debian Stretch 9.9 64 bits fonctionnel (installation basique avec utilitaires usuels du système et service SSH)
- Packages de base supplémentaires : sudo, dnsutils, git, resolvconf, terminator, tree
- Domaine utilisé : opensharing.priv
2. Configuration réseau initiale
| Serveur Claroline | |
| FQDN | mylms.opensharing.priv |
| Adresse IP | 192.168.1.10 |
| Réseau | 192.168.1.0/24 |
| Passerelle | 192.168.1.1 |
| dns-nameservers | 8.8.8.8 8.8.4.4 |
| dns-search | opensharing.priv |
Contenu initial du fichier /etc/network/interfaces :
sudo nano /etc/network/interfaces
auto lo iface lo inet loopback allow-hotplug enp0s3 iface enp0s3 inet static address 192.168.1.10 netmask 255.255.255.0 network 192.168.1.0 broadcast 192.168.1.255 gateway 192.168.1.1 dns-search opensharing.priv dns-nameservers 8.8.8.8 8.8.4.4
Contenu initial du fichier /etc/hosts :
sudo nano /etc/hosts
127.0.0.1 localhost.localdomain localhost 192.168.1.10 mylms.opensharing.priv mylms
Rmq : L’adresse 127.0.1.1 doit être retirée sur un serveur à IP fixe et remplacée par cette dernière, tel que l’exemple ci-dessus.
Contenu initial du fichier /etc/host.conf :
sudo nano /etc/host.conf
order hosts, bind multi on
Contenu initial du fichier /etc/resolv.conf (généré automatiquement) :
cat /etc/resolv.conf
# Dynamic resolv.conf(5) file for glibc resolver(3) generated by resolvconf(8) # DO NOT EDIT THIS FILE BY HAND -- YOUR CHANGES WILL BE OVERWRITTEN nameserver 8.8.8.8 nameserver 8.8.4.4 search opensharing.priv
Rmq : Le fichier /etc/resolv.conf ne doit pas être édité dès lors que le paquet resolvconf a été installé.
Pour prendre en compte les modifications des fichiers de configuration relatifs au réseau, redémarrage du service réseau et de l’interface réseau configurée en IP fixe :
sudo systemctl restart networking sudo ifup enp0s3
Vérification de la bonne configuration réseau :
ping 8.8.8.8 dig opensharing.fr
RÉALISATION
1. Installation de Apache (LAMP 2/4)
sudo apt-get update sudo apt-get upgrade
sudo apt-get install apache2 apache2-doc
2. Configuration de Apache (LAMP2/4)
Création d’une configuration minimale pour notre LMS
sudo nano /etc/apache2/sites-available/mylms.conf
<VirtualHost *:80>
DocumentRoot /var/www/mylms/
ServerName mylms.opensharing.priv
<Directory /var/www/mylms/>
Options -Indexes +FollowSymlinks +MultiViews
AllowOverride All
Require all granted
</Directory>
ErrorLog /var/log/apache2/mylms.error.log
CustomLog /var/log/apache2/mylms.access.log combined
</VirtualHost>
Désactivation du site par défaut :
sudo a2dissite 000-default
Activation du site hébergeant notre LMS :
sudo a2ensite mylms
3. Sécurisation de notre site en HTTPS (LAMP2/4)
Création d’une clé privée de 2048 bits de type RSA :
sudo openssl genrsa -out /etc/ssl/private/mylmsperso.key 2048
Generating RSA private key, 2048 bit long modulus (2 primes) ..............................................................................+++++ ....................................................................+++++ e is 65537 (0x010001)
Création d’une demande de signature de certificat (CSR, Certificate Signing Request) générée avec la clé privée RSA précédemment créée :
sudo openssl req -new -key /etc/ssl/private/mylmsperso.key -out /etc/ssl/certs/mylmsperso.csr
You are about to be asked to enter information that will be incorporated into your certificate request. What you are about to enter is what is called a Distinguished Name or a DN. There are quite a few fields but you can leave some blank For some fields there will be a default value, If you enter '.', the field will be left blank. ----- Country Name (2 letter code) [AU]:FR State or Province Name (full name) [Some-State]:Ile-de-France Locality Name (eg, city) []:Paris Organization Name (eg, company) [Internet Widgits Pty Ltd]:OpenSharing Organizational Unit Name (eg, section) []:IT Common Name (e.g. server FQDN or YOUR name) []:mylms.opensharing.priv Email Address []:admin@opensharing.priv Please enter the following 'extra' attributes to be sent with your certificate request A challenge password []: An optional company name []:
Auto-signature de la demande de certificat générant un certificat auto-signé (CRT) valable 1 an :
sudo openssl x509 -req -days 365 -in /etc/ssl/certs/mylmsperso.csr -signkey /etc/ssl/private/mylmsperso.key -out /etc/ssl/certs/mylmsperso.crt
Signature ok subject=C = FR, ST = Ile-de-France, L = Paris, O = OpenSharing, OU = IT, CN = mylms.opensharing.priv, emailAddress = admin@opensharing.priv Getting Private key
Activation du module SSL :
sudo a2enmod ssl
Activation du module rewrite pour les éventuelles réécritures d’URL :
sudo a2enmod rewrite
Modification de la configuration de notre site pour prendre en compte la sécurisation par le protocole HTTPS :
- Redirection du port 80 (HTTP) vers le port 443 (HTTPS)
- Directives de sécurisation (moteur SSL/TLS, certificat public, clé privée, etc.)
sudo nano /etc/apache2/sites-available/mylms.conf
<VirtualHost *:80>
ServerName mylms.opensharing.priv
Redirect permanent / https://mylms.opensharing.priv/
</VirtualHost>
<VirtualHost *:443>
DocumentRoot /var/www/mylms/
ServerName mylms.opensharing.priv
<Directory /var/www/mylms/>
Options -Indexes +FollowSymlinks +MultiViews
AllowOverride All
Require all granted
</Directory>
ErrorLog /var/log/apache2/mylms.error.log
CustomLog /var/log/apache2/mylms.access.log combined
SSLEngine On
SSLOptions +FakeBasicAuth +ExportCertData +StrictRequire
SSLCertificateFile /etc/ssl/certs/mylmsperso.crt
SSLCertificateKeyFile /etc/ssl/private/mylmsperso.key
</VirtualHost>
Redémarrage du démon Apache :
sudo systemctl restart apache2
4. Installation de MariaDB (LAMP 3/4)
sudo apt-get install mariadb-server mariadb-client
Vérifier si les démons mariadb et apache sont actifs au démarrage du systèmes :
sudo systemctl list-unit-files --type=service --state=enabled
Les services apache2.service et {mariadb, mysql, mysqld}.service doivent être dans l’état enabled.
Si ce n’est pas le cas, les activer avec la commande suivante :
sudo systemctl enable name[.service]
5. Configuration de MariaDB (LAMP 3/4)
Par défaut, le plugin unix_socket est actif et permet l’authentification avec les comptes locaux de mêmes noms. En d’autres termes, root-DB utilise root-system pour se connecter aux bases de données.
Si vous souhaitez différencier ces comptes et donc utiliser un mot de passe différent, il vous faudra activer le plugin mysql_native_password, ou encore mieux le plugin ed25519, mais ici nous resterons sur la configuration unix_socket et nous ne définirons pas de mot de passe pour root-DB.
Sécurisation de l’accès aux bases de données.
sudo mysql_secure_installation
NOTE: RUNNING ALL PARTS OF THIS SCRIPT IS RECOMMENDED FOR ALL MariaDB
SERVERS IN PRODUCTION USE! PLEASE READ EACH STEP CAREFULLY!
In order to log into MariaDB to secure it, we'll need the current
password for the root user. If you've just installed MariaDB, and
you haven't set the root password yet, the password will be blank,
so you should just press enter here.
Enter current password for root (enter for none):
OK, successfully used password, moving on...
Setting the root password ensures that nobody can log into the MariaDB
root user without the proper authorisation.
Set root password? [Y/n] n
... skipping.
By default, a MariaDB installation has an anonymous user, allowing anyone
to log into MariaDB without having to have a user account created for
them. This is intended only for testing, and to make the installation
go a bit smoother. You should remove them before moving into a
production environment.
Remove anonymous users? [Y/n] Y
... Success!
Normally, root should only be allowed to connect from 'localhost'. This
ensures that someone cannot guess at the root password from the network.
Disallow root login remotely? [Y/n] Y
... Success!
By default, MariaDB comes with a database named 'test' that anyone can
access. This is also intended only for testing, and should be removed
before moving into a production environment.
Remove test database and access to it? [Y/n] Y
- Dropping test database...
... Success!
- Removing privileges on test database...
... Success!
Reloading the privilege tables will ensure that all changes made so far
will take effect immediately.
Reload privilege tables now? [Y/n] Y
... Success!
Cleaning up...
All done! If you've completed all of the above steps, your MariaDB
installation should now be secure.
Thanks for using MariaDB!
Création d’une base de données et de son administrateur :
sudo mysql -u root
> CREATE DATABASE IF NOT EXISTS mylmsdb CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci; > CREATE USER mylmsadmin@localhost IDENTIFIED BY "mylmsadminpw"; > GRANT ALL PRIVILEGES ON mylmsdb.* TO mylmsadmin@localhost; > FLUSH PRIVILEGES; > SHOW DATABASES; > QUIT;
Redémarrage du démon MariaDB :
sudo systemctl restart mariadb
6. Installation de PHP et ses modules (LAMP 4/4)
⚠ Le module php-mcrypt est obsolète avec PHP 7.3, qui est la version par défaut sous Debian Buster.
sudo apt-get install php php-apcu php-bcmath php-bz2 php-curl php-fpm php-gd php-geoip php-gmp php-imagick php-intl php-ldap php-mbstring php-mcrypt php-memcached php-msgpack php-mysql php-pear php-soap php-xml php-xmlrpc php-zip libapache2-mod-php imagemagick
7. Configuration de PHP (LAMP 4/4)
Configuration de OPcache pour l’optimisation des performances par la mise en cache des scripts PHP compilés :
nano /etc/php/7.0/mods-available/opcache.ini
opcache.memory_consumption=128 opcache.interned_strings_buffer=8 opcache.max_accelerated_files=16229 opcache.revalidate_freq=60 opcache.fast_shutdown=1 opcache.enable_cli=1
Configuration de PHP spécifique à Claroline :
nano -c /etc/php/7.0/apache2/php.ini
ligne 368 ligne 389 ligne 924 ligne 1767
max_execution_time = 60 memory_limit = 256M date.timezone = 'Europe/Paris' opcache.enable = 1
8. Installation de Claroline (phase ligne de commandes)
Téléchargement et extraction de l’archive Claroline :
wget http://packages.claroline.net/releases/16.05/claroline-16.05.tar.gz tar zxvf claroline-16.05.tar.gz sudo mv claroline-16.05/ /var/www/mylms/ rm claroline-16.05.tar.gz
Modification des permissions sur le site :
sudo chown -R root:www-data /var/www/mylms/
sudo chmod -R g+w /var/www/mylms/{app,files,web}
Redémarrage des services Apache et MariaDB :
sudo systemctl restart mariadb sudo systemctl restart apache2
9. Installation de Claroline (phase web)
Pour l’installation par le navigateur, il faut se connecter à l’URL suivante :
https://mylms.opensharing.priv/web/install.php
Accepter l’exception de sécurité liée au certificat auto-signé de notre serveur Apache.
L’installation par le Web se lance et on commence par choisir la langue d’installation :
Puis on vérifie que les prérequis sont remplis :
Rmq : Si le message d’erreur suivant apparait, cliquez simplement sur Réessayer :
Le fichier app/config/parameters.yml doit être accessible en écriture.
Ensuite on spécifie les paramètres d’accès à la base de données créée précédemment :
Puis les paramètres de la plateforme :
Puis on crée un administrateur du portail :
On ne configurera pas ici le serveur de mails :
Nous n’enverrons pas de données d’utilisation :
L’interface d’authentification s’affiche :
Notre plateforme est maintenant installée et prête à l’emploi :
POUR ALLER PLUS LOIN
1. Effectuer une sauvegarde manuelle complète
mkdir -p /home/sysadmin/backup/16.05/ cd /home/sysadmin/backup/16.05/ sudo tar -czvf backup-claroline-20191201.tar.gz -C /var/www/ mylms/ mysqldump --user=mylmsadmin --password=mylmsadminpw --databases mylmsdb > claroline-20191201.sql
2. Effectuer une restauration manuelle complète
cd /home/sysadmin/backup/16.05/ sudo rm -rf /var/www/mylms/ sudo tar -xzvf backup-claroline-20191201.tar.gz -C /var/www/ sudo mysql -e "DROP DATABASE mylmsdb" sudo mysql -e "CREATE DATABASE IF NOT EXISTS mylmsdb CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci" mysql --user=mylmsadmin --password=mylmsadminpw mylmsdb < claroline-20191201.sql