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
|
Introduction
|
||||||
====================
|
====================
|
||||||
|
|
||||||
Documentation à destination d'un administrateur de service pad de Chalec.
|
Documentation à destination d'un administrateur de service pad de Chalec.
|
||||||
|
|
||||||
L'objectif est d'installer un service basé sur le logiciel etherpad-lite.
|
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
|
Il sera placé en amont, un service nginx qui gèrera le traffic TLS et ses
|
||||||
certificats.
|
certificats.
|
||||||
|
|
||||||
|
|
||||||
Base de données (BDD)
|
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
|
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
|
# su - postgres
|
||||||
$ createuser <UTILISATEUR>
|
$ createuser pad
|
||||||
$ createdb <BDD> -O <UTILISATEUR>
|
$ createdb pad -O pad
|
||||||
$ psql <BDD>
|
$ psql <BDD>
|
||||||
ALTER USER <UTILISATEUR> WITH PASSWORD '<MOTDEPASSE>' ;
|
ALTER USER <UTILISATEUR> WITH PASSWORD '<MOTDEPASSE>' ;
|
||||||
ALTER ROLE;
|
ALTER ROLE;
|
||||||
|
@ -38,17 +40,32 @@ Installer Etherpad-lite
|
||||||
Ajouter l'utilisateur etherpad :
|
Ajouter l'utilisateur etherpad :
|
||||||
```
|
```
|
||||||
# adduser 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
|
# apt install -y nodejs
|
||||||
$ git clone --branch master https://github.com/ether/etherpad-lite.git
|
$ 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
|
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,
|
Dans le cas contraire, si vous souhaitez conserver votre fichier initial,
|
||||||
veuillez suivre pas à pas cette section.
|
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
|
```
|
||||||
==================
|
$ cd /homer/etherpad/etherpad-lite
|
||||||
Commenter la BDD par défaut :
|
```
|
||||||
|
|
||||||
|
Commenter ou supprimer la BDD par défaut :
|
||||||
```
|
```
|
||||||
/*
|
/*
|
||||||
"dbType": "dirty",
|
"dbType": "dirty",
|
||||||
|
@ -76,11 +96,11 @@ Décommentez la section postgres et compléter avec les secrets :
|
||||||
```
|
```
|
||||||
"dbType" : "postgres",
|
"dbType" : "postgres",
|
||||||
"dbSettings" : {
|
"dbSettings" : {
|
||||||
"user": "etherpad",
|
"user": "pad",
|
||||||
"host": "localhost",
|
"host": "localhost",
|
||||||
"port": 5432,
|
"port": 5432,
|
||||||
"password": "<MOTDEPASSE>",
|
"password": "<MOTDEPASSE>",
|
||||||
"database": "etherpad",
|
"database": "pad",
|
||||||
"charset": "utf8mb4"
|
"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é
|
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
|
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,
|
"minify": false,
|
||||||
```
|
```
|
||||||
|
@ -119,7 +134,7 @@ On personnalise le titre :
|
||||||
"title": "Pad Chalec",
|
"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",
|
"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
|
systemd
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
Tester le démarrer du service etherpad-lite :
|
Tester le démarrer du service etherpad-lite :
|
||||||
`$ src/bin/run.sh`
|
`$ src/bin/run.sh`
|
||||||
|
|
||||||
|
|
Loading…
Reference in New Issue