biblioteca digital greenstone guía de instalación
Contents
1. El procedimiento de instalaci n comienza pregunt ndole en qu directorio quiere usted instalar Greenstone El primer archivo que se instala all es el programa de desinstalaci n que despeja toda instalaci n parcial en caso de que se topara usted con problemas o terminara la instalaci n prematuramente A continuaci n usted escoge si quiere instalar los binarios o el c digo fuente Luego se formulan algunas preguntas sobre la instalaci n de su servidor Web Es necesario tener un directorio de CGI ejecutable v lido que en los sistemas Unix suele llamarse cgi bin puede usted crear uno o utilizar el existente En caso de crear uno nuevo ser necesario que introduzca 9 esta informaci n en el archivo de configuraci n de su servidor Web En cualquier caso es necesario introducir la direcci n Web del directorio CGI El di logo de instalaci n lo guiar a trav s de todas estas opciones Es importante establecer correctamente los permisos de archivo en determinados directorios y se le invita a proporcionar la informaci n necesaria Por ltimo se le invita a escoger una clave de acceso para el usuario administrador admin Todo el programa Greenstone se instala por defecto en el directorio usr local gsdl si es el usuario root quien efect a la instalaci n y de otro modo en el directorio gsdl en que es el directorio principal del usuario La instalaci n de los binarios tarda apenas unos minutos ti2. Puede usted personalizar su instalaci n modificando este archivo aunque es muy probable que no tenga que hacerlo La l nea gsdlhome se ala simplemente hacia el directorio C Program Fileslgsdl httpprefix es la direcci n Web del directorio en que Greenstone est instalado Explicamos antes c mo crear un alias de tal modo que las URL con la forma http localhost esdl se busquen en el directorio C Program Fileslgsdl A adiendo una l nea httpprefix esdl en el archivo de configuraci n gsdlsite cfg se establece la misma convenci n para el programa Greenstone httpimg es la direcci n Web del directorio C Program Fileslgsdllimages que contiene todas las im genes en formato GIF utilizadas en la interfaz En cualquier instalaci n est ndar de Greenstone ste ser siempre httpprefix images y no se toca la l nea correspondiente en el archivo antes indicado gwcgl es la direcci n Web del programa CGI de la biblioteca La mayor a de los servidores Web incluido Apache no la necesitan y debe permanecer marcado como comentario por lo tanto inactiva No se debe quitar la marca de comentario a menos de estar seguro de que es necesario pues eso puede traer problemas maxrequests s lo es utilizado por las versiones de Greenstone que se compilaron con la opci n fast cgi La distribuci n binaria est ndar no comprende esta opci n porque no todos los servidores Web est n configurados para admitirla La opci n fast cgi
3. En el Ap ndice se proporciona informaci n sobre c mo obtener Apache y Perl Fuente Unix El c digo fuente para Unix es el mismo que para Windows Se ha compilado y probado en Linux Solaris y Macintosh OS X deber a resultar sencillo adaptarlo a otras variantes de Unix Para compilar el c digo fuente de Greenstone en Unix se necesita e el compilador de GNU C GCC e el administrador de la base de datos GNU GDBM Para activar el programa Greenstone se necesita tambi n un servidor Web y el programa Perl como se indica m s arriba en Binarios Unix Instalaci n en Unix Para instalar la versi n destinada a Unix a partir del CD ROM inserte el disco en el lector y teclee mount cdrom monta el dispositivo de CD ROM este comando puede diferir de un sistema a otro por ejemplo en OS X se teclea cd en el directorio Volumes y luego se pasa al subdirectorio correspondiente al CD ROM cd cdrom cambia de directorio y pasa al directorio principal del CD ROM cd Unix cambia de directorio y pasa adonde se encuentra el gui n de instalaci n para Unix sh Install sh inicia el proceso de instalaci n se utiliza un sh expl cito porque muchas instalaciones prohiben la ejecuci n de programas directamente a partir del CD ROM Este ltimo comando inicia un di logo interactivo en que se le pregunta a usted la informaci n necesaria para instalar Greenstone en su sistema proporcionando datos precisos sobre las operaciones efectuadas
4. Est usted utilizando Windows o Unix e Si es Windows est usted utilizando Windows 3 1 3 11 o una versi n m s reciente Aunque se pueden visualizar las colecciones en las m quinas que funcionan con las versiones 3 1 6 3 11 y dar servicio a otras computadoras en la misma red no puede usted crear nuevas colecciones El programa Greenstone completo funciona con 95 98 Me y NT 2000 e Si es Unix est usted utilizando Linux u otra versi n de Unix Para Linux se proporciona una versi n binaria del sistema completo que es f cil de instalar Para otros tipos de Unix tendr usted que instalar el c digo fuente y compilarlo Para ello puede ser preciso instalar en su computadora programas suplementarios Otro Versi n co disponi No pro Si es Windows NT 2000 o Unix puede usted iniciar la sesi n como administrador del sistema o root Esto puede ser necesario para configurar adecuadamente un servidor Web para Greenstone Quiere usted el c digo fuente Si est usted utilizando Windows o Linux puede usted instalar solamente los binarios Pero es posible que quiera usted tambi n el c digo fuente ste viene en la distribuci n de Greenstone Quiere usted crear nuevas colecciones de biblioteca digital En tal caso es necesario que tenga Perl disponible gratuitamente para Windows y Unix Su computadora maneja un servidor Web Greenstone viene con un servidor Web Windows No obstante si ya est usted utilizando
5. s sela Se la recomendamos Compilando la Interfaz de Bibliotecario de Greenstone Si usted baj la versi n con el c digo fuente de Greenstone entonces tendr con usted el c digo fuente Java de la Interfaz de Bibliotecario Para compilarlo su computadora necesitar contar con una versi n adecuada del Kit de Desarrollo de Software Java En el Ap ndice usted encontrar mayor informaci n sobre la forma de obtenerla Para compilar el c digo fuente ejecute los archivos makegli bat Windows o makegli sh UNIX Una vez que haya hecho esto usted podr correr la GLI tal como se describe arriba 2 5 Pruebas y soluci n de problemas Para probar Greenstone dirija su navegador Web hacia la p gina principal de Greenstone y explore la colecci n de demostraci n y cualquier otra colecci n que haya usted instalado No se preocupe no va a romper nada Pulse libremente se puede hacer clic en la mayor a de las Im genes que aparecen en la pantalla Si se mantiene el cursor quieto sobre una imagen en la mayor a de los navegadores aparece un mensaje en que se explica lo que suceder si se hace clic 12 Experimente y ver Elija palabras comunes como the el y and y para ejercitarse en la b squeda y no tema que nada se va a romper Para m s informaci n v ase la Gu a del Usuario de la Biblioteca Digital Greenstone Soluci n de problemas BIBLIOTECA LOCAL s lo con Windows BIBLIOTECA WEB WINDOWS Y U
6. 2 pero el icono de la colecci n de demostraci n no aparece Abra el programa library en el directorio cgi bin a partir del indicador de DOS o del shell para obtener informaci n sobre depuraci n que le ayudar a localizar el problema Cuando dirijo mi navegador hacia la Biblioteca Digital no puede encontrar esa p gina Intente utilizar 127 0 0 1 en lugar de localhost Este n mero IP reservado se define como un bucle de retroceso hacia su computadora local 14 Mi navegador se queja de que no puede encontrar main cfg Verifique que los archivos de Greenstone existen y que son legibles por todos Si est usando la biblioteca Web intente activar el programa library a partir de la l nea de comandos Si funciona bien el problema es con los permisos de archivo v ase la Secci n 5 1 En caso contrario es probable que la variable gsdlhome est configurada incorrectamente en el archivo de configuraci n gsdlsite cfg v ase la Secci n 5 2 Tengo problemas con la utilizaci n del Colector Lea la Gu a del Usuario de la Biblioteca Digital Greenstone Secci n 3 He a adido un nuevo usuario pero no parece poder iniciar la sesi n Verifique que el directorio C Program Fileslgsdlletc y todo su contenido son modificables v ase Secci n 5 1 2 6 Para obtener m s informaci n Para obtener m s informaci n sobre los entresijos de su instalaci n G
7. 2 3 Instalaci n simple Para instalar la versi n Windows a partir del CD ROM inserte el disco en el lector por ejemplo D Si al cabo de unos 20 segundos el procedimiento de instalaci n no comienza autom ticamente pulse en el men nicio seleccione Ejecutar y teclee D Windows Setup exe donde D es la letra que designa su lector de CD ROM Para Windows 3 1 seleccione Ejecutar en el Administrador de archivos y teclee D Windows Setup exe Para proceder a la instalaci n m s simple basta con aceptar el par metro por defecto en cada etapa pulsando el bot n Next siguiente Eso es todo Greenstone queda instalado en el directorio C Program Fileslgsdl stone di g ital AYUDA PREFERENCIAS software seleccionar una colecci n The Collector Le ayuda crear nuevas colecciones modificar o suprimir colecciones existentes o a adir documentos a una colecci n Administration Le permite a adir nuevos usuarios da un resumen de las colecciones que hay en el sistema y proporciona informaciones t cnicas sobre la instalaci n de Greenstone Greenstone Le proporciona informaci n sobre el software Greenstone y el proyecto de Biblioteca Electr nica de Nueva Zelandia de donde proviene Documentation Manuales de Greenstone ae 2 Transferring data from localhost N Figura 2 Su p gina principal Greenstone Una vez concluida la instalaci n para arrancar su sistema Greenstone pulse el bot n Inic
8. HTML para introducir el contenido que usted quiera ver en la p gina El texto es HTML normal si lo desea puede incluir hyperv nculos y utilizar todas las dem s funciones que ofrece HTML 25 PRINCIPAL AYUDA PREFERENCI Su propia p gina principal para Greenstone P gina de b squeda para la colecci n demo Presione aqu P gina sobre para la colecci n demo Presione aqu P gina de preferencias para la colecci n demo Presione aqu P gina principal Presione aqu P gina de ayuda Presione aqu P gina de administraci n Presione aqu El Collector Presione aqu Y QF ea Transferring data from localhost E Figura 3 Su propia p gina principal Greenstone package home _content_ lt h2 gt Su propia p gina principal para Greenstone lt h2 gt lt ul gt lt table gt lt tr valign top gt lt td gt P gina de b squeda para la colecci n demo lt br gt lt td gt lt td gt lt a href _httpquery sc demo gt Presione aqu lt a gt lt td gt lt tr gt lt tr gt lt td gt P gina sobre para la colecci n demo lt td gt lt td gt lt a href _httppageabout_sc demo gt Presione aqu lt a gt lt td gt lt tr gt lt tr gt lt td gt P gina de preferencias para la colecci n demo lt td gt lt td gt lt a href _httppagepref_8sc demo gt Presione aqu lt a gt lt td gt lt tr gt lt tr gt lt td gt P gina principal lt td gt lt td gt lt a href _httppagehome_ gt Presione aqu lt a gt
9. a home dm pero definir el package home que es la parte que efect a el trabajo efectivo de un modo distinto Al crear una p gina principal diferente hay que poder vincularla a las p ginas de la biblioteca digital para que usted pueda efectuar b squedas y consultar las colecciones en su sistema La soluci n adoptada por Greenstone es utilizar macros Por esa raz n el archivo de la p gina principal tiene por sufijo dm y no html es un archivo macro y no un archivo HTML ordinario Pero no se preocupe el archivo macro s lo contiene b sicamente el HTML acompa ado de unos cuantos ensalmos m gicos que se explican m s abajo El lenguaje macro es una funci n potente y s lo se describe una peque a parte de ella m s abajo V ase la Gu a del Programador de la Biblioteca Digital Greenstone para obtener m s informaci n al respecto 6 1 Ejemplo En la Figura 3 se muestra un ejemplo de una nueva p gina principal de la biblioteca digital Cada uno de los enlaces Presione aqu lo lleva a la funci n de Greenstone apropiada Esta p gina se produjo mediante un archivo llamado yourhome dm que se muestra en la Figura 4 Puede usted utilizar la Figura 4 como plantilla para crear su propia p gina principal de Greenstone personalizada B sicamente define una macro llamado content Entre llaves hay un HTML ordinario Puede usted insertar texto suplementario as como cualquiera de los comandos de formato
10. embargo los caracteres especiales Y W y _ deben ser precedidos de una barra inversa para evitar que sean procesados por el int rprete del lenguaje macro Obs rvese que la definici n de la macro _content_ no contiene ning n encabezado o pie de p gina HTML Si desea usted cambiar el encabezado o el pie de su p gina principal debe definir macros _header_ y o _footer_ a adi ndolas a su archivo yourhome dm de la siguiente forma _macroname Por ejemplo la barra verde ondulada que aparece en el lado izquierdo de las p ginas de Greenstone est definida en la macro _header_ y al anular esta macro se la har desaparecer como se indica al final de la Figura 4 6 2 C mo hacer que funcione Hay que indicar a Greenstone que se ha creado una nueva p gina principal yourhome dm El sistema lee en los archivos macro especificados en el archivo de configuraci n principal main cfg y por lo tanto si usted crea uno nuevo debe incluirlo all Los conflictos de nombres se manejan con el siguiente criterio la definici n m s reciente tiene prioridad sobre las dem s Por consiguiente para que el programa Greenstone de biblioteca digital utilice la p gina principal de la Figura 3 en vez de la instalada por defecto primero ponga el archivo yourhome dm de la Figura 4 en el directorio de macros Luego modifique el archivo de configuraci n main cfg para reemplazar home dm por yourhome dm en la lista de archivos macro que se cargan a
11. en la distribuci n de Greenstone Es poco probable que logre usted compilar Greenstone en una computadora que funcione con un sistema Windows 3 1 3 11 En caso de que usted vuelva a compilar Greenstone y desee utilizar la versi n nuevamente compilada para crear discos CD ROM debe tomar nota de que el c digo producido por las 7 versiones recientes del compilador Visual C no funciona con Windows 3 1 3 11 no habiendo en cambio problema alguno con sistemas Windows ulteriores 95 98 Me NT 2000 Si desea que sus CD ROM puedan leerse en m quinas con sistemas Windows antiguos se necesitar otra versi n del compilador Adem s Greenstone utiliza STL Standard Template Library la biblioteca est ndar de plantillas para C y aunque esos compiladores vienen a veces con STL la versi n proporcionada no siempre funciona correctamente Por consiguiente para volver a compilar Greenstone de tal modo que produzca discos CD ROM que funcionen con versiones antiguas de Windows se necesita e el compilador Microsoft Visual C versi n 4 0 4 2 una versi n externa de STL la biblioteca est ndar de plantillas para C STL viene incluida en el sistema Greenstone para poder utilizarla con esas versiones del compilador Cabe se alar que el procedimiento de instalaci n de Windows no propone compilar Greenstone si se escoge instalar el c digo fuente Para obtener instrucciones sobre la compilaci n de Greenstone relativas a su p
12. la Interfaz de Bibliotecario de Greenstone primero deber instalar un Kit de Desarrollo de Software Java SDK por sus siglas en ingl s Usted puede bajar el Kit de Desarrollo de Software J2SE desde http java sun com 2se downloads html Se requiere la versi n 1 4 0 o superior
13. la colecci n de demostraci n de Greenstone El Colector En la p gina principal de la biblioteca digital figura un enlace hacia el Colector Administraci n En la p gina principal de la biblioteca digital figura un enlace hacia las p ginas de Administraci n El usuario administrador se llama admin con una clave de acceso que usted escogi durante el proceso de instalaci n El administrador est autorizado a a adir nuevos usuarios y a crear colecciones 2 4 La Interfaz de Bibliotecario de Greenstone GLI La Interfaz de Bibliotecario de Greenstone GLI por sus siglas en ingl s es una herramienta gr fica que le ayuda a construir bibliotecas digitales d ndole acceso a todas las funciones de Greenstone por medio de una interfaz f cil de usar con la que s lo tiene que apuntar y hacer click GLI se instala autom ticamente con todas las versiones de Greenstone en el subdirectorio gli del directorio principal de la biblioteca digital C Program Fileslgsdllgli por omisi n Recuerde que la interfaz corre en conjunto con los programas de Greenstone y no funcionar adecuadamente a menos que se encuentre en un subdirectorio de Greenstone Si usted ya baj alguna de las versiones de Greenstone entonces ste ser el caso 11 Para poder usar la GLI su computadora deber contar con el Ambiente de Ejecuci n Java Si todav a no lo tiene el programa de instalaci n se ofrecer a instalar la versi n que est incluida en el CD
14. lt td gt lt tr gt lt tr gt lt td gt P gina de ayuda lt td gt lt td gt lt a href _httppagehelp_ gt Presione aqu lt a gt lt td gt lt tr gt lt tr gt lt td gt P gina de administraci n lt td gt lt td gt lt a href _httppagestatus _ gt Presione aqu lt a gt lt td gt lt tr gt lt tr gt lt td gt El Colector lt td gt 26 lt td gt lt a href _httppagecollector gt Presione aqu lt a gt lt td gt lt tr gt lt table gt lt ul gt H if you hate the squirly green bar down the left hand side of the page uncomment these lines _header_ 7 Figura 4 yourhome dm utilizado para crear la Figura 3 Para vincular su nueva p gina principal con otras p ginas de la biblioteca digital debe usted hacer uso de un conjuro m gico adecuado En este lenguaje macro los conjuros m gicos son palabras flanqueadas por signos de subrayado como se puede ver en la Figura 4 Por ejemplo _httppagehome_ lo lleva a la p gina principal httppagehelp_ a la p gina de ayuda y as sucesivamente En algunos casos es necesario incluir un nombre de colecci n Por ejemplo _httpquery_ c demo especifica la p gina de b squeda de la colecci n de demostraci n para otras colecciones se debe reemplazar demo por el nombre de la colecci n correspondiente La definici n de la macro llamada _content_ es HTML simple Cualquier c digo HTML est ndar puede colocarse dentro de una definici n de macro Sin
15. lugar de introducir las directivas de reenv o en el archivo httpd conf puede usted ponerlas en un archivo llamado htaccess dentro del directorio ra z de los documentos de su servidor De hecho esta soluci n tiene dos ventajas En primer lugar las modificaciones efectuadas en el archivo htaccess surten efecto de inmediato mientras que es necesario volver a arrancar el servidor Web Apache para ver los efectos de los cambios en el archivo httpd conf En segundo lugar en los sistemas Unix suele ser necesario iniciar la sesi n como el usuario roof para poder modificar el archivo httpd conf mientras que no lo es para modificar el archivo htaccess AP NDICE PROGRAMAS ASOCIADOS A continuaci n se explica c mo conseguir los paquetes de programas mencionados en este documento A 1 Servidor Web Apache Para hacer funcionar cualquier versi n de Greenstone aparte de la versi n de Biblioteca Local de Windows se necesita un servidor Web externo Muchas instalaciones en particular las m s voluminosas tendr n ya un servidor Web Si usted utiliza Linux Apache puede encontrarse en su disco de instalaci n pero puede no haber sido seleccionado durante el procedimiento de instalaci n El servidor Web Apache de www apache org es libre y f cil de instalar A 2 Perl Para crear colecciones con Greenstone se necesita el lenguaje Perl versi n 5 o superior Para Windows recomendamos ActivePerl de www activestate com La mayor a de los sis
16. pueden incidir en el procedimiento de instalaci n En la Secci n 1 se mencionan algunos puntos que tendr usted que examinar antes de instalar Greenstone En la Secci n 2 se detalla el procedimiento de instalaci n para todas las distintas versiones s lo es necesario que lea usted la parte correspondiente a su sistema operativo La Secci n 3 trata de las colecciones de demostraci n de la biblioteca digital que est n incluidas en la distribuci n En la Secci n 4 se explica c mo instalar servidores Web comunes Apache y PWS IS de Microsoft para que funcionen con Greenstone En la Secci n 5 se mencionan varias opciones de configuraci n de Greenstone y en la Secci n 6 se muestra c mo crear una p gina principal personalizada para la instalaci n de su biblioteca digital Por ltimo en el Ap ndice se enumeran los programas asociados y se indica c mo obtenerlos Conjunto de documentos La serie completa de documentos comprende cinco vol menes La Gu a de Instalaci n de la Biblioteca Digital Greenstone el presente documento La Gu a del Usuario de la Biblioteca Digital Greenstone La Gu a del Programador de la Biblioteca Digital Greenstone La Biblioteca Digital Greenstone del Papel a la Colecci n La Biblioteca Digital Greenstone uso del Organizador 111 Agradecimientos El programa Greenstone es fruto de la colaboraci n de muchas personas Rodger McNab y Stefan Boddie son los principales arquitectos y programadores Tam
17. 6 cltbib e cltext e MARC e oai e image e authen e garish Isis e Colecci n bibliogr fica 7 Mb Suplemento bibliogr fico 1 Mb Colecci n de muestra MARC 1 Mb Colecci n de muestra OAI 18 Mb Colecci n de Im genes sencillas 1 Mb Demostraci n de formateo y autenticaci n 8 Mb Versi n Garish de la colecci n de muestra 8 Mb Colecci n de muestra CDS ISIS 1 Mb Con aproximadamente 4 000 entradas bibliogr ficas esta colecci n incorpora una interfase de b squeda basada en formas que permite la b squeda por campos Es bastante compleja Esta peque a colecci n de 10 entradas bibliogr ficas ilustra el programa supercolecci n de Greenstone el cual busca en varias colecciones al mismo tiempo Opera junto con la colecci n Bibliogr fica y su archivo de configuraci n es casi id ntico Basada en algunos registros MARC de la Biblioteca del Congreso sta es una colecci n sencilla aunque no permite la b squeda basada en formas Por medio del Protocolo de Archivo Abierto y la funci n Import From sta recupera metadatos de un archivo y construye una colecci n a partir de los registros En este caso se trata de im genes por lo que se utilizan tanto el plugin OAI como el plugin ImagePlug Esta colecci n de im genes es sumamente b sica y no contiene texto ni metadatos expl citos lo que m s bien la hace poco pr ctica El archivo de configuraci n es lo
18. BIBLIOTECA DIGITAL GREENSTONE GUIA DE INSTALACION Ian H Witten y Stefan Boddie Departamento de Inform tica Universidad de Waikato Nueva Zelanda Greenstone es un conjunto de programas y aplicaciones de software especialmente dise ados para la creaci n y difusi n de colecciones documentales digitales el cual le ofrece una nueva forma de organizar la informaci n y publicarla en Internet o CD ROM Greenstone ha sido elaborado como parte del proyecto de Biblioteca Digital de Nueva Zelanda de la Universidad de Waikato y actualmente es desarrollado y distribuido en colaboraci n con la UNESCO y la ONG Human Info Es un software de c digo abierto disponible en http greenstone org bajo los t rminos y condiciones de la Licencia P blica General de GNU Queremos estar seguros que este software trabaje bien para usted Por favor comun quenos cualquier problema que tenga con l a la siguiente direcci n greenstone Wcs waikato ac nz Greenstone gsdl 2 50 Marzo de 2004 11 Acerca de este manual En este documento se explica c mo instalar Greenstone para que usted pueda utilizarlo en su propia computadora Se indica tambi n c mo obtener otros programas asociados disponibles gratuitamente el servidor Web Apache y Perl Hemos procurado que el procedimiento de instalaci n sea lo m s sencillo posible El programa funciona en diferentes plataformas y con distintas configuraciones Por consiguiente son muchos los factores que inciden o
19. NIX AMBAS VERSIONES 13 Problema Soluci n posible Cuando arranco el programa Greenstone mi computadora me invita a conectarme a mi proveedor de servicio Internet Pulse el bot n Cancelar en el cuadro de di logo Esto suele resolver el problema Cuando arranco el programa Greenstone mi computadora me sigue invitando a conectarme a mi proveedor de servicio Internet Escoja la versi n limitada cuando active Greenstone Esta versi n s lo funciona con Netscape Cuando dirijo mi navegador hacia la Biblioteca Digital no puede encontrar esa p gina Verifique su configuraci n de Internet Proxy y desconecte los proxies utilice Edit preferences en Netscape o Internet options en Explorer El Colector parece estar funcionando muy lentamente Est usted utilizando Netscape con Windows 2000 En ese caso intente utilizar m s bien Internet Explorer Parece haber cierta incompatibilidad entre Netscape y Windows 2000 Cuando arranco Apache se cierra de inmediato A ada en el archivo de configuraci n de Apache una directiva ServerName localhost v ase Secci n 4 1 Cuando dirijo mi navegador a la biblioteca digital aparece un archivo binario Verifique la directiva ScriptAlias en el archivo de configuraci n de Apache y cerci rese de que aparece antes de la directiva Alias v ase Secciones 4 2 y 4 3 Logro llegar a la p gina principal de Greenstone Figura
20. ROM En el caso de UNIX tambi n deber asegurarse de que Perl est instalado en el caso de Windows Perl ya viene incluido en el software Greenstone Por favor inf rmenos sobre cualquier problema que tenga al correr o usar la Interfaz de Bibliotecario a la siguiente direcci n greenstone dcs waikato ac nz Ejecuci n bajo Windows Para correr la GLI bajo Windows explore la carpeta gli que se encuentra en su instalaci n de Greenstone por ejemplo usando el Explorador de Windows y haga doble click en el archivo gli bat Este archivo verificar que Greenstone el Ambiente de Ejecuci n Java y Perl est n instalados e iniciar la Interfaz de Bibliotecario Ejecuci n bajo UNIX Para correr la GLI bajo UNIX cambie al directorio gli que se encuentra en su instalaci n de Greenstone y ejecute el gui n gli sh Este gui n verificar que Greenstone el Ambiente de Ejecuci n Java y Perl est n instalados y en su ruta de b squeda e iniciar la Interfaz de Bibliotecario C mo obtener ayuda La Interfaz de Bibliotecario de Greenstone cuenta con una extensa variedad de opciones de ayuda en l nea Usted puede obtenerla haciendo click en el bot n Ayuda que se encuentra en la parte superior derecha de la pantalla Esto abrir una secci n relacionada con lo que usted est haciendo es decir con el panel GLI en el que usted se encuentre en ese momento Una vez abierta haga click en la parte del texto de ayuda sobre la que usted quiera saber m
21. URL http Mocalhost esdl cgi bin hello el servidor Web intentar recuperar el archivo C Program Fileslesdllcgi binhello y ejecutarlo Sin embargo la URL http localhost cgi bin hello busca en el directorio cgi bin normal de Apache el archivo C Program Files Apache Group Apache cgi bin hello y lo ejecuta tal como lo hizo antes El directorio ra z de los documentos El directorio ra z de los documentos es la ra z de la estructura de directorios de su servidor Web Una vez instalado Apache dispone como ra z de documentos de C Program Files Apache GrouplApachelhtdocs Esto significa que si se le presenta la URL ht1p localhost hello html el 19 servidor Web intentar recuperar un archivo llamado hello html desde dentro del directorio antes mencionado Greenstone contiene varios archivos que el servidor Web tiene que leer La manera m s sencilla de proceder es utilizando la directiva Alias que es como ScriptAlias salvo que se aplica a las p ginas Web ordinarias no a los guiones CGI Inserte las siguientes l neas en su archivo de configuraci n Apache despu s de la directiva ScriptAlias a fin de a adir C Program Fileslgsdl como lugar suplementario donde buscar documentos Alias gsdl C Program Files gsdl lt Directory C Program Files gsdl gt Options Indexes MultiViews FollowSymLinks AllowOverride None Order allow deny Allow from all lt Directory gt Esto significa que cualquier URL que se ajuste al prim
22. a Secci n 4 se explica detalladamente qu partes de la instalaci n de un servidor Web Apache afectan a Greenstone y c mo hay que modificarlas Ello supone incluir una media docena de l neas en un archivo de configuraci n No es necesario que sea usted el usuario roof de Unix para ejecutar el procedimiento de instalaci n antes expuesto Sin embargo trat ndose de la configuraci n de un servidor Apache ser preciso disponer de privilegios de roof todo depende de c mo se instale Apache Si instala Apache usted mismo puede hacerlo como un usuario carente de privilegios de roof Si resulta 10 necesario eludir un administrador de sistema poco dispuesto a cooperar es posible instalar en su computadora un segundo servidor Web Apache aun si ya existe uno 2 3 C mo encontrar Greenstone Biblioteca Local s lo con Windows Si est utilizando la Biblioteca Local ejecute simplemente el programa Greenstone a partir del men de nicio Esto activa autom ticamente su navegador Internet y carga la p gina principal de la Biblioteca Digital Greenstone A partir de esta p gina se podr tener acceso a la colecci n de demostraci n de Greenstone Biblioteca Web Windows y Unix Si est utilizando la Biblioteca Web una vez instalado el programa y configurado el servidor Web utilice esta URL para entrar en su sistema Greenstone http Mlocalhost gsdl cgi bin library A partir de esta p gina se podr tener acceso a
23. acelera las ejecuciones de los guiones CGI manteniendo en memoria el ejecutable principal entre dos utilizaciones del programa en vez de cargarlo a partir del disco cada vez que el programa Greenstone solicita una p gina Web Se debe conseguir un equilibrio con la cantidad de memoria utilizada que puede aumentar mientras m s tiempo permanezca el programa en memoria Una vez generadas las p ginas maxrequests el programa CGI se cierra liberando as el espacio de memoria ocupado Para responder a la siguiente solicitud de p gina Web el programa CGI se lee de nuevo a partir del disco duro y se inicia un nuevo ciclo de solicitudes de p gina La mayor a de las instalaciones 23 utilizan el protocolo CGI est ndar lo que significa que el par metro maxrequests puede ser ignorado sin problema 6 PERSONALIZACI N DE SU INSTALACION Es probable que lo primero que usted quiera hacer una vez que Greenstone est instalado y en funcionamiento es personalizar la p gina principal El archivo que genera la p gina principal de Greenstone se llama home dm y est situado en el subdirectorio de macros del directorio en el que usted instal Greenstone El directorio por defecto para los sistemas Windows es C Program Fileslgsdl Se trata de un archivo de texto sin formato que tendr usted que modificar para crear una nueva p gina principal En vez de modificarla le recomendamos que cree un nuevo archivo por ejemplo pourhome dm ste ser semejante
24. bi n han contribuido David Bainbridge George Buchanan Hong Chen Michael Dewsnip Katherine Don Elke Duncker Carl Gutwin Geoff Holmes Dana McKay John McPherson Craig Nevill Manning Dynal Patel Gordon Paynter Bernhard Pfahringer Todd Reed Bill Rogers John Thompson y Stuart Yeates Otros miembros del proyecto Biblioteca Digital de Nueva Zelanda que proporcionaron asesor a y valiosas ideas para la concepci n del sistema son Mark Apperley Sally Jo Cunningham Matt Jones Steve Jones Te Taka Keegan Michel Loots Malika Mahoui Gary Marsden Dave Nichols y Lloyd Smith Tambi n queremos dar las gracias a todos aquellos que contribuyeron a los paquetes de programas con licencias GNU incluidos en esta distribuci n MG GDBM PDFTOHTML PERL WGET WVWARE y XLHTML NDICE Acerca d este Mandala ii 1 VERSIONES DE GREENSTONE s ssssssssssssrnsrnennnnnunnnnnnnounnennnnnnnnnnnnnnnnnnnnnnonnnennnnnnnn 1 2 ELPROCEDIMIENTO DE INSTALACI N c ncciccconocsssrrrrsss 3 LE WINDOWS roer ii REO 3 SACO SIMplS aaa i n 3 BinariosS WINdOWS seanser a E 5 Configuraci n del servidor Web de Windows en las versiones de Biblioteca Web nicamente Eae A EE E E A E A 6 Fuente WINDOWS iaa a a E eE A 6 La UM E A E 7 AE A a aa A E ER 7 A A O 8 Instalaci n UM id aldea 8 Configuraci n del servidor Web para UNIX ss ssessssessessressresseesresrrssreesresrrssressresresress 9 2 3 C mo encontrar Greenstone coccion 10 Biblioteca Local s lo c
25. d Permisos de aplicaciones None Pulse OK Esto hace que los archivos Greenstone sean accesibles para el servidor Web 3 Regrese a Opciones avanzadas seleccione gsdl y pulse A adir Rellene los campos del modo siguiente Campo Directorio C Program Files gsdl cgi bin Campo Alias cgi bin Permisos de acceso None Permisos de aplicaciones Execute Pulse OK Esto permite que el servidor Web ejecute el programa de Greenstone library exe 4 Vayaala URL http localhost cgi bin library exe Nota con el PWS y el IIS se debe especificar la extensi n de archivo exe 5 CONFIGURACI N DE SU SITIO Para que Greenstone funcione correctamente se deben instalar adecuadamente los permisos de acceso para determinados archivos Asimismo cada sitio Greenstone tiene un archivo de configuraci n asociado El procedimiento de instalaci n crea una configuraci n gen rica basada en las opciones de instalaci n escogidas por usted no obstante su contenido puede personalizarse para hacer frente a distintas situaciones En esta secci n se explican ambas cosas 5 1 Permisos de archivo Esta secci n no ata e a los usuarios de Windows 95 98 ya que esos sistemas no identifican a los propietarios de los archivos En Windows NT 2000 y en los sistemas Unix los guiones CGI no funcionan como usuarios normales ya que no se puede identificar a los usuarios en la Web En cambio se ejecutan en nombre del usuario que arranc el programa del servido
26. eb de su propia computadora 4 1 El servidor Web Apache El servidor Web Apache suele instalarse en C Program Files Apache Group Apache y se configura de tal modo que el directorio cgi bin est en el subdirectorio cgi bin y la ra z de documentos es el subdirectorio lhtdocs Se vuelve a configurar modificando el archivo de configuraci n en C Program Files Apache Group Apache confihttpd conf Se trata de un archivo de texto es muy f cil leerlo para ver c mo se ha efectuado la configuraci n Seg n c mo est configurado el programa de conexi n en red de su computadora podr ser necesario a adir la siguiente l nea en su archivo de configuraci n httpd conf de Apache ServerName localhost 18 Si esta l nea no figura el sistema intenta encontrar el nombre de su servidor Sin embargo en algunas versiones de Windows hay algunos errores que impiden esta operaci n En tal caso Apache se cierra inmediatamente despu s de arrancarlo Aparece un mensaje de error pero ste se borra de inmediato y es muy probable que usted no lo alcance a leer Instalaci n del directorio cgi bin de Greenstone cgi bin es un directorio desde el cual el servidor Web trata documentos como programas ejecutables La directiva ScriptAlias de Apache se utiliza para crear un directorio cgi bin Cabe se alar que esta directiva puede hacer de cualquier directorio un directorio CGI ejecutable sin que se llame forzosamente cgi bin A la inversa un dir
27. ectorio llamado cgi bin no tiene nada especial si no se le ha aplicado la directiva ScriptAlias Una vez instalado Apache tiene un directorio cgi bin en C Program Files Apache GrouplApachelcgi bin Esto significa que si se le presenta la URL http localhost cgi bin hello el servidor Web intentar ejecutar un archivo llamado hello en el directorio antes mencionado Hay un programa Greenstone llamado library exe que tiene que ser ejecutado por el servidor Web y que a su vez lee un archivo llamado el archivo de configuraci n de sitio de Greenstone o osdlsite cfg que debe estar situado en el mismo directorio La mejor manera de obtener este resultado es utilizar la directiva ScriptAlias de Apache para crear un nuevo directorio cgi bin Este es el pasaje del archivo de configuraci n httpd conf de Apache que a ade C Program Fileslgsdllcgi bin como un directorio cgi bin suplementario ScriptAlias gsdl cgi bin C Program Files gsdl cgi bin lt Directory C Program Files gsdl cgi bin gt Options None AllowOverride None lt Directory gt Curiosamente los archivos de configuraci n de Apache utilizan barras oblicuas hacia adelante en lugar de las barras oblicuas hacia atr s que se suelen utilizar en Windows Esto significa que el servidor Web buscar en el directorio C Program Fileslgsdilcgi bin cualquier URL que tenga la forma http localhost gsdl cgi bin y la ejecutar Por ejemplo si se le presenta la
28. empo suficiente para que usted responda a las preguntas correspondientes Si usted instala el c digo fuente el gui n de instalaci n lo compilar lo cual lleva entre diez minutos y una hora seg n la velocidad de su procesador Para desinstalar el programa teclee cd gsdl o bien usr local gsdl si quien instal Greenstone fue el usuario root sh Uninstall sh Durante el procedimiento de instalaci n se le preguntar si quiere usted instalar alguna colecci n Greenstone La colecci n de demostraci n Greenstone se instala autom ticamente las dem s colecciones que figuran en el CD ROM se describen en la Secci n 3 Configuraci n del servidor Web para Unix Si ya dispone usted de un servidor Web tendr que hacerle algunos peque os cambios en su configuraci n para poder instalar Greenstone El gui n de instalaci n explica en qu consisten Es probable que necesite la ayuda del administrador del sistema para volver a configurar el servidor Web esta persona comprender seguramente las instrucciones que figuran en el gui n de instalaci n y que pueden imprimirse Para su conveniencia la informaci n imprimible del gui n de instalaci n est escrita en un archivo llamado INSTALL RECORD situado en el directorio en que usted instal Greenstone Si no dispone usted todav a de un servidor Web tendr que instalar uno En el Ap ndice se proporciona informaci n sobre Apache Despu s tendr que configurarlo adecuadamente En l
29. er argumento de la directiva Alias gsdl se busca como archivo en el lugar correspondiente al segundo argumento Dicho de otro modo las URL con la forma http localhost gsdl se buscar n como archivos en el directorio C Program Fileslgsdl Por ejemplo si se le presenta la URL http localhost esdl hello html el servidor Web intentar recuperar el archivo C Program Fileslgsdllhello html Sin embargo la URL http Nlocalhost hello html busca el archivo C Program Files Apache Group Apache htdocs hello html en el directorio htdocs normal tal como lo hizo antes Aseg rese de a adir la directiva Alias despu s de la directiva ScriptAlias Si se le da la instrucci n a Apache de a adir el alias gsdl antes de gsdl cgi bin se har a corresponder la URL gsdl cgi bin library con la directiva Alias y no con la directiva ScriptAlias lo cual se interpretar a como una solicitud de un documento y no como el resultado de la ejecuci n de un programa La consecuencia ser a que se visualizar a el archivo del programa binario como una p gina en el servidor Web en vez de ejecutarlo Seguridad Debe usted saber que si la versi n de biblioteca Web de Greenstone se instala como se indica m s arriba cualquier persona podr descargar cualquier archivo en la estructura de directorios gsdl Esto comprende los archivos de ndice y los documentos fuente de cualquiera de las colecciones que haya usted creado la base de datos del usuario los regis
30. es 2000 y XP de Windows Windows NT puede utilizar cualquiera de los dos Las explicaciones relativas a Apache se aplican igualmente a la biblioteca Web Windows y a las versiones de Unix aunque utilizamos la terminolog a y los nombres de las rutas de acceso propios de Windows la secci n relativa a PWS IIS s lo se aplica a la biblioteca Web Windows Una vez instalado el servidor Web el siguiente paso es instalar Greenstone Supondremos que durante el procedimiento de instalaci n usted ha escogido la opci n por defecto en cada fase pulsando el bot n Next siguiente El resultado es la creaci n del directorio C Program Fileslgsdl donde se instala el binario de la biblioteca Web junto con algunos archivos auxiliares Todos los servidores Web utilizan la URL especial localhost que representa la computadora en que est funcionando el servidor Web As cuando se instala un servidor Web se puede acceder a los documentos HTML tecleando la URL http localhost en un navegador Si su computadora tiene instalado un nombre de dominio ste se utiliza en lugar del localhost para poder identificar su computadora desde sitios remotos En la computadora de la Biblioteca Digital de Nueva Zelanda por ejemplo las URL http nzdl org y http localhost son equivalentes Si usted teclea http nzdl org en su computadora obtendr el servidor Web de la Biblioteca Digital de Nueva Zelanda mientras que si teclea http localhost obtendr el servidor W
31. i idad 23 6 2 C mo hacer que funcione cocacacacacacacacanonononenenenonannancnarancrcncn rn rorororerororrrnrraranncnns 25 6 3 Reenviar una URL a GreenStone ssssssssrseresresrnrnennnrnennnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnn na 26 AP NDICE PROGRAMAS ASOCIADOS cccncnccacionicnionnnincssinsscss cono cnerenecrornecroran 27 A1 Servidor Web ADache iii Ai 27 A2 Pep a a ata aaa ake aaa aeae aaa i aaiae Ea eadein 27 A3 GCC e A A AA 27 PE DB Mitad 27 A 5 Ambiente de Ejecuci n Java ssssssssssssnrusuunnunnunnnunnnnnonnnnnnnnunnnnnnnnnnnnnnnnnnnnnnnnnnnnnns 27 A 6 Compilador Jav coin 28 1 VERSIONES DE GREENSTONE El programa Greenstone funciona en diferentes plataformas y con distintas configuraciones como se resume en la Figura 1 Windows o Unix Windows Unix Einarlos disponibles Necesita una sesi n para todas las versiones root para la instalaci n 3 95 981Me NT 2000 Linux Sun Solaris o Macintosh OS X Distribuye colecciones Versi n completa Versi n completa Versi n completa Versi n completa pero no las crea disponible disponible disponible disponible S lo los administradores C digo fuente probado C digo fuente probado Pueden instalar el programa binarios disponibles Figura 1 Las distintas opciones para las versiones Windows y Unix de Greenstone Hay muchos factores que inciden o pueden incidir en el procedimiento de instalaci n Antes de proseguir la lectura det ngase en los siguientes puntos e
32. io abra el men Programas y seleccione Biblioteca Digital Greenstone Greenstone Digital Library Esto hace aparecer un cuadro de di logo haga clic en Entrar en la biblioteca Enter Library Esto activa autom ticamente el navegador Internet y carga la p gina principal de la Biblioteca Digital Greenstone cuyo aspecto debe ser parecido al del ejemplo de la Figura 2 Se entra en la colecci n de demostraci n de Greenstone pulsando en su icono Binarios Windows En el CD ROM hay dos programas binarios Windows distintos la Biblioteca Local y la Biblioteca Web La instalaci n por defecto mencionada m s arriba selecciona la versi n Biblioteca Local Le recomendamos encarecidamente que utilice esta versi n La Biblioteca Web que es mucho m s dif cil de instalar s lo es necesaria si usted utiliza ya un servidor Web y experimenta conflictos de asignaci n de puerto al usar la Biblioteca Local A pesar de su modesto nombre la Biblioteca Local ofrece una capacidad completa y aut noma de servidor Web Despu s de haber seleccionado la versi n que va a instalar se le pedir que escoja entre una instalaci n completa o compacta La instalaci n completa incluye todo La instalaci n compacta por defecto comprende todo menos los manuales Greenstone y la funci n Exportar a CD ROM La instalaci n compacta ocupa en el disco duro apenas la tercera parte del espacio ocupado por la instalaci n completa La Biblioteca Local E
33. l inicio 27 6 3 Reenviar una URL a Greenstone Es posible que desee usted reenviar una URL m s apropiada a su programa CGI de Greenstone Por ejemplo en nuestro sistema la URL http nzdl org que es la abreviatura de http nzdl org index html se reenv a a http nzdl org cgi bin library El servidor Web Apache efect a esto mediante la directiva Redirect Como las dem s directivas sta va al archivo de configuraci n C Program FileslApache GrouplApachelconfihttpd conf Para reenviar la URL http www servidor com a http www servidor com cgi bin library a ada la l nea siguiente en httpd conf Redirect index html http www servidor com cgi bin library As llegar usted a su sistema de biblioteca digital directamente desde la URL http www servidor com En cambio si usted deseara reenviar una URL como http www servidor com greenstone a http www servidor com cgi bin library introduzca en el archivo httpd conf la l nea siguiente Redirect greenstone http ww servidor com cgi bin library Si su computadora carece de nombre de dominio como el www servidor com mencionado m s arriba basta con reemplazar www servidor com por localhost en las l neas que figuran m s arriba Mientras el navegador est funcionando en la misma m quina que el servidor Web lo cual es seguramente el caso si su computadora no tiene un nombre de dominio esto tiene el mismo efecto que los reenv os antes mencionados En
34. laci n del servidor Web Si ya dispone usted de un servidor Web habr que hacer algunos peque os cambios en su configuraci n para que la instalaci n de Greenstone funcione correctamente El gui n script de instalaci n explica cu les son esos cambios para el servidor Web Apache v ase la Secci n 4 2 para las instrucciones relativas a la configuraci n de los servidores Web PWS e IIS Es posible que necesite la ayuda de un administrador de sistema para volver a configurar un servidor Web ya instalado Esta persona entender seguramente las instrucciones del gui n de instalaci n que pueden imprimirse Si no dispone usted todav a de un servidor Web tendr que instalar uno v ase el Ap ndice para la informaci n relativa al servidor Web Apache y luego tendr que configurarlo adecuadamente En la Secci n 4 se explica detalladamente qu partes de la instalaci n de un servidor Web afectan a Greenstone y c mo deben modificarse Esto supone incluir una media docena de l neas en un archivo de configuraci n Fuente Windows El c digo fuente de Greenstone ocupa 50 Mb en el disco aunque para compilarlo se necesitar n unos 90 Mb Para compilar la fuente en Windows se necesita el compilador Microsoft Visual C Estamos resolviendo actualmente algunos problemas menores en la compilaci n de Greenstone con varios puertos Windows de GNU GCC No se necesita el GDBM el administrador de la base de datos de GNU porque viene incluido
35. lataforma y su compilador v ase el documento nstall que aparece en el directorio principal de Greenstone C Program Fileslgesdl por defecto durante el procedimiento de instalaci n 2 2 Unix Esta secci n est destinada a los usuarios de Unix Los usuarios de Windows pueden pasar directamente a la Secci n 2 3 Tiene usted que escoger entre instalar el c digo binario o el c digo fuente El c digo binario ocupa unos 50 Mb en el disco duro el c digo fuente necesita unos 160 Mb para compilar Binarios Unix El c digo binario requiere una distribuci n Linux basada en Intel x86 que incluye un soporte binario ELF Las distribuciones que cumplen estos requisitos son RedHat 5 1 SuSE Linux 6 1 Debian 2 1 Slackware 4 0 Deben funcionar tambi n las versiones m s recientes de estos productos Se necesitar un servidor Web recomendamos Apache Le recomendamos tambi n encarecidamente que instale su servidor Web antes de instalar Greenstone esto facilitar considerablemente la respuesta a las preguntas que se formulan durante el procedimiento de instalaci n de Greenstone Si desea crear nuevas colecciones de biblioteca digital necesitar tambi n Perl si ste no se encuentra ya en su sistema Para comprobarlo abra una ventana de terminal teclee perl v y vea si aparece un mensaje en que se especifica entre otras cosas el 8 n mero de la versi n En la mayor a de las versiones de Linux Perl viene instalado por defecto
36. m s simple que se puede encontrar Con el mismo material que la colecci n de muestra Greenstone original sta muestra dos funciones independientes el formateo de documentos que no sean est ndar y el acceso controlado a los documentos por medio de la autenticaci n de los usuarios Esta colecci n tambi n contiene el mismo material que la colecci n de muestra Greenstone s lo que su apariencia ha sido alterada para mostrar la forma en que las p ginas generadas pueden configurarse de manera diferente Se basa en un archivo de macros no est ndar que se proporciona junto con Greenstone Esta colecci n est construida a partir de una base de datos CDS ISIS de cerca de 150 referencias bibliogr ficas Usa el plugin ISISPlug el cual lee archivos est ndar ISIS mst y fdt y los convierte a metadatos de Greenstone 4 Instalaci n del servidor Web En esta secci n explicaremos c mo instalar su servidor Web para que funcione con Greenstone Cabe se alar que estas explicaciones son innecesarias cuando se utiliza la Biblioteca Local Windows ya que este programa est concebido para funcionar de entrada sin servidor Web Nos referiremos al servidor Web Apache que se puede conseguir libremente para Windows y Unix v ase el Ap ndice para m s detalles el Personal Web Server PWS y el servidor Web Internet Information Services IIS de Microsoft El PWS es el servidor Microsoft est ndar para Windows 95 98 el IIS es el de las version
37. o aparece un bot n que permite seleccionar la versi n limitada Se deber siempre utilizar la versi n est ndar a menos que se planteen los problemas antes mencionados Biblioteca Web Este programa permite que cualquier computadora con un servidor Web existente distribuya colecciones Greenstone previamente creadas Como en el caso de la Biblioteca Local la colecci n de demostraci n de Greenstone se instalar autom ticamente Se pueden instalar tambi n las dem s colecciones que figuran en el CD ROM v ase la Secci n 3 6 La Biblioteca Web difiere de la Biblioteca Local porque est destinada a computadoras que ya disponen de un programa de servidor Web e Para activar la Biblioteca Web se requiere tambi n un programa de servidor Web como por ejemplo Apache v ase el Ap ndice El Colector Este componente que viene tanto en la Biblioteca Local como en la Biblioteca Web permite crear colecciones que contengan el material elegido por usted Para activarlo se requiere tambi n Perl Recomendamos ActivePerl v ase el Ap ndice No se podr utilizar el Colector con un sistema Windows 3 1 6 3 11 Configuraci n del servidor Web de Windows en las versiones de Biblioteca Web nicamente Una ventaja de la versi n de la Biblioteca Local de Greenstone es que est lista para funcionar y no requiere ninguna configuraci n especial Para la versi n Biblioteca Web en cambio tendr usted que hacer algunos ajustes a su insta
38. on Windows evitara leidas 10 Biblioteca Web Windows y UNI ici te 10 A NEO 10 Administraci n eane a a ea E a a TAa 10 2 4 La Interfaz de Bibliotecario de Greenstone GLI acoconnnnnms 10 Ejecuci n bajo MW Socia iaa de tos pitosio psss 11 Ejecuci n Dajo UND bois A A A ie 11 C mo Obtener AU a rea e r a e a 11 Compilando la Interfaz de Bibliotecario de Greenstone occocio occoncmommmmmmmo 11 2 5 Pruebas y soluci n de problemas ssssssssssssrusnrnnurnnnnonunnnnnnnnnunnnunnnnnnnnnnnnnnnnnnnnnn 11 Soluci n de problemas iaa arado 12 2 6 Para obtener m s informaci n s ssssssssrrsrssnrunennnnnennnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnna 13 3 COLECCIONES GREENSTONE oonccciococnicicococnocococococococnnnonorococnonanenono no reresnanane res 14 4 INSTALACI N DEL SERVIDOR WEB cccccucncnoinssismrss 16 4 1 Ebservidor Web Apache soriana arroll 16 Instalaci n del directorio cgi bin de Greenstone oooocccicicicicicccciniiiiirannoss 17 El directorio ra z de los dOCUMENTOS oooooconcococcnoccncocncncncncncncncncncnrnrnrnrnrncnnncnos 17 Seguridad issa a a E 18 4 2 Los servidores Web PWS e IIS sssssssssssneussrnsnnnnnnnnnnnnnnnnnnnnnnnnennnnnnnnnnnnnnnnnnnnnnnnnna 19 5 CONFIGURACI N DE SU SlTlO ccccconmsmsmrcrros 20 51 Permisos dearchivo adn 20 5 2 El archivo de configuraci n gsdlSite CfO cmmmmmmmmmmmmmm 20 6 PERSONALIZACI N DE SU INSTALACI N isses 23 6 1 Ejemplos an
39. r Web en los sistemas Windows o de un usuario especial que en los sistemas Unix suele llamarse nobody Debido a esto todos los archivos y directorios dentro de C Program Fileslgsdl deben ser legibles por todos o al menos legibles por el usuario de guiones CGI que puede ser nobody Para comprobar si los permisos de archivo est n configurados correctamente ejecute el programa library exe a partir de la l nea de comando Si los archivos est n en los lugares correctos pero los permisos est n mal configurados el programa arrancar desde la l nea de comando esto es cuando usted la ejecuta pero no desde un navegador esto es cuando el usuario nobody la ejecuta Otra prueba es iniciar la sesi n como otro usuario para ver si los permisos de archivo corresponden espec ficamente a su cuenta de usuario original Para funcionar desde un navegador Web todos los directorios de Greenstone deben ser legibles por todos Asimismo el directorio C Program Fileslgsdlletc y todo su contenido deben ser modificables por cualquier persona ste es el directorio en el que el programa de biblioteca escribe el registro de uso los registros de error y de inicializaci n y varias bases de datos del usuario Si no desea usted que cualquier persona pueda modificar este directorio puede establecer permisos para que el usuario de CGI s lo pueda modificar los archivos errout txt initout txt key db users db history db y usage txt Si los pe
40. reenstone consulte la Gu a del Programador de la Biblioteca Digital Greenstone que comprende entre otras cosas los detalles sobre la estructura de los directorios que se ha creado e informaci n sobre c mo configurar su sitio Greenstone 3 COLECCIONES GREENSTONE El CD ROM incluye varias colecciones Greenstone de muestra Si usted tiene acceso a Internet tambi n podr bajar muchas otras desde el sitio Web del Proyecto de Biblioteca Digital de Nueva Zelanda nzdl org ya sea armadas previamente o sin armar La colecci n de muestra Greenstone es un peque o subconjunto de la Biblioteca para el Desarrollo Humano HDL por sus siglas en ingl s una colecci n perfectamente acabada que muestra la forma en que se puede lograr una amplia capacidad de exploraci n y b squeda siempre que se cuente con los metadatos adecuados Esta colecci n se incluye autom ticamente al momento de instalar el software Greenstone tambi n incluye otros ejemplos de colecciones documentadas cuyas p ginas informativas describen la forma en que est n construidas demostrando las diferentes capacidades de Greenstone Un cuadro de di logo le preguntar si quiere incluirlas junto con su instalaci n La cantidad aproximada de espacio de disco que se necesita para cada una se muestra a continuaci n demo Colecci n de muestra Un peque o subconjunto de la Biblioteca para el Greenstone Desarrollo Humano HDL por sus siglas en ingl s Si se 7 Mb clona es
41. rmisos de archivo no est n configurados correctamente para C Program Fileslgsdlletc es posible que no funcione la autenticaci n de usuario y el historial de b squeda y que no se genere un registro de uso usage txt 5 2 El archivo de configuraci n gsdlsite cfg El procedimiento de instalaci n crea un archivo de configuraci n de sitio gen rico de Greenstone basado en las opciones de instalaci n que usted ha escogido Para nuestra instalaci n este archivo es C Program Fileslgsdilcgi binlgsdlsite cfg y su contenido es el siguiente Site configuration file por Greenstone 22 Lines begining with are comments This file should be placed in the same directory as your library executable file It should be edited to suit your site points to the GSDLHOME directory gsdlhome C Program Files gsdl this is the http address of GSDLHOME if your webservers DocumentRoot is set to GSDLHOME then httpprefix can be commented out httpprefix gsdl this is the http address of the directory which contains the image for the interface httpimg gsdl images should contain the http address of this cgi script This is not needed if the http server sets the environment variable SCRIPT_NAME gwcgi cgi bin library maxrequests is the most requests a fastcgi process will serve before it exits This can be set to a low figure like 1 while debugging and then set to a high figure like 10000 when everything is working well maxrequests 10000
42. ste programa permite a cualquier computadora equipada con Windows distribuir colecciones Greenstone previamente creadas La colecci n de demostraci n de Greenstone se instalar autom ticamente se pueden instalar tambi n las dem s colecciones que figuran en el CD ROM v ase la Secci n 3 El programa de Biblioteca Local es el mismo utilizado en los CD ROM producidos por el sistema Greenstone La Biblioteca Local est destinada a utilizarse en computadoras aut nomas o en computadoras que a n no est n equipadas con un servidor Web Contiene un peque o servidor Web incorporado para que otras computadoras en la misma red puedan tambi n acceder a la biblioteca Sin embargo este servidor Web tiene una capacidad de configuraci n limitada El programa de Biblioteca Local detecta autom ticamente si su computadora tiene un programa de red instalado o si est conectada a una red Funciona correctamente en cualquier combinaci n de estas condiciones No obstante pueden plantearse eventualmente dos problemas Greenstone puede e provocar una operaci n no deseada de marcado telef nico e no funcionar debido a la presencia de un programa de red instalado incorrectamente Se suministra una versi n limitada de la Biblioteca Local que se puede utilizar en tales situaciones La versi n limitada s lo funciona con Netscape pero no con Internet Explorer Cuando se activa la versi n de la Biblioteca Local de Greenstone en el cuadro de di log
43. ta colecci n las funciones completas s lo estar n disponibles si sus nuevos archivos proporcionan la informaci n de metadatos apropiada dls e Subconjunto de la Al igual que la Colecci n de muestra Greenstone sta es Biblioteca para el un subconjunto de la Biblioteca para el Desarrollo Desarrollo Humano s lo que mucho mayor Contiene 250 150 Mb publicaciones entre libros informes y revistas relacionadas con diferentes reas del saber humano la HDL contiene un total de 1 230 publicaciones Tiene la misma estructura que la Colecci n de muestra Greenstone y es bastante compleja por lo que si apenas est empezando a familiarizarse con su uso quiz sea mejor que se fije primero en alguna otra p ej la demostraci n en MSWord y PDF los Archivos Greenstone o la colecci n de Im genes Sencillas wrdpdf e Demostraci n en Esta colecci n contiene unos cuantos documentos en MSWord y PDF formatos PDF MSWord RTF y PostScript y muestra la 4 Mb capacidad de construir colecciones a partir de diferentes tipos de documentos El archivo de configuraci n de la colecci n es sumamente sencillo gsarch e Colecci n de Una colecci n de mensajes de correo electr nico hecha a Archivos Greenstone partir de los archivos de las listas de correo de Greenstone 5 Mb Utiliza el plugin Email que descompone y analiza los archivos en formatos de correo electr nico El archivo de configuraci n de la colecci n es sumamente sencillo 1
44. temas Unix ya tienen Perl instalado pero si no es el caso los c digos fuente y los binarios de una amplia gama de plataformas Unix pueden descargarse libremente en www perl com A3 GCC La versi n Unix de Greenstone se compila con el compilador C de GNU GCC Greenstone hace un amplio uso de la biblioteca est ndar de plantillas C hemos observado que est rota en algunas antiguas versiones de GCC s rvase avisarnos si tiene usted problemas con STL Cabe se alar que esta versi n de Greenstone no compila con la versi n 3 0 de GCC A 4 GDBM Todas las versiones de Greenstone utilizan el Administrador de Base de Datos GNU GDBM GNU Database Manager Viene con todas las versiones Windows de Greenstone y se instala autom ticamente durante el procedimiento de instalaci n Los sistemas Linux ya tienen GDBM por lo que no lo proporcionamos para Linux La mayor a de los dem s sistemas Unix lo tienen pero si es necesario puede usted descargarlo en la URL www gnu org A 5 Ambiente de Ejecuci n Java Para poder usar la Interfaz de Bibliotecario de Greenstone es necesario contar con una versi n adecuada del Ambiente de Ejecuci n Java JRE por sus siglas en ingl s Si todav a no lo tiene el CD ROM incluye una versi n apropiada o tambi n puede bajar la versi n m s reciente desde http j ava sun com 2se downloads html Se requiere la versi n 1 4 0 o superior 29 A 6 Compilador Java Para compilar el c digo fuente de
45. tros de utilizaci n etc Para evitar esto puede usted reforzar f cilmente las medidas de seguridad modificando la configuraci n de su servidor Web En el caso del servidor Web Apache sustituya las l neas en el archivo de configuraci n indicadas en el apartado anterior por las siguientes Alias gsdl C Program Files gsdl lt Directory C Program Files gsdl gt Order allow deny Deny from all lt FilesMatch gif jpe g png css mov mpeg ps pdf doc rtf jar class gt Order allow deny Allow from all lt FilesMatch gt 20 lt Directory gt Esto significa que s lo se podr n descargar los archivos cuyas extensiones se ajustan a la expresi n regular indicada en la l nea FilesMatch 4 2 Los servidores Web PWS e IIS Aunque ni el PWS ni el IIS est n instalados por defecto en los actuales sistemas Windows stos se pueden instalar f cilmente usando el icono Agregar o quitar programas del panel de control Si no est n ya en su CD ROM de Windows tendr que descargarlos del sitio Web de Microsoft www microsofl com El procedimiento de instalaci n de Greenstone es id ntico para el PWS y el IIS Abra el Administrador Personal de Web y sigas las instrucciones siguientes 1 Seleccione Avanzadas para llegar a la pantalla Opciones avanzadas 2 Seleccione Inicio y pulse A adir Rellene los campos del modo siguiente Campo Directorio C Program Fileslgsdl Campo Alias gsdl Permisos de acceso Rea
46. un servidor Web es muy posible que quiera conservarlo Para Unix es necesario utilizar un servidor Web Sabe usted como volver a configurar su servidor Web Si usted no utiliza el servidor Web de Greenstone tendr que modificar ligeramente la configuraci n del suyo para que reconozca el programa Greenstone 2 EL PROCEDIMIENTO DE INSTALACI N Existen sendas versiones de Greenstone disponibles para Windows y Unix como binarios y en forma de c digo fuente La interfaz de usuario de Greenstone utiliza cualquiera de los dos navegadores Web siguientes Netscape Navigator o Internet Explorer versi n 4 0 o superior en ambos casos En caso de que no tenga usted todav a un navegador Web puede usted instalar una de las versiones Windows de Netscape que vienen en el CD ROM 2 1 Windows Si es usted un usuario de Unix pase directamente a la Secci n 2 2 Para los usuarios de Windows si s lo desea una instalaci n sencilla siga el siguiente procedimiento de instalaci n simple El sistema Greenstone ocupa unos 40 Mb de espacio de memoria en el disco duro Si no escoge usted la instalaci n por defecto tendr que decidir si quiere instalar el c digo binario o el c digo fuente En caso de duda escoja el c digo binario El procedimiento de instalaci n es el mismo para ambos En las secciones siguientes encontrar usted m s informaci n sobre las opciones ofrecidas Una vez terminada la instalaci n pase directamente a la Secci n
Download Pdf Manuals
Related Search