Manual de

Instalacin
DSpace
ROAF
ROAF
Facultad de Ciencias, Ciencias Computacionales,
Universidad Autnoma de Baja California
DSpace System
Documentation:
Installation

AP ROAF UABC
2 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
3 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
4 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 [dspace-
source]/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
5 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
6 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
7 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 dspace-
xmlui, 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
8 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.1-
release.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
9 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