Gestión de repositorios digitales con DSpace 2022

Curso de formación online

GESTIÓN DE REPOSITORIOS DIGITALES CON DSPACE

Instalación de DSpace 6.x

Elaborado por Ricardo Eito Brun

Página 1 de 28
Gestión de repositorios digitales con DSpace 2022

Contenidos
1. Objetivos del módulo ................................................................................................... 3
2. Instalación del programa DSpace ................................................................................. 3
3.1. Prerrequisitos para la instalación ........................................................................... 3
3.1.1. Instalar JDK. ................................................................................................... 4
3.1.2. Instalar Postgresql. ......................................................................................... 8
3.1.2. Instalar Apache Ant. ..................................................................................... 11
3.1.3. Instalar Apache Maven. ................................................................................ 13
3.1.4. Instalar Apache Tomcat. ............................................................................... 14
3.2. Instalación de DSpace ......................................................................................... 19
3.2.1. Crear la carpeta para la instalación. .............................................................. 19
3.2.2. Crear el usuario de base de datos, y la base de datos. .................................. 19
3.2.3. Establecer la configuración inicial en local.cfg ............................................ 22
3.2.4. Construcción del programa (ant y maven) ................................................... 23
3.2.5. Despliegue de las aplicaciones web.............................................................. 24
3.2.6. Crear un usuario administrador .................................................................... 26

Página 2 de 28
Gestión de repositorios digitales con DSpace 2022

1. Objetivos del módulo

En este módulo se describe la instalación del programa, versión 6.x.

2. Instalación del programa DSpace

La instalación de DSpace puede realizarse en ordenadores con distintos sistemas operativos:
Windows y las variantes de Linux (debían, RedHat, SUSE, etc.)

En esta sección del manual, se usa como referencia un sistema operativo Windows 7, de 64
bits. Se destaca que el proceso de instalación es prácticamente idéntico en Windows y Linux, y
que el proceso de instalación es prácticamente independiente del sistema operativo. En este
documento, se usará como versión de DSpace la última versión estable disponible, la 6.2, que
está disponible en esta página web:

https://github.com/DSpace/DSpace/releases/download/dspace-6.3/dspace-6.3-release.zip

Entre las versiones disponibles, descargaremos el archivo: dspace-6.3-release.zip. En

esta misma página también está disponible el manual con la documentación oficial de DSpace.

Nota: en la página de descarga de DSpace el programa está disponible en distintos formatos:

ZIP, tar.gz, etc. Algunos de los archivos de descarga incluyen las letras –src-. Estos son los
archivos que, además de los ficheros ejecutables, incluyen el código fuente de DSpace. Se
descargarán estos archivos cuando se quiera modificar el código fuente de DSpace. En el
curso, únicamente necesitaremos las versiones binarias, que también ofrecen distintas
opciones de configuración.

3.1. Prerrequisitos para la instalación

Antes de instalar DSpace necesitamos instalar en el ordenador otros programas que son
utilizados por éste. La lista de programas que se deben instalar como prerrequisitos para la
instalación de DSpace es la siguiente:

 Intérprete y entorno de desarrollo del lenguaje JAVA, pudiendo utilizarse Oracle Java
JDK u OpenJDK. JDK corresponde a Java Development Kit, y es un conjunto de
archivos que incluye tanto el intérprete del lenguaje Java (JRE o Java Runtime
Environment), como unas librerías y utilidades adicionales.

 Servidor de bases de datos Postgresql, versión 9.0 o posterior. Esta base de datos
mantendrá toda la información sobre colecciones, metadatos, usuarios, etc. DSpace
también funciona con el servidor de bases de datos Oracle 10g o superior, pero éste no
es gratuito y exige el pago de una licencia, por lo que optaremos por utilizar Postgresql.

 Herramientas para la construcción del programa Apache Ant, versión 1.8 o superior, y
Apache Maven, versión 3.0.5 o superior. Estos dos programas se usarán durante el
proceso de instalación.

 Servidor de aplicaciones web Apache Tomcat 7 o superior. Es el software que ejecuta

