Manual de Instalacin DSpace

ROAF

ROAF
DSpace System Documentation: Installation

Facultad de Ciencias, Ciencias Computacionales, Universidad Autnoma de Baja California

Manual de Instalacin DSpace

Proyecto ROAF

Administradora: Cristal Azalia Dena Flores Priscila Acosta Medina Iris Esther Arellano Balbuena Jos Feliciano Daz Beltrn Jos Antonio Snchez Guerra Gustavo Mndez Espritu Octavio Avendao Romero
2009 Administracin de Proyectos Ciencias Computacionales Facultad de Ciencias Universidad Autnoma de Baja California Campus Ensenada Baja California MEXICO

AP

ROAF

UABC

Manual de Instalacin DSpace

1 Introduccin
DSpace es uno de los programas de cdigo abierto preferidos por las instituciones acadmicas para gestionar repositorios de archivos (textuales, audio, vdeo, etc.), facilitando su depsito, organizndolos en comunidades, asignndoles metadatos y permitiendo su difusin en recolectores o agregadores. El objetivo de este manual es explicar la instalacin, en cualquier servidor, de la herramienta DSpace. Sin ser el objetivo de este manual, en la primera parte se dan una serie de nociones en la instalacin y configuracin de todas las aplicaciones necesarias para el correcto funcionamiento de DSpace. En la segunda parte, se explicarn los pasos necesarios para instalar un servidor con DSpace. Debemos comentar que la herramienta es multiplataforma, es decir, puede ser instalado y Configurado en un servidor Linux o en uno Windows (Wn32). A continuacin comentamos los programas necesarios para que funcione DSpace, en Linux.

2 Prerrequisitos de Software
La lista de abajo describe los componentes y herramientas que necesitaras para correr el servidor de DSpace.

2.1 Linux como SO

LINUX como SO (Ubuntu 8.04): Muchas de las distribuciones de Linux/Unix vienen con algunas de las dependencias de abajo pre instaladas o instalarlas fcilmente va actualizacin, puedes consultar la documentacin de tu distribucin para determinar que esta realmente disponible.

Nota:Es recomendable que vayas a las direcciones donde estn los software y los descargues.

2.2 Java JDK 5 (el estndar SDK esta bien, no necesitas J2EE)
DSpace ahora requiri Java 5 o mayor debido al uso de las nuevas capacidades de lenguaje introducidas en 5 que hacen la codificacin ms fcil y ms limpia.

AP

ROAF

UABC

Manual de Instalacin DSpace

Java 5 o mayor lo puede bajar de la siguiente direccin:

http://java.sun.com/javase/downloads/index.jsp

2.3 Apache Maven 2.0.8 o mayor (Java built tool)

Maven es necesario en la primera etapa de la construccin del proceso de montar el paquete de instalacin de DSpace. Este te da la flexibilidad de modificar DSpace usando el proyecto de Maven existente que se encuentra en el directorio [dspace-source]/ dspace/modules o agregando en tu propio proyecto de Maven para construir el paquete de instalacin para DSpace. Maven puede ser descargado de la siguiente direccin: http://maven.apache.org/download.html

2.4 Apache Ant 1.6.2 o mayor (Java built tool)

Apache Ant es aun requerido para la segunda etapa de la construccin del proceso. Este es usado una ves que el paquete de instalacin ha sido construido en [dspacesource]/dspace/target/dspace-<versin>-build.dir Ant puede ser descargado de la siguiente direccin: http://ant.apache.org [http://ant.apache.org/]

2.5 Base de Datos Relacional: (PostgreSQL)

PostgreSQL 8.3.7 o mayor. PostgreSQL puede ser descargado de la siguiente direccin: http://www.postgresql.org/ [http://www.postgresql.org/] Es altamente recomendable trabajar con Postgre 8.x o mayor aunque puede trabajar con anteriores. Una vez instalado. Necesitas habilitar la conexin TCP/IP (usar DSpace JDBC). Para 8.x+, editar postgresql.conf empiece quitando los comentarios (ver el problema 1 de la instalacin del PostgreSQL en la gua de problemas y acciones) listen_addresses = localhost Despus aumente un poco la seguridad editando pg_hba.conf y agregue esta lnea (ver el problema 2 de la instalacin del PostgreSQL en la gua de problemas y acciones): host dspace dspace 127.0.0.1 255.255.255.255 md5

