==== etherpad.hadoly.fr ====

====== Description ======

Etherpad est un container lxc sur [[karadoc]].

====== Historique ======

  * Création du conteneur et installation d'etherpad en Février 2017
  * Upgrade Ubuntu 16.04 vers 18.04 en avril 2020
  * Upgrade en 20 en janvier 2024
  * Upgrade en 22 en janvier 2024

====== Hack moche ======

depuis le passage en ubuntu 22, pour que npm accepte de fonctionner (lors du démarrage de etherpad) il faut rajouter l'adresse ipv6 dans /etc/hosts:

<code>
#20240111: npm c'est de la 💩, ça force la connexion en IPv4, ce qui ne peut pas fonctionner sur ce conteneur IPv6 Only.
2606:4700::6810:1e22 registry.npmjs.org
</code>


====== Services ======

  * Pad accessible via https://pad.hadoly.fr
  * Les fichiers applicatifs sont stockés dans /home/etherpad/etherpad-lite
  * Démarrage du service : systemctl start etherpad.service
  * nodejs, <del>mongodb</del>postgresql

===== Mise à jour =====
Il peut être intéressant de faire une mise à jour manuelle des plugins depuis la page d'admin de temps en temps

Le mot de passe permettant d'accéder à l'interface d'admin est dans settings.json

<code>
cd /home/etherpad
sudo -u postgres /usr/bin/pg_dump -U postgres etherpad > etherpad.psql.sql
rm -fr etherpad-lite.ORIG
cp -a etherpad-lite{,.ORIG}
cd etherpad-lite
sudo -u etherpad git pull origin master
vimdiff /home/etherpad/etherpad-lite*/settings.json # pour merger les modifications de configuration
chown -R etherpad ~etherpad/etherpad-lite
systemctl restart etherpad
# wait
# wait
# fear uncertainty doubts...
# ...
# enjoy  or see journalctl -xe --unit etherpad
</code>

Ne pas oublier de mettre à jour [[administration:maj|Gestion des mises à jour]]

====== Supervision / monitoring ======

Services de base et présence de processus "node / etherpad" via [[documentation_technique:supervision|zabbix]]

====== Sauvegarde ======

  * what:
    * /etc
    * /root
    * /home/etherpad
    * /var/lib/postgresql/backups
  * where: vm2
  * how: [[:documentation_technique:sauvegardes]]