el servidor web y las aplicaciones web de DSpace. Es posible usar otras alternativas a
Tomcat (Jetty, Caucho o Resin), pero Apache Tomcat es la opción más habitual.

En los siguientes apartados se describe cómo instalar estos programas.

Página 3 de 28
Gestión de repositorios digitales con DSpace 2022

3.1.1. Instalar JDK.

Se puede descargar JDK desde la página web:

http://www.oracle.com/technetwork/java/javase/downloads/jdk8-downloads-2133151.html

En esta página están disponibles las versiones de JDK para distintos sistemas operativos. En
el caso de Windows, disponemos de la versión para 32 y 64 bits. En el ejemplo utilizado en
este documento, se ha descargado e instalado el archivo jdk-8u201-windows-x64.exe,
pero se puede usar el más reciente que esté disponible en la página.

1. Para instalar JDK, haremos doble clic sobre este archivo jdk-8u111-windows-
x64.exe y seguiremos los pasos que nos indica el asistente.

2. Haremos clic en Next >.

3. Nuevamente hacemos clic en Next >. Tras unos segundos, aparecerá la siguiente
ventana:

Página 4 de 28
Gestión de repositorios digitales con DSpace 2022

4. Mantenemos la carpeta por defecto, y hacemos clic en Siguiente >. Continuará la

instalación y se mostrará la siguiente ventana:

5. Haremos clic en Close para finalizar.

6. A continuación, añadiremos la ruta del programa Java a la variable de entorno PATH de

sistema de Windows. Esto nos permitirá ejecutar Java desde cualquier carpeta de
nuestro disco. Para hacer esto:

a. Accedemos a las variables de entorno del sistema. Podemos hacerlo desde el

explorador de Windows, haciendo clic en la opción Este equipo, pulsando el
botón derecho del ratón, y seleccionando Propiedades.

Página 5 de 28
Gestión de repositorios digitales con DSpace 2022

b. Aparecerá la ventana Sistema, en la que haremos clic en Configuración

Avanzada del sistema.

c. Haremos clic en Variables de entorno…

Página 6 de 28
Gestión de repositorios digitales con DSpace 2022

d. En el recuadro Variables del sistema, haremos clic en Nueva… Aparecerá

una ventana donde escribiremos el nombre de la variable JAVA_HOME, y como
valor la ruta donde hemos instalado Java, por defecto: C:\Program
Files\Java\jdk1.8.0_201

e. A continuación buscamos la variable PATH, y tras el valor que ya tenga,

escribimos un punto y coma (;), y tras él la ruta %JAVA_HOME%\bin.
Comprobaremos si existe una variable CLASS_PATH, y en caso de que no esté
creada, la crearemos dándole el valor: %JAVA_HOME%\lib.

