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

Als Paketadmin xyz00 nehmen mit

sudo -u xyz00-pad -i

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

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/
./bin/run.sh 

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

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 htdocs
rm -rf htdocs-ssl
ln -s ~/etherpad-lite/src/static htdocs
ln -s ~/etherpad-lite/src/static htdocs-ssl

Für die Anwendung legen wir in den Verzeichnissen ~/doms/pad.example.com/app/ und ~/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)

---