4.4.3 Einrichtung von Agora

Es wird vorausgesetzt, daß unser Beispielprojekt ‚DigitalLibrary’ inhaltlich konfiguriert ist, d.h. es existiert bereits eine Datei ‚DigitalLibrary.war’, die alle projekt-spezifischen Templates und Dokumentstrukturen sowie alle Agora-Klassen vollständig enthält. Die konkrete Verhaltensweise von Agora wird über die Konfigurationsdatei agora-server.xml gesteuert. Also muß agora-server.xml an die aktuellen Rechnerverhältnisse angepaßt werden. Weiterhin ist die Einrichtung des Agora Repository durchzuführen.

Hierzu liefert Agora ein Skript CreateRepository.cmd, das die Datenstruktur des Repository im Dateisystem erzeugt. Das Skript ist vor dem Starten an die jeweiligen Rechner/Projektkonfigurationen anzupassen. Folgende Einträgen in CreateRepository.cmd müssen überprüft werden: - Da das Skript zur Ausführung Java benötigt, muß eine Umgebungsvariable JAVA_HOME gesetzt sein, die den Pfad zur Java-Umgebung enthält. - Setzen des Konfigurationsverzeichnisses für das Agora Repository, z. B.:

set CONFIG_BASE=c:\agora\DigitalLibrary\config

- Setzen Konfigurationsdatei für das Programmlogging, z. B.:

set CONFIG_LOG4j=%CONFIG_BASE%\log4j.xml

- Pfad zum Agora Repository, z. B.:

Set REPOSITORY_DIR=c:\agora\DigitalLibrary\repository

- Setzen der Agora Bibliothek, z. B.:

set AGORA_LIB=%CONFIG_BASE%\agora-all.jar

- Setzen des CLASSPATH, z. B.:

set CLASSPATHX=%AGORA_LIB%

- Setzen der Konfigurationsdatei repository-config.xml, die den Aufbau des Repositorys beschreibt

set CONFIG=%CONFIG_BASE%\repository-config.xml

- Setzen der verwendeten Dokumentstruktur-Datei, z. B. :

set DOCSTRCT=%CONFIG_BASE%\docstrct-DigitalLibrary.xml

- Setzen der Konfigurationsdatei für den Indexaufbau, z. B.:

set INDEX=%CONFIG_BASE%\index-DigitalLibrary.xml

Folgende Schritte ergeben sich zusätzlich:

- Erstellen eines Agora Projektverzeichnis, z. B.:

Windows: C:\agora\DigitalLibrary

Linux: /home/agora/DigitalLibrary - Erstellen von Datenverzeichnissen (für Image– und Dokumentdaten), z. B.:

Windows: C:\agora\DigitalLibrary\images

Windows: C:\agora\DigitalLibrary\docs

Linux: /home/agora/DigitalLibrary/images

Linux: /home/agora/DigitalLibrary/docs - Erstellen eines Importverzeichnisses (als Container/Hotfolder für Dokumente, die zu importieren sind), z. B.:

Windows: C:\agora\DigitalLibrary\import

Linux: /home/agora/DigitalLibrary/import

- Über den Windows Internet Informationsdienst wird ein virtuelles Verzeichnis DigitalLibrary angelegt, das auf C:\agora\DigitalLibrary\ zeigt (das Verzeichnis, in dem die Images liegen). Unter Linux wird ein virtuelles Verzeichnis DigitalLibrary angelegt, das auf /home/agora/DigitalLibrary/ zeigt.

Üblicherweise wird dies in der Alias-Sektion von /etc/httpd/conf/httpd.conf konfiguriert.

Die entsprechende Zeile muß dann lauten:

...
Alias /DigitalLibrary "/home/agora/DigitalLibrary/"
...

Weiter müssen unter Linux folgende Umgebungsvariablen (in .profile) gesetzt sein: CATALINA_HOME wird auf das Tomcat Home-Verzeichnis gesetzt, z.B.:

CATALINA_HOME=/var/tomcat5

JAVA_HOME wird auf das Java Home-Verzeichnis gesetzt, z.B.:

JAVA_HOME=/usr/lib/java

TOMCAT_HOME wird auf das Tomcat Home-Verzeichnis gesetzt, z.B.:

TOMCAT_HOME=/var/tomcat5