Manual paso a paso de instalación de Repositorios Dspace 5.6

Por Ing. Luis Carlos Alvarez Fernandez

Le compartimos el Manual para la instalación desde cero de un Repositorio utilizando la herramienta Dspace versión 5.6 en un servidor Ubuntu Linux, acompañado de dos videos donde se explica el procedimiento descrito.

 

Instalación:

Los pasos de instalación son a través de una consola o terminal, autenticándose como usuario root o de administración.

Crear una carpeta “dspace” en la dirección /usr/local

$ mkdir /usr/local/dspace

1. Copiar dependencias a la direccion /usr/local/

cp /home/user/Desktop/Instalar/dependencias/apache-ant-1.9.7-bin.tar.gz /usr/local/dspace/

cp /home/user/Desktop/Instalar/dependencias/apache-tomcat-8.0.35.tar.gz /usr/local/dspace/

cp /home/user/Desktop/Instalar/dependencias/jre-8u77-linux-x64.tar.gz /usr/local/dspace/

cp /home/user/Desktop/Instalar/dependencias/postgresql-9.4.1-1-linux-x64.run /usr/local/dspace/

2. Descompactar las dependencias

tar -xzvf apache-ant-1.9.7-bin.tar.gz

tar -xzvf apache-tomcat-8.0.35.tar.gz

tar -xzvf jre-8u77-linux-x64.tar.gz

3. Cambiar el nombre a las dependencias(Cambiamos el nombre de las dependencias para una mayor comodidad para el trabajo)

mv apache-ant-1.9.7 ant

mv apache-tomcat-8.0.35 tomcat

mv jre1.8.0_77 java

4. Borrar los compactados

rm apache-ant-1.9.7-bin.tar.gz

rm apache-tomcat-8.0.35.tar.gz

rm jre-8u77-linux-x64.tar.gz

5. Dar permiso al instalador del postgres

chmod -R 777 postgresql-9.4.1-1-linux-x64.run

6. Ejecutar el instalador del postgres

./postgresql-9.4.1-1-linux-x64.run

Seguir los pasos(NEXT siempre)

7. Instalar la Máquina Virtual de Java(JVM)

Edita el archivo de sistema PATH /etc/profile y agrega las siguientes variables de sistema a tu PATH de sistema. Usa “nano”, “gedit” o cualquier otro editor de texto, como raíz y abre /etc/profile.

• Teclea/Copia/Pega: sudo gedit /etc/profile
• o
• Teclea/Copia/Pega: sudo nano /etc/profile

Desplázate hacia el final del archivo usando las flechas en tu teclado y agrega las siguientes líneas debajo de tu archivo /etc/profile:

• Teclea/Copia/Pega:
  
  JAVA_HOME=/usr/local/dspace/java
  PATH=$PATH:$HOME/bin:$JAVA_HOME/bin
  export JAVA_HOME
  export PATH

Informa a tu sistema Ubuntu Linux dónde se encuentra Oracle Java JRE. Esto le dirá a tu sistema que hay una nueva versión de Oracle Java disponible.

• Teclea/Copia/Pega: sudo update-alternatives --install "/usr/bin/java" "java" "/usr/local/dspace/java/bin/java" 1
• Este comando notifica al sistema que hay una versión de Oracle Java JRE disponible para usarse.
• Teclea/Copia/Pega: sudo update-alternatives --install "/usr/bin/javaws" "javaws" "/usr/local/dspace/java/bin/javaws" 1
• Este comando notifica al sistema que Oracle Java Web Start está disponible para su uso.

Informa a tu sistema de Ubuntu Linux que Oracle Java JRE será el Java predeterminado.

• Teclea/Copia/Pega: sudo update-alternatives --set java /usr/local/dspace/java/bin/java
• Este comando establecerá el JRE para el sistema.
• Teclea/Copia/Pega: sudo update-alternatives --set javaws /usr/local/dspace/java/bin/javaws
• Este comando establecerá el Java Web Start para el sistema.

Recarga el PATH del sistema /etc/profile tecleando el siguiente comando:

• Teclea/Copia/Pega: /etc/profile
• Nota que el archivo de sistema PATH /etc/profile se cargará después de reiniciar tu sistema Ubuntu Linux.

Una instalación exitosa de Oracle Java 64-bit mostrará lo siguiente:

• Teclea/Copia/Pega: java -version
• Este comando mostrará la versión de Java que tienes en el sistema
• Deberás recibir el siguiente mensaje:
• java version "1.8.0_77"

