pad/INSTALL.md

5.7 KiB

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 avec le mot de passe , et la base

# 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- 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