AP

ROAF

UABC

Manual de Instalacin DSpace

Despus reinicia PostgreSQL

2.6 Motor de Servlet: (Jakarta Tomcat 5.5)

Jacarta Tomcat 5.5 o mayor Tomcat puede ser descargado de la siguiente direccin: http://tomcat.apache.org [http://tomcat.apache.org/whichversion.html] Observe que DSpace necesitar funcionar como el mismo usuario que Tomcat, puede ser que quiera instalar y correr Tomcat como un usuario llamado dspace. Fija apropiadamente la variable de entorno TOMCAT_USER. Modificaciones en [tomcat]/tomcat.conf Necesitas asegurarte que Tomcat tiene a) suficiente memoria para correr DSpace y b) usar UTF-8 como su codificacin del archivo por defecto. Entonces asegrate en tus scripts que la siguiente variable de entorno se fije: JAVA_OPTS=-Xmx512M -Xms64M -Dfile.encoding=UTF-8 Modificacin en [tomcat]/config/server.xml Tambin necesitas alterar la configuracin por default de Tomcat para soportar la bsqueda y la lectura de multi bytes UTF-8 correctamente.necesitas agregar a la opcin de configuracin a el elemento<Connector> en [tomcat]/config/server.xml URIEncoding =UTF-8 Ejemplo. Si estas usando la configuracin que tiene por default el Tomcat, se debera leer:
<!-- Define a non-SSL HTTP/1.1 Connector on port 8080 --> <Connector port="8080" maxThreads="150" minSpareThreads="25" maxSpareThreads="75" enableLookups="false" redirectPort="8443" acceptCount="100" connectionTimeout="20000" disableUploadTimeout="true" URIEncoding="UTF-8" />

AP

ROAF

UABC

Manual de Instalacin DSpace

