From e45f003e6cd82cdcc88e9281f5f783cbcdac867d Mon Sep 17 00:00:00 2001
From: Bastien Lacoste <bastien.lacoste@a-lec.org>
Date: Mon, 16 May 2022 23:41:17 +0200
Subject: [PATCH] Ajout des noms d'utilisateurs de BDD dans la doc

---
 INSTALL.md | 54 +++++++++++++++++++++++++++++++++++-------------------
 1 file changed, 35 insertions(+), 19 deletions(-)

diff --git a/INSTALL.md b/INSTALL.md
index d05c358..d4a641c 100644
--- a/INSTALL.md
+++ b/INSTALL.md
@@ -1,11 +1,13 @@
 Introduction
 ====================
+
 Documentation à destination d'un administrateur de service pad de Chalec.
 
 L'objectif est d'installer un service basé sur le logiciel etherpad-lite.
 Il sera placé en amont, un service nginx qui gèrera le traffic TLS et ses
 certificats.
 
+
 Base de données (BDD)
 =========
 
@@ -21,11 +23,11 @@ On vérifie que l'on peut se connecter en IP avec vérification du mot de passe
 host    all             all             127.0.0.0/24            md5
 ```
 
-On crée l'utilisateur <UTILISATEUR> avec le mot de passe <MOTDEPASSE>, et la base <BDD> : 
+On crée l'utilisateur "pad" avec le mot de passe <MOTDEPASSE>, et la base "pad" associée à l'utilisateur : 
 ```
 # su - postgres
-$ createuser <UTILISATEUR>
-$ createdb <BDD> -O <UTILISATEUR>
+$ createuser pad
+$ createdb pad -O pad
 $ psql <BDD>
   ALTER USER <UTILISATEUR> WITH PASSWORD '<MOTDEPASSE>' ;
   ALTER ROLE;
@@ -38,17 +40,32 @@ Installer Etherpad-lite
 Ajouter l'utilisateur etherpad : 
 ```
 # adduser etherpad
-# su - etherpad && cd
 ```
 
-Suivre les recommandations etherpad-lite pour installer sur Debian : 
+On se connecte avec l'utilisateur etherpad
 ```
-# curl -sL https://deb.nodesource.com/setup_14.x | sudo -E bash -
+# su - etherpad
+```
+
+Suivre les recommandations de la documentation officielle d'etherpad-lite pour installer sur Debian.
+
+```
+$ cd /home/etherpad
+$ curl -sL https://deb.nodesource.com/setup_14.x | sudo -E bash -
 # apt install -y nodejs
 $ git clone --branch master https://github.com/ether/etherpad-lite.git
-$ cd etherpad-lite 
 ```
 
+Récupérer les ressoures du pad Chalec
+=======================
+
+Cloner le dépot Pad de chalec avec l'utilisateur etherpad
+
+```
+$ git clone https://git.a-lec.org/a-lec/commissions/chalec/pad
+```
+
+
 Configuration Etherpad-lite
 =====================
 
@@ -59,10 +76,13 @@ celui-ci. Il faudra néanmoins mettre en place les secrets décrits ci-dessous.
 Dans le cas contraire, si vous souhaitez conserver votre fichier initial,
 veuillez suivre pas à pas cette section.
 
+Les instruction suivantes s'appliquent au fichier settings.json qui se trouve dans le home du user etherpad, dossier etherpad-lite.
 
-Secrets
-==================
-Commenter la BDD par défaut : 
+```
+$ cd /homer/etherpad/etherpad-lite 
+```
+
+Commenter ou supprimer la BDD par défaut : 
 ```
 /*                                                                                    
   "dbType": "dirty",                                                                  
@@ -76,11 +96,11 @@ Décommentez la section postgres et compléter avec les secrets :
 ```
   "dbType" : "postgres",
   "dbSettings" : {
-    "user":     "etherpad",
+    "user":     "pad",
     "host":     "localhost",
       "port":     5432,
       "password": "<MOTDEPASSE>",
-    "database": "etherpad",
+    "database": "pad",
     "charset":  "utf8mb4"
   },
 ```
@@ -102,14 +122,9 @@ Dans l'objet json "users", configurer l'admin :
   },
 ```
 
-
-
-Personnalisation de l'instance
-==================
-
 Pour la réalisation des tests et la mise en place du pad, il est fortement conseillé
 de régler le paramètre "minify" à false. Dans le cas contraire, le temps de chargement
-du premier pad peut-être très long.
+du premier pad peut-être très long. Penser à reactiver ce paramètre si besoin pour réduire le traffic web.
 ```
   "minify": false,
 ```
@@ -119,7 +134,7 @@ On personnalise le titre :
   "title": "Pad Chalec",
 ```
 
-Placer la favicon dans le dossier parent et la référencer : 
+Placer la favicon dans le dossier parent (/home/etherpad) et la référencer : 
 ```
   "favicon": "../pad.chalec.org.svg",
 ```
@@ -165,6 +180,7 @@ Note @todo : cette partie est en travaux et le mécanisme décrit devrait évolu
 systemd
 
 
+
 Tester le démarrer du service etherpad-lite : 
 `$ src/bin/run.sh`