Etherpad: Unterschied zwischen den Versionen
Keine Bearbeitungszusammenfassung |
|||
| (5 dazwischenliegende Versionen von 4 Benutzern werden nicht angezeigt) | |||
| Zeile 2: | Zeile 2: | ||
Er ist ohne Anmeldung zu erreichen unter https://ep.mafiasi.de | Er ist ohne Anmeldung zu erreichen unter https://ep.mafiasi.de | ||
Über https://mafiasi.de/etherpad lassen sich geschützte Pads für Gruppen anlegen. | |||
Inzwischen wurde die Instanz auf [https://github.com/ether/etherpad-lite Etherpad-Lite] migriert. | Inzwischen wurde die Instanz auf [https://github.com/ether/etherpad-lite Etherpad-Lite] migriert. | ||
Die Wiki-Seite zur alten Instanz lässt sich unter [[Etherpad (alt)]] finden. | Die Wiki-Seite zur alten Instanz lässt sich unter [[Etherpad (alt)]] finden. | ||
Eine Alternative ist Gobby, | Eine Alternative ist Gobby, das richtige GTK+ Widget anbietet und sich somit intuitiver und sinnvoller bedienen läßt. Leider bieten wir noch keinen Gobby-Service an. Wenn du Lust hast, das zu bauen, wende dich an ag-server@. | ||
== Gespeicherte Daten == | == Gespeicherte Daten == | ||
| Zeile 14: | Zeile 16: | ||
Alle über Etherpad eingegebenen Daten werden derzeit unbefristet gespeichert. Dies betrifft: | Alle über Etherpad eingegebenen Daten werden derzeit unbefristet gespeichert. Dies betrifft: | ||
* | * das Dokument selbst, | ||
* | * die Historie des Dokuments, | ||
* | * das Chatprotokoll. | ||
=== | === Nginx === | ||
Da die Verbindungen zum Etherpad über den | Da die Verbindungen zum Etherpad über den Nginx geschleift werden, loggt dieser zudem die Verbindungen mit den folgenden Informationen: | ||
* Hostname/IP-Adresse des Clients | * Hostname/IP-Adresse des Clients, | ||
* Zeitpunkt des Zugriffs | * Zeitpunkt des Zugriffs, | ||
* Informationen des Browsers des Clients | * Informationen des Browsers des Clients, | ||
* | * den Dokumentennamen eines Etherpads (GET-Parameter). | ||
Diese Informationen werden | Diese Informationen werden nach drei Wochen gelöscht. | ||
== ToDos == | == ToDos == | ||
Es | Es wäre auch toll, wenn der Benutzer sich eine Gobby-Instanz klicken könnte. Potentielle Probleme sind die Firewall (man könnte das auf der Hetzner Maschine laufen lassen) und verwaiste Sessions (könnte evtl. durch eine Art Counter implementiert werden, i.e. keine Änderungen mehr seit >7 Tagen: Session beenden. Idealerweise wieder herstellbar machen). | ||
== Interna == | == Interna == | ||
[https://github.com/ether/etherpad-lite Etherpad-lite] ist eine JavaScript-Neuimplementation (über [http://nodejs.org/ nodejs]) des in Java geschriebenen Etherpads und ist daher deutlich weniger | [https://github.com/ether/etherpad-lite Etherpad-lite] ist eine JavaScript-Neuimplementation (über [http://nodejs.org/ nodejs]) des in Java geschriebenen Etherpads und ist daher deutlich weniger ressourcenhungrig. | ||
Die Instanz läuft auf dem Fachschaftsserver im RZ des Informatikums. | Die Instanz läuft auf dem Fachschaftsserver im RZ des Informatikums. | ||
Wir benutzen direkt die Version aus dem git, welche in <tt>/var/lib/etherpad-lite/</tt> liegt. Sie wird ab und zu von | Wir benutzen direkt die Version aus dem git, welche in <tt>/var/lib/etherpad-lite/</tt> liegt. Sie wird ab und zu von 0rokita auf den neuesten Stand gebracht. Die Abhängigkeit [http://nodejs.org/ nodejs] wurde manuell kompiliert und paketiert und liegt derzeit in Version 0.6.4 vor. Die Einrichtung folgte generell der offiziellen [https://github.com/ether/etherpad-lite Installationsanleitung]. | ||
Für das Setup werden Einstellungen für diverse Komponenten benötigt. Dazu gehört Etherpad-lite | Für das Setup werden Einstellungen für diverse Komponenten benötigt. Dazu gehört Etherpad-lite selbst, Postgres, Nginx, ein Init-Skript und eine Logrotate-Konfiguration. | ||
=== Etherpad-lite === | === Etherpad-lite === | ||
Etherpad-lite wird über <tt>/var/lib/etherpad-lite/etherpad-lite/settings.json</tt> konfiguriert. In der derzeitigen Konfiguration lauscht der Daemon lokal auf Port <tt>9001</tt> und benutzt eine | Etherpad-lite wird über <tt>/var/lib/etherpad-lite/etherpad-lite/settings.json</tt> konfiguriert. In der derzeitigen Konfiguration lauscht der Daemon lokal auf Port <tt>9001</tt> und benutzt eine Postgres-Datenbank für die Persistierung. Für Etherpad-lite wurde ein Systembenutzer angelegt, der sich nicht eigenständig einloggen darf. | ||
=== | === Postgres === | ||
Die Datenbank heißt <tt> | Die Datenbank heißt <tt>etherpad</tt>. Die Benutzerdaten stehen in <tt>/var/lib/etherpad-lite/etherpad-lite/settings.json</tt>. | ||
=== | === Nginx === | ||
Der lokal-lauschende Daemon | Der lokal-lauschende Daemon ist über Nginx als Reverse Proxy von außen erreichbar. Die relevanten Konfigurationsdateien sind: | ||
* <tt>/etc/ | * <tt>/etc/ningx/sites-aviable/ep.mafiasi.de</tt> | ||
=== Init-Skript === | === Init-Skript === | ||
| Zeile 68: | Zeile 65: | ||
=== Logrotate === | === Logrotate === | ||
Etherpad-lite loggt nach <tt>/var/log/etherpad-lite/etherpad-lite.log</tt>. Damit dieser Log nicht vollläuft wacht Logrotate über diesen Log mit der Konfiguration aus <tt>/etc/logrotate.d/etherpad-lite</tt>. | Etherpad-lite loggt nach <tt>/var/log/etherpad-lite/etherpad-lite.log</tt>. Damit dieser Log nicht vollläuft, wacht Logrotate über diesen Log mit der Konfiguration aus <tt>/etc/logrotate.d/etherpad-lite</tt>. | ||
Aktuelle Version vom 3. Februar 2017, 09:48 Uhr
Einer unserer Dienste ist Etherpad, ein kollaborativer Editor im Webbrowser.
Er ist ohne Anmeldung zu erreichen unter https://ep.mafiasi.de
Über https://mafiasi.de/etherpad lassen sich geschützte Pads für Gruppen anlegen.
Inzwischen wurde die Instanz auf Etherpad-Lite migriert. Die Wiki-Seite zur alten Instanz lässt sich unter Etherpad (alt) finden.
Eine Alternative ist Gobby, das richtige GTK+ Widget anbietet und sich somit intuitiver und sinnvoller bedienen läßt. Leider bieten wir noch keinen Gobby-Service an. Wenn du Lust hast, das zu bauen, wende dich an ag-server@.
Gespeicherte Daten[Bearbeiten]
Etherpad[Bearbeiten]
Alle über Etherpad eingegebenen Daten werden derzeit unbefristet gespeichert. Dies betrifft:
- das Dokument selbst,
- die Historie des Dokuments,
- das Chatprotokoll.
Nginx[Bearbeiten]
Da die Verbindungen zum Etherpad über den Nginx geschleift werden, loggt dieser zudem die Verbindungen mit den folgenden Informationen:
- Hostname/IP-Adresse des Clients,
- Zeitpunkt des Zugriffs,
- Informationen des Browsers des Clients,
- den Dokumentennamen eines Etherpads (GET-Parameter).
Diese Informationen werden nach drei Wochen gelöscht.
ToDos[Bearbeiten]
Es wäre auch toll, wenn der Benutzer sich eine Gobby-Instanz klicken könnte. Potentielle Probleme sind die Firewall (man könnte das auf der Hetzner Maschine laufen lassen) und verwaiste Sessions (könnte evtl. durch eine Art Counter implementiert werden, i.e. keine Änderungen mehr seit >7 Tagen: Session beenden. Idealerweise wieder herstellbar machen).
Interna[Bearbeiten]
Etherpad-lite ist eine JavaScript-Neuimplementation (über nodejs) des in Java geschriebenen Etherpads und ist daher deutlich weniger ressourcenhungrig.
Die Instanz läuft auf dem Fachschaftsserver im RZ des Informatikums.
Wir benutzen direkt die Version aus dem git, welche in /var/lib/etherpad-lite/ liegt. Sie wird ab und zu von 0rokita auf den neuesten Stand gebracht. Die Abhängigkeit nodejs wurde manuell kompiliert und paketiert und liegt derzeit in Version 0.6.4 vor. Die Einrichtung folgte generell der offiziellen Installationsanleitung.
Für das Setup werden Einstellungen für diverse Komponenten benötigt. Dazu gehört Etherpad-lite selbst, Postgres, Nginx, ein Init-Skript und eine Logrotate-Konfiguration.
Etherpad-lite[Bearbeiten]
Etherpad-lite wird über /var/lib/etherpad-lite/etherpad-lite/settings.json konfiguriert. In der derzeitigen Konfiguration lauscht der Daemon lokal auf Port 9001 und benutzt eine Postgres-Datenbank für die Persistierung. Für Etherpad-lite wurde ein Systembenutzer angelegt, der sich nicht eigenständig einloggen darf.
Postgres[Bearbeiten]
Die Datenbank heißt etherpad. Die Benutzerdaten stehen in /var/lib/etherpad-lite/etherpad-lite/settings.json.
Nginx[Bearbeiten]
Der lokal-lauschende Daemon ist über Nginx als Reverse Proxy von außen erreichbar. Die relevanten Konfigurationsdateien sind:
- /etc/ningx/sites-aviable/ep.mafiasi.de
Init-Skript[Bearbeiten]
Der Daemon wird über das Init-Skript /etc/init.d/etherpad-lite verwaltet. Darüber wird Etherpad-lite auch beim Systemstart mitgestartet.
Logrotate[Bearbeiten]
Etherpad-lite loggt nach /var/log/etherpad-lite/etherpad-lite.log. Damit dieser Log nicht vollläuft, wacht Logrotate über diesen Log mit der Konfiguration aus /etc/logrotate.d/etherpad-lite.