3 Opciones de Instalacin
3.1 Visin general de las opciones de instalacin
Con la llegada de un nuevo Apache Maven 2 [http://maven.apache.org/] basado en arquitectura de construccin en DSpace 1.5.1 ahora tienes dos opciones en como podras desear la instalacin y manejo de tu instalacin local de DSpace. Si has usado DSpace 1.4.x , por favor reconoce que los procedimientos inciales de construccin ha cambiado para permitir mayor adecuacin. Despues encontraras los pasos basados en Ant del proceso de instalacin familiares. Maven es usado para resolver las dependencias de DSpace online para el servidor Repositorio Central de Maven. Esto es importante para notar que las estrategias son en trminos idnticos de la lista de procedimientos requeridos para completar la construccin del proceso, la nica diferencia es que el la versin incluye more modules que se construiran dando sus precedencias en el paquete de instalacin. Deafault Release (dspace-<versin>-release.zip) o Estos mtodos permiten adecuar la configuracin de DSpace (en dspace.cfg) o interfaces de usuario, usando interfaces preconstruidas bsicas. o Se descarga las libreras precompiladas para el nucleo del api-dspace, soportando servlets, etiquetas de librera, aspectos y temas para el dpsce-xmlui, dspace-xmlui y otros webservice/aplicaciones. o Las exposiciones de los acercamientos de las partes de la aplicacin que los apegados a DSpace prefieren mirarlo adecuado. La estructura del directorio de esta versin es la siguiente: [dspace-source] o Dspace/ - construccion y modulo de configuracin de DSpace o Pom.xml la definicin del proyecto padre. Fuente de la version (dspace-<version>-src-release.zip) o Este mtodo es recomendado para quienes cuyos deseos de desarrollar DSpace a futuro o alterar sus capacidades a un estado mas avanzado.

AP

ROAF

UABC

Manual de Instalacin DSpace

o Este contiene todos el codigo de dspace para el numero de dspace-api, soportado servlets, libreras etiquetas, aspectos y temas para el dspacexmlui, dspace-xmlui y otros servicios web/aplicaciones. o Provee todas las mismas capacidades como la versin normal. La estructura del directorio de esta version es mas detallada: | [dspace-source] o dspace/ -construccion y modulo de configuracin de DSpace o dspace-api/ -modulo de la fuente de java API o dspace-jspui/ -modulo fuente JSP-UI o dspace-oai/ -modulo fuente OAI-PMH o dspace-xmlui/ -modulo fuente XML-UI o dspace-lni/ -modulo fuente de Lightweight Network Interface o dspace-sword/ -modulo fuente del deposito de servicio SWORD (Simple Web-service Offering Repository Deposit) o pom.xml -definicin del proyecto padre de DSpace. Ambos acercamientos te proveen con el mismo control sobre como DSpace se construye asi mismo (especialmente en trminos de agregando adecuaciones completamente/3er parte de los modulos de DSpace que desees usar). Ambos mtodos te permiten la habilidad para crear interfaces de usuario ms complejas sobre capas en Maven. Una interfaz en capas te permite solo manejar tu adecuacin de cdigo local (en tu local CVS o SVN), y automticamente descargas el resto del cdigo de la interfaz del repositorio central de maven. Este reduce la cantidad de cdigo desempacado de la interfaz de DSpace mantenido en su CVS/SVN local.

3.2 Visin general de los directorios de DSpace

Antes de comenzar con una instalacin, es importante tomar conocimiento general de los directorios de DSpace y los nombres de los cuales son referidos generalmente. DSpace utiliza 3 arboles de directorio separados. Aunque no necesitas saber todos los detalles de estos para instalar DSpace, no necesitas saber que existen y tampoco como se refieren en este documento: 1. El directorio de instalacin, referido como [dspace]. Esta es la ubicacin en donde esta instalado y ejecutado Dspace de el es la ubicacin que esta definida en el dspace.cfg como dspace.dir. En donde estn todos los archivos de configuracin de Dspace, lneas de comando, documentacin y aplicaciones web que sern instaladas.

AP

ROAF

UABC

Manual de Instalacin DSpace

2. El directorio fuente, referido como [dspace-source]. Esta es la ubicacin donde ha sido descomprimida la distribucin de la versin de Dspace. Este usualmente tiene el nombre de el archivo que expandir como sigue dspace<versin>-release o dspace-<versin>-src release. Este es el directorio donde todos tus comandos de construccion sern ejecutados. 3. El directorio de implementacin web. Este es el directorio que contiene las aplicaciones web de Dspace. En Dspace 1.5.1 y anterior, le corresponde a [dspace]/webapps por default. Sin embargo, si tu estas usando Tomcat, podras decidir copiar las aplicaciones web de Dspace de [dspace]/webapps/ a [tomcat]/webapps/ .

3.3 Instalacin
Este mtodo te levanta y tiene corriendo Dspace rpida y fcilmente. Este es idntico en ambas distribuciones la versin por default y la versin fuente. 1. Crear un usuario Dspace. Este necesita ser el mismo usuario que Tomcat correr como por ejemplo: useradd -m dspace 2. Descarga la ultima versin [http://sourceforge.net/projects/dspace/] y desempaqutalo. Aunque ah hay dos versiones disponibles (dspace -1.5.1release.zip y dspace-1.5.1-src-release.zip), solo necesitas escoger uno. Si quieres copiar todo el cdigo fuente de java, deberas descargar la versin dspace-1.5.1-src-release.zip unzip dspace-1.5.1-release.zip Para fcil referencia, referiremos a la ubicacin de la versin descomprimida de Dspace como [dspace-source] en el resto de estas instrucciones. 3. Instalacin de la base de datos.

Postgres:
a) El driver PostgreSQL 8.1-404 jdbc3 esta configurado como parte de la construccin por default de Dspace. b) Crear una base de datos Dspace, propietaria del usuario de dspace PostgreSQL:

createuser -U postgres -d -A -P dspace createdb -U dspace -E UNICODE dspace

AP

ROAF

UABC

Manual de Instalacin DSpace

Introducir una contrasea para la base de datos de Dspace. (Esta no es la misma que la contrasea del usuario de Linux)

4.

