Instalando el Isis-oai-provider

De wiki.bireme.org/es
Saltar a: navegación, buscar

Isis-oai-provider es una aplicación que proporciona el acceso a bases de datos ISIS a través del protocolo OAI para ser recogido.

La aplicación ejecuta bajo PHP 5.3.x.

Instalación

Método 1 - Archivos para download

Descargue la versión más reciente a través de la opción Downloads en el repositorio github (archivo zip o tar.gz) y descomprima para su servidor.

Ejemplos:

  • Creando una estructura y extrayendo los archivos de la aplicación en el directorio /opt/ de un servidor Linux:
   $ cd /opt/
   $ mkdir bireme
   $ cd bireme
   $ wget https://github.com/bireme/isis-oai-provider/tarball/master -O isis-oai-provider.tar.gz
   $ tar xvfzp isis-oai-provider.tar.gz
   $ mv bireme-isis-oai-provider-53c0abc/ isis-oai-provider

NOTA: el término 53c0abc es generado automaticamente durante la creación del archivo tar.gz y por lo tanto, será diferente en cada ejecución.

  • Extrayendo los archivos de la aplicación en un servidor Windows:
    • acceda la página del aplicativo en https://github.com/bireme/isis-oai-provider
    • clic en el botón download zip para cargar los archivos de la aplicación
    • descomprima en el directorio donde se desea instalar el paquete

Método 2 - Clonar el repositorio del proyecto en git

El ventaje de este método es que se puede facilmente actualizar la aplicación en otro momento, mientras es necesario tener el paquete git-core esteé instalado.

Ejemplo: Creando una estructura y extrayendo la aplicación del repositorio en el directorio /opt/ del servidor:

   $ cd /opt/
   $ mkdir bireme
   $ cd bireme
   $ git clone git://github.com/bireme/isis-oai-provider.git

Publique la aplicación en el servidor web (ej. Apache Web Server)

Opción A - Usando un Virtual Host específico para la aplicación isis-oai-provider

   <VirtualHost *:80>
      ServerName isis-oai-provider.local
      DocumentRoot /opt/bireme/isis-oai-provider/htdocs/
      <Directory "/opt/bireme/isis-oai-provider/cgi-bin">
           Options +ExecCGI
           AllowOverride None
           Order deny,allow
      </Directory>
      ScriptAlias /cgi-bin/ /opt/bireme/isis-oai-provider/cgi-bin/
      LogLevel warn
      CustomLog /var/log/apache2/isis-oai-provider.log combined
      ServerSignature On
   </VirtualHost>

Opción B - Usando un Virtual Host existente

Suponiendo que ya existe un sitio web ejecutando, solamente es necesario discubrir los directorios para los componentes abajo:

  • DocumentRoot --- el directorio donde los archivos estáticos y scripts PHP se encuentram, en general es htdocs
  • cgi-bin --- el directorio con permisos especiales para ejecutar scripts CGI, generalmente es cgi-bin
  • bases de dados ISIS --- el directorio donde las bases de datos ISIS se encuentran, en general es 'bases

A continuación, mover/copiar o crear enlaces simbólicos para los directorios del isis-oai-provider:

Ex. Suponiendo un sitio web con la siguiente estructura de directorios:

 /home/sites/
            /site1/
                   htdocs/
                   cgi-bin/
                   bases/

Siga los pasos abajo para crear enlaces simbólicos para los directorios de la aplicación:

 $ cd /home/sites/site1/htdocs
 $ ln -s /opt/bireme/isis-oai-provider/htdocs/isis-oai-provider/ .
 $ cd /home/sites/site1/cgi-bin
 $ ln -s /opt/bireme/isis-oai-provider/cgi-bin/isis-oai-provider/ .

Antes de empezar la configuración

Para que el ISIS-OAI-Provider funcione correctamente es necesario renombrar algunos directorios en conformidad con la plataforma utilizada.

  1. Si es un sistema operativo Linux, renombra a los directorios abajo:
    • Ejecutables binarios (WWWISIS)
      • de: cgi-bin/isis-oai-provider-linux
      • para: cgi-bin/isis-oai-provider
    • Tabla de tradución de metadatos (oai_dc)
      • de: htdocs/isis-oai-provider/gizmo-linux
      • para: htdocs/isis-oai-provider/gizmo
  2. Si es un sistema operativol Windows, renombra a los directorios abajo:
    • Ejecutables binarios (WWWISIS)
      • de: cgi-bin/isis-oai-provider-windows
      • para: cgi-bin/isis-oai-provider
    • Tabla de tradución de metadatos (oai_dc)
      • de: htdocs/isis-oai-provider/gizmo-windows
      • para: htdocs/isis-oai-provider/gizmo

