| Excerpt |
|---|
| This guide |
...
| will help you setup the OAI-PMH provider for Fedora 4 on Tomcat 7. For further details, please refer to the project's documentation on GitHub. |
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: "
| Code Block |
|---|
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.
| Info |
|---|
...
| <fcrepo> is the name of the .war file minus the .war extension and the exact file name can vary on build/release number. |
...
Install the fcrepo-oaiprovider library dependencies
...
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:
| Property | Default |
|---|---|
| oai:repositoryName | "Fedora 4" |
| oai:description | "An example repository description" |
| oai:version | <build version> |
| oai: |
...
| adminAddress | "admin@example.com" |
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:
| Property | Default |
|---|---|
| oai:repositoryName | "Fedora 4" |
| oai:description | "An example repository description" |
| oai:version | <build version> |
| oai:adminAddress | "admin@example.com" |
...
As an example:
| Code Block | ||
|---|---|---|
| ||
echo "insert data {<> oai:repositoryName coolrepo } " | curl -X PATCH --upload-file - http://localhost:8080/fcrepo/rest |