Open Archives Initiative Protocol for Metadata Harvesting (OAI-PMH) es un mecanismo de interoperabilidad entre repositorios.
Data Providers son repositorios que exponen metadatos estructurados via OAI-PMH que serán requeridos por los Service Providers.
OAI-PMH esta compuesto por un conjunto de seis verbos o servicios que son invocados via HTTP.
Para mas información ver: https://www.openarchives.org/OAI/2.0/openarchivesprotocol.htm
Para activar el servidor OAI-PMH solo es necesario que la aplicación web [dspace]/webapps/oai/ este habilitada desde el Web Container (Tomcat) con un link simbólico o un context. Ver Configurar tomcat
Para probar esto se puede enviar un requerimiento a: http://[URL-a-OAI-PMH]/request?verb=Identify
La respuesta debería ser similar a la respuesta de la Demo de Dspace http://demo.dspace.org/oai/request?verb=Identify
Luego de activar el servidor OAI-PMMH, es necesario asegurarse de que el indice permanezca actualizado periódicamente. Para esto es necesario programar el comando [dspace.dir]/bin/dspace oai import.
Puede verse en como se programa en el archivo /etc/cron.d/cron.d-dspace
Para mas información sobre cronjobs, ver Cronjobs
OAI 2.0 es una implementación de una interface data provider OAI-PMH en Java desarrollada por Lyncode, que utiliza XOAI, una librería de Java OAI-PMH.
Para entender como funciona XOAI, es necesario entender los conceptos de Filter, Transformer y Context.
Con un Filter es posible seleccionar información desde un data source. Un Transformer permite a uno realizar algunos cambios en los metadatos antes de exponerlos a la interface OAI. XOAI también agrega el concepto de Context. Un contexto se puede identificar con una URL de la siguiente manera:
http://www.example.com/oai/<context>
Los Contexts pueden ser visto como distintas interfaces virtuales OAI, pudiendo tener cosas como:
http://www.example.com/oai/request
http://www.example.com/oai/driver
http://www.example.com/oai/openaire
Esta solución puede satisfacer los requerimientos tanto de Driver, OpenAIRE u otros requerimientos como los que exige SNRD.
Los Contexts pueden ser vistos como sets (Definidos en el protocolo OAI-PMH).
Esta implementación facilita el hecho de que uno pueda necesitar un metadata format específico para un determinado contexto. Los requerimientos para Driver difieren ligeramente a los de OpenAIRE. Entonces para cada contexto uno puede implementar un transformer específico.
OAI 2.0 permite configurar un data source. Por defecto los metadatos requeridos se encuentran en el indice de Solr (separado en el core "oai").
OAI manager es una utilidad que permite realizar ciertas operaciones administrativas con OAI. Se puede acceder a él a través de la linea de comandos de la siguiente manera:
[dspace]/bin/dspace oai <acción> [parametros]
import Importa items DSpace al índice OAI Solr (tambien limpia la cache de OAI)
clean-cache Limpia la cache de OAI
-o Optimiza indices despues de indexar
-c Limpia el indice de Solr antes de indexar (importa todos los items otra vez)
-v Verbose output
-h Ayuda
