Ce tutoriel est vérifié avec RHEL8 et AlmaLinux8
Dans cet article, nous allons voir comment mettre en oeuvre Etherpad sur RHEL 8 et dérivées.
On aura besoin des outils de développement suivant :
On aura besoin d'une base de données MariaDB :
Et d'une version récente de NodeJS (14 en provenance des modules) :
On va démarrer et activer le service :
On lance la procédure d'initialisation de MariaDB :
Répondez aux questions et définissez un mot de passe à root !
Ensuite, créons un utilisateur et une base de données pour Etherpad :
On va créer un utilisateur pour le service, dont le dossier personnel est /opt/etherpad :
On attribue les bons droits :
Pour installer etherpad, on va se connecter en utilisateur etherpad :
On va ensuite cloner le code source :
On va copier le fichier de config :
Et on va l'éditer :
On vérifie que ça écoute partout :
On commente la base de données dirty :
Et on va renseigner les paramètres corrects de MariaDB :
Code TEXT : "dbType" : "mysql",
"dbSettings" : {
"user": "etheruser",
"host": "localhost",
"port": 3306,
"password": "etherpadd",
"database": "etherpad",
"charset": "utf8mb4"
},
On va installer les dépendances en exécutant :
On ouvre le parefeu, sur le port 9001 :
Puis on lance Etherpad :
Etherpad se ne se lance pas tout seul.
On va donc créer un service pour le démarrer automatiquement :
On va créer un service simple qui lancera avec notre utilisateur l'etherpad :
Code TEXT :[Unit]
Description=Etherpad
After=network.target
[Service]
Type=simple
User=etherpad
Group=etherpad
ExecStart=/opt/etherpad/etherpad-lite/bin/run.sh
Restart=always
[Install]
WantedBy=multi-user.target
On active et démarre le service :
On peut accéder au pad avec
http://serveur:9001
Vu qu'etherpad est lancé en tant que service, on pourra facilement avoir des infos via les logs :
Pour mettre à jour Etherpad :
Et on redémarre le service :
Il est possible, si on le souhaite, d'utiliser NGINX comme proxy et pour gérer la partie HTTPS.
On l'installe :
On se créé un server block (mais on peut tout à fait modifier la config de base si on a que Etherpad sur le serveur) :
Si on utilise SELinux, on permet d'accéder au réseau nginx :
On active nginx au boot et on démarre le service :
On ouvre le parefeu évidemment sur le port http :
On peut accéder maintenant à etherpad via :
http://serveur
Pour du HTTPS on modifiera le fichier :
Et on ajoutera :
Evidemment, indiquez vos certificats.
Note : Générer des certificats Lets Encrypt (
https://www.linuxtricks.fr/wiki/let-s-encrypt-mise-en-place ) ou autosigné (
https://www.linuxtricks.fr/wiki/openssl-creation-de-certificats-et-ca-autosignes )
On ouvre le parefeu évidemment sur le port https :
Et on redémarre nginx :