Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

This guide should help you setup the OAI-PMH provider for fcrepo Fedora 4 using tomcat7 Tomcat 7 as the platform.

(Parts of this wiki page were taken from https://github.com/fcrepo4-labs/fcrepo4-oaiprovider)

...

For further details, please refer to the project's documentation on GitHub.

Setting up Tomcat7

I'm using a Virtualbox VM, but this should work "as-is" on any linux platform

...

<fcrepo> is fcrepo-webapp-4.0.0-beta-04-SNAPSHOT

 

Setting up Tomcat7

Om On Xubuntu, setting up tomcat7 Tomcat is a simple command: "sudo apt-get install tomcat7" to download and install the webserver and any prerequisites. On other systems, use the build-in package manager (yum, portage) to install tomcat7 or install it manually using the useful instructions on the packages website. By the completion of the installation, you should be able to run tomcat and see the "It Worked!" screen when you visit http://localhost:8080

 

Setting up Fedora Repository

...

Using either the pre-packaged binary .WAR file from webapp-plus or building it Fedora from the source files (using the helpful and informative instructions), the result should be a .WAR file. Copy the .WAR file to the tomcats root directory <CATALINA_HOME>/webapps. Start/restart tomcat and http://localhost:8080/<fcrepo>/rest should display the fedora repository front page.

(I've called it <fcrepo> as its <fcrepo> is the name of the .WAR file minus the .war extension and it can vary on build number/release.)

 

Install the fcrepo-oaiprovider library dependencies

FcrepoThe OAI-PMH provider in fcrepo4-oaiprovider relies on JAX-B to operateJAXB, so install them by grabbing download the following jar files from:

 http://central.maven.org/maven2/com/sun/xml/bind/jaxb-impl/2.2.7/jaxb-impl-2.2.7.jar
 http://central.maven.org/maven2/com/sun/xml/bind/jaxb-core/2.2.7/jaxb-core-2.2.7.jar

and moving move them to <CATALINA_HOME>/webapps/<fcrepo>/WEB-INF/lib

...

To fcrepo-kernel-impl/src/main/resources/fedora-node-types.cnd in the main core and rebuilt, but you may have to find another way to add it. See Here

 

5) Restart tomcat, wait a whileTomcat. Go to http://localhost:8080/<fcrepo>/rest/oai?verb=Identify. If it all worked, you should see xml XML that defines the default configuration for the OAI-PMH provider.

Popular Common errors are either the OAI-Provider PMH provider generating 4xx HTTP error codes or producing the default values (see below). The 4xx HTTP Error codes are a manifestation that the namespace having not been defined (Step 4b above), so make sure the OAI compact node definition has been added to the fedora-node-types.cnd file or however you have found to add the definition is correct.The default values appearing instead of properties you have defined would mean the properties are not available or defined incorrectly.

...