How do I create an OAIPMH service in Silva?

Asked by Kit Blake

We need to understand how we can do this ourselves in future; can you give us a step-by-step description on how this was done and why things are done the way they are?

Question information

Language:
English Edit question
Status:
Solved
For:
Document Library Edit question
Assignee:
No assignee Edit question
Solved by:
Richard H.
Solved:
Last query:
Last reply:
Revision history for this message
Torvald (torvalddb) said :
#1

Every Silva root that needs to access the DL must have an OAIPMH service. To add one:

1. Go to the ZMI of the Silva root
2. From the Add pulldown menu at the upper right, select OAIPMH Service
3. In the ensuing add screen there are four fields:
+ Id: give the service an id that starts with 'service_', such as service_doclib. This keeps it in the services tab and not mixed with Silva content.
+ OAI PMH Repository URL: this is a private url that requires a password. Fill in http://[myDocLibSite]/dl/oaipmh_private
+ Repository username: there should already be a user configured especially for this harvesting. Don't use the manager password.
+ Repository passwd: enter the harvester user's password
4. Click the "Add and edit" button. (The above info must be valid because the service checks upon creation and will complain or error if something doesn't jive.)
5. At the bottom of the edit screen, check the "create storage" checkbox for the DL.
6. Click the "Change Settings" button.
7. In the ensuing edit screen, click the "Update from server according to settings 'Update'" button. Wait until the update is completed.

The OAIPMH service has now been created, populated, and will be listed as an option when a user adds a Document Library Listing to the SMI.

Revision history for this message
Richard H. (richard-hewison) said :
#2

If the above instructions create a private service, how do you create a public service that is searchable by Open Archive search engines?

Revision history for this message
Richard H. (richard-hewison) said :
#3

Also, where is the 'user configured especially for harvesting' created?

Revision history for this message
Eric Casteleijn (thisfred) said :
#4

Well, the instructions are not so much to create a private service, as create a harvesting service that harvests from a private OAI Server. The same procedure applies to harvest from a public one, where the only difference would be not filling in a username and password since they are not needed for publicly accessible servers.

Revision history for this message
Best Richard H. (richard-hewison) said :
#5

so, how do we create a user specially configured for harvesting?

Revision history for this message
Kit Blake (kitblake) said :
#6

First, create a harvesting user in the DocLib (this may be in acl_users/LDAP or whatever is determining authentication).
Then, go to http://[mySilvaSite]/service_doclib/manage_main
Change the "Repository username" to the harvesting user.
Change the "Repository password" to the harvesting user's password.
Click the "Change settings" button.
Probably you want to click the "Update" button.

Revision history for this message
Kit Blake (kitblake) said :
#7

Thanks Richard H., that solved my question.