OAI-PMH Harvester Manager Project Homepage
Welcome to OAI-PMH Harvester Manager Project.
OAI-PMH Harvester Manager is an implementation of
Open Archives Initiative's
Protocol for Metadata Harvesting
with a browser-based graphical user interface (GUI).
It allows you to define as many OAI-Repositories as you like each also with different OAI-Sets,
Metadata formats etc.
You can also define a queue of one-time or regularly repeating Harvesting Tasks which will automatically
execute the related OAI-PMH Harvester when defined execution time arrives.
To learn how you can use
OAI Harvester Manager inside of an Internet Browser Window
to plan, define and manage your harvesting activities please read the document:
OAI Harvester Manager Web Based User Interface - Getting Started
To learn how you can extend/modify
the Manager for your own needs please see the
Documentation for Developers like JavaDoc
You can also use our:
OAI-PMH Harvester Manager is originally developed by
German National Library
IT-Team for the harvesting activities of the library and published as
Free Software as
Defined by Open Source Initiative
and distributed under
GNU GPL v3
. So please feel free to improve it. We will be thankful if you share your improvements with us.
The source code is commented completely in English but the user interface is in German.
It will also be a great help if you translate it in your language.
You can mail directly to the project lead Kadir Karaca Koçer
using the internal mailing function of SourceForge.
How can I use it?
Every institution using OAI-PMH to collect metadata can use the OAI-Harvester Manager. In most cases only things you have to do are:
- make sure that you are using the
latest Java 1.6 SDK (versions prior to Update 23 have serious security bugs!)
- write the parameters that suits your configuration in configuration files
- build a
(preferably by using the provided
- deploy it to a
Apache Tomcat 6.0.x installation
If you prefer to use a Relational Database the Database must be initialised too.
Installation is a little bit tricky if the provided functionality does not satisfy your needs.
In that case you have to implement one or both two Java Interfaces yourself to get the desired functionality.
This is the normal situation for institutions which plan to use harvested data in production systems. Then the
method of the interface
must be implemented in a way that puts your data in your production system!
Documentation and Screenshots
Sourcecode is released under GNU GPL v3
and can be downloaded from
together with WAR file which also contains all required
The present OAI-PMH Harvester Manager software represents an experimental software
(so-called "beta release"). The software and its specification may include technical
inaccuracies or typographical errors. Changes are periodically added to the information
therein; these changes will be incorporated into new versions of the specification,
if any. The usage of the software is at one's own risk. The Sourceforge project or
German National Library in no event will be liable for any damages to hardware and software,
lost data or other special, indirect, consequential incidential or punitive damages
however caused, arising or related to any use of the specification or the software.
See the chapters 15 and 16 of the licence.
In some countries, the cryptographical software or other components contained
in the software may be subject to special export regulations or software patents.
In such cases the software may not be distributed to and within those countries.
This web site is published under:
Creative Commons Attribution-NonCommercial-ShareAlike 3.0 License (CC BY-NC-SA 3.0)