f. Para concluir, abriremos una ventana de línea de comandos (podemos hacerlo

desde Windows pulsando el botón de inicio y escribiendo cmd, y escribiremos:
java –version. Pulsaremos la tecla <ENTER>, y si Java se ha instalado
correctamente, se nos mostrará un mensaje como este:

Página 7 de 28
Gestión de repositorios digitales con DSpace 2022

3.1.2. Instalar Postgresql.

Se trata del servidor de base de datos. Podemos descárga la versión para Windows de la
página web: https://www.postgresql.org/download/windows/ . En esta página, haremos clic en
el enlace Download the installer, que nos conduce a otra página donde podemos indicar la
versión que queremos descargar, y la de nuestro sistema operativo. En este documento,
usaremos la versión 9.6 para Windows 64 bits, que corresponde con el archivo postgresql-
9.6.12-1-windows-x64.exe. Para completar la instalación:

1. Haremos doble clic sobre este archivo. Aparecerá la siguiente ventana:

2. Haremos clic en Siguiente >. Aparece una ventana que nos indica dónde se va a
instalar el programa.

Página 8 de 28
Gestión de repositorios digitales con DSpace 2022

3. Nuevamente haremos clic en Siguiente > para confirmar el valor propuesto por
defecto. Se mostrará una nueva ventana que indica en qué carpeta se guardarán las
bases de datos.

4. Mantendremos el valor propuesto por defecto, y haremos clic en Siguiente >. Aparece
una ventana que nos pide la contraseña del usuario administrador de la base de datos
(el nombre de este usuario administrador es postgres, pero no necesitamos
indicarlo).

5. Escribiremos dos veces la contraseña. Es importante recordar esta contraseña, ya que

será necesaria para poder trabajar con la base de datos en los siguientes pasos y en la
administración de DSpace. Tras indicarla, haremos clic en Siguiente >.

Página 9 de 28
Gestión de repositorios digitales con DSpace 2022

6. El programa de instalación nos indica qué puerto se usará para interactuar con la base
de datos. No es necesario que cambiemos el valor por defecto, 5432, por lo que
haremos clic en Siguiente > para continuar.

7. En esta ventana indicaremos la configuración regional. Escogeremos en la lista

desplegable el valor Spanish, Spain, y haremos clic en Siguiente >.

Página 10 de 28
Gestión de repositorios digitales con DSpace 2022

8. En esta ventana, iniciaremos la copia de los archivos haciendo clic en Siguiente >.
Tras unos segundos, aparecerá la siguiente ventana informando del final de la
instalación:

9. En este punto, haremos clic en Terminar. Si no hemos desactivado la opción Stack

builder puede ser usado…, se abrirá una nueva ventana que permite descargar
elementos adicionales. Señalamos no obstante que no es preciso instalar ningún
elemento más de Postgresql para trabajar con DSpace.

3.1.2. Instalar Apache Ant.

Este programa se puede obtener en el sitio web: http://ant.apache.org/

Para instalar ANT, sólo tenemos que descomprimir el archivo apache-ant-1.9.13-bin.zip

en C:\. Se creará una carpeta con el nombre C:\apache-ant-1.9.13.

Página 11 de 28
Gestión de repositorios digitales con DSpace 2022

A continuación, debemos crear la variable de sistema ANT_HOME, que tomará como valor la
carpeta donde está instalado ANT. Para hacer esto:

1. Desde el escritorio o el explorador de Windows, haremos clic en el botón derecho del

ratón en el icono tras situarnos sobre el icono que muestra al ordenador.

2. En el menú que aparece, seleccionamos Propiedades.

3. Haremos clic en Configuración avanzada del sistema, y luego en Variables de

entorno.

4. En la sección Variables del sistema, hacemos clic en Nueva…, y escribimos el

nombre de la variable ANT_HOME y su valor.

5. Para poder ejecutar el programa Apache Ant desde cualquier carpeta del ordenador, en
la ventana Variables de entorno, hacemos clic en la variable PATH y luego en
Editar… Escribiremos, a continuación del valor que ya tenga esta variable, un punto y
coma seguido de %ANT_HOME%\bin. Cerraremos la ventana haciendo clic en Aceptar
para guardar los cambios.

6. Para comprobar que se ha instalado correctamente, desde una ventana de línea de

comandos Windows ejecutaremos el comando ant -h. Debe aparecer un mensaje
como el siguiente:

Página 12 de 28
Gestión de repositorios digitales con DSpace 2022

3.1.3. Instalar Apache Maven.

El proceso es similar al descrito para Apache Ant. El archivo se puede descargar de la página:
https://maven.apache.org/download.cgi . Tras obtenerlo, se debe descomprimir el archivo
apache-maven-3.6.0-bin.zip en una carpeta con el nombre C:\apache-maven-
3.6.0.

A continuación, crearemos la variable de entorno de sistema MAVEN_HOME, que tomará como

valor la carpeta donde está instalado Maven. Para hacer esto:

1. Desde el escritorio, haremos clic en el botón derecho del ratón en el icono que muestra
al ordenador.

2. En el menú que aparece, seleccionamos Propiedades.

3. Haremos clic en Configuración avanzada del sistema, y luego en Variables de

entorno.

4. En la sección Variables del sistema, hacemos clic en Nueva…, y escribimos el

nombre de la variable MAVEN_HOME y su valor: C:\apache-maven-3.6.0.

5. Para poder ejecutar Apache Maven desde cualquier carpeta del ordenador, en la
ventana Variables de entorno del sistema, hacemos clic en la variable PATH,
Editar…, y escribiremos, a continuación del valor que ya tenga esta variable, un punto
y coma seguido de %MAVEN_HOME%\bin. Cerraremos la ventana haciendo clic en
Aceptar para guardar los cambios.

6. Para comprobar la instalación, desde una ventana de línea de comandos Windows,

ejecutaremos el comando mvn –-version. Aparecerá un mensaje similar al
siguiente:

Página 13 de 28
Gestión de repositorios digitales con DSpace 2022

3.1.4. Instalar Apache Tomcat.

Este programa puede descargarse desde el sitio web: http://tomcat.apache.org/download-
80.cgi#8.5.38 (en este documento se ha descargado la versión 8.5.38, que corresponde con el
archivo apache-tomcat-8.5.38.exe). Este archivo se puede descargar a través del enlace:
32-bit/64-bit Windows Service Installer disponible en la página anterior.