Java(TM) SE Runtime Environment (build 1.8.0_77-b03)

Java HotSpot(TM) 64-Bit Server VM (build 25.77-b03, mixed mode)

INSTALACIÓN DEL DSPACE

1. Crear directorio de instalación

mkdir /dspace

2. Dar todos los permisos a la carpeta de instalación

chmod 777 /dspace

3. Copiar el instalador de dspace para la carpeta de instalación

cp /home/user/Desktop/Instalar/dspace-installer2.tar.gz /dspace/

4. Ir a la carpeta de instalación

cd /dspace

5. Descompactar el instalador

tar -xzvf dspace-installer2.tar.gz

6. Crear la base de datos

6.1 En la terminal autenticarse como usuario postgres

>su - postgres

>bash

> /opt/PostgreSQL/9.4/bin/createdb -U postgres -E UNICODE dspace

>exit

>exit

7. Editar el fichero de configuración de dspace

(/dspace/dspace/target/dspace-installer/config/dspace.cfg)

gedit /usr/local/dspace/dspace/target/dspace-installer/config/dspace.cfg

Cambiar el lenguaje en la variable default.locale

default.locale = pt

Usar más de un idioma

Ej. webui.supported.locales = pt, en, es

8. Ejecutar la instalación

8.1 Colocarnos en la terminal en el directorio de instalación

cd /usr/local/dspace/dspace/target/dspace-installer

8.2 Ejecutar la instalación con el Ant

/usr/local/dspace/ant/bin/ant fresh_install

9. Redireccionar el servidor tomcat hacia el directorio de instalación

9.1 Editar el fichero /usr/local/dspace/tomcat/config/server.xml

gedit /usr/local/dspace/tomcat/conf/server.xml

o

nano /usr/local/dspace/tomcat/config/server.xml

Guardar> Ctrl+O  y salir>Ctrl+X

o usando editor de texto

gedit /usr/local/dspace/tomcat/conf/server.xml

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

               unpackWARs="true" autoDeploy="true">

Debe quedar:

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

               unpackWARs="true" autoDeploy="true">

10. Iniciar el servidor tomcat

>  /usr/local/dspace/tomcat/bin/startup.sh

11. Abrir en un navegador web

http://localhost:8080/jspui

12. Crear administrador

/dspace/bin/dspace create-administrator

Administración

E-Personas y Grupos

 Aunque muchas de las funciones de DSpace como el descubrimiento y recuperación de documentos pueden usarse de forma anónima, algunas características (y tal vez algunos documentos) solo están disponibles para ciertos usuarios “privilegiados”. Las E-Personas (Usuarios del Repositorio) y los Grupos es la manera en la que DSpace identifica a los usuarios de la aplicación para el propósito de conceder privilegios. Esta identidad está ligada a una sesión de una aplicación DSpace. Tanto E-Gente como Grupos gozan de privilegios por el sistema de autorización.

E-Persona DSpace mantiene la siguiente información sobre cada E-Persona:

·         Dirección email.

·         Nombre y apellidos.

·         Si el usuario es capaz de entrar en el sistema a través de la interfaz de usuario Web, y si debe utilizar un certificado X509.

·         Una contraseña (encriptada), en su caso.

·         Una lista de las colecciones para las cuales la E-Persona desea ser notificado de nuevos ítems.

·         Si la E-Persona fue “auto-registradas” con el sistema, es decir, si el sistema creó el registro de la E-Persona automáticamente  el registro de correo persona, como por ejemplo el personal de la organización.

·         El identificador de red para el correspondiente registro LDAP.

Grupos

Los grupos son otro tipo de entidad a la que se le pueden conceder permisos en el sistema de autorización. Un grupo es por lo general una lista explícita de E-Gente, cualquier persona identificada como uno de esa E-Gente también se beneficia de los privilegios concedidos al grupo. Sin embargo, una sesión de aplicación puede ser asignada a la pertenencia de un grupo sin ser identificada como una E-Persona. Por ejemplo, la gente que se conecta al sitio a través de una red local podría leer materiales restringidos al resto de los usuarios. Los administradores también pueden utilizar grupos como “roles” para gestionar la concesión de privilegios de manera más eficiente.

Autenticación

La autenticación es cuando una sesión de aplicación es identificada de manera positiva como perteneciente a una E-Persona o un Grupo. Este sistema está implementado como una pila de métodos de autenticación que se van aplicando sobre la sesión de la aplicación para identificar a la E-Persona a la que pertenece y los grupos en los que está encuadrada. Este mecanismo tiene las siguientes ventajas:

