Install imeji under Arch Linux

Werter Leser, diese Dokumentation hilft Entwicklern möglichst schnell unter Arch Linux eine Entwicklungsumgebung einzurichten und einen Buildcycle zu vollziehen. Am Ende läuft Ihre imeji-Instanz auf Ihrem Server. Das Ziel des Autors ist eine Anleitung zu erstellen, die speziell ist und funktioniert. Aus Erfahrung hilft dieser Ansatz mehr als eine generische Anleitung, die schnell den Rahmen sprengt und trotzdem unvollständig ist. Vorbereitung Zunächst müssen das Java Developement Kit und ein Apache Tomcat Applicationserver installiert werden. Im Terminal Ihres Arch Linux Servers tippen Sie:

$ su root
# pacman -S jdk7-openjdk tomcat7

Das System muss noch konfiguriert werden, damit Tomcat beim Booten gestartet wird. Und weil Sie jetzt nicht booten wollen, starten Sie den Tomcat Daemon manuell:

#systemctl enable tomcat7.service
#systemctl start tomcat7.service

Zur Kontrolle müssten Sie nun unter http://127.0.0.1:8080 eine Webseite vorfinden. Der Zugriff auf den Webmanager ist noch eingeschränkt. Um das zu ändern müssen in der Datei /etc/tomcat7/tomcat-users.xml Rollen und Benutzer konfiguriert sein, wie folgt:

<?xml version=’1.0’ encoding=’utf-8’?>
<tomcat-users>
<role rolename="tomcat"/>
<role rolename="manager-gui"/>
<user username="tomcat" password="geheim" roles="tomcat"/>
<user username="manager" password="geheim" roles="manager-gui"/>
</tomcat-users>

Alle Systembenutzer, die Tomcat konfigurieren oder anderweitig damit zu tun haben (dazu zählt auch Ändern der Java-Quellen mit Eclipse) müssen der Systemgruppe tomcat7 angehören:

# gpasswd -a username tomcat7

Nach jeder Konfigurationsänderung müssen Sie den Tomcat Daemon neustarten:

# systemctl restart tomcat7.service
# exit

Nun können Sie http://localhost:8080/manager aufrufen und sich als manager mit Ihrem Passwort in den Webmanager einloggen. Repository klonen Weitere benötigte Werkzeuge sind Git zu Quellcodeverwaltung und Maven zum automatisierten Compilieren der Quellen. Zum Installieren tippe:

$ su root
# pacman -S git maven
# exit

Nun können Sie das auf Github gehostete Repository der imeji- Quellen klonen.

$ cd $HOME
$ git clone https://github.com/imeji-community/imeji.git

Unter ~/imeji finden Sie nun alle Dateien aus denen imeji besteht. Zum Bauen, tippe:

 $ cd $HOME/imeji
 $ mvn package

Beim ersten Ausführen werden automatisch Abhängigkeiten bereitgestellt. Das kann je nach Internetanbindung eine Weile (7 Minuten) dauern. Etwa am Ende der Ausgabetirade sollte [INFO] BUILD SUCCESS stehen. Die erzeugte Datei $HOME/imeji/target/imeji.war können Sie im Tomcat Webmanager deployen. Standardmäßig kann man nur Dateien bis maximal 50MB deployen. Passen Sie die Datei /var/lib/tomcat7/webapps/manager/WEB-INF/web.xml an:

<servlet>
 <servlet-name>HTMLManager</servlet-name>
 [ . . . ]
 <multipart-config>
 <!--150MB max -->
 <max-file-size>157286400</max-file-size>
 <max-request-size>157286400</max-request-size>
 <file-size-threshold>0</file-size-threshold>
 </multipart-config>
 </servlet>

(Danach: Tomcat neustarten!) Aber: Noch geht imeji nicht. Die Properties müssen heruntergeladen, überarbeitet und an Ort und Stelle kopiert werden.

 $ cd $HOME
 $ wget --timestamping '<https://raw.githubusercontent.com/imeji-community/imeji/develop/src/main/resources/imeji.properties>'
 $ mv imeji.properties{.txt,}
 $ edit imeji.properties

  Diese Dateien müssen nach /etc/tomcat7 kopiert werden:

$ su root
# chown root:tomcat7 imeji.properties
# mv imeji.properties /etc/tomcat7/imeji.properties
# exit

Notiz: Unter Arch wird ein symbolischer Link von /usr/share/tomcat7/conf nach /etc/tomcat7 angelegt. Das ist gut, weil es dem FHS2 entspricht. Verzeichnisse anlegen (nach FHS)

$ su root

#mkdir /srv/http/imeji{,/tdb,/files}

#chown -R tomcat7:tomcat7 /srv/http/imeji

#exit

Deployen der Datei imeji.war über den Webmanager funtioniert jetzt. Das Aufrufen von http://127.0.0.1:8080/imeji/ zeigt nun die erstellte imeji-Instanz. Die Admin-Zugangsdaten sind voreingestellt und lauten admin@imeji.org mit dem Passwort admin. Man sollte sich sofort über die Weboberfläche einloggen und die Zugangsdaten ändern! Logs Die Logs finden sich unter /var/log/tomcat7/imeji.log und mit Hilfe des folgenden Befehls:

$ su root

#journalctl /usr/bin/jsvc

#exit