VuFind Documentation

This page is read only. You can view the source, but not change it. Ask your administrator if you think this is wrong.
====== DSpace: Enabling OAI-PMH ======

// These instructions were shared by the Naval Postgraduate School in Monterey, California. //

:!: Newer releases of DSpace have OAI-PMH enabled by default, so these steps should not be needed. They are retained only for historical reasons (and in case there is still an instance of DSpace 3.x or earlier than needs to be harvested).

OAI must be enabled on the DSpace repository before you can [[indexing:dspace|index DSpace records into VuFind]]:

  - Modify the DSpace server config in **nginx.conf** on the DSpace server:<code>Location /oai/ {
    Proxy_set_header X-Forwarded-Host $host;
    Proxy_set_header X-Forwarded-Server $host;
    Proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
   
    Proxy_pass http://yourdspacehostname:8080/oai/;
    Proxy_redirect http://yourdspacehostname:8080/oai/  http://yourdspacehostname/oai;

    Proxy_buffering off;
    Proxy_store off;

    Proxy_connect_timeout 120;
    Proxy_send_timeout 120;
    Proxy_read_timeout 120;
}
</code> Comparable configuration in Apache makes use of [[http://httpd.apache.org/docs/2.2/mod/mod_proxy.html|mod_proxy]]. Note that the proxy configuration is only necessary if you are unable to open port 8080 to your VuFind instance. If you are not limited by such restrictions, feel free to use your full DSpace hostname appended with ":8080" and skip the above proxy configuration.
  - Modify the **server.xml** for the appropriate DSpace Tomcat instance in the **HOST** block:<code><Context path="/oai" docBase="/path_to_dspace/webapps/oai" debug="0"
    Reloadable="true" cachingAllowed="false"
    allowLinking="true" /></code>
  - Modify the **dspace.conf** config file for the appropriate DSpace instance:<code>...
harvest.includerestricted.oai = true
harvester.autoStart = true
...</code>
VuFind Documentation

Site Tools

Page Tools
