You can get the latest release from the iiit webpage http://www.iiit.de/english/download/index.html. There you will find source packages and precompiled binary packages.
To use iiitAccessServer you need some additional software packages.
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 and 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.
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
Important: The command SHUTDOWN does work for security reasons only if you have logged-in directly from the server where iiitAccessServer runs and only with the command
telnet localhost <portnummer>.
Otherwise the command will be ignored.
If everything works as described here, you have successfully installed iiitAccessServer. The configuration is documented in the Configuration Guide.
[1] | 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) 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 |