Bienvenidos

Instalación de Dspace Miguel Ángel Ortiz Camilo

Milestones ● Requerimientos. ● Descarga de la web oficial. ● Preparación del entorno de trabajo ● Configuración de Dspace ● “Compilación” de la Aplicación. ● Creación de cuenta de Administrador. ● Notas Adicionales

Requerimientos ● Requerimientos ● Sistema Operativo ● Java SDK 6.0 ● Apache Maven 2.2.x ● Apache Ant 1.8 ● PostgreSQL ● Tomcat 6.0

Descarga de la Web Oficial

Preparación del entorno de trabajo ● Con la cuenta de administrador del servidor, crearemos al Usuario que manipulará el código fuente de Dspace. Con el siguiente comando ● adduser testSpace ● Se le asignará una contraseña al usuario. ● passwd testSpace

Preparación del entorno de trabajo ● iniciaremos sesión como el usuario recién creado y accederemos a su carpeta principal, ello para manipular el archivo descargado de la página oficial de Dspace. Mediante los comandos: ● su testSpace ● cd /home/testSpace

Preparación del entorno de trabajo ● Se descomprimirá el archivo mediante el comando: ● tar xvfz dspace src-release.tar.gz

Preparación del entorno de trabajo ● Tendremos generada la carpeta del código fuente (source) desde la cual manipularemos la instalación a medida, podremos observarla al ejecutar el comando: ● ls -l

Preparación del entorno de trabajo ● Crearemos la cuenta de usuario para Dspace dentro de nuestro manejador de bases de datos. Se logrará mediante el comando: ● createuser -U postgres -d -A -P testSpace ● El primer par de contraseñas, son para el usuario recién creado. La última es del administrador de la base de datos.

Preparación del entorno de trabajo ● Con el usuario recién creado, se dará de alta la base de datos que utilizará Dspace para su funcionamiento. Lograremos ésto mediante el comando: ● createdb -U testSpace -E UNICODE testSpace ● La contraseña solicitada, es la ingresada al nuevo usuario testSpace

Preparación del entorno de trabajo ● Iniciaremos sesión como el usuario de Linux que manipulará el código fuente de Dspace; y accederemos a la ruta de archivos de configuración. Mediante la ejecución de comandos: ● su testSpace ● cd /home/testSpace/dspace src-release/dspace/config

Configuración Dspace ● Se editará el archivo de configuración mediante el editor nano, ejecutando el comando: ● nano dspace.cfg

Configuración Dspace I nformación B ásica ● Se definirá la carpeta de almacenamiento en el servidor, que almacenará Dspace; estará en la raíz del disco duro. Se definirá en la variable: ● dspace.dir

Configuración Dspace I nformación B ásica ● Si nuestro servidor poseé un dominio, debemos indicarle a Dspace el nombre del mismo. Se definirá en la variable: ● dspace.hostname

Configuración Dspace I nformación B ásica Se debe indicar la URL base, incluyendo el puerto en que funciona Tomcat. Se definirá en la variable: dspace.baseUrl

Configuración Dspace I nformación B ásica ● Se indicará a Dspace la GUI del usuario, pude ser XMLUI o bien la que está por defecto, JSPUI. Se asignará valor a la variable: ● dspace.url

Configuración Dspace I nformación B ásica ● Para colocar nombre a nuestro repositorio, bastará con definirlo en la variable: ● dspace.name

Configuración Dspace C onfiguración de la B ase de D atos ● Aún cuando la configuración de Dspace está orientada al manejador de bases de datos postgresql, es necesario indicarlo quitando el comentario a la variable: ● db.name

Configuración Dspace C onfiguración de la B ase de D atos ● Es necesario indicar el URL de conexión para la base de datos, indicando el puerto y la ruta con el nombre que asignamos a nuestra base de datos de Dspace. La asignación debe hacerce a la variable: ● db.url

Configuración Dspace C onfiguración de la B ase de D atos ● Dspace al realizar conexiones automáticas, requiere de parametros tales como nombre de usuario y contraseña, ésto será definido en las variables: ● db.username ● db.password

Configuración Dspace C onfiguración de C orreo E lectrónico ● Dspace necesita una cuenta de correo electrónico para controlar y arbitrar el acceso a sus recursos, si no se tiene un servidor dedicado a tal efecto, puede configurarse el de google Gmail. Ésto se logra en definiéndo la variable: ● mail.server

