ingenieurbuero fuer innovative informationstechnik

Dipl.-Ing. Joerg Beckmann

Installation

     

Contents

Download iiitAccessServer Prerequisites Building iiitAccessServer Installing iiitAccessServer

Download iiitAccessServer

You can get the latest release from the iiit webpage http://www.iiit.de/download/index_en.html. There you will find source packages and precompiled binary packages.

Prerequisites

To use iiitAccessServer you need some additional software packages.
    JavaTM 2 Platform, Standard Edition, Runtime Environment (JRE), version 1.4.1 or higher by Sun Microsystems, Inc.
    JavaMailTM API Implementation by Sun Microsystems, Inc.
    JavaBeansTM Activation Framework by Sun Microsystems, Inc.
    Log4J by The Apache Jakarta Project
    Xerces2 Java Parser by The Apache XML Project
    MySQL database server and MySQL Connector/J by MySQL AB
    OpenLDAP by The OpenLDAP Foundation
    iiitTookit

If you want to build iiitAccessServer from source you need JavaTM 2 SDK, Standard Edition, version 1.4.1 or higher by Sun Microsystems, Inc. instead of the above mentioned JRE. Additionaly you need Apache Ant by The Apache Jakarta Project

Follow the installation guides published together with each of those packages.

Building iiitAccessServer from source

To build iiitAccessServer from source you have to download the source distribution and unpack it into a directory of your choice. Once you have done this, change into the installation directory and type

    ant install

If all prerequisites are installed correctly this will create an additional directory iiitAccessServer inside the out directory. It contains a sample configuration, a start script aand the Jar file iiitAccessServer.jar.

If you call

    ant dist

instead, you will find archives like the ones you can download from our web site in the directory dist.

Installing iiitAccessServer

Whether you downloaded and unpacked the binary distribution or built it yourself, you should now have a directory named iiitAccessServer. Move or copy this directory together with its content to /usr/local or /opt or wherever you want to install it. Change to the installation directory. In the sub-directory etc you will find the example configuration consisting of the files AccessServer-Simple.xml and expressions-example.properties. Rename or copy them to AccessServer.xml rsp. expressions.properties. The different Java libraries mentioned above as requirements may be added to the CLASSPATH environment variable or you may copy them into the sub-directory lib, where the start-up script run.sh will find them automatically.

To start the iiitAccessServer call the start-up script run.sh. This should give you an output like this:

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>

If you have not changed the configuration, you should now be able to log-in to the iiitAccessServer with the command

    telnet localhost 54321

It should now greet you with something like

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

You may shut the iiitAccessServer down with the command

    SHUTDOWN

Import: The command SHUTDOWN does work for security reasons only if you have logged-in to it directly from the server where it runs and only with the command

    telnet localhost <portnummer>.

Otherwise the command will be ignored.

If anything work as described here, you have successfully installed iiitAccessServer. The configuration is documented in the Configuration Guide.

   
[menu off]