OAI defined

jOAI is a Java-based OAI software that supports the Open Archives Initiative Protocol for Metadata Harvesting (OAI-PMH), version 2.0. The protocol establishes methods for sharing individual metadata files that are XML documents. The software contains a data provider that makes XML metadata files available to others and a data harvester that can get XML metadata files from others.

Data Provider

Use the data provider to make metadata files available to others via the OAI protocol. Set up the Provider. If only harvesting metadata files, provider setup is not necessary.

See the Data provider documentation for detailed information about the jOAI data provider.

To harvest from this data provider, use this baseURL: https://doc-oai.eaurmc.fr:443/oai/provider


Use the harvester to get metadata files from OAI data providers. Set up the Harvester. If only providing metadata files, harvester setup is not necessary.

See the Harvester documentation for detailed information about the jOAI harvester.


Use the Search page to view and find items in the data provider. Free-text searches operate over the full text of all metadata files. Searches may be limited by set and/or keyword terms.

See the ODL Search documentation for detailed information about the search functionality available in jOAI.

jOAI system requirements

The jOAI software runs on Windows, Mac, Linux and Unix platforms. The following components are needed to operate the software:

Version of the jOAI software has been tested with Java 5 and 6 and Tomcat version 5.5.x and 6.x on Linux and Windows XP.

Downloading jOAI

Download the software from the jOAI download page at DLESE.

Installing jOAI

See the installation instructions for information about installing jOAI.

Configuring jOAI

See Configuring jOAI for information about optional configuration options jOAI.

Version and licensing

See About jOAI for version and licensing information.

Source Code

See the build instructions for detailed infromation about obtaining the source code and building jOAI using Ant.


The jOAI User Forum at SourceForge is a place where members of the jOAI community can seek advice, provide tips, share experiences, report bugs, and interact with the developers and other users of the tool. Inquiries may also be sent via e-mail to support@dlese.org.

See also the jOAI documentation pages for information about using the software.





University Corporation for Atmospheric Research (UCAR) National Science Foundation (NSF) Digital Library for Earth System Education (DLESE)