{"id":1104,"date":"2010-07-19T13:06:29","date_gmt":"2010-07-19T11:06:29","guid":{"rendered":"http:\/\/www.bdjl.de\/localhost\/?p=1104"},"modified":"2010-11-08T14:24:53","modified_gmt":"2010-11-08T13:24:53","slug":"etherpad-2","status":"publish","type":"post","link":"https:\/\/www.bdjl.de\/localhost\/?p=1104","title":{"rendered":"etherpad"},"content":{"rendered":"

Die c’t von heute hat einen Artikel zur Installation von etherpad<\/a> auf debianoiden Linuxen ver\u00f6ffentlicht, den ich gerade in einer VM unter Debian 5 nachzuvollziehen versuche. Der Artikel scheint jedoch f\u00fcr Ubuntu geschrieben worden zu sein. Unter Debian 5 will es wie von der c’t beschrieben einfach nicht klappen – und aus diesem Grund hier eine ver\u00e4nderte und erweiterte Anleitung, die hoffentlich Idioten sicher ist:<\/p>\n

Zuerst kommt die Installation eines Debian5-Minimalsystems dran. Dann als root<\/p>\n

deb http:\/\/apt.etherpad.org all .
\ndeb http:\/\/ftp.de.debian.org\/debian\u00a0 sid main non-free<\/p><\/blockquote>\n

in die \/etc\/apt\/sources.list eintragen. Ein<\/p>\n

apt-get update<\/p><\/blockquote>\n

aktualisiert die Paketliste. Aufpassen: Durch das SID Repo w\u00fcrde ein apt-get dist-upgrade zu einem Wechsel von der stable Version von Debian zu Sid f\u00fchren. Wer das vermeiden will, sollte das Repo f\u00fcr Sid nach Fertigstellung der ehterpad-Installation dann wieder aus der sources.list auskommentieren. Die Fehlermeldungen wegen den evtl. nicht vorhandenen Keys (auf’s Erste) ignorieren. Ein<\/p>\n

apt-get install\u00a0 sun-java6-jdk<\/p><\/blockquote>\n

f\u00fchrt zur Installation der folgenden zus\u00e4tzlichen Pakete:<\/p>\n

avahi-daemon dbus gsfonts gsfonts-x11 java-common libasound2 libavahi-common-data libavahi-common3 libavahi-core7 libc-bin libc6 libc6-i686 libdaemon0 libdbus-1-3 libexpat1 libfontenc1 libfreetype6 libltdl7 libncurses5 libnss-mdns libreadline6 libx11-6 libxcb1 libxfont1 libxi6 libxtst6 locales odbcinst odbcinst1debian2 sun-java6-bin sun-java6-jre unixodbc xfonts-encodings xfonts-utils<\/p><\/blockquote>\n

Insgesamt landen hier rund 75 MB an zus\u00e4tzlichen Daten aus dem Netz auf dem Rechner und brauchen ca. 180 MB an Platz nach der Installation. Wegrennen kann man in dieser Phase nicht, weil (neben einigen anderen notwendigen Userinteraktionen) die Lizenzbedingungen von Sun abgenickt werden m\u00fcssen.<\/p>\n

Ein<\/p>\n

java -version<\/p><\/blockquote>\n

sollte die folgende Ausgabe bringen:<\/p>\n

java version „1.6.0_20“
\nJava(TM) SE Runtime Environment (build 1.6.0_20-b02)
\nJava HotSpot(TM) Client VM (build 16.3-b01, mixed mode, sharing)<\/p><\/blockquote>\n

Wenn nicht, dann ist die Sun Java VM mit dem folgenden Befehl als Default einzurichten:<\/p>\n

update-alternatives –config java<\/p><\/blockquote>\n

Es folgt die Installation des mysql Servers sowie der Verbindungssoftware zwischen Java und dem Datenbankserver. Ich zieh mir hier auch gleich noch phpmyadmin und einen Apachen:<\/p>\n

apt-get install scala mysql-server libmysql-java mercurial phpmyadmin apache2<\/p><\/blockquote>\n

Debian zieht sich nun<\/p>\n

apache2-mpm-prefork apache2-utils apache2.2-bin apache2.2-common dbconfig-common fontconfig-config javascript-common libapache2-mod-php5 libapr1 libaprutil1 libaprutil1-dbd-sqlite3 libaprutil1-ldap libdb4.7 libdb4.8 libdbd-mysql-perl libdbi-perl libfontconfig1 libgd2-xpm libgssapi-krb5-2 libhtml-template-perl libjpeg62 libjs-mootools libk5crypto3 libkrb5-3 libkrb5support0 libmcrypt4 libmysqlclient16 libnet-daemon-perl libonig2 libpcre3 libplrpc-perl libpng12-0 libqdbm14 libsqlite3-0 libssl0.9.8 libt1-5 libuuid1 libxml2 libxpm4 make mercurial-common mysql-client-5.1 mysql-common mysql-server-5.1 mysql-server-core-5.1 openssl perl perl-base perl-modules php5-cli php5-common php5-gd php5-mcrypt php5-mysql php5-suhosin psmisc python-support scala-library ssl-cert wwwconfig-common<\/p><\/blockquote>\n

und l\u00e4dt hierzu 67 MB aus dem Netz. Nach der Installation ist der Plattenplatz wieder um 130 MB kleiner.<\/p>\n

Bei der Installation ist dann das mysql root-Passwort anzugeben und dieser f\u00fcr den Apachen zu konfigurieren (ist nur ein Klick in einem Auswahlfenster). Weiter ist der administrative Benutzer f\u00fcr phpmyadmin anzugeben und ein Passwort zu setzen.<\/p>\n

Jetzt kann man im Browser durch Aufruf der IP \/ Domain des Servers mal nachsehen, ob alles geklappt hat und der Server sowie phpmyadmin erreichbar sind.<\/p>\n

In die Datei \/etc\/profile wird nun der folgende Code hinzugef\u00fcgt, damit alle Komponenten sich auch gegenseitig finden k\u00f6nnen:<\/p>\n

export JAVA_HOME=“\/usr\/lib\/jvm\/java-6-sun“
\nexport SCALA_HOME=“\/usr\/share\/java“
\nexport JAVA=“\/usr\/bin\/java“
\nexport SCALA=“\/usr\/bin\/scala“
\nexport PATH=“\/usr\/bin:\/usr\/bin:\/usr\/local\/mysql\/bin:$PATH“
\nexport MYSQL_CONNECTOR_JAR=“\/usr\/share\/java\/mysql-connector-java-5.1.10.jar“
\nexport JAVA_HOME SCALA_HOME JAVA SCALA MYSQL_CONNECTOR_JAR PATH<\/p><\/blockquote>\n

Ein<\/p>\n

echo $PATH<\/p><\/blockquote>\n

zeigt, ob es mit den Exporten klappt. Wenn nicht, dann entweder „sourcen“ oder ab- und wieder anmelden und erneut \u00fcberpr\u00fcfen.<\/p>\n

Ein<\/p>\n

apt-get install etherpad<\/p><\/blockquote>\n

zieht die notwendigen Abh\u00e4ngigkeiten mit sich. Man sollte hier aber nicht wie gewohnt ein paar Mal [Enter] dr\u00fccken, sondern beachten, dass auf Grund der fehlenden Keys f\u00fcr die neu hinzugef\u00fcgten Repos die Vorauswahl von Debian bei der R\u00fcckfrage, ob man nicht vertrauensw\u00fcrdige Pakete einspielen will, auf Nein steht. Das sieht so aus:<\/p>\n

WARNUNG: Die folgenden Pakete k\u00f6nnen nicht authentifiziert werden!
\netherpad
\nDiese Pakete ohne \u00dcberpr\u00fcfung installieren [j\/N]? j<\/p><\/blockquote>\n

Rund 30 MB werden aus dem Netz geholt, die nach der Installation weitere 44 MB belegen werden. W\u00e4hrend der Installation sind dann wieder das mysql root Passwort anzugeben (damit etherpad seine Datenbank anlegen kann). Au\u00dferdem ist der administrative Benutzer f\u00fcr Etherpad anzugeben und auch die Domain, unter der etherpad zu erreichen sein soll. Der Eintrag localhost ist hier entsprechend zu erg\u00e4nzen.<\/p>\n

In der Datei<\/p>\n

\/usr\/share\/etherpad\/etherpad\/bin\/run-local.sh<\/p><\/blockquote>\n

sind ist noch eine Anpassungen n\u00f6tig: Ziemlich weit oben in diesem Startskript steht<\/p>\n

MXRAM=“1G“<\/p><\/blockquote>\n

Das ist f\u00fcr die ersten Tests ein wenig viel, schreibt die c’t, und meint, der folgende Eintrag w\u00fcrde auch reichen:<\/p>\n

MXRAM=“128m“<\/p><\/blockquote>\n

Hervorzuheben ist, dass hier nicht 128MB oder 128M stehen darf, da sonst ein Syntaxfehler moniert wird. In vielen Anleitungen im Netz ist das aber der Fall. Komisch.<\/p>\n

Die w\u00e4hrend der Installation gemachten Angaben sind dann hier<\/p>\n

\/etc\/etherpad\/etherpad.local.properties<\/p><\/blockquote>\n

zu finden und k\u00f6nnen falls n\u00f6tig angepasst werden. Ich habe am Ende noch die Zeile<\/p>\n

etherpad.skipHostnameCheck = true<\/p><\/blockquote>\n

eingef\u00fcgt, um sp\u00e4ter weniger Probleme zu bekommen. Hier besteht aber auch die M\u00f6glichkeit, den etherpad Server auf HTTPS umzubiegen. Gelogt wird im default nach<\/p>\n

\/var\/log\/etherpad<\/p><\/blockquote>\n

Da das Startskript in \/etc\/init.d\/etherpad extrem schweigsam ist, empfiehlt sich f\u00fcr den ersten Start die Nutzung von run-local.sh im oben angegebenen Verzeichnis.<\/p>\n

root@debian5:\/usr\/share\/etherpad\/etherpad# .\/bin\/run-local.sh<\/p><\/blockquote>\n

Wichtig ist hier, dass der etherpad Server wirklich aus dem Verzeichnis \/usr\/share\/etherpad\/etherpad heraus gestartet wird, sonst erh\u00e4lt man die Fehlermeldung<\/p>\n

Using config file: .\/etc\/etherpad.localdev-default.properties
\nException in thread „main“ java.lang.NoClassDefFoundError: net\/appjet\/oui\/main
\nCaused by: java.lang.ClassNotFoundException: net.appjet.oui.main
\nat java.net.URLClassLoader$1.run(URLClassLoader.java:202)
\nat java.security.AccessController.doPrivileged(Native Method)
\nat java.net.URLClassLoader.findClass(URLClassLoader.java:190)
\nat java.lang.ClassLoader.loadClass(ClassLoader.java:307)
\nat sun.misc.Launcher$AppClassLoader.loadClass(Launcher.java:301)
\nat java.lang.ClassLoader.loadClass(ClassLoader.java:248)
\nHeap
\ndef new generation\u00a0\u00a0 total 14784K, used 263K [0x9f880000, 0xa0880000, 0xa0880000)
\neden space 13184K,\u00a0\u00a0 2% used [0x9f880000, 0x9f8c1ec8, 0xa0560000)
\nfrom space 1600K,\u00a0\u00a0 0% used [0xa0560000, 0xa0560000, 0xa06f0000)
\nto\u00a0\u00a0 space 1600K,\u00a0\u00a0 0% used [0xa06f0000, 0xa06f0000, 0xa0880000)
\nconcurrent mark-sweep generation total 245760K, used 0K [0xa0880000, 0xaf880000, 0xaf880000)
\nconcurrent-mark-sweep perm gen total 16384K, used 1567K [0xaf880000, 0xb0880000, 0xb3880000)
\nCould not find the main class: net.appjet.oui.main.\u00a0 Program will exit.<\/p><\/blockquote>\n

Jetzt kann etherpad auch auf der Shell mit dem Browser links2 erreicht werden:<\/p>\n

links2 http:\/\/localhost:9000\/<\/p><\/blockquote>\n

Damit der Server auch \u00fcber Port 80 und nicht nur lokal zu benutzen ist, passen wir den Apache an.<\/p>\n

a2enmod proxy_http
\n\/etc\/init.d\/apache2 restart<\/p><\/blockquote>\n

Der folgende Code kommt in die Apache Konfigurationsdatei:<\/p>\n

<IfModule mod_proxy_http.c>
\nProxyPass\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 \/\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 http:\/\/localhost:9000\/
\nProxyPassReverse\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 \/\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 http:\/\/localhost:9000\/
\nProxyPreserveHost\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 on
\n<Proxy http:\/\/localhost:9000\/>
\nOrder Allow,Deny
\nAllow from all
\n<\/Proxy>
\n<\/IfModule><\/p><\/blockquote>\n

der daraufhin einen restart braucht:<\/p>\n

\/etc\/init.d\/apache2 restart<\/p><\/blockquote>\n

Wenn man dann immer bei einer komischen Seite mit dem Namen „false“ landet, liegt es an der Konfiguration von etherpad. Ein Eintrag der IP des Servers hinter<\/p>\n

topdomains =<\/p><\/blockquote>\n

in<\/p>\n

\/etc\/etherpad\/etherpad.local.properties<\/p><\/blockquote>\n

und nachfolgendem Neustart von etherpad und Apache erledigt das Problem.<\/p>\n

Und nach dem vielen Text, hier dann endlich das Ergebnis mit Bild:<\/p>\n

\"\"<\/a><\/p>\n

Ich muss schon sagen: Die Herren Jo Bager und Alvar Freude machen es sich in der c’t doch ein wenig einfach \ud83d\ude42 Ohne meinen Basteltrieb h\u00e4tte ich z\u00fcgig wieder aufgegeben.<\/p>\n

Sicherheitstechnisch ist der etherpad-Server, den ich hier beschreibe, nicht eine Bohne wert – aber f\u00fcr das interne Netz m\u00fcsste es reichen. Hoffentlich. Sobald ich das Ding dann in meiner Schule am laufen habe, werde ich die Konsequenzen ja miterleben und auch mittragen. F\u00fcr einen solchen Einsatzzweck sollte man dann screen<\/a> f\u00fcr den Start im Hintergrund nutzen – oder mit nohup<\/a> arbeiten, vor allem aber die Namensaufl\u00f6sung in den Griff bekommen und so evtl. um den Apache-Proxy rumkommen. Ob man hierzu etherpad aus den Quellen selbst kompilieren muss – das will ich heute nach dem ganzen Gefrickel gar nicht wissen.<\/p>\n

Quellen, Ideen und vor allem Probleml\u00f6sungen gibt es hier:<\/p>\n

http:\/\/oceanobservatories.org\/spaces\/display\/~gadavis\/Etherpad+Migration<\/a><\/p>\n

http:\/\/mclear.co.uk\/2010\/03\/10\/installing-etherpad-on-debian\/<\/a><\/p>\n

Diesen Text habe ich auch – etwas gegl\u00e4ttet – auf dem LFB ver\u00f6ffentlicht: http:\/\/lehrerfortbildung-bw.de\/werkstatt\/sonstige\/txtimnetz\/1_ethpad.htm<\/a><\/p>\n

Siehe hierzu auch: http:\/\/www.bdjl.de\/localhost\/?p=1489<\/a> (Update auf etherpad 1.1)<\/p>\n","protected":false},"excerpt":{"rendered":"

Die c’t von heute hat einen Artikel zur Installation von etherpad auf debianoiden Linuxen ver\u00f6ffentlicht, den ich gerade in einer VM unter Debian 5 nachzuvollziehen versuche. Der Artikel scheint jedoch f\u00fcr Ubuntu geschrieben worden zu sein. Unter Debian 5 will es wie von der c’t beschrieben einfach nicht klappen – und aus diesem Grund hier […]<\/p>\n","protected":false},"author":2,"featured_media":0,"comment_status":"open","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[9,5,10],"tags":[20],"class_list":["post-1104","post","type-post","status-publish","format-standard","hentry","category-lfb","category-linux","category-schule","tag-etherpad"],"_links":{"self":[{"href":"https:\/\/www.bdjl.de\/localhost\/index.php?rest_route=\/wp\/v2\/posts\/1104","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/www.bdjl.de\/localhost\/index.php?rest_route=\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/www.bdjl.de\/localhost\/index.php?rest_route=\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/www.bdjl.de\/localhost\/index.php?rest_route=\/wp\/v2\/users\/2"}],"replies":[{"embeddable":true,"href":"https:\/\/www.bdjl.de\/localhost\/index.php?rest_route=%2Fwp%2Fv2%2Fcomments&post=1104"}],"version-history":[{"count":43,"href":"https:\/\/www.bdjl.de\/localhost\/index.php?rest_route=\/wp\/v2\/posts\/1104\/revisions"}],"predecessor-version":[{"id":1492,"href":"https:\/\/www.bdjl.de\/localhost\/index.php?rest_route=\/wp\/v2\/posts\/1104\/revisions\/1492"}],"wp:attachment":[{"href":"https:\/\/www.bdjl.de\/localhost\/index.php?rest_route=%2Fwp%2Fv2%2Fmedia&parent=1104"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/www.bdjl.de\/localhost\/index.php?rest_route=%2Fwp%2Fv2%2Fcategories&post=1104"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/www.bdjl.de\/localhost\/index.php?rest_route=%2Fwp%2Fv2%2Ftags&post=1104"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}