Etherpad Installieren: Unterschied zwischen den Versionen
K (Update VHost Config) |
(Version update) |
||
Zeile 25: | Zeile 25: | ||
== Installation == | == Installation == | ||
Etherpad benötigt ''nodejs'' in einer Version > | Etherpad benötigt ''nodejs'' in einer Version > 10.13. Die Installation erfolgt gemäß der Wiki-Anleitung: [[NodeJS]] | ||
Als Paketadmin ''xyz00'' nimmt man mit <pre>sudo -u xyz00-pad -i</pre> die Rechte des Domain-Administrators ''xyz00-pad'' für die neue Domain ''pad.example.com'' an. | Als Paketadmin ''xyz00'' nimmt man mit <pre>sudo -u xyz00-pad -i</pre> die Rechte des Domain-Administrators ''xyz00-pad'' für die neue Domain ''pad.example.com'' an. | ||
Zeile 36: | Zeile 36: | ||
cd etherpad-lite/ | cd etherpad-lite/ | ||
git tag -l | git tag -l | ||
git checkout tags/1. | git checkout tags/1.8.3 | ||
./bin/run.sh | ./bin/run.sh | ||
</pre> | </pre> | ||
Mit "git checkout tags/1. | Mit "git checkout tags/1.8.3" wird Release 1.8.3 ausgecheckt, die heute (02.05.2020) aktuelle Version. | ||
Bei der Initialisierung der Anwendung gibt es einige Warnungen, die man ignorieren kann. Wenn die Initialisierung durchgelaufen ist, kann man | Bei der Initialisierung der Anwendung gibt es einige Warnungen, die man ignorieren kann. Wenn die Initialisierung durchgelaufen ist, kann man |
Version vom 2. Mai 2020, 16:55 Uhr
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.3 ./bin/run.sh
Mit "git checkout tags/1.8.3" wird Release 1.8.3 ausgecheckt, die heute (02.05.2020) 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)