Configuración Dspace C onfiguración de C orreo E lectrónico ● Una vez configurado el servidor, es necesario indicar la cuenta de acceso al mismo. Ésto lo logramos asignándo valores a las variables: ● mail.server.username ● mail.server.password

Configuración Dspace C onfiguración de C orreo E lectrónico ● Finalmente, es necesario brindar el correo del administrador del servidor Dspace. Definiremos las variables: ● mail.from.address feedback.recipient ● mail.admin alert.recipient ● registration.notify

Configuración Dspace C onfiguración de I dioma ● El idioma por defecto para los valores de metadatos, se especificará en la variable: ● default.language

Configuración Dspace C onfiguración de I dioma ● Para establecer por defecto el idioma en español, para la interfaz de Dspace a nuestros usuarios, debemos asiganr el valor a la variable: ● default.locale

Configuración Dspace C onfiguración de I dioma ● Si deseamos que nuestro Dspace tenga varios idiomas disponibles para el usuario final, debemos indicarlo creando y asignando valores a la variable: ● webui.supported.locales

Configuración Dspace C onfiguración del M anejador ● El prefijo del manejador, es aquél que brindará acceso directo a los usuarios externos, pero sobretodo al cosechador de metadatos. Lo definiremos en la variable: ● handle.prefix

Configuración Dspace ● Es necesario crear la carpeta que almacenará Dspace dentro de la raíz del disco duro, ejecutaremos los comandos de creación y asignación de dueño, a nuestro usuario de Linux destinado a tal fin, mediante los comandos: ● cd / ● mkdir testSpace ● chown testSpace testSpace

Compilación de la Aplicación ● Necesitamos iniciar sesión como el usuario dueño de Dspacey debemos acceder a la carpeta de código fuente, para ejecutar Apache-Maven. Mediante los comandos. ● su testSpace ● cd /home/testSpace/dspace src-release/dspace ● mvn package

Compilación de la Aplicación ● Al terminar la ejecución de Maven, obtendremos un cuadro de resumen indicando el éxito en la operación.

Compilación de la Aplicación ● Con lo anterior se habrá generado una carpeta de nombre target, que contendrá una más con los archivos de instalación final. Accederemos con la ejecución de comandos: ● cd target/dspace build

Compilación de la Aplicación ● La instalación de los archivos se realizará mediante la ejecución de Apache-Ant, mediante el comando: ● ant fresh_install

Compilación de la aplicación ● Al finalizar, tendremos un cuadro indicando el éxito en el proceso y, las indicaciones del siguiente paso.

Compilación de la aplicación ● Se creará la carpeta web para TomCat con el usuario administrador de nuestro servidor. Lograremos ésto con los comandos: ● cd $CATALINA_HOME ● cd webapps ● mkdir testSpace

Compilación de la aplicación ● Es necesario copiar los archivos necesarios para la interfaz web, ésto lo realizaremos copiando lo que hemos instalado en la carpeta creada para Tomcat. Se hará con el comando: ● cp -R /testSpace/webapps/jspui/* /usr/local/apache-tomcat /webapps/testSpace/

Creación de cuenta de Administrador ● Es necesario dar de alta la cuenta de usuario de Dspace, ésto se logra iniciando sesión como el usuario dueño de Dspace y ejecutando el archivo dspace, mediante los comandos: ● su testSpace ● cd /testSpace/bin ●./dspace create-administrator

Creación de cuenta de Administrador ● Se agregarán los datos de la cuenta de administrador conforme el sistema los pida, hay que anotar que el password puede cambiarse después.

Comprobación ● Al ingresar la dirección de dominio, con el puerto, debemos observar Dspace Funcionando.

Notas Adicionales ● La configuración de los requisitos es esencial. ● Existen fallas tanto de hardware como de software. ● La configuración de éste tutorial no funciona.

Siguiente Paso ● Personalización de la Interfaz de Usuario

Recomendación ● Elección de Sistema Operativo de Red. ● Optimización del Servidor de Red a nivel software y hardware. ● Incremento en la seguridad de acceso al servidor. ● No realizar la instalación de Dspace desde el usuario root.