Ajout des noms d'utilisateurs de BDD dans la doc
This commit is contained in:
parent
d56ba2c2a6
commit
e45f003e6c
54
INSTALL.md
54
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`
|
||||
|
||||
|
|
Loading…
Reference in New Issue