Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

OAI 2.0 is a separate webapp which is a complete substitute for the old "oai" webapp. OAI 2.0 has a configurable data source, by default it will not query the DSpace SQL database at the time of the OAI-PMH request. Instead, it keeps the required metadata in its Solr index (currently in a separate "oai" Solr core) and serves it from there. Although it's also possible to set OAI 2.0 to only use the database for querying purposes. Furthermore, it caches the requests, so doing the same query repeatedly is very fast, but not only, it also compiles DSpace items to make uncached responses much faster.

Details about OAI 2.0 internals could be found at: https://wiki.duraspace.org/display/DSPACE/OAI-PMH+Data+Provider+2.0+%28Internals%29

Using Solr

OAI 2.0 establishes Solr data source by default.

...

<ac:structured-macro ac:name="unmigrated-wiki-markup" ac:schema-version="1" ac:macro-id="635e61f349cdfeb7-b78d16f2-45584f71-ac88a8a2-29803e1d53c0045fb857699d"><ac:plain-text-body><![CDATA[

Configuration File:

[dspace]/config/modules/oai.cfg

]]></ac:plain-text-body></ac:structured-macro>

Property:

storage

Example Value:

storage = solr

Information Note:

This allows to choose the OAI data source between solr and database

Property:

solr.url

Example Value:

solr.url = ${default.solr.server}/oai

Informational Note:

Solr Server location

Property:

identifier.prefix

Example Value:

identifier.prefix = ${dspace.hostname}

Informational Note:

OAI persistent identifier prefix. Format - oai:PREFIX:HANDLE

Property:

config.dir

Example Value:

config.dir = ${dspace.dir}/config/modules/oai

Informational Note:

Configuration directory, used by XOAI (core library). Contains xoai.xml, metadata format XSLTs and transformer XSLTs.

Property:

cache.dir

Example Value:

cache.dir = ${dspace.dir}/var/oai

Informational Note:

Directory to store runtime generated files (for caching purposes).

...