Skip to content

Commit

Permalink
Update documentation, fixing #64.
Browse files Browse the repository at this point in the history
  • Loading branch information
martignoni committed Nov 27, 2023
1 parent c1899f4 commit 5b72125
Show file tree
Hide file tree
Showing 4 changed files with 42 additions and 26 deletions.
16 changes: 10 additions & 6 deletions content/de/help/domain-name-change.md
Original file line number Diff line number Diff line change
Expand Up @@ -5,7 +5,7 @@ authors:
- Ralf Krause
type: kb
date: 2018-09-27
lastmod: 2021-10-21
lastmod: 2023-11-27
description: In dieser Anleitung wird erklärt, wie Sie den Domainnamen Ihrer MoodleBox ändern können, damit er besser zu Ihrer lokalen Situation passt.
slug: domainname-aenderung
categories_weight: 90
Expand Down Expand Up @@ -39,23 +39,27 @@ In der Datei `/etc/hostname` ersetzen Sie `moodlebox` durch `learn.example.com`

#### Schritt 3: Anpassung der DNS-Server-Masquerading-Konfiguration

Ändern Sie die Datei `/etc/dnsmasq.conf` und ersetzen Sie `home` durch __learn.example.com__ in den beiden Zeilen, die mit `domain` und `local` beginnen.
Ändern Sie die Datei `/etc/NetworkManager/dnsmasq-shared.d/00-dhcp.conf` und ersetzen Sie `home` durch __learn.example.com__ in den beiden Zeilen, die mit `domain` und `local` beginnen.

Wenn der neue Domänenname öffentlich ist, auskommentieren oder löschen Sie die Zeile, die mit `address` beginnt. Andernfalls, wenn der neue Domänenname lokal bleiben soll und mit `.home` endet, können Sie diese Zeile unverändert lassen.

#### Schritt 4: Anpassung der Moodle-Konfiguration (Moodle-URL)
#### Schritt 4: Anpassung der WLAN-Captive-Portals-Konfiguration (Nodogsplash)

Ersetzen Sie in der Datei `/etc/nodogsplash/nodogsplash.conf` die URL `http://moodlebox.home` durch `http://learn.example.com`.

#### Schritt 5: Anpassung der Moodle-Konfiguration (Moodle-URL)

Ersetzen Sie in der Datei `/var/wwww/moodle/config.php` in der Zeile, die mit `$CFG->wwwwroot` beginnt, die URL `http://moodlebox.home` durch `http://learn.example.com`. Fügen Sie keinen Schrägstrich am Ende der URL hinzu.

#### Schritt 5: Neustart der MoodleBox
#### Schritt 6: Neustart der MoodleBox

Um alle Änderungen zu übernehmen, starten Sie Ihre MoodleBox neu.

#### Schritt 6: Ersetzen von Moodle-URLs
#### Schritt 7: Ersetzen von Moodle-URLs

Rufen Sie mit Ihrem Browser die neue URL `http://learn.example.com/` auf und melden Sie sich als Administrator an. Verwenden Sie das Tool __Suchen und Ersetzen in der Datenbank__ `http://learn.example.com/admin/tool/replace/index.php`, um die URLs in der Moodle-Datenbank zu ersetzen.

#### Schritt 7: SSL-Zertifikate ersetzen (optional)
#### Schritt 8: SSL-Zertifikate ersetzen (optional)

Wenn Sie [HTTPS][3] verwenden möchten, müssen Sie sich Ihre eigenen SSL-Zertifikate besorgen, da die von der MoodleBox bereitgestellten Zertifikate nicht mit dem neuen Domainnamen __learn.example.com__ funktionieren. Vergessen Sie nicht, auch die URL zu ändern.

Expand Down
20 changes: 12 additions & 8 deletions content/en/help/domain-name-change.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,7 +4,7 @@ authors:
- Nicolas Martignoni
type: kb
date: 2018-09-27
lastmod: 2021-10-21
lastmod: 2023-11-27
description: This guide explains how to change the domain name of your MoodleBox to better match your own local situation.
slug: domain-name-change
categories_weight: 90
Expand All @@ -20,7 +20,7 @@ We accept no responsibility for any direct or indirect damage caused by the use

### How to proceed

The example below shows how to change the domain name of a MoodleBox, which will allow a local device to reach it with a new URL. The example shows how to give the MoodleBox the domain name __learn.example.com__.
The instructions below shows how to change the domain name of a MoodleBox, which will allow a local device to reach it with a new URL. The example shows how to give the MoodleBox the domain name __learn.example.com__.

