Changer le nom de domaine de la MoodleBox

Avertissement

Les opérations décrites sur cette page sont susceptibles de rendre votre MoodleBox inutilisable, nécessitant l’effacement complet de la carte SD et la perte de toutes les données qui s’y trouvent (contenus de cours, plugins installés, configurations personnalisées, etc.). N’effectuez ces opérations que si vous savez exactement ce que vous faites. Dans tous les cas, aucune assistance n’est assurée sur ce sujet.

Nous déclinons toute responsabilité pour tout dommage direct ou indirect lors de l’utilisation de la MoodleBox, notamment suite à un changement du nom de domaine.

Marche à suivre

L’exemple ci-dessous montre comment changer le nom de domaine d’une MoodleBox, ce qui permettra à un appareil local de l’atteindre au moyen d’une nouvelle URL. L’exemple indique comment donner à la MoodleBox le nom de domaine learn.example.com.

Information

Cette opération n’a pas d’influence sur l’accès à la MoodleBox depuis un réseau Ethernet ou depuis Internet : la MoodleBox restera accessible uniquement depuis le réseau Wi-Fi qu’elle fournit, depuis les appareils qui s’y sont connectés.

Étape 1 : changer le nom d’hôte (hostname)

À la dernière ligne du fichier /etc/hosts, remplacer moodlebox par learn.example.com.

Dans le fichier /etc/hostname, remplacer moodlebox par learn.example.com (cette modification n’est n’est pas indispensable, mais vivement recommandée).

Étape 2 : adapter la configuration du serveur web nginx

Modifier le fichier /etc/nginx/sites-available/default, en y remplaçant moodlebox par le nom de domaine complet (FQDN) learn.example.com dans la directive server_name.

Étape 3 : adapter la configuration du serveur DHCP

Modifier le fichier /etc/NetworkManager/dnsmasq-shared.d/00-dhcp.conf, en y remplaçant home par learn.example.com dans les deux lignes qui commencent par domain et local.

Si le nouveau nom de domaine est public, commenter ou effacer complètement la ligne commençant par address. Sinon, si le nouveau nom de domaine reste local, se teminant par .home, cette ligne peut être laissée telle quelle.

Étape 4 : Adapter la configuration du portail captif (Nodogsplash)

Dans le fichier /etc/nodogsplash/nodogsplash.conf, remplacer l’URL http://moodlebox.home par http://learn.example.com.

Étape 5 : Adapter la configuration de Moodle (URL de Moodle)

Dans le fichier /var/www/moodle/config.php, à la ligne qui commence par $CFG->wwwroot, remplacer l’URL http://moodlebox.home par http://learn.example.com. Ne pas ajouter de barre oblique à la fin de l’URL.

Étape 6 : Redémarrer la MoodleBox

Afin de prendre en compte ces modifications, redémarrer votre MoodleBox.

Étape 7 : Remplacer les URLs de Moodle

Accéder à votre MoodleBox au moyen votre navigateur en utilisant la nouvelle adresse http://learn.example.com/ et utiliser l’outil de remplacement d’URL à l’adresse http://learn.example.com/admin/tool/replace/index.php pour remplacer les URLs dans la base de données de Moodle.

Étape 8 : Remplacer les certificats SSL (optionel)

Si vous voulez utiliser HTTPS, vous devrez obtenir vos propres certificats SSL, car ceux fournis par MoodleBox ne fonctionneront pas avec votre nom de domaine personnalisé learn.example.com. N’oubliez pas de changer également l’URL.

Options similaires