Difference between revisions of "OAI"

From EPrints Documentation
Jump to: navigation, search
m (Typos)
 
Line 5: Line 5:
 
====Configuring====
 
====Configuring====
  
The setting for OAI are held in the <tt>oai.pl</tt> file, in the <tt>eprints3/archives/<archive id>/cfg/cfg.d/</tt> directory.  This is a perl file, but don't let that daunt you. Some of the settings are set to sensible defaults.  This guide cover the essentials.  Feel free to use your favourite text editor instead of pico.
+
The setting for OAI are held in the <tt>oai.pl</tt> file, in the <tt>eprints3/archives/<archive id>/cfg/cfg.d/</tt> directory.  This is a perl file, but don't let that daunt you. Some of the settings are set to sensible defaults.  This guide covers the essentials.  Feel free to use your favourite text editor instead of pico.
  
 
At the command prompt, backup then open the file:
 
At the command prompt, backup then open the file:
Line 27: Line 27:
  
 
<strong>Policies</strong>
 
<strong>Policies</strong>
Next you need to define a number of policies which will define how your repository may be used.  It may be helpful for you to visit http://www.opendoar.org/tools/en/policies.php which has a step-by-step process to create these policies.  It will even output EPrints 3 configuration code. which you can then copy and paste into the oai.pl file.  These policies are:
+
Next you need to define a number of policies which will define how your repository may be used.  It may be helpful for you to visit http://www.opendoar.org/tools/en/policies.php, which has a step-by-step process to create these policies.  It will even output EPrints 3 configuration code, which you can then copy and paste into the oai.pl file.  These policies are:
  
 
* Metadata Policy
 
* Metadata Policy

Latest revision as of 09:38, 15 June 2012

We would also encourage you to configure the OAI support for your archive and register it.

Configuring

The setting for OAI are held in the oai.pl file, in the eprints3/archives/<archive id>/cfg/cfg.d/ directory. This is a perl file, but don't let that daunt you. Some of the settings are set to sensible defaults. This guide covers the essentials. Feel free to use your favourite text editor instead of pico.

At the command prompt, backup then open the file:

>cd /opt/eprints3/archive/<archive id>/cfg/cfg.d
>cp oai.pl oai.backup
>pico oai.pl

The following need to be changed:

The archive ID. This needs to be unique, so check that it doesn't already exist at http://www.openarchives.org/.

Find the following line in oai.pl:

$oai->{v2}->{archive_id} = "generic.eprints.org";

And change generic.eprints.org to something which identifies your repository.

Content Description. What does your repository contain? Write a description, then find the lines:

$oai->{content}->{"text"} = latin1( <<END );
OAI Site description has not been configured.
END

Do not modify the first or last line in any way. Simply put your new text in the place of the middle line. This text can be as many lines as you wish, but it must not contain the word "END" at the start of a line.

Policies Next you need to define a number of policies which will define how your repository may be used. It may be helpful for you to visit http://www.opendoar.org/tools/en/policies.php, which has a step-by-step process to create these policies. It will even output EPrints 3 configuration code, which you can then copy and paste into the oai.pl file. These policies are:

  • Metadata Policy
  • Data Policy
  • Submission Policy

These are updated in exactly the same way as the Content Description section. Just look for the following lines:

  • $oai->{metadata_policy}->{"text"} = latin1( <<END );
  • $oai->{data_policy}->{"text"} = latin1( <<END );
  • $oai->{submission_policy}->{"text"} = latin1( <<END );

Registering

Once you register your archive (at http://www.openarchives.org) various search systems will be able to collect the metadata (titles, authors, abstract etc.) and allow more people to find records in your archive.

See http://www.openarchives.org/ for more information on the OAI protocol. For more information setting up the OAI interface archive see the section in this documentation about Configuring an Archive.