Edita [dspace-source]/dspace/config/dspace.cfg, en particular necesitas un conjunto de estas propiedades:

dspace.dir debe ser conjunto de el directorio [dspace](instalacion). dspace.url completa el URL de la pgina inicial del servidor de Dspace. dspace.hostname completamente calificado el nombre del dominio del
web server.

dspace.name -- apropiado nombre de tu servidor, por ejemplo My Digital

Library.

db.password -- La contrasea de la base de datos que introdujiste en el paso

anterior.

mail.server -- nombre de dominio completamente calificado del correo del

servidor.

feedback.recipient -- bandeja para la regeneracin de correos. mail.admin -- bandeja de correos para el sitio de administrador de Dspace. alert.recipient -- bandeja de correo para los errores o alertas del servidor. registration.notify -- bandeja de correo para los emails de usuarios
registrados (opcional). NOTA: Puedes interpolar el valor de una variable de configuracin con el valor de otra. Por ejemplo, para feedback.recipient al mismo valor como mail.admin, la lnea se mirara como:

AP

ROAF

UABC

10

Manual de Instalacin DSpace

feedback.recipient = ${mail.admin}
mira el archivo dspace.cfg para mas ejemplos.

5. Crear el directorio para la instalacin de Dspace (i.e. [dspace]). Como raz , correr as:

mkdir [dspace] chown dspace [dspace]

(Asumiendo que el nombre de usuario de LINUX es dspace) 6. Como usuario de LINUX dspace , genera el paquete de instalacin de Dspace en el directorio [dspace-source]/dspace/target/dspace-[versin].dir/:

cd [dspace-source]/dspace/ mvn package NOTA: sin ningn argumento extra, el paquete de instalacin de Dspace es inicializado por PostgreSQL.
7. Como dspace usuario de Linux ,inicializa la base de datos de Dspace e instala Dspace a [dspace]:

cd [dspace-source]/dspace/target/dspace-[version].dir/ ant fresh_install

ant help
Lo ms probable es que vaya a salir un error en la conexin de la base de datos. Mira la seccin de problemas comunes. 8. Dile a la instalacin de Tomcat donde encontrar tu aplicacin web de Dspace. Como ejemplo, en la seccin <Host> de tu [tomcat]/conf/server.xml podras agregar lneas similares a lo siguiente (pero sustituya [dspace] con tu instalacin local):

AP

ROAF

UABC

11

Manual de Instalacin DSpace

<!-- DEFINE A CONTEXT PATH FOR DSpace JSP User Interface --> <Context path="/jspui" docBase="[dspace]\webapps\jspui" debug="0" reloadable="true" cachingAllowed="false" allowLinking="true"/> <!-- DEFINE A CONTEXT PATH FOR DSpace OAI User Interface --> <Context path="/oai" docBase="[dspace]\webapps\oai" debug="0" reloadable="true" cachingAllowed="false" allowLinking="true"/>

Alternativamente, podras copiar solo las aplicaciones Web de Dspace que desees usar de [dspace]/webapps al directorio apropiado en su instalacin de Tomcat, por ejemplo: cp -r [dspace]/webapps/jspui [tomcat]/webapps cp -r [dspace]/webapps/oai [tomcat]/webapps

9. Crea una cuenta inicial de administrador [dspace]/bin/create-administrator 10. Ahora el momento de la verdad! Reinicia Tomcat. Visita el URL de la base de su servidor, dependiendo de cual aplicacin web de Dspace utilizaste. Deberas de ver la pgina inicial de Dspace. Y Felicidades! URL de la base de la aplicacin web de Dspace: JSP interfaz de usuario --(ej.)http://dspace.myu.edu:8080/jspiu XML interfaz de usuario -- (ej.) http://dspace.myu.edu:8080/xmlui OAI-PMH intefaz -- (ej.) http://dspace.myu.edu:8080/oai/request?verb=identify

Para fijar algunas comunidades y colecciones, necesitaras iniciar sesin como administrador de Dspace (la cual ya creaste arriba con create-administrator) y entrar a la UI del administrador en cualquiera de las interfaces de usuario de JSP o XML

AP

ROAF

UABC