Location via proxy:   [ UP ]  
[Report a bug]   [Manage cookies]                

Dspace Instalacion v7x

Descargar como pdf o txt
Descargar como pdf o txt
Está en la página 1de 47

Gestión de repositorios digitales con DSpace 2022

Curso de formación online

GESTIÓN DE REPOSITORIOS DIGITALES CON DSPACE

Instalación de DSpace 7.x (sin Docker)

Elaborado por Ricardo Eito Brun

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

Contenidos
1. Objetivos del módulo ................................................................................................... 3
2. Instalación del programa DSpace ............................... ¡Error! Marcador no definido.
3.1. Prerrequisitos para la instalación ........................................................................... 3
3.1.1. Instalar JDK. ................................................................................................... 3
3.1.2. Instalar Postgresql. ......................................................................................... 7
3.1.2. Instalar Apache Ant. ..................................................................................... 12
3.1.3. Instalar Apache Maven. ................................................................................ 12
3.1.4. Instalar Apache Tomcat. ............................................................................... 12
3.2. Instalación de DSpace ......................................................................................... 25
3.2.1. Crear la carpeta para la instalación. .............. ¡Error! Marcador no definido.
3.2.2. Crear el usuario de base de datos, y la base de datos. .................................. 34
3.2.3. Establecer la configuración inicial en local.cfg ............................................ 38
3.2.4. Construcción del programa (ant y maven) ................................................... 38
3.2.5. Despliegue de las aplicaciones web.............................................................. 40
3.2.6. Crear un usuario administrador .................................................................... 42

Página 2 de 47
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 7.x, sin usar contenedores
Docker. La instalación se divide en tres apartados:

• Instalación de pre-requisitos (software que es necesario para instalar DSpace)

• Instalación del back-end, es decir, la parte de DSpace que interactúa con la base de
datos y presta los servicios.

• Instalación del front-end, que es la interfaz web de usuario.

2. 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 11.0. 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.10 o superior, y
Apache Maven, versión 3.3 o superior. Estos dos programas se usarán durante el
proceso de instalación.

• Servidor de aplicaciones web Apache Tomcat 9. 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.

• Indexador Apache Solr 8.x. Se utiliza para las búsquedas, índices y estadísticas.

• GIT, software para gestionar descargas y configuración.

• Node.js, intérprete y librerías de JavaScript utilizadas por el Front-end (interfaz web


cliente)

• Yarn, versión 1.x, que se utiliza para ejecutar el Front-end de DSpace.

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

2.1. Instalar JDK.

Se puede descargar JDK desde la página web:

https://www.oracle.com/java/technologies/downloads/#java11

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

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-11.0.14_windows-
x64_bin.exe. Es necesario registrarse para poder hacer la descarga.

1. Para instalar JDK, haremos doble clic sobre el archivo jdk-11.0.14_windows-


x64_bin.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 47
Gestión de repositorios digitales con DSpace 2022

4. Haremos clic en Close para finalizar.

5. 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.

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


Avanzada del sistema.

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

c. Haremos clic en Variables de entorno…

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\jdk-11.0.14.

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.

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

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 similar a este:

2.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.enterprisedb.com/downloads/postgres-postgresql-downloads

En esta página, haremos clic en el enlace correspondiente a la versión 11 para 64 bits, que
corresponde con el archivo postgresql-11.15-1-windows-x64. 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 7 de 47
Gestión de repositorios digitales con DSpace 2022

3. Nuevamente haremos clic en Siguiente > para confirmar el valor propuesto por
defecto.

4. Mantendremos las opciones propuestas y haremos clic en Siguiente >.

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

5. Mantendremos las opciones propuestas 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).

6. 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 47
Gestión de repositorios digitales con DSpace 2022

7. 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.

8. 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 47
Gestión de repositorios digitales con DSpace 2022

Hacemos clic en Siguiente:

9. 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 47
Gestión de repositorios digitales con DSpace 2022

10. 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.

2.3. Instalar Apache Ant.


Este programa se puede obtener en el sitio web: https://ant.apache.org/bindownload.cgi

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


