Outils pour utilisateurs

Outils du site


services:pad.chapril.org

Différences

Ci-dessous, les différences entre deux révisions de la page.

Lien vers cette vue comparative

Les deux révisions précédentesRévision précédente
services:pad.chapril.org [2026/04/11 17:40] – supprimée - modification externe (Date inconnue) 127.0.0.1services:pad.chapril.org [2026/04/11 17:40] (Version actuelle) – ↷ Page déplacée de admin:services:pad.chapril.org à services:pad.chapril.org pitchum
Ligne 1: Ligne 1:
 +====== É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_12.x bookworm main
 +deb-src https://deb.nodesource.com/node_12.x bookworm 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.
 +