1. Haremos doble clic en el archivo anterior:

2. Haremos clic en Next >. Se nos presentará el texto de licencia.

Página 14 de 28
Gestión de repositorios digitales con DSpace 2022

3. Haremos clic en I agree para continuar.

4. En esta ventana, hacemos clic en Next >. A continuación se presenta una ventana
donde se pueden indicar los puertos y la contraseña del usuario de Tomcat.

Página 15 de 28
Gestión de repositorios digitales con DSpace 2022

5. En La ventana anterior se nos indica qué puertos usará Tomcat, y nos pide el nombre y
contraseña del usuario administrador. Mantendremos los puertos por defecto, y
escribiremos (y recordaremos) estas contraseñas. Haremos clic en Next >.

6. El programa nos indicará en qué ruta se encuentra el programa JAVA, que hemos
instalado anteriormente:

Página 16 de 28
Gestión de repositorios digitales con DSpace 2022

7. Comprobaremos que la ruta es correcta, y haremos clic en Next >. Se nos indica
dónde se va a instalar Tomcat:

8. Haremos clic en Install. Tras unos segundos, se nos indicará que el programa se ha
instalado correctamente:

Página 17 de 28
Gestión de repositorios digitales con DSpace 2022

9. Para concluir, haremos clic en Finish. Se iniciará el programa, y se presentará un

archivo informativo (lo podemos cerrar).

10. Para saber si Tomcat está funcionando, comprobaremos que en la barra de tareas de
Windows (parte inferior de la ventana), aparece un icono similar al siguiente: .

Además, abriremos un navegador y teclearemos la URL: http://localhost:8080.

Debemos ver una página como esta:

Tomcat puede cerrarse e iniciarse mediante las opciones que aparecen cuando hacemos
presionamos el botón derecho del ratón tras situarnos sobre el icono . Veremos que
aparecen dos opciones en un menú emergente: Stop service y Start service. Esto es

Página 18 de 28
Gestión de repositorios digitales con DSpace 2022

importante ya que, durante la instalación y configuración de DSpace, será necesario reiniciar

tomcat para que los cambios que hagamos tengan efecto.

A continuación, ya se puede proceder a la instalación de dspace.

3.2. Instalación de DSpace

3.2.1. Crear la carpeta para la instalación.
La instalación la realizaremos con el archivo dspace-6.3-release. Debemos descomprimir
este archivo a una carpeta al disco duro C. Concretamente, lo haremos en una carpeta con
nombre C:\dspace-6.3-release.

3.2.2. Crear el usuario de base de datos, y la base de datos.

