Aus Goobi

Status dieses Artikels
Erstellt für Goobi Version:	1.5.1
Überprüft für Goobi Version:	1.5.1
Anmerkungen:	Dieses Dokumentation ist aktuell

Goobi auf Basis des Quellcodes kompilieren

Inhaltsverzeichnis 1 Voraussetzungen 2 Quellcode herunterladen 3 Konfiguration anpassen 3.1 Konfiguration duplizieren 3.2 Lokale Konfigurationsdateien bearbeiten 4 Goobi kompilieren 4.1 Ant ausführen 5 Goobi per Tomcat-Manager deployen 6 Update 7 Löschen der kompilierten Dateien

Voraussetzungen

• Ant, mindestens Version 1.7 (muss unter SLES 10 separat installiert werden)
• JDK 1.5 nur von Sun (unter SLES 10 sind Umgebungsvariablen einzurichten) siehe das etwas veraltete Beispiel
• Tomcat 5.5 (ist unter SLES 10 als TOMCAT_HOME bei den Umgebungsvariablen einzubinden)
• Java Servlet API (Teil des Tomcats)
• Quellcode (Aus dem Repository)
• Subversion Client (für regelmäßige updates)

Quellcode herunterladen

Quellcodes aus dem Repository auschecken, hier am Beispiel des Göttinger Astes:

svn co https://develop.sub.uni-goettingen.de/repos/goobi/Goobi/trunk/

Warnungen bezüglich des Zertifikats können an dieser Stelle ignoriert werden.

Konfiguration anpassen

Konfiguration duplizieren

Zuerst sollte die Konfiguration der Distribution dupliziert werden, das Build Script erwartet den Namen "config-local".

cp config config-local

Lokale Konfigurationsdateien bearbeiten

Im Ordner "config-local" müssen die folgenden Dateien angepasst werden:

• GoobiConfig.properties - Goobi Konfiguration
• contentServerConfig.xml - Konfiguration des ContentServers2
• hibernate.cfg.xml - Konfiguration der Datenbankanbindung
• log4j.properties - Konfiguration des Loggers

Goobi kompilieren

Ant ausführen

Ant muss den Pfad zur Java Servlet API mitgeteil bekommen, damit der Compiler Zugriff darauf hat.

ant -lib /path/to/servlet-api.jar

Unter SLES 10 findet sich die Datei unter "/usr/share/tomcat5/common/lib/servlet-api.jar".

Alternativ dazu kann eine Datei namens build.properties im selben Verzeichnis angelegt werden. In ihr muss der Pfad zu den Tomcat-Bibliotheken angegeben werden:

tomcat.dir.lib=/usr/share/tomcat5/common/lib

Goobi per Tomcat-Manager deployen

Mit

ant deploy

wird ein Deployment per HTTP gestartet. Dazu müssen in der Datei build.properties oder auch deploy.properties (beide werden zu Beginn geladen) die Zielwerte für den Applikationsserver angegeben werden:

tomcat.manager=http://goobi-host:8080/manager/
tomcat.username=goobi-admin
tomcat.password=***********
tomcat.webpath=/goobi
tomcat.dir.lib=/usr/share/tomcat5/common/lib

Update

Mit Hilfe von Subversion kann jederzeit ein Update auf eine aktuelle Entwicklungsversion

svn up

Löschen der kompilierten Dateien

Es existiert ein Ant Target zu löschen der kompilierten Dateien. Bei Änderungen an der Konfiguration oder einem checkout aus dem Repository sollten die bereite kompilierten Klassen und die WAR Datei gelöscht werden.

ant clean