Installation

Download des iiitAccessServer

Die jeweils neueste Version kann von der iiit Web-Site unter http://www.iiit.de/download/index.html herunter geladen werden. Dort befinden sich sowohl Quell-Pakete wie auch fertig übersetzte Binär-Pakete der Software.

Voraussetzungen

Für den iiitAccessServer werden zusätzliche Software-Pakete benötigt.

• Java^TM 2 Platform, Standard Edition, Runtime Environment (JRE), Version 1.4.1 oder neuer von Sun Microsystems, Inc.
• JavaMail^TM API Implementation von Sun Microsystems, Inc.
• JavaBeans^TM Activation Framework von Sun Microsystems, Inc.
• Log4J von Logging Services Project @ Apache
• Xerces2 Java Parser von The Apache XML Project
• MySQL database server und MySQL Connector/J von MySQL AB
• OpenLDAP von The OpenLDAP Foundation
• iiitTookit

Diejenigen, die den iiitAccessServer selbst aus den Quellen übersetzen wollen, benötigen Java^TM 2 SDK, Standard Edition, Version 1.4.1 oder neuer von Sun Microsystems, Inc. anstelle des oben erwähnten JRE.

Zusätzlich wird das Paket Apache Ant von The Apache Ant Project benötigt.

Für die Installation dieser Pakete befolgen Sie bitte die jeweiligen Installationsanleitungen.

Übersetzung des iiitAccessServer aus den Quellen

Für die Übersetzung des iiitAccessServers aus den Quellen muss das Quell-Paket der Software herunter geladen und in einem beliebigen Verzeichnis ausgepackt werden. Danach wechseln Sie in das dabei enstandene Installationverzeichnis und geben das Kommando

ant install

ein.

Wenn alle Voraussetzungen korrekt erfüllt sind, wird dieses Kommando im Unterverzeichnis out ein weiteres Verzeichnis iiitAccessServer mit einer Beispiel-Konfiguration, einem Start-Script und dem Jar-File iiitAccessServer.jar an.

Wenn Sie stattdessen das Kommando

ant dist

benutzen, werden zusätzlich im Verzeichnis dist Archive angelegt, so wie sie auch von unserer Homepage heruntergeladen werden können.

Installation des iiitAccessServer

Unabhängig davon, ob Sie die Binär-Pakete herunter geladen und ausgepackt oder selbst übersetzt haben, sollte Ihnen nun ein Verzeichnis namens iiitAccessServer vorliegen. Verschieben oder kopieren Sie dieses Verzeichnis zusammen mit seinem Inhalt nach /usr/local oder /opt oder wo immer Sie den iiitAccessServer installieren möchten. Wechseln Sie in das Installationsverzeichnis. Im Unterverzeichnis etc befindet sich die Beispiel-Konfiguration in den Dateien AccessServer-Simple.xml und expressions-example.properties. Für den ersten Start reicht es, diese Dateien in AccessServer.xml bzw. expressions.properties umzubenennen. Die verschiedenen Java-Bibliotheken, die oben als Voraussetzungen aufgelistet sind, können Sie entweder von Hand zur CLASSPATH Environment-Variable hinzufügen um sie auch anderen Programmen zugänglich zu machen oder Sie können diese auch einfach in das Unterverzeichnis lib hineinkopieren. Dort findet der Start-Script run.sh sie automatisch.

Zum Starten des iiitAccessServers rufen Sie den Start-Script run.sh auf. Dies sollte eine Ausgabe wie folgende erzeugen:

Searching for <AccessServer.xml> in <.:etc:/usr/local/etc:/etc>
File <AccessServer.xml> found in <etc>
Start reading file <etc/AccessServer.xml>

Finished reading file <etc/AccessServer.xml>.
Logging to file <./accessserver.log>

Sofern Sie die Konfiguration nicht verändert haben, können Sie sich nun über das Kommando

telnet localhost 54321

in den iiitAccessServer einloggen. Er sollte Sie jetzt mit einer Ausgabe wie dieser

Connected to localhost.
Escape character is '^]'.
iiitAccessServer - For help send command "HELP"
OK

begrüßen. Sie können ihn dann mit dem Kommando

SHUTDOWN

wieder beenden.

Wichtig: Das Kommando SHUTDOWN funktioniert aus Sicherheitsgründen nur, wenn Sie sich von dem Rechner aus, auf dem der iiitAccessServer läuft, mit

telnet localhost <portnummer>

anmelden. In allen anderen Fällen wird das Kommando ignoriert.

Wenn bis hier hin alles funktioniert hat, ist der iiitAccessServer erfolgreich installiert. Die weitere Konfiguration wird in der Konfigurationsanleitung erläutert.