·         Separa la autenticación de la interfaz de usuario Web.

·         Mejora la modularidad: los métodos de autenticación son independientes los unos de los otros. Así los métodos de autenticación personalizados pueden ser añadidos a la cima de la pila del método de autenticación predeterminado de DSpace.

·         Soporte para autenticación implícita, por ejemplo, un certificado de cliente X.509

Autorización

El sistema de autorización de DSpace está basado en la asociación de acciones con los objetos y con las listas de E-Personas que pueden llevarlas a cabo. Las asociaciones se llaman Políticas de Recursos, y las listas de E-Personas se llaman grupos. Hay dos grupos específicos: “Los administradores”, que pueden hacer cualquier cosa en un sitio, y “Anónimo”, que es una lista que contiene todos los usuarios. Asignando una política para una acción en un objeto para los medios anónimos da permiso a todos los usuarios para hacer esa acción. Los permisos deben ser explícitos, sino la falta de un permiso de una política dará como resultado “denegado”. Si una E-Persona tiene permiso de lectura sobre un ítem, no necesariamente tendrá permiso de lectura sobre los paquetes y los bitstreams de ese ítem. En la actualidad las colecciones, las comunidades y los ítems se pueden encontrar con los sistemas de navegación y de búsqueda, independientemente de la autorización READ. Las siguientes acciones pueden llevarse a cabo en DSpace por defecto:

·         Comunity

ü  ADD/REMOVE: se pueden añadir y eliminar colecciones y subcomunidades.

·         Collection

ü  ADD/REMOVE: se pueden añadir y borrar ítems (ADD = permiso para enviar ítems).

ü  DEFAULT_ITEM_READ: heredado como READ por todos los ítems enviados.

ü  DEFAULT_BITSTREAM_READ: heredado como READ por todos los bitstreams de todos los ítems enviados. Esto solo afecta a los bitstreams de un ítem en el momento en el que es inicialmente enviado. Si un bitstream se añade más tarde no tendrá la misma política de lectura por defecto.

ü  COLLECTION_ADMIN: los administradores de la colección pueden editar los ítems de la colección, pueden retirar ítems e insertar otros ítems en la colección.

·         Ítem

ü  ADD/REMOVE: se pueden añadir y eliminar paquetes.

ü  READ: se pueden ver los ítems (los metadatos de los ítems se pueden ver siempre).

ü  WRITE: se puede modificar el ítem.

·         Bundle

ü  ADD/REMOVE: se pueden añadir o eliminar bitstreams a un paquete.

·         Bitstream

ü  READ: se puede ver el bitstream.

ü  WRITE: se puede modificar el bitstream. Hay que indicar que no hay acción “DELETE”. Para poder eliminar un objeto del archivo se debe tener el permiso REMOVE sobre todos los objetos que lo contienen. Los ítems que se quedan huérfanos son borrados automáticamente.

Supervisión y Colaboración

A fin de facilitar, como un objetivo primordial, la oportunidad para que los autores de tesis puedan ser supervisados en la preparación de sus tesis, existe un sistema de orden de supervisión ligar grupos de otros usuarios (directores de tesis) a un ítem en el espacio de trabajo de alguien. La unión del grupo  puede tener un sistema de políticas asociado a él, que permiten diferentes niveles de interacción con el ítem del estudiante; por defecto se proporciona un pequeño conjunto de políticas para estos grupos:

·         Control editorial completo.

·         Ver los contenidos del ítem.

Esta funcionalidad también se podría utilizar en situaciones en las que los investigadores deseen colaborar en una presentación especial, aunque no hay un espacio de trabajo colaborativo particular.

Usuarios estándares

Incorporación de Objetos de Aprendizaje

La incorporación de nuevos objetos de aprendizaje(o documentos digitales de forma general) al Repositorio Digital lo realizan usuarios comunes del sistema, siempre y cuando en las políticas de las colecciones se definan los permisos de incorporación a cada una de las colecciones.

El proceso de incorporación de un documento u objeto digital se inicia desde la propia página personal del usuario, donde puede seleccionar a que colección del repositorio va a realizar el envío. Luego pasa por una serie de vistas donde se ingresan los metadatos correspondientes al objeto digital. Por último se incorpora el documento digital(o los documentos digitales, en caso que sean varios).

