Instructions for building the DLESE OAI software v2.0.9.3 from source.

Quick instructions: 
--------------------------------------------

This software may be built easily using Ant. If you are already using Ant
and Tomcat, building the software is a three step process:
1. Unzip the DLESE OAI software source files, which will contain the two directories
oai-project and dlese-tools-project.
2. Set the ant property 'catalina.home' to point to your Tomcat installation.
3. From the oai-project directory, execute the 'deploy' target.

This will build the software and place it in a directory named 'oai_testing'
inside your Tomcat webapps directory.


Detailed instructions:
--------------------------------------------

To build the DLESE OAI software from source you must have the following:
  
1. oai-project - the DLESE OAI software source code directory
2. dlese-tools-project - the DLESE Java libraries source code directory
Note: 1 & 2 are available at http://sourceforge.net/project/showfiles.php?group_id=23991
by downloading the latest OAI source distribution or via anonymous CVS at
http://sourceforge.net/cvs/?group_id=23991
3. Tomcat version 4.x, 5.0.x or 5.5.x (available at http://tomcat.apache.org/)
4. Ant (available at http://ant.apache.org/)
5. Java2 platform v1.4 or later (available from IBM at http://www6.software.ibm.com/dl/lxdk/lxdk-p
or from Sun at http://java.sun.com/j2se/). Note that Java2 comes pre-installed on 
Mac OS X (Jaguar or later).


Build instructions:

These instructions assume you will be working in a UNIX command-line environment.
The software can also be built on Windows but specific instructions are not 
provided here.

1. Obtain the oai-project and dlese-tools-project source directories (see above).

2. Obtain and install all the required tools (see above).

3. Place the oai-project and dlese-tools-project directories into a single directory.
For example:
 # cd ~/my_build_area
 # ls 
   dlese-tools-project oai-project
	  
4. cd into the oai-project directory.
  # cd oai-project

5. Create a file named build.properties in the oai-project directory 
(alternatively this can be placed in your home directory).

6. Edit the build.properties file and set the poperty catalina.home to
point to your intallation of Tomcat, for example:
catalina.home = /home/username/dev/tomcat-4.0.6

See the build.xml file located in oai-project for information on the 
properties settings.

7. Execute the Ant deploy command.
  # ant deploy
You should see a number of messages in your terminal. Once complete
you should see a message like:
    BUILD SUCCESSFUL
    Total time: 36 seconds

8. The software will be built into a directory named oai_testing inside your
Tomcat webapps directory. After (re)starting Tomcat you will be able to
access the software at the URL http://localhost:8080/oai_testing/ 
(substitute localhost with your domain name if appropriate).



Additional support is available by e-mailing support@dlese.org.

Some additional instructions are available at:
http://www.dlese.org/Metadata/tool/index.htm