File Release Notes and Changelog
Release Name: OAI Software v1.01
Notes: <b>The DLESE OAI provider and harvester v1.01 is an 'out of the box' Java OAI solution that enables a simple means for transferring metadata contained in XML files using the OAI protocol v1.1. <br><br> The software runs as a Java web application in a servlet environment such at Tomcat. Installation and usage instructions are included in the download. The README.txt file is also included below.</b> <br><br><hr><br><br> Installation instructions for the DLESE OAI software. <br><br> To use the DLESE OAI software you must have the following: <br><br> 1. oai.war - the DLESE OAI software. <br> 2. A servlet environment such as Tomcat to run the OAI software.<br> <br><br> The software should run properly in any servlet container environment. The following example shows how to install and configure the software in a UNIX environment using Tomcat, an open source servlet environment from Apache. These instructions are for Tomcat version 4.0 but should be similar to other versions as well. <br><br> Step 1: Install the Tomcat servlet environment on your machine. In general this will be the same machine where your data repository resides.<br> - General information and instructions for installing Tomcat are available at: http://jakarta.apache.org/tomcat/ or see also http://java.sun.com/docs/books/tutorial/servlets/servletrunner/tomcat-start.html<br> - Download Tomcat from: http://jakarta.apache.org/site/binindex.html <br><br> Step 2: Place the file 'oai.war' into the 'webapps' directory found in your Tomcat installation and then start or restart Tomcat. This is the default location where Tomcat expects to find web applications.<br> - Tomcat will automatically unpack the oai.war archive into the directory 'oai' when it starts up, creating the application context 'oai.' If you already have a directory named 'oai' Tomcat will do nothing, however if you rename the war file Tomcat will use the new name to create a directory. For example 'oai2.war' will be unpacked into the directory 'oai2' and so forth.<br> - If Tomcat does not unpack the archive you must do so manually: 1. Create an 'oai' directory in the 'webapps' directory. 2. cd into 'oai.' 3. Enter the command 'jar xvf ../oai.war.' <br><br> Step 3: The OAI Provider/Harvester should now be running. To verify it is up and running, bring up the test page in a web browser:<br> - The address will use the context you have set up in step 2. For example if the domain name to your server is http://www.myserver.edu and you have done a simple default installation of Tomcat then the oai test page will be at http://www.myserver.edu:8080/oai/ (Tomcat uses port 8080 as a default).<br> - If you do not have your machine configured on a network with a domain name you can also access it on the host machine using the localhost domain shortcut: http://localhost:8080/oai/.<br> - You should be able to use the test page to access a small example collection of records that are included with the installation. If there are errors accessing or using the test page try repeating or verifying steps 1 and 2. <br><br> Step 4: Read the usage and configuration documentation provided with the software. In the example above this would be located at http://www.myserver.edu:8080/oai/documentation/index.html or http://localhost:8080/oai/documentation/index.html.<br>
Changes:
