To build this project with Ant, create a 'build.properties' file in the oaiharvesterdemo directory
and add a line to it pointing to the oaiharvest.jar file such as:

oaiharvester.jar=/home/fred/proj/oaiharvesterjar/dist/oaiharvester.jar

To download and run:

- download oaiharvesterdemo.tar (CVS/Ant users can change to the oaiharvesterdemo/dist directory)
- tar xvf oaiharvesterdemo.tar (Windows users can use WinZip to unpack this file. Be sure the "use folder names" checkbox is checked when extracting.)
- download xerces.jar (version 1.4.4 works well) from http://xml.apache.org/xerces2-j/index.html.

OPTION 1:
OAIHarvester is a stand-alone Java harvesting application. A demo script is available and can be run as follows:

- chmod +x serverset.sh (Unix/Linux only)
- chmod +x display.sh (Unix/Linux only)
- ./serverset.sh (Windows users can use serverset.bat)
- ./display.sh (Windows users can use display.bat)

To customize the harvester, modify the source in oaiharvesterdemo/src/org/acme/oai/OAIDisplayFunction.java to suit your needs and rebuild the oaiharvesterdemo project.

To change the list of repositories to be harvested, change the serverset.xml file and run serverset.sh again.

To change the metadataPrefix to be harvested, change the Crosswalks.oai_etdms and Passthrough.schemaLocation entry in the harvester.properties file from etdms to something else (e.g. oai_dc)..

OPTION 2:
For developers who want to write their own OAI harvester driver or incorporate OAI harvesting in other applications, consider using ORG.oclc.oai.harvester.io.OAIReader instead. A demo script is available and can be run as follows:

- ./oaireader.sh (Windows users can use oaireader.bat)

OPTION 3:
For developers who want to capture the raw OAI responses, look at the demo script at:

- ./rawdump.sh (Windows users can use rawdump.bat)

More to come later....