Allgemein

Goobi nutzt zum Speichern von Informationen eine Datenbank. Hierfür wird grundsätzlich MySQL bevorzugt. Diese Datenbankengine wird vorzugsweise aus den Standardrepositories des Betriebssystems in der jeweils letzten stabilen Version installiert.

Beispiel: Ubuntu Linux 14.04 LTS

MySQL wird unter Ubuntu Linux 14.04 LTS aus den Standard Repositories mit dem folgenden Befehl installiert:

Der Dienst kann mit diesen beiden Befehlen gestoppt und gestartet werden:

Die Konfigurationsdateien für MySQL befinden sich im folgenden Pfad:

Für den Betrieb von Goobi werden verschiedene Dienste benötigt. Diese werden auf den folgenden Seiten detailliert beschrieben.

Allgemeines

Goobi verwendet Samba, um den Nutzern Verzeichnisfreigaben zum Lesen und Schreiben der Bilddaten zur Verfügung zu stellen. Die Installation von Samba sollte aus den Standardrepositories des Betriebssystems in der jeweils letzten stabilen Version erfolgen.

Beispielinstallation unter Ubuntu Linux 14.04 LTS

Samba wird unter Ubuntu Linux 14.04 LTS aus den Standardrepositories mit dem folgenden Befehl installiert:

sudo aptitude install samba

Der Dienst kann mit den folgenden beiden Befehlen gestoppt und gestartet werden:

service smbd stop
service smbd start
service nmbd stop
service nmbd start

Die Konfigurationsdateien befinden sich unter diesem Pfad:

/etc/samba/

Zugriff mittels Windows 7 und neueren Versionen

Unter Windows 7 sowie den nachfolgenden Versionen kann das Verzeichnis als Netzlaufwerk eingebunden werden. Hierzu erfolgt die Einrichtung mittels Klick auf Start und Computer und anschließend mit einem Rechtsklick auf Netzwerk und der Wahl von Netzlaufwerk verbinden.

Im Dialogfenster kann nun ein freier Laufwerksbuchstabe zugeordnet werden. Als Ordner erfolgt die Eingabe in der Form SERVERNAME\USERNAME, wobei USERNAME für den Goobi Benutzernamen steht. Entsprechen die Anmeldedaten für Goobi nicht denen des Windows PCs, so ist zusätzlich Verbindung mit anderen Anmeldeinformationen herstellen auszuwählen.

Gegebenenfalls müssen im nächsten Schritt Nutzername und Passwort eingegeben werden. Danach steht das Netzlaufwerk unter dem gewählten Laufwerksbuchstaben zur Verfügung.

Zugriff mittels Goobi Mount Tool

Das Goobi Mount Tool ist eine alternative Methode zum Verbinden der Goobi Freigaben als Netzlaufwerk.

Die Konfiguration des Goobi Mount Tools erfolgt über die Datei config.properties im selben Verzeichnis wie GoobiMountTool.exe.

drive_letter=G
ip_address=192.168.100.1

Der Parameter drive_letter definiert hierbei den Laufwerksbuchstaben, unter dem das Netzlaufwerk eingebunden wird. ip_address bezeichnet die IP-Adresse des Goobi Servers, welcher die Netzlaufwerke zur Verfügung stellt.

Ist die Konfiguration korrekt erfolgt, so kann das Goobi Mount Tool direkt aufgerufen werden. Es erfordert im Weiteren nur noch die Eingabe der Goobi Anmeldeinformationen (Benutzername und Passwort).

Nach Auswahl von Verbinden steht das Netzlaufwerk unter dem konfigurierten Laufwerksbuchstaben zur Verfügung.

Allgemein

Goobi ist eine webbasierte Java Applikation. Damit diese im Webbrowser aufrufbar ist, muss der Java Code übersetzt werden. Hierfür ist ein Servlet Container zuständig. Beispiele für Servlet Container sind:

Üblicherweise wird in einem Apache Tomcat installiert. Dieser wird aus den Standardrepositories des Betriebssystems installiert, sofern diese die Version 7 enthalten. Ist das nicht der Fall, wird der Apache Tomcat von Hand installiert und gepflegt.

Beispiel: Ubuntu Linux 14.04 LTS

Apache Tomcat in der Version 7 wird unter Ubuntu Linux 14.04 LTS aus den Standardrepositories mit dem folgenden Befehl installiert:

sudo aptitude install tomcat7

Der Dienst kann mit diesen beiden Befehlen gestoppt und gestartet werden:

service tomcat7 stop
service tomcat7 start

Die Konfigurationsdateien befinden sich unter:

/etc/tomcat7/
/etc/default/tomcat7/

