====== MyPads ======

Nous utilisons une instance de [[https://git.framasoft.org/framasoft/ep_mypads|ep_mypads]] de Framasoft.

Le but est de fournir un outil pour gérer des pads privés pour les groupes de travail de la Fédération.

L'outil est accessible à l'adresse https://pads.ffdn.org

===== Documentation utilisateur =====

La [[documentation:pads|documentation utilisateur]] explique comment se servir des pads en groupe.

===== Installation =====

Installation de nodejs :

  sudo apt install -t jessie-backports nodejs nodejs-legacy

Installation de npm en local (le paquet Debian est beaucoup trop vieux) :

  sudo su - mypads
  wget https://registry.npmjs.org/npm/-/npm-5.5.1.tgz
  tar xf npm-5.5.1.tgz
  mv package/ npm-5.5.1/
  echo 'alias npm="node ~/npm-5.5.1/bin/npm-cli.js"' > ~/.bash_aliases
  . ~/.bash_aliases

<note important>La dernière version de npm, 5.6.0, a [[https://github.com/npm/npm/issues/19304|un bug]]
 qui empêche la réinstallation de certaines dépendences d'etherpad</note>

Installation de la dernière version stable de etherpad-lite :

  sudo su - mypads
  git clone git://github.com/ether/etherpad-lite.git
  cd etherpad-lite
  git checkout 1.6.2
  mkdir node_modules
  ln -s ../src node_modules/ep_etherpad-lite
  cd node_modules/ep_etherpad-lite
  npm install

Installation du plugin mypads : passer par l'interface web d'Etherpad : https://pads.ffdn.org/admin

On est censé pouvoir l'installer en ligne de commande avec npm, mais ça a l'air très aléatoire...
===== Configuration =====

Copier settings.json.template vers settings.json et éditer la configuration.

Base de données : postgresql

  sudo su - postgres
  createuser -P mypads
  createdb -O mypads etherpad

===== Lancement =====

Manuellement :

  sudo su - mypads
  cd ~/etherpad-lite
  node node_modules/ep_etherpad-lite/node/server.js

Avec supervisord :
  
  # /etc/supervisor/conf.d/mypads.conf 
  [program:mypads]
  command=/usr/bin/node node_modules/ep_etherpad-lite/node/server.js
  directory=/home/mypads/etherpad-lite
  user=mypads
  autostart=true
  autorestart=true
  redirect_stderr=True

===== Mise à jour =====