NOTAS:

  1. Garantize que los archivos ejecutables esteam con permiso para ejecución en la linea de comando y tambíen via interfaz CGI;
  2. Las versiones de archivos ejecutables del paquete son todas 32 bits;
  3. Tenemos versiones 64 bits compiladas solamente para Linux.

Archivos de configuración

Cambiar los archivos de configuración de la muestra de la siguiente manera:

 $ cd htdocs/isis-oai-provider/
 $ mv oai-config-sample.php oai-config.php
 $ mv oai-databases-sample.php oai-databases.php

Modificar los archivos oai-config.php y oai-databases.php en conformidad con los pasos abajo:

oai-config.php

  • cambiar el contenido de la variable DATABASE_PATH para el directorio 'bases' de la instalación actual
DATABASE_PATH=/home/www/my-iah/bases
  • altere el contenido de la variable NAME para un nombre que identifique la instancia
NAME=MyIAHdb
  • altere el contenido de la variable EMAIL para la dirección del correo electrónico de la persona encargada por los datos
EMAIL=me@institution.org
  • altere el contenido de las variables IDPREFIX y IDDOMAIN en conformidad con la información de dominio de su instancia
IDPREFIX=br
IDDOMAIN=bvs

Ejemplo: www.bvssmu.org.uy

IDPREFIX=uy
IDDOMAIN=org


  • configure la variable EARLIESTDATESTAMP para una fecha próxima del princípio de la entrada de datos de la instancia
    • Es un dato fijo
EARLIESTDATESTAMP=1998-12-30

oai-databases.php

Cada base de datos debe ser configurada teniendo en cuenta la siguiente estructura y campos mandatorios:

[set-spec]
name=
description=
database=
mapping=
prefix=oai_date_
isis_key_length=<1660|1030>
identifier_field=<tag>
datestamp_field=<tag>
  • [set-spec] empeza y describe una sección para aquela base de datos y identifica el nombre lógico de ese conjunto de datos. Esta información es presentada en el verbo ListSets y tambiém es parte del identificador único de cada documento.

ej.:

[lilacs]
  • La variable name sirve como una etiqueta para el conjunto de datos que será mostrado en el verbo ListSets.

ej.:

name=LILACS
  • La variable description contiene la descripción del conjunto de datos que será mostrado en el verbo ListSets.

ej.:

description="LILACS Database"
  • La variable database contiene la dirección para el directorio y el nombre del archivo maestro de la base de datos.

ej.:

database=/home/www/my-iah/bases/iah/dblil
  • La variable mapping se refiere al nombre del formato utilizado para asignar elementos de datos. (Se localiza en el subdirectorio map/)

ej.:

mapping=lilacs-dc.pft

  • La variable prefix especifica un prefijo para el campo de fecha. Este prefijo debe ser incluido en el archivo FST de la base de datos para la regeneración del invertido.

ej.:

prefix=oai_date_

ej. de inversión para incluir en la LILACS.FST

93 0 |oai_date_|v93^*/
  • La variable isis_key_length define el mínimo y el máximo para la clave que se utiliza para la inversión de la base de datos. Hay que tener mucha atención con la versión utilizada especialmente de acuerdo con su origen (ej. LILACS es 1660, IAH es 1030)

ej.:

isis_key_length=1660
  • La variable identifier_field informa la tag del identificador único de los registros

ej.:

identifier_field=2
  • La variable datestamp_field informa la tag de la fecha de creación del registro

ej.:

datestamp_field=93

Por lo tanto, si hay necesidad de añadir nuevas bases de datos en la configuración, solamente es necesario llenar los campos informados arriba en conformidad con los parámetros y añadir al archivo.

NOTA: Mientras que el nombre de la sección también es el nombre de la base de datos, no se permiten duplicidades para estos campos.

Probando

Probar la aplicación empezando el navegador de internet deseado y informar el nombre del dominio en acuerdo con el modelo: http://nombre_del_servidor/isis-oai-provider/

Ej.: http://isis-oai-provider.local/isis-oai-provider/

Documentación OAI