Exposing Nesstar Metadata for Harvesting With OAI-PMH

Nesstar now supports the Open Archives Initiative Protocol for Metadata Harvesting. A new stand alone component allows server administrators to expose a server's metadata for harvesting by others.

OAI-PMH is a standard protocol designed to make it simpler for data providers to open up their repositories and for service providers to harvest metadata. The protocol uses XML over HTTP and supports Dublin Core and DDI 1.2. The protocol is described here:


Getting Started With Nesstar OAI-PMH Server

The Nesstar OAI-PMH Server can be installed in either an existing Nesstar Server or in an Apache Tomcat application server.

Nesstar OAI-PMH Server details:

Release version : Nesstar OAI-PMH Server 0.2.1 (See also the Release Notes )

Release Date     : 2013.07.19

Release File      : nesstar_oai_pmh-0.2.1.zip ( Note: Extract the zip archive. The output is a folder called oai-pmh.war.)


Using an Existing Nesstar Server

To install the Nesstar OAI-PMH Server in an existing Nesstar Server:

  1. Stop the Nesstar Server
  2. Copy the oai-pmh.war folder to this location: <installed nesstar server>/jboss/server/default/deploy
  3. Start the server again.

Using Apache Tomcat

To deploy the Nesstar OAI-PMH Server to Apache Tomcat, just follow your normal routines for deploying web applications.

Configuring the Nesstar OAI-PMH Server

The Nesstar OAI-PMH Server will respond to requests under /oai-pmh under your application server.
The server needs some basic configuration before it will operate properly. To do this, point your browser to <server IP or hostname>/oai-pmh/install and fill out the form.

Here is a brief explaination of the fields:

The URL of the OAI-PMH Server: This is the URL the Nesstar OAI-PMH Server will respond to. The application tries to suggest the URL but make sure it is correct.
The URL of the server to disseminate: This points to the Nesstar Server that holds the data you wish to disseminate.
The port of the server to disseminate: The port the Nesstar Server runs on. This defaults to 80. If you are in doubt, it is most probably 80.
The administrator’s e-mail address: Put an e-mail address that users of the OAI-PMH service can use to reach the administrator.
The username to access the disseminated server: If necessary, put the username here. The Nesstar OAI-PMH Server will use this to access the Nesstar Server.
The password to access the disseminated server: The user’s password.

If you wish you can also create a username and password that allows you to go back and edit the configuration at a later point.

After you click the Save button your Nesstar OAI-PMH Server is ready.

Reconfiguring the Server

If you need to reconfigure the Nesstar OAI-PMH Server and didn’t set a username and password in the installation step, you can still edit or reset the configuration. However, you need access to the application server’s file system.
The configuration is stored in the WEB-INF folder under web application’s folder in your application server. The file is called nesstar-oai.properties and you can either edit it with a text editor or delete it and re-run the web installation as explained above.