User Tools

Site Tools


instalacion_de_opacmarc

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revision Previous revision
Next revision
Previous revision
instalacion_de_opacmarc [18/12/2006 09:34]
fernando acceso a múltiples bases
instalacion_de_opacmarc [25/05/2009 00:00] (current)
Line 1: Line 1:
-====== OPACMARC - Guía de instalación (versión ​actual: ​2006.11.13) ======+====== OPACMARC - Guía de instalación (versión 2006.11.13) ======
  
 [[http://​inmabb.criba.edu.ar/​catalogo/​|{{opacmarc-1-500.png|Página principal del catálogo de la Biblioteca del INMABB}}]] [[http://​inmabb.criba.edu.ar/​catalogo/​|{{opacmarc-1-500.png|Página principal del catálogo de la Biblioteca del INMABB}}]]
 +
 +
 +<​note>​
 +Esta información corresponde a una versión antigua de OpacMarc. Para la versión más reciente, visite http://​code.google.com/​p/​opacmarc/​
 +</​note>​
  
 ===== Introducción ===== ===== Introducción =====
  
-OPACMARC es... bueno, un OPAC... que se lleva muy bien con MARC. En otras palabras, es una aplicación que permite publicar en la Web una o más bases bibliográficas en formato MARC 21, y que intenta sacar provecho de gran parte de la información presente en los registros, para así ofrecer a los usuarios de nuestras bibliotecas una buena herramienta de búsqueda.+OPACMARC es, sencillamente, un OPAC que se lleva muy bien con MARC. En otras palabras, es una aplicación que permite publicar en la Web una o más bases bibliográficas en formato MARC 21, y que intenta sacar provecho de gran parte de la información presente en los registros, para así ofrecer a los usuarios de nuestras bibliotecas una buena herramienta de búsqueda.
  
 (En realidad, OPACMARC debiera llamarse de alguna otra manera --no es necesario que aparezcan en el nombre ni //OPAC// ni //MARC//--, pero hasta tanto algo mejor se nos ocurra seguiremos llamándolo así.) (En realidad, OPACMARC debiera llamarse de alguna otra manera --no es necesario que aparezcan en el nombre ni //OPAC// ni //MARC//--, pero hasta tanto algo mejor se nos ocurra seguiremos llamándolo así.)
Line 16: Line 21:
  
   - software para ejecutar la aplicación web, es decir el OPAC propiamente dicho.   - software para ejecutar la aplicación web, es decir el OPAC propiamente dicho.
-  - software para //​actualizar ​el OPAC//, es decir, para generar --a partir de una base bibliográfica original-- las bases que serán publicadas.+  - software para //​actualizar ​los datos del OPAC//, es decir, para generar --a partir de una base bibliográfica original-- las bases que serán publicadas.
  
 La primera instalación pública de OPACMARC, y que puede tomarse como referencia para testear el funcionamiento del sistema, es la de la [[http://​inmabb.criba.edu.ar/​catalogo/​|Biblioteca Dr. Antonio Monteiro, del Instituto de Matemática de Bahía Blanca]], donde OPACMARC fue desarrollado desde 2003. La primera instalación pública de OPACMARC, y que puede tomarse como referencia para testear el funcionamiento del sistema, es la de la [[http://​inmabb.criba.edu.ar/​catalogo/​|Biblioteca Dr. Antonio Monteiro, del Instituto de Matemática de Bahía Blanca]], donde OPACMARC fue desarrollado desde 2003.
 +
 +
 +
  
 ===== Requerimientos===== ===== Requerimientos=====
  
  
-  * Sistema operativo: el OPAC puede instalarse en **Linux** o en **Windows**. Sin embargo, el script de actualización está disponible solamente para Linux, aunque incluye una opción de configuración para convertir las bases generadas de modo que puedan ser usadas en Windows. Este script tiene una [[opac.bat|versión para Windows]] que ha quedado desactualizada,​ pero afortunadamente Rubén Mansilla se está ocupando de ponerla al día. +==== Sistema operativo ​==== 
-  + 
-  ​* ​Software adicional +El OPAC puede instalarse en **Linux** o en **Windows**. Sin embargo, el script de actualización está disponible solamente para Linux, aunque incluye una opción de configuración para convertir las bases generadas de modo que puedan ser usadas en Windows. ​<del>Este script tiene una [[opac.bat|versión para Windows]] que ha quedado desactualizada,​ pero afortunadamente Rubén Mansilla se está ocupando de ponerla al día.</​del>​ Actualización (feb 2008): el plan es migrar el script ''​update-opac.sh''​ al lenguaje Python, y así lograr que funcione independientemente de la plataforma
-    * Software utilizado para el OPAC: + 
-      * **Servidor web** (e.g. Apache). En esta guía supondremos que ya se cuenta con un servidor web instalado. + 
-      * **wxis** (wwwisis 5.x): se puede descargar desde Bireme: ​http://productos.bvsalud.org/​product.php?id=wwwisis&​lang=es. OPACMARC ha sido probado con las versiones 5.0 y 5.4 de wxis. +==== Software adicional ​==== 
-      * **agrep**: herramienta para encontrar coincidencias aproximadas,​ utilizada en OPACMARC para generar sugerencias al estilo "did you mean?" de Google. Su instalación es opcional, pero recomendada. Agrep está disponible para Windows en http://​www.tgries.de/​agrep/​. Para Linux, puede compilarse a partir del [[http://​freshmeat.net/​projects/​agrep/​|código fuente]], o bien se puede recurrir al administrador de paquetes de la distribución que usen. Por ejemplo, usando Synaptic en Ubuntu Dapper en octubre de 2006 se instala ''​agrep_4.17-2_i386.deb''​. + 
-    * Software utilizado para la actualización del OPAC: +  ​* Software utilizado para el OPAC: 
-      * **Utilitarios Cisis**: ​se descargan en http://productos.bvsalud.org/​product.php?id=cisis&​lang=es. //No utilice versiones viejas//; todo anda bastante bien con la versión 4.3a. +    * **Servidor web** (e.g. Apache). En esta guía supondremos que ya se cuenta con un servidor web instalado. 
-/* ''​mx'',​ ''​i2id'',​ ''​id2i''​ y ''​msrt''​ (también ''​crunchmf''​ y ''​crunchif'',​ si se desea convertir las bases generadas al "​formato Windows"​) */+    * **wwwxis** (también conocido como **wxis**): se puede [[http://bvsmodelo.bvsalud.org/​php/level.php?​lang=es&​component=28&​item=2|descargar desde Bireme]]. OPACMARC ha sido probado con la versión **Estándar (10/​30)** ​de wxis. 
 +    * **agrep**: herramienta para encontrar coincidencias aproximadas,​ utilizada en OPACMARC para generar sugerencias al estilo "did you mean?" de Google. Su instalación es opcional, pero recomendada. Agrep está disponible para Windows en http://​www.tgries.de/​agrep/​. Para Linux, puede compilarse a partir del [[http://​freshmeat.net/​projects/​agrep/​|código fuente]], o bien se puede recurrir al administrador de paquetes de la distribución que usen. Por ejemplo, usando Synaptic en Ubuntu Dapper en octubre de 2006 se instala ''​agrep_4.17-2_i386.deb''​. 
 + 
 +  ​* Software utilizado para la actualización ​de las bases de datos del OPAC: 
 +    * **Utilitarios Cisis**: ​[[http://bvsmodelo.bvsalud.org/​php/level.php?​lang=es&​component=28&​item=1|se descargan del sitio de Bireme]]. También debe elegirse la versión **Estándard (10/30)**. //No utilice versiones viejas//. /* ''​mx'',​ ''​i2id'',​ ''​id2i''​ y ''​msrt''​ (también ''​crunchmf''​ y ''​crunchif'',​ si se desea convertir las bases generadas al "​formato Windows"​) */
  
 ===== Pasos ===== ===== Pasos =====
Line 47: Line 59:
   * Dentro de la carpeta ''​opacmarc-2006.11.13''​ encontrará 4 carpetas, que deberá copiar de esta manera:   * Dentro de la carpeta ''​opacmarc-2006.11.13''​ encontrará 4 carpetas, que deberá copiar de esta manera:
     * ''​htdocs'',​ ''​bases''​ y ''​cgi-bin''​ son las carpetas asociadas al servidor web, que deben recibir el mismo tratamiento que en la [[http://​inmabb.criba.edu.ar/​catalis/​instalacion/​guia-instalacion.html#​instalar|instalación de Catalis]] (lea ''​opacmarc''​ donde dice ''​catalis_pack''​).     * ''​htdocs'',​ ''​bases''​ y ''​cgi-bin''​ son las carpetas asociadas al servidor web, que deben recibir el mismo tratamiento que en la [[http://​inmabb.criba.edu.ar/​catalis/​instalacion/​guia-instalacion.html#​instalar|instalación de Catalis]] (lea ''​opacmarc''​ donde dice ''​catalis_pack''​).
-    * ''​opacmarc-admin''​ es la carpeta usada para generar las actualizaciones del OPAC; como no tiene relación con el servidor web, esta carpeta puede ubicarse en cualquier parte, incluso en otra máquina.+    * ''​opacmarc-admin''​ es la carpeta usada para generar las actualizaciones ​de las bases del OPAC; como no tiene relación con el servidor web, esta carpeta puede ubicarse en cualquier parte, incluso en otra máquina.
  
   * Copie el archivo ''​wxis''​ en la carpeta ''​cgi-bin/​opacmarc''​. Si tiene el archivo de licencia ''​wxis.lic'',​ también cópielo en esa carpeta. //​Alternativamente//,​ si prefiere tener estos archivos en otra ubicación, puede crear links simbólicos:​   * Copie el archivo ''​wxis''​ en la carpeta ''​cgi-bin/​opacmarc''​. Si tiene el archivo de licencia ''​wxis.lic'',​ también cópielo en esa carpeta. //​Alternativamente//,​ si prefiere tener estos archivos en otra ubicación, puede crear links simbólicos:​
Line 57: Line 69:
   * Archivos de configuración:​   * Archivos de configuración:​
     * Para el OPAC: las opciones de configuración están definidas en el archivo ''​cgi-bin/​opacmarc/​opac/​config/​opacmarc.conf''​. Para facilitar la instalación de futuras actualizaciones de OPACMARC, se recomienda **no modificar** este archivo; todas las opciones de configuración locales (es decir, aquellas que difieran de los valores predeterminados en ''​opacmarc.conf''​) se deben colocar en el archivo ''​cgi-bin/​opacmarc/​opac/​config/​local.conf''​. Mantenga el archivo ''​local.conf''​ lo más chico posible; //sólo incluya en él los parámetros de configuración que necesite redefinir//​.     * Para el OPAC: las opciones de configuración están definidas en el archivo ''​cgi-bin/​opacmarc/​opac/​config/​opacmarc.conf''​. Para facilitar la instalación de futuras actualizaciones de OPACMARC, se recomienda **no modificar** este archivo; todas las opciones de configuración locales (es decir, aquellas que difieran de los valores predeterminados en ''​opacmarc.conf''​) se deben colocar en el archivo ''​cgi-bin/​opacmarc/​opac/​config/​local.conf''​. Mantenga el archivo ''​local.conf''​ lo más chico posible; //sólo incluya en él los parámetros de configuración que necesite redefinir//​.
-    * Para el proceso de actualización ​del OPAC: edite el archivo ''​opacmarc-admin/​conf.sh''​. Preste atención especialmente a las siguientes opciones:+    * Para el proceso de actualización ​de bases de datos: edite el archivo ''​opacmarc-admin/​conf.sh''​. Preste atención especialmente a las siguientes opciones:
       * ''​OPACMARC_DIR'':​ la ruta absoluta del directorio ''​opacmarc-admin''​.       * ''​OPACMARC_DIR'':​ la ruta absoluta del directorio ''​opacmarc-admin''​.
       * ''​PATH'':​ sólo si el directorio de los utilitarios Cisis no se encuentra ya en el PATH.       * ''​PATH'':​ sólo si el directorio de los utilitarios Cisis no se encuentra ya en el PATH.
Line 154: Line 166:
  
 NOTA: desde una misma instalación de OPACMARC es posible brindar acceso a múltiples bases, repitiendo el proceso descripto arriba para cada una de ellas. NOTA: desde una misma instalación de OPACMARC es posible brindar acceso a múltiples bases, repitiendo el proceso descripto arriba para cada una de ellas.
 +
 +
 +==== Imágenes de portadas ====
 +
 +OPACMARC permite asociar a registro bibliográfico una imagen --que usualmente corresponderá a la cubierta o portada del documento-- para ser visualiada en el estilo "​completo"​ y en el listado de novedades.
 +
 +No nos ocuparemos aquí de la forma de obtención de dichas imágenes. Lo que nos interesa es que los archivos (jpg, gif, png) 
 +
 +Si sus registros incluyen las imágenes de las tapas, proceda de la siguiente forma:
 +
 +
 +1) Cree un directorio para ubicar las imágenes:
 +
 + htdocs/​opacmarc/​opac/​img/​mibase/​
 +
 +
 +nótese que el directorio debe tener el mismo nombre de la base a crear
 +
 +
 +2) Si es necesario, cuando configure el archivo opacmarc-admin/​conf.sh para sus necesidades locales, revise la línea que corresponde a la ruta de las imágenes y modifíquela de acuerdo a la ubicación que éstas tienen en su servidor.
 +
 + DIR_IMG=/​opacmarc/​opac/​img
 +
 +
 +
 +3) Las imágenes deben tener como nombre el número de registro al cual corresponden,​ que se aloja en el campo 001 del registro en cuestión:
 +
 + 000234.jpg
 + 000023.gif
 +
 +
 +4) Es conveniente uniformar el tamaño de todas las imágenes.
  
 ===== Apéndice: Salida de update-opac.sh ===== ===== Apéndice: Salida de update-opac.sh =====
Line 332: Line 376:
   * revisar codificación de los archivos de texto (UTF-8, etc)   * revisar codificación de los archivos de texto (UTF-8, etc)
 */ */
 +
 +
 +{{tag>​opacmarc admin}}
instalacion_de_opacmarc.1166445271.txt.gz · Last modified: 26/06/2007 00:00 (external edit)