Etherpad Installieren: Unterschied zwischen den Versionen
K (Typo) |
K (Version Update) |
||
| (10 dazwischenliegende Versionen von 3 Benutzern werden nicht angezeigt) | |||
| Zeile 25: | Zeile 25: | ||
== Installation == | == Installation == | ||
Als Paketadmin ''xyz00'' nimmt man mit <pre>sudo -u xyz00-pad -i</pre> die Rechte des Domain-Administrators für die neue Domain ''pad.example.com'' an. | 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. | |||
Die Etherpad-Software kann aus dem Git-Repository bei Github ausgecheckt werden: | Die Etherpad-Software kann aus dem Git-Repository bei Github ausgecheckt werden: | ||
| Zeile 33: | Zeile 35: | ||
git clone https://github.com/ether/etherpad-lite.git | git clone https://github.com/ether/etherpad-lite.git | ||
cd etherpad-lite/ | cd etherpad-lite/ | ||
git tag -l | |||
git checkout tags/1.8.12 | |||
./bin/run.sh | ./bin/run.sh | ||
</pre> | </pre> | ||
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 | Bei der Initialisierung der Anwendung gibt es einige Warnungen, die man ignorieren kann. Wenn die Initialisierung durchgelaufen ist, kann man | ||
| Zeile 42: | Zeile 48: | ||
== Konfiguration für Apache und Passenger == | == 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 | Die statischen Dateien der Anwendung werden mit den folgenden Befehlen richtig verlinkt | ||
| Zeile 49: | Zeile 57: | ||
cd | cd | ||
cd ~/doms/pad.example.com | cd ~/doms/pad.example.com | ||
rm -rf | rm -rf subs/www | ||
rm -rf subs-ssl/www | |||
rm -rf htdocs-ssl | rm -rf htdocs-ssl | ||
ln -s ~/etherpad-lite/src/static htdocs-ssl | ln -s ~/etherpad-lite/src/static htdocs-ssl | ||
</pre> | </pre> | ||
Für die Anwendung legen wir | Für die Anwendung legen wir im Verzeichnis ''~/doms/pad.example.com/app-ssl/'' eine Datei app.js mit dem folgenden Inhalt an: | ||
<pre> | <pre> | ||
| Zeile 81: | Zeile 89: | ||
Etherpad sollte nun unter der URL: ''http://pad.example.com/'' erreichbar sein. | Etherpad sollte nun unter der URL: ''http://pad.example.com/'' erreichbar sein. | ||
== Links == | == Links == | ||
Aktuelle Version vom 10. März 2021, 12:37 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.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)