Current released version OAI Provider Service 1.2 has now been released. ../images/logo_44x60.gif Fedora OAI Provider ServiceVersion 1.2Table of Contents1. About This ServiceThe Fedora OAI Provider Service is part of the Fedora Service Framework and offers a vast improvement over the previous, simple OAI provider that the Fedora Repository used in previous versions. The new provider is based on PROAI, an open source caching, polling OAI provider. It has the following features:
NEW FEATURES\\\\ This release of the OAI Provider incorporates the following new features:
See the Configuration section for more detail on using these new capabilities. 2. InstallationTo install the service:
3. Demonstration / Test SetupThe source distribution of the OAI Provider service includes several test Fedora digital objects. You can use these objects and the default proai.properties configuration file to quickly understand how the service works.
Upon starting, the Fedora OAI Provider service will poll the repository for objects that provide OAI record content and have changed since its last update. It will find the demonstration objects you just ingested, request appropriate disseminations of each, and save them in its cache. Once it has successfully completed a cache update cycle, you should be able call the oaiprovider client service interface with OAI-PMH verbs. Here are some examples (note that you may have to substitute the name of your host for localhost): Now try using fedora-admin to edit a datastream in one of the demonstration objects you just ingested. The next time the OAI Provider service polls the repository for modified objects, it should pick up this change and make it available via the oaiprovider client service interface. Note that the poll frequency is ten minutes by default – this can be configured to be more or less frequent by changing the proai.driverPollSeconds property in the proai.properties file. 4. ConfigurationPlease consult the PROAI documentation for a complete list of proai.properties configuration options and what they do. You should also take a look at the log4j.xml that resides alongside the proai.properties file in the Web application's WEB-INF/classes directory. This file controls where log messages will be sent and how much detail they will contain. When first setting up the Fedora OAI Provider service, it is recommended that you keep the log level high (DEBUG for most categories). Copyright © 2006-2007 Fedora Project, 2008 Fedora Commons, Inc. |