(https://dlcdn.apache.org//ant/binaries/apache-ant-1.10.12-bin.zip ) y
descomprimirlo en C:\.

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

2.4. 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 . Descargaremos el archivo apache-maven-3.8.4-
bin.zip (https://dlcdn.apache.org/maven/maven-3/3.8.4/binaries/apache-
maven-3.8.4-bin.zip ) y lo descomprimiremos en C:\. Se creará una carpeta con el
nombre C:\apache-maven-3.8.4.

2.5. Instalar Apache Tomcat.


Este programa puede descargarse desde el sitio web: Apache Tomcat® - Apache Tomcat 9
Software Downloads (en este documento se ha descargado la versión 9.0.59, que corresponde
con el archivo https://dlcdn.apache.org/tomcat/tomcat-9/v9.0.59/bin/apache-
tomcat-9.0.59.exe).

1. Haremos doble clic en el archivo anterior:

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

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

3. Haremos clic en I agree para continuar.

Página 13 de 47
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.

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

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

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

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

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

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


archivo informativo (lo podemos cerrar).

9. 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:

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

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
importante ya que, durante la instalación y configuración de DSpace, será necesario reiniciar
tomcat para que los cambios que hagamos tengan efecto.

2.6. Instalación de Apache Solr


Este programa se descargará desde la página web:

https://solr.apache.org/downloads.html

Concretamente, se descargará este archivo:

https://www.apache.org/dyn/closer.lua/lucene/solr/8.11.1/solr-8.11.1.zip?action=download

Para instalarlo, basta con descomprimir el archivo zip en el disco C:\. Se creará una carpeta
C:\solr-8.11.1:

Para comprobar que Solr funciona correctamente, abriremos una ventana “negra” de
comandos, nos situaremos en la carpeta C:\solr-8.11.1\bin y ejecutaremos el comando solr
start:

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

A continuación, abrimos una ventana del navegador web y vamos a la dirección:


http://localhost:8983/ . Aparecerá una ventana como la siguiente:

2.7. Instalar GIT


Este programa se puede obtener en el sitio web: https://git-scm.com/download/win ,
concretamente: https://github.com/git-for-windows/git/releases/download/v2.35.1.windows.2/Git-
2.35.1.2-64-bit.exe

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

Para instalar GIT, sólo tenemos que ejecutar el archivo:

1. Haremos clic en Next.

2. Sin cambiar ninguna opción, seleccionamos Next.

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

3. Haremos clic en Next nuevamente.

4. Sin cambiar nada, hacemos clic en Next.

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

5. Nuevamente, hacemos clic en Next.

6. Nuevamente, hacemos clic en Next.

7. Nuevamente, hacemos clic en Next.

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

8. Nuevamente, hacemos clic en Next.

9. Seleccionamos Use Windows…, y hacemos clic en Next.

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

10. Hacemos clic en Next.

11. Continuamos haciendo clic en Next hasta llegar a esta ventana, donde seleccionamos
Install:

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

12. Al completarse la instalación, aparecerá esta ventana:

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: git version. Pulsaremos la
tecla <ENTER>, y si se ha instalado correctamente, se nos mostrará un mensaje similar a este:

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

2.8. Instalar NODE.JS


Este programa se descarga desde:

https://nodejs.org/en/

Elegiremos la opción 16.14.0 LTS. Se descargará el archivo node-v16.14.0-x64.exe. Lo


ejecutaremos:

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

Aceptamos los términos y hacemos clic en Next.

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

Sin cambiar la carpeta por defecto, hacemos clic en Next.

Hacemos clic en Next.

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

En esta ventana, no es necesario seleccionar la opción Automatically…, y haremos clic en


Next.

Hacemos clic en Install. Cuando se complete la instalación, aparecerá esta ventana:

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

2.9. Instalar YARN 1.X

Para instalar este programa, debemos ir a la página web:


https://classic.yarnpkg.com/en/docs/install#windows-stable

Debajo de Alternatives, hacemos clic en Click to expand / collapse:

Página 29 de 47
Gestión de repositorios digitales con DSpace 2022

En las dos listas desplegables, seleccionamos Windows y Classic Nigthly….:

Haremos clic en Download Installer (Nightly), y ejecutaremos el archivo que se ha


descargado. Únicamente debemos seguir el asistente paso a paso:

Página 30 de 47
Gestión de repositorios digitales con DSpace 2022

Página 31 de 47
Gestión de repositorios digitales con DSpace 2022

Página 32 de 47
Gestión de repositorios digitales con DSpace 2022

3. Instalación de DSpace BackEnd


3.1. Descargar y descomprimir el archivo DSpace backend.
Se debe descargar un archivo ZIP desde la página:

https://github.com/DSpace/DSpace/releases

Concretamente, se descargará el archivo:

https://github.com/DSpace/DSpace/archive/refs/tags/dspace-7.2.zip

El archivo se descomprimirá en el disco duro C. Se creará una carpeta C:\DSpace-dspace-


7.2.

Página 33 de 47
Gestión de repositorios digitales con DSpace 2022

3.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\11\bin, y ejecutaremos el comando:

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

Se nos pedirá la contraseña para el nuevo usuario (escribiremos dspace con minúsculas) dos
veces, y luego la contraseña del usuario administrador postgres. Es importante recordar que
cuando escribimos las contraseñas, estas no se muestran en pantalla.

Página 34 de 47
Gestión de repositorios digitales con DSpace 2022

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 > Postgresql 11 > SQL Shell (psql). Aparecerá una ventana
como la siguiente:

2. Pulsaremos <ENTER>.

Página 35 de 47
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 36 de 47
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.

Página 37 de 47
Gestión de repositorios digitales con DSpace 2022

3.3. Revisar 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-dspace-7.2\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.ui.url = http://localhost:4000
dspace.name = Repositorio dspace SEDIC
default.language = es_ES
db.url = jdbc:postgresql://localhost:5432/dspace
db.username = dspace
db.password = dspace

Se descomentará la línea solr.server, eliminando el carácter #.

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


mail.admin y mail.alert.recipent se podrían indicar 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.4. Construcción del programa (ant y maven)


Desde la “ventana negra” de comandos, nos situaremos en la carpeta C:\DSpace-dspace-
7.2, y ejecutaremos el comando: C:\apache-maven-3.8.4\bin\mvn package.

Página 38 de 47
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, tras unos minutos la ventana de comandos
mostrará un mensaje similar a este:

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-dspace-
7.2\dspace\target\dspace-installer, y ejecutaremos la orden:

C:\apache-ant-1.10.12\bin\ant fresh_install

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

Página 39 de 47
Gestión de repositorios digitales con DSpace 2022

3.5. Despliegue de las aplicaciones web y “cores” Solr


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
9\webapps.

Seguidamente, copiaremos las cuatro carpetas disponibles en C:\dspace\solr a la carpeta


C:\solr-8.11.1\server\solr\configsets.

Página 40 de 47
Gestión de repositorios digitales con DSpace 2022

Una vez se hayan copiado, reiniciaremos Solr y Tomcat.

Para reiniciar Solr, desde la “ventana negra” escribiremos la orden solr stop -p 8983, y luego
solr start.

Para reiniciar Tomcat, 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/server.

También podemos comprobar que Solr funciona, desde la página http://localhost:8983.

Página 41 de 47
Gestión de repositorios digitales con DSpace 2022

3.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.

4. Instalación DSpace Front-end

Desde la página https://github.com/DSpace/dspace-angular/releases, descargaremos el


archivo:

https://github.com/DSpace/dspace-angular/archive/refs/tags/dspace-7.2.zip

Lo descomprimiremos en C:\. Se creará una carpeta C:\dspace-angular-dspace-7.2:

Página 42 de 47
Gestión de repositorios digitales con DSpace 2022

A continuación, desde una ventana “negra” de comandos, nos situamos en esa carpeta :

Y ejecutaremos la orden:
"C:\Program Files (x86)\Yarn\bin\yarn" install

Página 43 de 47
Gestión de repositorios digitales con DSpace 2022

Tras unos minutos, deberíamos ver un mensaje similar a éste:

En la carpeta C:\dspace-angular-dspace-7.2\config hay un archivo


config.example. Lo renombraremos como config.prod y lo abriremos con el bloc de
notas (Notepad).

Veremos una sección rest:

Página 44 de 47
Gestión de repositorios digitales con DSpace 2022

Tenemos que hacer varios cambios, para que esas líneas queden así:

# The REST API server settings


# NOTE: these must be 'synced' with the 'dspace.server.url' setting
in your backend's local.cfg.
rest:
ssl: false
host: localhost
port: 8080
# NOTE: Space is capitalized because 'namespace' is a reserved
string in TypeScript
nameSpace: /server

Guardamos los cambios y volvemos a la ventana “negra” de comandos.

Ejecutaremos la orden:

"C:\Program Files (x86)\Yarn\bin\yarn" run build:prod

Página 45 de 47
Gestión de repositorios digitales con DSpace 2022

El proceso necesitará unos minutos… Transcurridos estos, ejecutaremos el comando que inicia
el frontend:
"C:\Program Files (x86)\Yarn\bin\yarn" run serve:ssr.

Para comprobar que funciona, abriremos la página http://localhost:4000

Página 46 de 47
Gestión de repositorios digitales con DSpace 2022

Podemos comprobar que nos logamos con el usuario que creamos en el punto 3.6.

Página 47 de 47

También podría gustarte