infrastructure:services:travail-collaboratif:etherpad:installation [Grohub wiki]

Cette page est en lecture seule. Vous pouvez afficher le texte source, mais ne pourrez pas le modifier. Contactez votre administrateur si vous pensez qu'il s'agit d'une erreur.
====== Installation Etherpad ======
{{tag>"travail collaboratif" "éditeur texte" Etherpad installation}}
Etherpad vous permet d'éditer des documents de manière collaborative en temps réel, un peu comme un éditeur multi-joueurs en direct qui s'exécute dans votre navigateur. Rédigez des articles, des communiqués de presse, des listes de choses à faire, etc. avec vos amis, camarades ou collègues, tous travaillant sur le même document en même temps.

===== Installation Node JS =====
Nous installons node.js
<code>
curl -sL https://deb.nodesource.com/setup_16.x | sudo -E bash -
sudo aptitude install nodejs
</code>

Nous installons Nginx et redis (qui nous servira de base de données)
<code>
sudo aptitude install nginx redis-server
</code>

===== Installation Etherpad =====
Nous créons l'utilisateur
<code>
sudo adduser --shell /bin/bash --home /opt/etherpad --gecos "Etherpad user" etherpad
</code>

<WRAP center round important 60%>
Note importante : le paramètre "--home" est primordial, car au premier lancement, node.js va chercher à écrire dans le home de l'utilisateur (ici etherpad).
</WRAP>

Nous téléchargeons la dernière version d'Etherpad
<code>
wget https://github.com/ether/etherpad-lite/archive/1.8.18.tar.gz
</code>

Nous la dézippons et mettons les bons droits, et le plaçons dans son répertoire de travail
<code>
tar xzf 1.8.4.tar.gz
sudo chown -R etherpad: etherpad-lite-1.8.18
sudo mv etherpad-lite-1.8.18/* /opt/etherpad
</code>

À l'issue de l'installation, nous pouvons vérifier la version installée
<code>
node --version
npm --version
</code>

===== Configuration MariaDB =====
<WRAP center round important 60%>
Nous n'utilisons plus MariaDB, mais à défaut de mieux, Redis.
</WRAP>

Nous créons la base de données, et y attachons l'utilisateur
<code>
mysql -u root -p
create database etherpad;
grant all privileges on etherpad.* to 'etherpad'@'%' identified by 'mon_super_mot_de_passe';
flush privileges;
quit
</code>

===== Configuration Etherpad =====
Nous créons le fichier de configuration depuis settings.json.template
<code>
sudo cp settings.json.template settings.json
</code>

Nous éditons le fichier settings.json
<code>
sudo vi settings.json
</code>

Nous ajoutons le connecteur pour Redis
<code>
  "dbType" : "redis",
  "dbSettings" : {
    "host": "localhost",
    "port": 6379,
    "database": 0
  },
</code>

Nous configurons le compte admin en décommentant / adaptant ce bloc
<code>
  "users": {
    "admin": {
      // 1) "password" can be replaced with "hash" if you install ep_hash_auth
      // 2) please note that if password is null, the user will not be created
      "password": "monsupermotdepasse",
      "is_admin": true
    }
  },
</code>

===== Configuration Systemd =====
Nous créons le fichier qui va permettre de gérer le service à l'aide de Systemd
<code>
sudo vi /etc/systemd/system/etherpad.service
</code>

Nous y ajoutons cette configuration
<code>
[Unit]
Description=Etherpad-lite, the collaborative editor.
After=syslog.target network.target

[Service]
Type=simple
User=etherpad
Group=etherpad
WorkingDirectory=/opt/etherpad
Environment=NODE_ENV=production
ExecStart=/usr/bin/node /opt/etherpad/node_modules/ep_etherpad-lite/node/server.js
Restart=always

[Install]
WantedBy=multi-user.target
</code>

Nous rechargeons systemd
<code>
sudo systemctl daemon-reload
</code>

===== Lancement final =====
Nous activons le service via systemd et le lançons
<code>
sudo systemctl enable --now etherpad.service
</code>

Pour contrôler que le service tourne correctement
<code>
sudo systemctl status etherpad.service
</code>


===== Proxy Nginx =====

Nous créons un vHost Nginx
<code>
sudo vi /etc/nginx/sites-available/pad.domain.tld.conf
</code>

Nous y collons et adaptons ce contenu
<code>
À venir.
</code>

Nous créons le liens symbolique
<code>
cd /etc/nginx/sites-enabled/
sudo ln -s /etc/nginx/sites-available/pad.domain.tld.conf
</code>

Nous vérifions la configuration et la rechargeons
<code>
sudo nginx -t
sudo systemctl reload neginx.service
</code>

===== Liens =====
  * [[https://etherpad.org/|site de l'éditeur]]
  * [[https://github.com/ether/etherpad-lite#installation|documentation installation]]
  * [[https://www.howtoforge.com/tutorial/ubuntu-etherpad-editor-server-installation/|How to Install Collaborative Real-time Editor Etherpad on Ubuntu 18.04]]
  * [[https://etherpad.org/doc/latest/|documentation Etherpad-lite]]
  * [[https://github.com/ether/etherpad-lite/wiki/How-to-use-Etherpad-Lite-with-Redis|How to use Etherpad Lite with Redis]]