The jOAI Java web application implements 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: http://gfzpublic.gfz-potsdam.de/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 Linux/Mac/Unix and Windows platforms. The following components are needed to operate the software:

Version 3.2 of the jOAI software has been tested with Java 8 and Tomcat 7 and 8.

Downloading jOAI

The jOAI repository at GitHub has binary releases and source code.

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.

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)