Dspace Instalacion v6x
Dspace Instalacion v6x
Dspace Instalacion v6x
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
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
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.
Página 3 de 28
Gestión de repositorios digitales con DSpace 2022
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.
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
Página 5 de 28
Gestión de repositorios digitales con DSpace 2022
Página 6 de 28
Gestión de repositorios digitales con DSpace 2022
Página 7 de 28
Gestión de repositorios digitales con DSpace 2022
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).
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.
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:
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:
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.
Página 12 de 28
Gestión de repositorios digitales con DSpace 2022
1. Desde el escritorio, haremos clic en el botón derecho del ratón en el icono que muestra
al ordenador.
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.
Página 13 de 28
Gestión de repositorios digitales con DSpace 2022
Página 14 de 28
Gestión de repositorios digitales con DSpace 2022
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
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: .
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
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:
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:
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
Página 21 de 28
Gestión de repositorios digitales con DSpace 2022
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
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
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.
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
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.
Página 28 de 28