Um Goobi zu installieren, muss die Datei goobi.war in den webapps-Ordner des Tomcat gelegt werden. Die Datei goobi.war wird automatisch entpackt. Der webapps-Ordner befindet sich unter folgendem Pfad:

/var/lib/tomcat7/webapps/

Allgemeines

Goobi verwendet in der Regel einen LDAP Server zur Authentifizierung der Benutzer. Hierdurch ist es möglich, sich mit dem selben Benutzernamen und Passwort wie in Goobi auch mit dem bereitgestellten Netzlaufwerk zu verbinden. In der Konfigurationsdatei goobi_config.properties wird einerseits angegeben, ob LDAP grundsätzlich von Goobi verwendet werden soll, andererseits wird dort auch der verwendete Truststore konfiguriert. Alle weiteren Einstellungen zu LDAP-Verbindungen und -Benutzergruppen werden im Administrationsbereich in der Benutzeroberfläche vorgenommen.

Der LDAP Server sollte über die Schemata COSINE, inetOrgPerson, NIS und SAMBA verfügen.

Konfiguration in der Datei goobi_config.properties

In der Datei goobi_config.properties stehen die folgenden Einstellungen für LDAP und den Truststore zur Verfügung:

Hinweis: In früheren Goobi-Versionen gab es an dieser Stelle die Einstellungen ldap_keystore und ldap_keystore_password. Diese wurden umbenannt, da der Keystore auch für andere Zwecke verwendet werden kann. Diese Einstellungen werden nicht mehr unterstützt.

Hinweis: Gelegentlich tauchen in älteren Konfigurationsdateien die falsch überlieferten Einstellungen ldap_truststore und ldap_truststore_password auf. Diese Einstellungen existieren in Goobi nicht und werden entsprechend nicht unterstützt.

Die Konfiguration innerhalb der Konfigurationsdatei goobi_config.properties bei Verwendung eines lokalen LDAP Servers kann zum Beispiel wie folgt aussehen:

# -----------------------------------
# ldap
# -----------------------------------

# Use LDAP server for authentication
ldap_use=true

# -----------------------------------
# truststore
# -----------------------------------

# Keystore for LDAP and other services
# There is no default value, but the truststore can look like this example:
# /opt/digiverso/goobi/scripts/mykeystore.ks
#truststore=
#truststore_password=

Konfiguration in Goobi

LDAP-Gruppen können in Goobi im Bereich Administration -> Authentifizierung eingerichtet werden. Es wird zunächst eine Liste mit bereits eingerichteten Authentifizierungsoptionen angezeigt. Um eine LDAP-Gruppe einzurichten, muss eine neue Authentifizierung angelegt werden.

Aktuell stehen drei Authentifizierungsarten zur Verfügung. Bei allen muss mindestens ein Name, ein Typ und ein Login-Shell-Befehl ausgewählt werden.

Wird als Typ LDAP ausgewählt, so stehen einige weitere Optionen zur Verfügung. Außerdem stehen für LDAP insgesamt drei Tabs (Allgemein, Details und Authentifizierung) zur Verfügung.

Auf der Seite Allgemein werden grundlegende Einstellungen zur LDAP-Gruppe vorgenommen, wie zum Beispiel die URL des LDAP-Servers, der User DN (distinguishing name) und Samba IDs. Das Feld User DN wird für das Mapping von der Nutzeridentifikation in der Goobi Datenbank zur Nutzeridentifikation in der LDAP-Gruppe verwendet. Der Platzhalter {login} repräsentiert dabei den Login-Namen eines Benutzers und muss angegeben werden, damit Goobi später für jeden neuen Goobi-Account auch einen namentlich angepassten LDAP-Account anlegen kann.

Auf der Seite Details werden viele weitere Details zur LDAP-Gruppe eingestellt.

Auf der Seite Authentifizierung werden technische Details zur Authentifizierung bei dem im Allgemein-Tab eingerichteten LDAP-Service angegeben. Diese Seite beinhaltet einige Einstellungen, die früher nur einmalig in der Konfigurationsdatei goobi_config.properties vorgenommen werden konnten und können nun für diese spezielle LDAP-Authentifizierung angegeben werden.

Konfiguration im Betriebssystem

Neben den Goobi-spezifischen LDAP-Einstellungen ist weiterhin sicherzustellen, dass auch dem Betriebssystem die LDAP-Nutzer bekannt sind. Hierzu ist die korrekte Angabe der LDAP-Informationen insbesondere in den folgenden Dateien notwendig:

/etc/ldap/ldap.conf
/etc/ldap.conf
/etc/nsswitch.conf
/etc/pam.d/*

Die Verwendung des LDAP-Servers muss für SAMBA aktiviert sein. Seit Ubuntu 14.04 LTS ist dies standardmäßig voreingestellt.