Manual de Instalacin

DSPACE en OPENSUSE

Elaborado por Oficina Tcnica CBUES, junio de 2011

Tabla de contenido
Qu es Dspace? ................................................................................................................................. 3
Instalacin de Dspace en Open Suse 11.3........................................................................................... 3
Instalacin de los pre-requisitos ..................................................................................................... 3
Java Development Kit (JDK) ......................................................................................................... 3
Instalacin de Apache Maven ..................................................................................................... 4
Instalacin de Apache Ant........................................................................................................... 4
Instalacin de Apache Tomcat .................................................................................................... 5
Instalacin de PostgreSQL ........................................................................................................... 5
Instalacin de Dspace 1.7.1 ............................................................................................................. 5

Qu es Dspace?
DSpace es un software de cdigo abierto diseado por el Massachusetts Institute of
Technology (MIT) y los laboratorios de HP para gestionar repositorios de ficheros
(textuales, audio, vdeo, etc.), facilitando su depsito, organizndolos en comunidades,
asignndoles metadatos y permitiendo su difusin a recolectores o agregadores. Estas
caractersticas han hecho que sea uno de los programas preferidos por las instituciones
acadmicas para gestionar el repositorio dnde los investigadores depositan sus
publicaciones y materiales de bsqueda con objeto de darles una mayor visibilidad.

Instalacin de Dspace en Open Suse 11.3

Dspace es una aplicacin desarrollada en Java y para su correcto funcionamiento necesita de los
siguientes pre-requisitos:
1.
2.
3.
4.
5.

Java Development Kit (JDK) 6.x o superior

Apache Maven 2.2.x
Apache Ant 1.7 o superior
Apache Tomcat 5.5.x o superior
PostgreSQL 8.3 o superior

Instalacin de los pre-requisitos

Java Development Kit (JDK)
Aunque hay muchas versiones de JDK y openSUSE trae una por defecto, es recomendable instalar
el JDK distribuido por Oracle.
Los pasos para la instalacin del JDK son:
1. Descargar el JDK del sitio de Oracle y ubicarlo en el directorio usr/local
http://www.oracle.com/technetwork/java/javase/downloads/jdk-6u26-download400750.html
Se recomienda descargar el archivo jdk-6u26-linux-i586.bin
2. Cambiar los permisos al archivo con la instruccin siguiente
chmod +X jdk-6u26-linux-i586.bin
La instruccin anterior generar un archivo ejecutable
3. Ejecutar el archivo con la instruccin siguiente
./ jdk-6u26-linux-i586.bin
La Instruccin anterior generara un directorio con todos los archivos del JDk
4. Cambiarle nombre al directorio generado con la siguiente instruccin
mv jdk-6u26-linux-i586 jdk
Se recomienda hacer lo anterior para que sea fcil el manejo del directorio
5. Agregar variable de entorno en el archivo profile que se encuentra en el directorio etc
(etc/profile)

export JAVA_HOME=usr/local/jdk
export PATH="$PATH:/usr/local/jdk/bin"
6. Guardar el archivo y reiniciar el sistema operativo para que los cambios tengan efecto
7. Probar la instalacin de con la instruccin java -version
Nota: si ya hay una instalacin del JDK se deben eliminar los archivos de esa instalacin y crear un
enlace a la nueva instalacin de la siguiente manera:
a. Desinstalar la versin existente desde jast (entorno grfico)
b. Eliminar los archivos del directorio usr/bin
rm usr/bin/java
c. Crear el enlace a la nueva instalacin
cd usr/bin
ln s /usr/local/jdk/ java
Instalacin de Apache Maven
1. Descargar Apache Maven de la direccin http://maven.apache.org/download.html y
ubicarlo en el directorio /usr/local se recomienda descargar el archivo apache-maven2.2.1-bin.tar.gz
2. Descomprimir el archivo con la instruccin
tar xvf apache-maven-2.2.1-bin.tar.gz
3. Le cambiamos nombre para que sea ms fcil el manejo.
mv apahe-maven-2.2.1 maven
4. Agregar variable de entorno en el archivo profile que se encuentra en el directorio etc
(etc/profile)
export M2_HOME=/usr/local/maven
export M2=$M2_HOME/bin
export PATH=$M2:$PATH
5. Guardar el archivo y reiniciar el sistema operativo para que los cambios tengan efecto
6. Probar la instalacin con la instruccin mvn -version
Instalacin de Apache Ant
1. Descargar Apache Ant de la direccin http://ant.apache.org/bindownload.cgi y ubicarlo
en el directorio usr/local, se recomienda descargar el archivo apache-ant-1.8.2-bin.tar.gz
2. Descomprimir el archivo con la instruccin
tar xvf apache-ant-1.8.2-bin.tar.gz
3. Cambiar nombre al archivo
mv apache-ant.1.8.2 ant
4. Agregar variable de entorno en el archivo profile que se encuentra en el directorio etc
(etc/profile)
PATH=$PATH:/usr/local/ant/bin
5. Guardar el archivo y reiniciar el sistema operativo para que los cambios tengan efecto
6. Probar la instalacin con la instruccin ant -version

