Installation instructions for the DLESE OAI software v2.0.9.3. To install and run the DLESE OAI software you must have the following: 1. oai.war - the DLESE OAI software. 2. A servlet container such as Tomcat to run the OAI software. 3. Java2 platform v1.4 or later. Note that the IBM Java2 package has been shown to be considerably faster than the Sun Java2 package for search operations in this software when running on Linux. The following example shows how to install and configure the software using the Tomcat servlet container. Tomcat is a free, open source servlet container available from Apache at http://tomcat.apache.org/. These instructions were written for Tomcat version 5.x running in a UNIX environment but should be similar to other versions and platforms. Version 2.0.9.3 of the DLESE OAI software has been tested successfully in Tomcat 4.x and minimally tested in 5.0.18 and 5.5.9. Step 1: Download and install the Tomcat servlet container on your server. To install Tomcat, follow the instructions available from Apache at http://tomcat.apache.org/. You must configure Tomcat to run using the Java2 platform v1.4 or later. If using Tomcat 5.5.x, you must also download and install the compatibility package as well (even if using a 1.5 JVM). Java2 is available at: IBM (recommended for Linux): http://www6.software.ibm.com/dl/lxdk/lxdk-p Sun: http://java.sun.com/j2se/ For Mac OSX (Jaguar or later): Java2 comes pre-installed or may be installed using software update. On recent versions of Linux (Red Hat 9 or later), you must also set the following environmental variable: export LD_ASSUME_KERNEL=2.2.5 Step 2: Place the file 'oai.war' into the 'webapps' directory found in your Tomcat installation. 'webapps' is the default location where Tomcat expects to find web applications. Step 3: Start or restart Tomcat. Upon startup the first time, Tomcat will automatically unpack the oai.war archive, creating a directory and application context named 'oai'. - Tip: if Tomcat does not unpack the archive you may do so manually: 1. Create an 'oai' directory in the 'webapps' directory. 2. cd into 'oai.' 3. Enter the command 'jar xvf ../oai.war.' Step 4: The DLESE OAI software should now be running. Launch a web browser and type in the URL to the oai servlet context, which will have the following form: - The address will use the context path created in step 3 ('oai'). If the domain name to your server is http://www.myserver.edu and Tomcat was been installed using the default port (8080), the URL to the OAI software will be http://www.myserver.edu:8080/oai/ - Alternatively you may access the software using the localhost domain shortcut: http://localhost:8080/oai/. - If there are errors accessing the software try repeating or verifying steps 1 and 2. - Tip: Check the Tomcat logs for error messages located in the 'logs' directory of your Tomcat installation if there are problems. Step 5: At the URL mentioned above, you will be greeted by a 'Getting started' page that will walk through the remaining few steps necessary to use the harvester and/or make your metadata available in the data provider. If you have questions or comments, please e-mail support@dlese.org Additional instructions are available at: http://www.dlese.org/Metadata/tool/index.htm