Dependiendo de la política de la colección a la que la propuesta sea enviada, el flujo de trabajo puede iniciarse. El flujo de trabajo normalmente admite uno o varios revisores para comprobar sobre la propuesta y asegurarse de que es apta para ser incluida en la colección. Cuando se completa la “propuesta en progreso” y se invoca la siguiente etapa de la ingesta, se agrega un mensaje de la procedencia a Dublin Core. Del mismo modo, cada vez que un flujo de trabajo cambia de estado (por ejemplo, un revisor acepta la presentación), se añade una declaración de procedencia similar. Esto permite realizar un seguimiento de cómo el ítem ha cambiado desde que un usuario lo envía. Una vez que todo flujo de trabajo se completa con éxito, el sistema realiza una serie de actividades sobre el objeto:

·         Asigna una fecha de adquisición.

·         Agrega el valor “date.available” para el registro de metadatos de Dublin Core del ítem.

·         Añade una fecha de emisión si todavía no se ha hecho.

·         Agrega un mensaje de procedencia. (incluyendo el checksum del bitstream)

·         Asigna un identificador de forma persistente.

·         Agrega el ítem a la colección de destino, y agrega las políticas de autorización adecuadas.

·         Agrega el nuevo elemento a la búsqueda y navegación por índices.

Pasos del flujo de trabajo

El flujo de trabajo de una colección puede tener hasta tres pasos. Cada colección puede tener un grupo de E-Personas asociadas para realizar cada paso, si ningún grupo está asociado a un determinado paso, ese paso se omite. Si una colección no tiene grupos de E-personas asociadas con cualquiera de las fases, las propuestas de esta colección se mostrarán directamente en el archivo principal.  Las posibles acciones que puede realizar una E-Persona en cada paso del flujo de trabajo son las siguientes:

·         Paso 1: puede aceptar la propuesta o puede rechazarla.

·         Paso 2: Puede editar los metadatos de la propuesta proporcionada por el usuario, aunque no puede cambiar los archivos enviados. Puede aceptar la propuesta para su inclusión o rechazarla.

·         Paso 3: Puede editar los metadatos de la propuesta proporcionada por el usuario, aunque no puede cambiar los archivos enviados. Y después debe enviar el ítem al archivo. No puede rechazar la propuesta. 

Si la propuesta es rechazada se le enviará un email al usuario que hizo la propuesta con un mensaje indicando los motivos del rechazo para que el usuario pueda realizar los cambios oportunos y pueda volver a enviar el archivo.

Búsqueda y Navegación

DSpace permite al cliente descubrir el contenido, de diferentes formas:

·         Referencia de una vía externa como un Handle.

·         Un buscador de una o más claves en metadatos o un fragmento de texto.

Navegar a través del título, el autor, la fecha, o un índice de temas. El buscador es un componente esencial en DSpace. Las expectaciones de un usuario sobre un motor de búsqueda son bastante altas, así que un objetivo para DSpace es suministrar tantas características de búsqueda como sea posible. El módulo de indexado y búsqueda de DSpace tiene una API muy sencilla que permite indexar nuevo contenido, regenerar el índice y realizar búsquedas la recopilación entera, una comunidad, o colección. Detrás del API está el motor de búsqueda SOLR. SOLR permite realizar búsquedas por campos, eliminar palabras de parada, obtener las raíces de las palabras, y la capacidad de añadir el nuevo contenido en el índice sin regenerar el índice entero. Los índices de búsqueda específicos de SOLR son configurables permitiendo a las instituciones personalizar que campos de metadatos de DSPACE se incluyen en el índice. Otro mecanismo importante en DSpace es la navegación. Esto es el proceso por el cual el usuario ve un índice particular, como el índice de título, y navega a través de él en busca de ítems interesantes. El subsistema de navegación proporciona un API simple, que permite que el usuario pueda especificar una subsección del índice para poder verla con más detalle. Además la navegación puede ser limitada a los ítems de una determinada colección o comunidad.

Suscripciones

Como se señaló anteriormente, los usuarios (E-Personas) pueden “suscribirse” a las colecciones con el fin de recibir una alerta cuando aparecen nuevos ítems en esas colecciones. Cada día, los usuarios que están suscritos a una o más colecciones recibirán un e-mail indicándole una breve descripción de todos los elementos nuevos que aparecieron en cualquiera de las colecciones del día anterior. Si no hay ítems nuevos en cualquiera de las colecciones suscritas, no se enviará ningún email. Los usuarios pueden cancelar su suscripción en cualquier momento.