Instalacin de Apache Tomcat

1. Descargar el tomcat de la direccin http://tomcat.apache.org/download-60.cgi y ubicarlo
en el directorio usr/local, en esta instalacin se ha usado la versin 6.0.32
2. Descomprimir los archivos con la instruccin
tar xzvf apache-tomcat-6.0.32.tar.gz
3. Cambiarle nombre al directorio generado
mv apache-tomcat-6.0.32 tomcat
4. Agregar variable de entorno en el archivo profile que se encuentra en el directorio etc
(etc/profile)
export CATALINA_HOME=/usr/local/tomcat
export PATH=$PATH:/usr/local/tomcat/bin
export JAVA_OPTS="-Xmx512M -Xms64M -Dfile.encoding=UTF-8"
5. Guardar el archivo y reiniciar el sistema operativo para que los cambios tengan efecto
Nota: Para probar el funcionamiento de tomcat utilice la instruccin catalina.sh run, luego desde
un navegador Web ingrese la url http://127.0.0.1:8080 si todo est bien aparecer la pgina de
inicio del servidor tomcat.
Instalacin de PostgreSQL
La instalacin de PostgreSQL se har desde los repositorios de OpenSuse utilizando yast2
1. yast2 -- install postgresql-server
2. hacer los cambios siguientes en el archivo postgresql.conf que se encuentra en el
directorio /var/lib/pgsql/data
a. Quitar comentario a la lnea listen_addresses = localhost para que el servidor de
bases de datos permita conexiones locales.
3. hacer los cambios siguientes en el archivo pg_hba.conf que se encuentra en el directorio
/var/lib/pgsql/data
# "local" is for Unix domain socket connections only
local all
all
md5
# IPv4 local connections:
host all
all
127.0.0.1/32

md5

Nota: Para iniciar el servicio de postgresql utilice la instruccin rcpostgresql start, Tambin
puede configurar el inicio automtico de postgresql con el arranque del sistema operativo con
la instruccin
chkconfig --add postgresql
/etc/init.d/postgresql start

Instalacin de Dspace 1.7.2

1. Descargar software de la direccin
http://sourceforge.net/projects/dspace/files/DSpace%20Stable/1.7.2/ y ubicarlo en el

2.
3.
4.
5.

directorio raz, para esta instalacin se usar el archivo dspace-1.7.2-src-release.zip

(Prob el tar.gz y no funcion, posiblemente no se descarg completo)
Descomprimir en el directorio raz
unzip dspace-1.7.2-src-release.zip
Crear usuario en postgresql para la base de datos
createuser U postgres d A P dsapce
Crear base de datos en postgresql
createdb U dspace E UNICOSE dspace
Revisar configuracin inicial en el archivo dspace.cfg que se encuentra ubicado en
/dspace-1.7.2-src-release/dspace/config, las variables que se deben revisar son las
siguientes:
dspace.dir El directorio de instalacin de dspace.
dspace.url url de dspace.
dspace.hostname nombre de dominio del servidor dspace.
dspace.name Nombre del repositorio.
db.password contrasea de la base de datos.
mail.server servidor de correo saliente.
mail.from.address cuenta de correo que se usar para enviar correos desde dspace.
feedback.recipient cuenta de correo de feedback.
mail.admin cuenta de correo del administrador de dspace.
alert.recipient cuenta de correo de las alertas
registration.notify cuenta de correo de registro de usuarios
db.schema Nombre del esquema de la base de datos que utilizar dsapace
default.locale Idioma por defecto
webui.supported.locales soporte de idiomas mltiples
webui.strengths.show - conteo de contenidos de las comunidades y colecciones

Estadsticas
solr.log.server solr.log.server =http://localhost:8080/solr/statistics
statistics.items.authorization.admin - statistics.items.authorization.admin=false
report.public report.public=true

6. Instalar el paquete
cd /dspace-1.7.2-src-release/dspace
mvn package
7. Compilar el paquete
cd dspace-1.7.2-src-release /dspace/target/dspace-1.7.2-build.dir
ant fresh_install
8. Modificar el archivo server.xml de apache tomcat para indicarle donde debe buscar los
archivos de Dspace

<Host name="localhost" appBase="/dspace/webapps"

unpackWARs="true" autoDeploy="true"
xmlValidation="false" xmlNamespaceAware="false"
</Host>
9. Reiniciar Apache tomcat y probar desde el navegador la siguiente direccin
http://127.0.0.1:8080/jspui/ Si la instalacin de Dspace es correcta aparecer la pgina de
inicio.

Fig. 1 Pantalla de Inicio Dspace

Creacin de usuario Administrador

La creacin del usuario administrador se har desde la consola utilizando la siguiente instruccin:
linux:/ # dspace/bin/dspace create-administrator
El sistema solicitar los siguientes datos:
1.
2.
3.
4.
5.

Correo electrnico del usuario administrador

Nombre y apellido
Idioma que el usuario tendr por defecto
Contrasea
Confirmar informacin

Configuracin de Estadsticas