{{< notice info >}}
This operation has no influence on access to the MoodleBox from an Ethernet network or from the Internet: the MoodleBox __will remain accessible only from the Wi-Fi network it provides__, from the devices that have connected to it.
Expand All @@ -34,27 +34,31 @@ In the `/etc/hostname` file, replace `moodlebox` with __learn.example.com__ (thi

#### Step 2: Adapt the configuration of the nginx web server

Change the file `/etc/nginx/sites-available/default`, replacing `moodlebox` with the full domain name (_FQDN_) __learn.example.com__ in the `server_name` directive.
In the file `/etc/nginx/sites-available/default`, replace `moodlebox` with the full domain name (_FQDN_) __learn.example.com__ in the `server_name` directive.

#### Step 3: Adapt the DNS server masquerading configuration

Change the file `/etc/dnsmasq.conf`, replacing `home` by __learn.example.com__ in the two lines that start with `domain` and `local`.
In the file `/etc/NetworkManager/dnsmasq-shared.d/00-dhcp.conf`, replace `home` by __learn.example.com__ in the two lines that start with `domain` and `local`.

If your domain name is a public one, comment out or delete completely the line starting with `address`. Otherwise, if your new domain name will remain local, ending with `.home`, you can keep this line untouched.

#### Step 4: Adapt the Moodle configuration (Moodle URL)
#### Step 4: Adapt the captive portal configuration (Nodogsplash)

In the file `/etc/nodogsplash/nodogsplash.conf`, replace the URL `http://moodlebox.home/` by `http://learn.example.com`.

#### Step 5: Adapt the Moodle configuration (Moodle URL)

In the file `/var/www/moodle/config.php`, on the line beginning with `$CFG->wwwroot`, replace the URL `http://moodlebox.home` by `http://learn.example.com`. Do not add a slash at the end of the URL.

#### Step 5: Restart the MoodleBox
#### Step 6: Restart the MoodleBox

In order to apply these changes, restart your MoodleBox.

#### Step 6: Replace Moodle URLs
#### Step 7: Replace Moodle URLs

Access your MoodleBox through your browser using the new address `http://learn.example.com/` and use the URL replacement tool at `http://learn.example.com/admin/tool/replace/index.php` to replace URLs in the Moodle database.

#### Step 7: Replace SSL certificates (optional)
#### Step 8: Replace SSL certificates (optional)

If you want to [use HTTPS][3], you'll have to get your own SSL certificates, as those provided by the MoodleBox won't work with your custom domain name __learn.example.com__. Don't forget to change the URL too.

Expand Down
16 changes: 10 additions & 6 deletions content/es/help/domain-name-change.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,7 @@ authors:
- Eric Efrain Solano-Uscanga
type: kb
date: 2018-09-27
lastmod: 2021-10-21
lastmod: 2023-11-27
description: Esta guía explica cómo cambiar el nombre de dominio de tu MoodleBox para que coincida mejor con tu propia situación local.
slug: cambio-nombre-dominio
categories_weight: 90
Expand Down Expand Up @@ -40,23 +40,27 @@ Modifica el archivo `/etc/nginx/sites-available/default`, sustituyendo `moodlebo

#### Paso 3: Adaptar la configuración de enmascaramiento del servidor DNS

Modifique el archivo `/etc/dnsmasq.conf`, sustituyendo `home` por __learn.example.com__ en las dos líneas que empiezan por `domain` y `local`.
Modifique el archivo `/etc/NetworkManager/dnsmasq-shared.d/00-dhcp.conf`, sustituyendo `home` por __learn.example.com__ en las dos líneas que empiezan por `domain` y `local`.

Si tu nombre de dominio es público, comenta o borra completamente la línea que empieza por `address`. De lo contrario, si su nuevo nombre de dominio seguirá siendo local y terminará con `.home`, puede mantener esta línea intacta.

#### Paso 4: Adaptar la configuración de Moodle (URL de Moodle)
#### Paso 4: Adaptar la configuración del portal cautivo (Nodogsplash)

En el archivo `/etc/nodogsplash/nodogsplash.conf`, sustituya la URL `http://moodlebox.home` por `http://learn.example.com`.

#### Paso 5: Adaptar la configuración de Moodle (URL de Moodle)

En el archivo `/var/www/moodle/config.php`, en la línea que empieza por `$CFG->wwwroot`, sustituya la URL `http://moodlebox.home` por `http://learn.example.com`. No añada una barra al final de la URL.

#### Paso 5: Reinicie MoodleBox
#### Paso 6: Reinicie MoodleBox

Para aplicar estos cambios, reinicie su MoodleBox.

#### Paso 6: Reemplazar las URLs de Moodle
#### Paso 7: Reemplazar las URLs de Moodle

Acceda a su MoodleBox a través de su navegador utilizando la nueva dirección `http://learn.example.com/` y utilice la herramienta de reemplazo de URLs en `http://learn.example.com/admin/tool/replace/index.php` para reemplazar las URLs en la base de datos de Moodle.

#### Paso 7: Sustituir certificados SSL (opcional)
#### Paso 8: Sustituir certificados SSL (opcional)

Si desea [utilizar HTTPS][3], tendrá que obtener sus propios certificados SSL, ya que los proporcionados por MoodleBox no funcionarán con su nombre de dominio personalizado __learn.example.com__. No olvide cambiar también la URL.

Expand Down
16 changes: 10 additions & 6 deletions content/fr/help/domain-name-change.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,7 +4,7 @@ authors:
- Nicolas Martignoni
type: kb
date: 2018-09-27
lastmod: 2021-10-21
lastmod: 2023-11-27
description: Ce guide explique la démarche à effectuer pour changer le nom de domaine de votre MoodleBox, de sorte à mieux refléter votre propre situation locale.
slug: changer-nom-de-domaine
categories_weight: 90
Expand Down Expand Up @@ -38,23 +38,27 @@ Modifier le fichier `/etc/nginx/sites-available/default`, en y remplaçant `mood

#### Étape 3 : adapter la configuration du serveur DHCP

Modifier le fichier `/etc/dnsmasq.conf`, en y remplaçant `home` par __learn.example.com__ dans les deux lignes qui commencent par `domain` et `local`.
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 de Moodle (URL de Moodle)
#### Étape 4 : Adapter la configuration du portail captif (Nodogsplash)

Dans le fichier `/var/wwww/moodle/config.php`, 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 5 : Redémarrer la MoodleBox
#### Étape 6 : Redémarrer la MoodleBox

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

#### Étape 6 : Remplacer les URLs de Moodle
#### É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.

#### Step 7: Remplacer les certificats SSL (optionel)
#### Step 8: Remplacer les certificats SSL (optionel)

Si vous voulez [utiliser HTTPS][3], 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.

Expand Down

0 comments on commit 5b72125

Please sign in to comment.