A continuación, crearemos un usuario de la base de datos postgresql llamado dspace. Este es
el usuario que usará el programa DSpace para conectarse a la base de datos. No debe
confundirse con el usuario administrador de DSpace.

Para crear este usuario (al que llamaremos dspace), abriremos una ventana de línea de
comandos de Windows, y nos situaremos en la carpeta: C:\Program
Files\PostgreSQL\9.6\bin, y ejecutaremos el comando:

createuser --username=postgres --no-superuser –pwprompt dspace

Página 19 de 28
Gestión de repositorios digitales con DSpace 2022

Se nos pedirán los datos del usuario, y la contraseña del usuario administrador postgres.

A continuación crearemos una base de datos vacía con nombre dspace, de la cual será
propietario el usuario dspace que acabamos de crear. Para esto, lanzaremos esta orden:

createdb --username=postgres –-owner=dspace -–encoding=UNICODE dspace

Tras crear la base de datos, debemos habilitar la extensión pgcrypto. Para ello:

1. Seleccionamos Inicio > Programas > Postgresql 9.6 > SQL Shell (psql). Aparecerá
una ventana como la siguiente:

2. Pulsaremos <ENTER>.

Página 20 de 28
Gestión de repositorios digitales con DSpace 2022

3. Escribiremos el nombre de la base de datos dspace y pulsaremos <ENTER>.

4. Hacemos clic en <ENTER>.

5. De nuevo hacemos clic en <ENTER>.

Página 21 de 28
Gestión de repositorios digitales con DSpace 2022

6. Escribiremos la contraseña del administrador de Postgresql.

7. En la línea de comandos escribiremos esta orden:

CREATE EXTENSION pgcrypto;

, y haremos clic en <ENTER>.

8. A continuación, cerraremos la ventana escribiendo \q.

3.2.3. Establecer la configuración inicial en local.cfg

A continuación, abriremos con el bloc de notas (notepad) el archivo local.cfg.EXAMPLE
que está situado en la carpeta: C:\ dspace-6.0-release\dspace\config. Lo
guardaremos con nombre local.cfg.

En este nuevo archivo, asignaremos los valores a las variables de configuración que se indican
a continuación:

dspace.hostname = localhost
dspace.baseUrl = http://localhost:8080
dspace.name = Repositorio dspace SEDIC
default.language = es_ES
db.url = jdbc:postgresql://localhost:5432/dspace
db.username = dspace
db.password = (contraseña real)

Página 22 de 28
Gestión de repositorios digitales con DSpace 2022

En las variables mail.server, mail.from.address, mail.feedback.recipient,

mail.admin y mail.alert.recipent indicaremos los datos correspondientes a nuestro
servidor de correo-e.

A continuación, crearemos la carpeta C:\dspace desde el explorador de Windows. Esta es la

carpeta donde se instalará el programa DSpace.

3.2.4. Construcción del programa (ant y maven)

Nos situaremos en la carpeta C:\dspace-6.0-release, y ejecutaremos el comando: mvn
package.

Se iniciará la descarga de distintos archivos (por lo que es necesario contar con una conexión a
Internet en el momento de ejecutarlo). Al finalizar, la ventana de comandos mostrará esto:

Nota: Si se identifica un error con la aplicación SOLR que indica un problema de dependencias
con la librería Java tools.java, éste puede solucionarse copiando el archivo tools.java (o la
carpeta lib completa) desde la carpeta C:\Program Files\Java\jdk1.8.0_201\lib a la
carpeta C:\Program Files\Java.

Página 23 de 28
Gestión de repositorios digitales con DSpace 2022

A continuación se ejecutará la orden ant para completar la instalación. Desde la línea de

comandos, nos situaremos en la carpeta C:\dspace-6.0-
release\dspace\target\dspace-installer, y ejecutaremos la orden: ant
fresh_install.

Si todo funciona correctamente, se nos mostrará un mensaje como el siguiente:

3.2.5. Despliegue de las aplicaciones web

