pad/INSTALL.md

Pré-requis
====================

Installer les paquets suivants :
```
# apt install screen
```

Base de données (BDD)
=========

Installer la base de données et démarrer le service : 
```
# apt install postgresql postgresql-client
# systemctl enable --now postgresql
```

On vérifie que l'on peut se connecter en IP avec vérification du mot de passe par la BDD. Editer le fichier suivant : 
/etc/postgresql/xx/main/pg_hba.conf
```
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>
```
# su - postgres
$ createuser <UTILISATEUR>
$ createdb <BDD> -O <UTILISATEUR>
$ psql <BDD>
  ALTER USER <UTILISATEUR> WITH PASSWORD '<MOTDEPASSE>' ;
  ALTER ROLE;
  \q
```

Installer Etherpad-lite
=====================

Ajouter l'utilisateur etherpad
```
# adduser etherpad
# su - etherpad && cd
```

Suivre les recommandations etherpad-lite pour installer sur Debian : 
```
# 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 
```

Configuration Etherpad-lite
=====================

Edition du settings.json


BDD
Commenter la BDD par défaut : 
```
/*                                                                                    
  "dbType": "dirty",                                                                  
  "dbSettings": {                                                                     
    "filename": "var/dirty.db"                                                        
  },                                                                                  
*/
```
Renseigner les paramètres de la BDD postgres

```
  "dbType" : "postgres",
  "dbSettings" : {
    "user":     "<UTILISATEUR>",
    "host":     "localhost",
      "port":     5432,
      "password": "<MOTDEPASSE>",
    "database": "<BDD>",
    "charset":  "utf8mb4"
  },
```


Personnalisation de l'instance
```
  "title": "Pad Chalec",
```
```
  "favicon": "../pad.chalec.org.svg",
```
```
    "skinName": "chalec",
```
```
"defaultPadText" : " <---- Tapez votre texte ici et libre à vous d'effacer cette \
page d'informations.\n\nBienvenue sur pad.chalec.org, un service Chalec, basé sur le \
logiciel libre Etherpad-lite !\n\nNous vous souhaitons une agréable navigation ainsi \
que de partager les valeurs du libre ici ou ailleurs.\n\nQuelques conseils : \n- cons\
ervez pour vous-même l'adresse (URL) de ce pad et communiquez-la à vos collaborateurs\
. Le contenu est synchronisé entre participants ;\n- attention, tout est public ! Mai\
s sans adresse (URL) point d'accès. Ne la partagez pas avec n'importe qui ;\n- choisi\
ssez un pseudonyme et une couleur (bouton en haut à droite) afin que les participants\
 puissent identifier l'utilisateur faisant les modifications.\n\nPolitique de conserv\
ation et de suppression des données : \n- effacement à J+6 mois : votre pad est susce\
ptible d'être effacé six mois après la date de dernière modification (utiliser les fo\
nctions d'export si nécessaire) ;\n- nous ne traitons pas de demandes de suppression \
autres que pour des motifs règlementés par la loi française. En effet, nous ne pouvon\
s pas assurément vous identifier comme le propriétaire d'un pad !\n\nConditions Génér\
ales d'Utilisation : \nEn utilisant ce service, vous acceptez tacitement les Conditio\
ns Générales d'Utilisation (CGU) des services Chalec (https://www.chalec.org/CGU) qui\
 régissent formellement le service et priment sur toutes autres explications fournies\
 sur cette page.\n\nLibrement, \nL'équipe Chalec (https://www.chalec.org),\nCandidat \
CHATONS par Libre en Communs (https://a-lec.org)\nmailto:contact+pad@chalec.org\nxmpp\
:chalec@salons.a-lec.org?join",
```

Configuration de la BDD :




Then try to start etherpad

`$ src/bin/run.sh`

Then CTRL-C

Restore the run.sh script in home folder

Setup the cron

`$ crontab -e`

and insert at the end of the file

`@reboot /home/etherpad/run.sh`

Restore "run.sh" script helper to run Etherpad in screen znd run

`~/run.sh`

Install the proxy
==================
Restore html content into /var/www

Install nginx
```
# apt install nginx
# mkdir /var/log/nginx/pad.chalec.org
# chown www-data:www-data /var/log/nginx/pad.chalec.org
```


Setup the config file from nginx/sites-available/etherpad in /etc/nginx/sites-available/etherpad

Link available to enable
```
# cd /etc/nginx/sites-enabled
# ln -s ../sites-available .
```


Start nginx

`# systemctl enable --now nginx`

Open firewall

`# ufw allow proto tcp port 80,443`

Check the service is reachable at
```
http://pad.chalec.org
https://pad.chalec.org
```

INSTALL etherpad plugins
========================

Plugin list to install at https://pad.chalec.org/admin
- adminpads2
- align
- author_hover
- delete_after_delay
- delete_empty_pads
- font_color
- font_size
- headings2
- spellcheck
- table_of_contents


Chalec infos
============

Intall Java
`# apt install openjdk-jre-headless`

`# adduser statoolinfos`
Add to admin group to read logs
```
# adduser statoolinfos admin
# su - statoolinfos
$ cd
```

Download Statoolinfos jar at https://forge.devinsy.fr/devinsy/statoolinfos/releases

Uncompress in /home/statool-<version>
link versioned folder to generic one

`$ ln -s statoolinfos-<verion> statoolinfos`

Restore statool config

(/var/www/html/.well-known/statoolinfos already restored in etherpad install)

/home/statoolinfos/statoolinfos/statoolinfos.sh probe -full /hhome/statoolinfos/statoolinfos/conf/pad.chalec.org.conf

`$ crontab -e`

`45 * * * * /home/statoolinfos/statoolinfos/statoolinfos.sh probe -previousday /home/statoolinfos/statoolinfos/conf/pad.chalec.org.conf >> /home/statoolinfos/statoolinfos.log`