Etherpad Installieren

Etherpad Lite installieren

Etherpad ist eine JavaScript-Anwendung mit der mehrere Bearbeiter gleichzeitig einen Text im Browser editieren können.

Mit Hilfe von Etherpad können zum Beispiel die Teilnehmer einer Telefonkonferenz gemeinsam an einem Text-Dokument arbeiten.

Vorbereitung

Als Paket-Admin xyz00 werden mit HSAdmin ein User angelegt und eine Domain aufgeschaltet. Eine produktive Installation von Etherpad braucht zusätzlich einen MySQL-User und eine MySQL-Datenbank.

Mit hsscript können diese Ressourcen wie folgt angelegt werden:

Als Paketadmin xyz00 aufrufen:

hsscript -i

In der HSAdmin-Shell gibt man dann ein:

xyz00@hsadmin> user.add({set:{name:'xyz00-pad', password:'mein-Geheimwort', shell:'/bin/bash'}})
xyz00@hsadmin> domain.add({set:{name:'pad.example.com', user:'xyz00-pad'}})
xyz00@hsadmin> mysqluser.add({set:{name:'xyz00_padusr', password:'anderes-Geheimwort'}})
xyz00@hsadmin> mysqldb.add({set:{name:'xyz00_paddb', owner:'xyz00_padusr'}})
xyz00@hsadmin> bye

Installation

Etherpad benötigt nodejs in einer Version > 10.13. Die Installation erfolgt gemäß der Wiki-Anleitung: NodeJS

Als Paketadmin xyz00 nimmt man mit

sudo -u xyz00-pad -i

die Rechte des Domain-Administrators xyz00-pad für die neue Domain pad.example.com an.

Die Etherpad-Software kann aus dem Git-Repository bei Github ausgecheckt werden:

cd
git clone https://github.com/ether/etherpad-lite.git
cd etherpad-lite/
git tag -l
git checkout tags/1.8.12
./bin/run.sh 

Mit "git checkout tags/1.8.12" wird Release 1.8.12 ausgecheckt, die heute (10.03.2021) aktuelle Version.

Bei der Initialisierung der Anwendung gibt es einige Warnungen, die man ignorieren kann. Wenn die Initialisierung durchgelaufen ist, kann man unter der URL http://xyz00.hostsharing.net:9001/ schon die die Etherpad-Anwendung ohne Datenbank und ohne die gewünschte Domain sehen.

Wir brechen das run.sh-Skript mit Ctrl-c ab.

Konfiguration für Apache und Passenger

Vor der Nutzung von Phusion Passenger bitte unbedingt die dortigen Hinweise zur Nutzung beachten.

Die statischen Dateien der Anwendung werden mit den folgenden Befehlen richtig verlinkt (immer noch als User xyz00-pad):

cd
cd ~/doms/pad.example.com
rm -rf subs/www
rm -rf subs-ssl/www
rm -rf htdocs-ssl
ln -s ~/etherpad-lite/src/static htdocs-ssl

Für die Anwendung legen wir im Verzeichnis ~/doms/pad.example.com/app-ssl/ eine Datei app.js mit dem folgenden Inhalt an:

require('/home/pacs/xyz00/users/pad/etherpad-lite/node_modules/ep_etherpad-lite/node/server.js');
process.chdir('/home/pacs/xyz00/users/pad/etherpad-lite');

Zum Schluß wird in der Datei ~/etherpad-lite/settings.js noch die MySQL-Datenbank konfiguriert. Dazu muss der Teil mit dbType: mysql aktiv (nicht auskommentiert) sein. Etwa wie folgt:

   "dbType" : "mysql",
   "dbSettings" : {
      "user"    : "xyz00_padusr",
      "host"    : "localhost",
      "password": "anderes-Geheimwort",
      "database": "xyz00_paddb",
      "charset" : "utf8mb4",
      "insecureAuth": "true"
    },

Die Einstellungen für den dbType: dirty werden dafür entfernt.

Weiter unten in der Datei kann dann noch ein Admin-User aktiviert werden.

Etherpad sollte nun unter der URL: http://pad.example.com/ erreichbar sein.

Links

• Etherpad Homepage (Englisch)
• Github Repository (Englisch)
• Running Etherpad on Phusion Passenger (Englisch)

---