OAI installation instructions
The DLESE OAI software includes a data provider that supports protocol version 2.0 and a harvester that supports protocol versions 2.0 and 1.1. For more information about OAI, see http://www.openarchives.org/. The data provider serves XML metadata. Likewise, the harvester saves downloaded XML metadata in a specified directory.
Operating systems & web browsers
General installation procedure
This quick start process describes how to set up the supporting software for OAI, the OAI software itself, and a basic OAI configuration. The process also includes doing a test harvesting and providing of metadata records. This process assumes a stand-alone Tomcat instance.
To install and run the DLESE OAI software you must have the following:
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/.
Java2 JDKis available at:
To download and unpack OAI, follow the steps below:
Upon startup the first time, Tomcat will automatically unpack the oai.war archive, creating a directory and application context named 'oai'.
Launch a web browser and type in the URL to the oai servlet context,
If there are errors accessing the software try repeating or verifying Steps 1 and 2.
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. More detailed instructions are provided in Steps 5 and 6.
Section 5 and 6 test the OAI harvest and data provider components.
To set your OAI software to harvest records from DLESE do the following:
To set your OAI software to provide the enclosed sample records do the following:
If you have harvested and provided with your OAI tool, you are operational. However, based on user experiences, the information below may help answer further questions about memory issues with Linux (a known issue with Red Hat 9) or how to add XML schema or namespace information to the ListMetadataFormats response. For other questions, please contact firstname.lastname@example.org.
Other possible documents that may answer questions:
Last updated: 2005-12-09