====== Éditeur de pad collaboratif ======
===== Installation du système de la vm =====

La machine a été installée en repectant les [[admin:procedures:creation_machine_virtuelle|procédures d'installations de VM]].

Les volumes suivants ont été créés et montés:

  * modele-vg-postgres_data sur ''/var/lib/postgresql''

===== Installation des services =====

==== Installation des pré-requis ====

Ajout dépot nodejs de nodejs (version récente requise) :
<code>
deb https://deb.nodesource.com/node_6.x stretch main
deb-src https://deb.nodesource.com/node_6.x stretch main
</code>

Ajout de la clé du dépôt :
<code>
curl -s https://deb.nodesource.com/gpgkey/nodesource.gpg.key | apt-key add -
apt update
</code>

<code bash>
apt-get install gzip git curl python libssl-dev pkg-config build-essential nodejs npm
</code>

==== Installation des sources ====

<code bash>
mkdir -p /var/www/etherpad-lite
cd /var/www/
git clone git://github.com/ether/etherpad-lite.git
useradd etherpad
sed -e 's|/home/etherpad|/var/www/etherpad-lite|' /etc/passwd -i
chown -R etherpad:etherpad /var/www/etherpad-lite
mkdir -p ~etherpad/.npm
chown -R etherpad:etherpad-lite ~etherpad-lite
</code>

==== Installation de la base postgres ====

<code>
apt install postgresql
</code>

Création de l'utilisateur etherpad dans postgres :
<code>
sudo -u postgres sh -c 'createuser -d etherpad && createdb -O etherpad etherpad' 
</code>

==== Monitoring ====
Configuration de nagios pour le monitoring :

Ajouter cette ligne à la fin du fichier /etc/postgresql/9.6/main/pg_hba.conf

<code>
host    template1   nagios      127.0.0.1/32                    trust
</code>

Ajouter le rôle nagios :
<code>
sudo -u postgres sh -c 'createuser nagios' 
</code>

Relancer postgres :
<code>
systemctl restart postgresql.service
</code>
==== Configuration ====

Configuration de la base de données dans ''settings.json'':

<code json settings.json>
"dbType" : "postgres",
"dbSettings" : {
    "user"    : "etherpad",
    "host"    : "/var/run/postgresql",
    "password": "",
    "database": "etherpad",
    "charset" : "utf8mb4"
},
</code>

Le démarrage du service est effectué manuellement de la manière suivante :

<code bash>
su - etherpad -s /bin/bash
./bin/run.sh
</code>


==== Intégration au système ====

Le script suivant a été écrit pour le démarrage de etherpad au boot:

<code bash /etc/systemd/system/etherpad-lite.service>
[Unit]
Description=etherpad-lite (real-time collaborative document editing)
After=syslog.target network.target

[Service]
Type=simple
User=etherpad-lite
Group=etherpad-lite
ExecStart=/srv/etherpad-lite/bin/run.sh

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

<code>
systemctl enable etherpad-lite
</code>

===== Activation des plugins =====

==== Activation du plugin adminpads ====

Ce plugin permet de remplacer l'ancien système et d'effacer des pads.  Il a été installé de la manière suivante:

<code bash>
cd /var/www/etherpad-lite/src
npm i ep_adminpads
systemctl restart etherpad-lite
</code>

L'accès à l'interface se fait via https://pad.chapril.org/admin

==== Activation du plugin delete_empty_pads ====

Ce plugin permet la suppression automatique des pads créés pour rien.

L'installation via le gestionnaire de plugin ayant échouée, passage en manuel :
<code>
=(^-^)=root@pad:/var/www/etherpad-lite# npm i ep_delete_empty_pads
/var/www/etherpad-lite
└── ep_delete_empty_pads@0.0.4 

npm WARN enoent ENOENT: no such file or directory, open '/var/www/etherpad-lite/package.json'
npm WARN etherpad-lite No description
npm WARN etherpad-lite No repository field.
npm WARN etherpad-lite No README data
npm WARN etherpad-lite No license field.

=(^-^)=root@pad:/var/www/etherpad-lite# service restart etherpad-lite
</code>

==== Affichage de la table de matière par défaut ====

Convient pour le plugin : https://npmjs.org/package/ep_table_of_contents

ajouter
<code json>
"ep_toc": {
  "disable_by_default": false
},
</code>

dans le fichier settings.json à la racine du etherpad-lite ou via l'interface d'administration.