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.
Für den iiitAccessServer werden zusätzliche Software-Pakete benötigt.
Diejenigen, die den iiitAccessServer selbst aus den Quellen übersetzen wollen, benötigen JavaTM 2 SDK, Standard Edition [1], Version 1.4.1 oder neuer von Sun Microsystems, Inc. [4] anstelle des oben erwähnten JRE.
Zusätzlich wird das Paket Apache Ant [14] von The Apache Ant Project [14] benötigt.
Für die Installation dieser Pakete befolgen Sie bitte die jeweiligen Installationsanleitungen.
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.
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.
[1] | (1, 2) http://java.sun.com/j2se/downloads.html |
[2] | http://java.sun.com/products/javamail/index.html |
[3] | http://java.sun.com/products/javabeans/glasgow/jaf.html |
[4] | (1, 2, 3, 4) http://www.sun.com |
[5] | http://logging.apache.org/log4j |
[6] | http://logging.apache.org |
[7] | http://xml.apache.org/xerces2-j/index.html |
[8] | http://xml.apache.org |
[9] | http://www.mysql.com/downloads/index.html |
[10] | http://www.mysql.com |
[11] | http://www.openldap.org/software/download/ |
[12] | http://www.openldap.org |
[13] | ../iiitToolkit/index.html |
[14] | (1, 2) http://ant.apache.org |