Page History

...

1.  Obtain and build the fcrepo-oaiprovider source code:

   Code Block
   language text
   git clone https://github.com/fcrepo4-labs/fcrepo4-oaiprovider.git cd fcrepo4-oaiprovider mvn package

2.  Move the generated JAR to Tomcat's lib folder:

   Code Block
   language text
   cp target/fcrepo4-oaiprovider-4.0.0-beta-04-SNAPSHOT.jar <CATALINA_HOME>/webapps/<fcrepo>/WEB-INF/lib

3.  Copy the oai.xml file to the fcrepo config directory:

   Code Block
   cp fcrepo4-oaiprovider/src/main/resources/spring/oai.xml /<CATALINA_HOME>/webapps/<fcrepo>/WEB-INF/classes/spring/

4. Add the import to fcrepo's master.xml file:

     - Edit <CATALINA_HOME>/webapps/<fcrepo>/WEB-INF/classes/spring/master.xml

      - Add '<import resource="classpath:/spring/oai.xml"/>' after the other <import> declarations

5. Make sure the OAI namespace is defined as a Compact Node Definition Type. Add: <oai = 'http://www.openarchives.org/OAI/2.0/'> to fcrepo-kernel-impl/src/main/resources/fedora-node-types.cnd in the main core and rebuild the project, but you may have to find another way to add it. See Here
6. Restart Tomcat. Go to http://localhost:8080/<fcrepo>/rest/oai?verb=Identify. If everything is in order, you should see XML outlining the default configuration for the OAI-PMH provider.

Common errors are either the OAI-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 5 above), so make sure the OAI compact node definition has been added correctly to the fedora-node-types.cnd file. If default values appear instead of the properties you definedpopulated, this means the properties are not available or defined incorrectly.

...