The 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:
To install the service:
oaiprovider.war
file into your servlet
container.
The 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.
proai.properties
configuration file and
ensure the following properties are set according to your own
Fedora Repository installation:
fedora.fcfg
file:
If one of the values of "retainPIDs" is "demo" or
"*" (asterisk), your repository is configured correctly. Otherwise,
you should add this value and re-start it.
fedora-admin
GUI or fedora-ingest
command-line
utility to ingest all demonstration objects in the src/test/foxml
directory of the Fedora OAI Provider service source distribution.
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
):
http://localhost/oaiprovider/?verb=Identify
http://localhost/oaiprovider/?verb=ListRecords&metadataPrefix=oai_dc
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.
Please 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).