DSpace consta de varias aplicaciones web (JSPUI, XMLUI, etc.) que deben desplegarse en el
servidor Tomcat. Para hacer esto, en primer lugar debemos detener el servidor Tomcat. Para
ello, nos situaremos sobre su icono en la barra de estado de Windows, pulsaremos el botón
derecho del ratón y seleccionaremos Stop Service. El icono cambiará y mostrará un recuadro
rojo en lugar del triángulo verde.

A continuación, copiaremos todas las subcarpetas incluidas en C:\dspace\webapps a la

carpeta de Tomcat C:\Program Files\Apache Software Foundation\Tomcat
8.5\webapps.

Página 24 de 28
Gestión de repositorios digitales con DSpace 2022

Una vez se hayan copiado, reiniciaremos Tomcat. Para ello, nos situamos sobre su icono en la
barra de estado, hacemos clic en el botón derecho del ratón y seleccionamos Start Service.

Para comprobar si todo funciona correctamente, abriremos un navegador e iremos a la URL:

http://localhost:8080/xmlui.

También podemos comprobar que se puede acceder al administrador de Tomcat, desde la

página http://localhost:8080.

En esta página podemos hacer clic en Manager App, y tras escribir el nombre de usuario y la
contraseña del administrador de Tomcat, aparecerá una ventana como la siguiente:

Página 25 de 28
Gestión de repositorios digitales con DSpace 2022

3.2.6. Crear un usuario administrador

Para finalizar, debemos crear al menos un usuario administrador para DSpace. No debemos
confundir este usuario (que será una persona encargada de la gestión del repositorio), con el
usuario que hemos creado para Tomcat o para postgresql, que son usuarios que usará Tomcat
y el software DSpace para interactuar con la base de datos.

La creación de un usuario administrador para DSpace la haremos desde la línea de comandos

Windows, con la orden dspace create-administrator. Para poder ejecutar esta orden,
debemos situarnos en la carpeta C:\dspace\bin.

Tras ejecutar esta orden, el programa de instalación nos pedirá datos para el nuevo usuario
administrador: correo-e, nombre y apellidos y contraseña.

Página 26 de 28
Gestión de repositorios digitales con DSpace 2022

Una vez hayamos creado este usuario, desde la página de inicio de DSpace podemos
comprobar que accedemos usando estas credenciales, haciendo clic en el enlace Acceder o
Login:

Veremos que aparece el nombre y apellidos del usuario con el que nos hemos logado en la
esquina superior derecha, y que en el menú lateral aparecen nuevas opciones que no estaban
disponibles antes de iniciar la sesión de usuario:

Para salir de DSpace, disponemos del enlace Salir, situado dentro del recuadro Mi cuenta, o
del enlace Logout, situado en la esquina superior derecha.

Página 27 de 28
Gestión de repositorios digitales con DSpace 2022

Tras la instalación, en el ordenador habrán quedado: a) Las carpetas desde las que hemos
hecho la instalación, C:\dspace-6.0-release. B) Las carpetas en las que se ha instalado
dspace: C:\dspace. C) Las carpetas de las aplicaciones web (webapps) que están en el
directorio de instalación de Tomcat: C:\Program Files\Apache Software
Foundation\Tomcat 8.5\webapps.

Estas carpetas se mantendrán en el sistema, si bien es necesario entender su función y

finalidad de cara a la evolución, mantenimiento y adaptación del sitio. Por ejemplo, para que los
cambios en las aplicaciones web se hagan efectivos, éstos deben estar realizados en las
carpetas de Tomcat. Pero no debemos modificar directamente estos archivos, y sucede algo
parecido con los archivos de configuración disponibles en C:\dspace. Si bien esto se describe
en un módulo posterior del curso, dedicado a la adaptación del sitio DSpace, señalamos que
los cambios se harán normalmente en la carpeta desde la que se ha hecho la instalación, y
luego ser hará una construcción (o build) del programa usando de nuevo Ant y Maven, de
forma similar a cómo se ha hecho con la primera instalación descrita en este documento.

Página 28 de 28