Page History

...

Setting up Tomcat7

Install Tomcat. Use the appropriate package manager (e.g. yum, portage) to install Tomcat (on Xubuntu, for example, setting up Tomcat is accomplished by a simple command: "

sudo apt-get install tomcat7

"). Alternatively, visit the Apache Tomcat project documentation for more installation options. Once Tomcat is installed and running, you should see the Tomcat welcome screen when you visit http://localhost:8080.

Setting up Fedora Repository

Use either the pre-packaged WAR file (.war) from webapp-plus project or build Fedora from source to get a WAR file. Copy the WAR to the Tomcat root directory <CATALINA_HOME>/webapps. Start/restart Tomcat, and http://localhost:8080/<fcrepo>/rest should display the Fedora repository front page.

...

...

Install the fcrepo-oaiprovider library dependencies

...

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-05-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. Edit the fcrepo master.xml file in <CATALINA_HOME>/webapps/<fcrepo>/WEB-INF/class/spring/master.xml to paste the following <import> declaration after other <import> declarations:

   Code Block
   language text
   <import resource="classpath:/spring/oai.xml"/>

5. Make sure the OAI namespace is defined as a Compact Node Definition Type. You may have to add the following namespace element to fcrepo-kernel-impl/src/main/resources/fedora-node-types.cnd in the fcrepo4 project and rebuild it, or reference your .cnd file in repository.json, if necessary. 

   Code Block
   language text
   <oai = 'http://www.openarchives.org/OAI/2.0/'>

6. Restart Tomcat. Go to http://localhost:8080/<fcrepo>/rest/oai?verb=Identify. If everything is in order, you should see an XML file outlining the default configuration for the OAI-PMH provider.

...

The OAI Provider relies on four properties being present in the main repository for the IDENTIFY verb. The properties and the corresponding default values are:

...

These properties have to populated manually for now (with the exception of oai:version, which is populated automatically to reflect the build version), using the following SPARQL/Update queries of the pattern:

INSERT {<> oai:repositoryName "exciting repository name here"}

...

INSERT {<> oai:adminEmail "your.email@here.org"}

If one or more of the properties are missing, the OAI Provider uses the built-in values:

...

As an example:

echo "insert data {<> oai:repositoryName coolrepo } " | curl -X PATCH --upload-file - http://localhost:8080/fcrepo/rest