Manual de instalación y configuración de Dspace para Cybertesis

Índice de contenido

 1.  Introducción................................................................................................................ 3 

2.  Instalación................................................................................................................... 3 

a.  Linux ........................................................................................................................ 3 

i.  Instalación de software requerido ....................................................................... 4 

b.  Windows.................................................................................................................. 7 

i.  Instalación de software requerido ....................................................................... 9 

3.  Configuración de opciones adicionales..................................................................... 25 

4.  Proceso de backup y restauración ............................................................................ 26 

a.  Backup ................................................................................................................... 26 

i.  Base de datos ..................................................................................................... 26 

ii.  Creación del paquete ......................................................................................... 27 

b.  Restauración.......................................................................................................... 28 

i.  Linux ................................................................................................................... 28 

ii.  Windows ............................................................................................................ 28 

 

Página 3 de 31

Manual de instalación y configuración de Dspace

para Cybertesis

1. Introducción El siguiente documento tiene como finalidad mostrar el proceso de instalación y configuración del producto Dspace para el uso como portal Cybertesis. Se verá la instalación del software necesario para el despliegue de la aplicación y la instalación de la misma. Se explicará este proceso de instalación tanto para la plataforma Linux como para Windows en sus versiones para servidores. Adicionalmente se mostrará el procedimiento que se debe seguir para generar un backup completo de la aplicación. De esta manera se podrá contar con algún punto de regresión en caso de que ocurra algún problema con el servidor donde esté desplegada la aplicación. Finalmente se mostrará cómo restaurar uno de estos backups generados.

2. Instalación Como ya se ha mencionado, el paquete que se instalará es el gestor de repositorios digitales DSpace (http://www.dspace.org) que ha sido desarrollado en Java y es de código abierto. Esto significa que cualquier persona puede descargar el código fuente completo de la aplicación y hacer las modificaciones que crea necesarias. Debido a la arquitectura del software, existen los siguientes programas de código libre que son necesarios instalar previamente a Dspace:

● Java (versión mínima 1.6) ● Postgresql (versión mínima 8.3) ● Apache Tomcat (versión mínima 5.5)

La versión de DSpace que se instalará es la 3.0 y el paquete de instalación provisto cuenta con todas las modificaciones necesarias para Cybertesis.

a. Linux Antes de iniciar la instalación en Linux es necesario notar que todo el proceso se ejecutará utilizando al usuario root, para esto deberemos ejecutar el siguiente comando luego de iniciar sesión en el sistema:

Página 4 de 31

$ sudo su

Se nos pedirá que se ingrese la contraseña de usuario. Una vez que estemos con el usuario root descomprimiremos el paquete provisto para la instalación ( dspace linux.tar.bz2 ) ejecutando la siguiente secuencia de comandos (uno a la vez):

# cd /dspace # tar xvjf ./dspace\ linux.tar.bz2

i. Instalación de software requerido Para la instalación del software requisito basta con ejecutar el siguiente comando:

# apt‐get install tomcat7 postgresql authbind

El comando descargará e instalará todo el software, sin embargo, es necesario hacer algunas configuraciones previas antes de proceder con la instalación.

1. Tomcat Por defecto la instalación del Tomcat viene configurada para que éste corra en el puerto 8080, sin embargo, lo que queremos es que corra en el puerto 80 que es el puerto por defecto del protocolo HTTP. Para lograr esto deberemos ejecutar el siguiente conjunto de comandos (una línea a la vez):

# touch /etc/authbind/byport/80 # touch /etc/authbind/byport/443 # chmod 0755 /etc/authbind/byport/80 # chmod 0755 /etc/authbind/byport/443 # chown tomcat7:tomcat7 /etc/authbind/byport/80 # chown tomcat7:tomcat7 /etc/authbind/byport/443

Seguidamente debemos editar el archivo de configuración de la instalación del Tomcat. Para esto ejecutamos el siguiente comando:

# nano /etc/default/tomcat7

Página 5 de 31

En este archivo deberemos modificar y/o descomentar las siguientes propiedades y asignarles los valores que se mencionan a continuación:

� JAVA_OPTS="‐Djava.awt.headless=true  ‐Xmx1024m  ‐

XX:MaxPermSize=1024m ‐XX:+UseConcMarkSweepGC" 

� AUTHBIND=yes 

� JAVA_HOME=/usr/lib/jvm/[carpeta java instalado] 

Finalmente deberemos indicarle al Tomcat que debe correr en el puerto 80 al momento de iniciarse. Para esto deberemos modificar el siguiente archivo de configuración:

# nano /etc/tomcat7/server.xml

Modificamos la línea que contiene el siguiente texto:

<Connector port="80" protocol="HTTP/1.1"             connectionTimeout="20000"             URIEncoding="UTF‐8"             redirectPort="8443" />

Luego de guardar el archivo deberemos detener el tomcat para que no ocurran problemas al momento de copiar todos los componentes de Dspace:

# service tomcat7 stop

2. Postgresql Básicamente la única configuración necesaria para el Postgresql es la creación del usuario de base de datos, la creación de la propia base de datos y la restauración de la misma. Para esto primero deberemos autenticarnos como el usuario postgres del sistema:

# su postgres

Una vez que estemos con el usuario postgres ejecutamos los siguientes comandos (uno a la vez) para la creación del usuario, la creación de la base de datos y la restauración de la copia de seguridad respectivamente:

Página 6 de 31

$ cd $ createuser ‐d ‐P concytec $ createdb ‐O concytec ‐E UNICODE dspace_concytec $ pg_restore ‐d dspace_concytec /dspace/dspace.backup $ exit

Con esto queda lista y configurada la base de datos para el uso de Dspace.

La instalación está casi completa, ahora los que resta es copiar los componentes de Dspace dentro del Tomcat. Para esto se deben ejecutar los siguientes comandos:

# cd /var/lib/tomcat7/webapps # rm ‐Rf * # cp ‐R /dspace/dspace/webapps/* . # chown ‐R tomcat7:tomcat7 * # chown ‐R tomcat7:postgres /dspace # chmod g+w /dspace

Con esto quedan copiados los módulos de Dspace dentro del Tomcat y lo que queda es proceder a levantar el servicio para poner en funcionamiento al Dspace:

# service tomcat7 start

Para ver el progreso del log del tomcat se puede usar el siguiente comando:

# tail ‐f /var/log/tomcat7/catalina.out (ctrl + c  para cerrar salida)

Una vez que hayan terminado de cargar todos los módulos de Dspace aparecerá un mensaje como el siguiente: “Server startup in xxxx ms”, con esto se da por culminada la instalación. Para la verificación de la instalación se puede acceder al servidor desde cualquier otra PC desde un navegador de la siguiente manera: http://<ip-del-servidor>. Deberá aparecer la siguiente pantalla:

Página 7 de 31

b. Windows El proceso de instalación en windows no difiere del de Linux, sin embargo, es un poco más sencillo debido a que la seguridad es más laxa y la configuración del Tomcat para que funcione en el puerto 80 es más sencilla. En primer lugar procederemos a descomprimir el archivo C:\dspace\dspace windows.tar.bz2 que se ha provisto para la instalación. Para esto podemos usar cualquier programa que permita descomprimir este tipo de archivos, en nuestro caso recomendamos usar 7zip.

Página 8 de 31

Con esto deberían quedar los archivos de la siguiente manera:

Página 9 de 31

i. Instalación de software requerido La instalación del software requerido para Dspace es bastante sencilla y no requiere de mayor configuración adicional.

1. Java Procederemos con el proceso de instalación del archivo jdk-6u45-windows-i586.exe.

Página 10 de 31

Página 11 de 31

Página 12 de 31

2. Tomcat Instalamos el archivo apache-tomcat-7.0.42.exe con los valores seteados por defecto.

Página 13 de 31

Página 14 de 31

Página 15 de 31

Luego de haber instalado el Tomcat deberemos configurar el arranque para aumentar la memoria. Debido a algún tipo de limitación impuesto por el sistema operativo, no podremos asignar 1GB de memoria al Tomcat.

Página 16 de 31

Para esto ejecutamos el archivo C:\dspace\tomcat\bin\tomcat7w.exe y detenemos el servicio tomcat desde la pantalla General.

Nos dirigimos a la pestaña Java y deberemos dejar la configuración que figura en la siguiente imagen:

Página 17 de 31

Dejamos esta ventana abierta y nos dirigimos a la ruta C:\dspace\tomcat\webapps y procedemos a eliminar todas las aplicaciones que se encuentren en dicha ruta.

Página 18 de 31

3. Postgresql Para la instalación del Postgresql deberemos ejecutar el archivo postgresql-9.2.4-1-windows.exe y seguimos el proceso de instalación por defecto:

Página 19 de 31

Página 20 de 31

Asignamos la contraseña del usuario postgres con el valor postgres.

Página 21 de 31

Página 22 de 31

Añadir al path del sistema la ruta de los binarios del Postgres

Página 23 de 31

Seguidamente deberemos abrir una línea de comandos para proceder con la creación del usuario de base de datos, la base de datos misma y la restauración de dicha base de datos con los siguientes comandos:

> createuser ‐U postgres ‐d ‐P concytec > createdb ‐U postgres ‐O concytec ‐E UNICODE dspace_concytec > pg_restore ‐U postgres ‐d dspace_concytec C:\dspace\dspace.backup

Con esto queda ya todo listo para la instalación de Dspace.

Para la instalación basta con copiar todas las carpetas desde la ruta C:\dspace\dspace\webapps hacia la ruta C:\dspace\tomcat\webapps.

Página 24 de 31

Seguidamente deberemos volver a la pantalla de administración del servicio del Tomcat y en la pestaña principal iniciar el servicio.

Una vez que haya culminado el proceso de inicialización del Tomcat (que puede ser verificado en el archivo C:\dspace\tomcat\logs\catalina…) podremos acceder desde otra PC al servidor de la siguiente manera: http://<ip-del-servidor>. Deberá aparecer la siguiente pantalla:

Página 25 de 31

3. Configuración de opciones adicionales El paquete provisto para la instalación y el que ha sido instalado en cada una de las instituciones ya ha sido previamente configurado para el funcionamiento out-of-the box. Sin embargo, queda pendiente realizar la configuración de la cuenta de correo para el envío de notificaciones y registro de usuarios que se explicará a continuación. El archivo principal de configuración de Dspace se llama dspace.cfg y está ubicado en la carpeta config dentro de la instalación de Dspace: /dspace/dspace/config/dspace.cfg para Linux y C:\dspace\dspace\config\dspace.cfg para Windows. Para configurar adecuadamente el envío y recepción de correo deberemos modificar las siguientes propiedades dentro de dicho archivo:

� mail.server 

� mail.server.username 

� mail.server.password 

� mail.from.address 

� feedback.recipient 

� mail.admin 

� alert.recipient 

� registration.notify 

Cada una de estas propiedades deberá tener asignado el valor correspondiente para cada institución. El archivo de configuración mencionado contiene toda la configuración del sistema y puede ser modificado para activar o desactivar diversas opciones del Dspace. Este archivo está extensamente documentado y es recomendable que las personas encargadas de la administración del sistema estén familiarizadas con este archivo.

Página 26 de 31

4. Proceso de backup y restauración Se ha diseñado el proceso de backup de tal manera que al momento de restaurar una copia de seguridad se haga lo más parecido al mismo proceso de instalación.

a. Backup Para el proceso de backup son básicamente 2 elementos que se deben tener en consideración: la base de datos y la data de los documentos que se han subido.

i. Base de datos El proceso de copia de seguridad de la base de datos es bastante similar tanto en Linux como en Windows, con la única excepción de que en Linux se debe acceder con el usuario postgres. A continuación se muestran los pasos para la generación del backup, nótese de que se generará el nombre del archivo con la fecha del sistema para evitar sobreescribir backups anteriores:

1. Linux

$ sudo su # su postgres $ cd  $ pg_dump ‐E UNICODE ‐Fc ‐f /dspace/dspace_`date +"%Y‐%m‐%d"`.backup dspace_concytec (obtendremos un archivo dspace_yyyy‐mm‐dd.backup en el directorio /dspace que contendrá el backup de la base de datos)

2. Windows

> pg_dump ‐U postgres ‐E UNICODE ‐Fc ‐f C:\dspace\dspace_yy‐mm‐dd.backup dspace_concytec (donde yy, mm,dd debe ser reemplazado por los datos de fecha actual.)

Página 27 de 31

ii. Creación del paquete Una vez que se tenga el backup de la base de datos procederemos a generar el paquete que contendrá tanto la data como la base de datos. De igual manera, tendremos diferencias entre la forma de la generación entre Linux y Windows.

1. Linux

$ sudo su # cd /dspace # tar jcvf dspace_`date +"%Y‐%m‐%d"`.tar.bz2 dspace/ dspace_`date +"%Y‐%m‐%d"`.backup (obtendremos un archivo dspace_yyyy‐mm‐dd.tar.bz2 en el directorio /dspace que contendrá el backup de la base de datos y el backup de los archivos subidos)

2. Windows Para este caso se puede usar cualquier herramienta de compresión de archivos. En este caso se muestra el proceso usando 7zip.

Página 28 de 31

b. Restauración Como ya se ha mencionado, el proceso de restauración es bastante similar al de instalación. Hay que tener en consideración que el paquete generado está configurado para residir en la misma ubicación donde ha sido instalado Dspace y no pueden haber dos ambientes iguales funcionando al mismo tiempo. A continuación se muestra la manera en que se debe limpiar el sistema para poder realizar una nueva instalación tomando en consideración algún backup en específico (identificado por una fecha dada).

i. Linux

$ sudo su # service tomcat7 stop # rm ‐Rf /dspace/dspace # rm ‐Rf /var/lib/tomcat7/webapps # su postgres $ psql postgres=# DROP DATABASE dspace_concytec; postgres=# \q $ exit

ii. Windows En primer lugar deberemos detener el servicio del Tomcat:

Página 29 de 31

Seguidamente se debe eliminar los módulos de Dspace que están dentro de la ruta C:\dspace\tomcat\webapps.

Página 30 de 31

A continuación es necesario eliminar la carpeta C:\dspace\dspace.

 

 

 

 

 

 

 

El proceso para borrar la base de datos es bastante similar al equivalente en Linux:

> psql postgres=# DROP DATABASE dspace_concytec; postgres=# \q

Luego de haber realizado la eliminación de todo lo que se instaló originalmente, basta con realizar nuevamente el proceso de instalación utilizando algún paquete de backup realizado anteriormente. Para el ejemplo en linux, si el paquete de backup que tenemos se llama dspace_2013-09-18.tar.bz2 realizaremos los siguientes comandos: $ sudo su # cd /dspace # tar xvjf dspace_2013-09-18.tar.bz2 # chown ‐R tomcat7:postgres /dspace/dspace

# cp ‐R /dspace/dspace/webapps /var/lib/tomcat7/ # chown ‐R tomcat7:tomcat7 /var/lib/tomcat7/webapps

Página 31 de 31

# sudo postgres $ createdb ‐O concytec ‐E UNICODE dspace_concytec $ pg_restore ‐d dspace_concytec /dspace/dspace_2013‐09‐18.backup $ exit  # service tomcat7 start Para  el  caso  de  Windows,  descomprimir  el  paquete  de  backup  en  la carpeta C:\dspace y copiar los archivos al tomcat como se muestra en la figura:

Luego crear la base de datos, entrando a una consola y dando los comandos: > createdb ‐U postgres ‐O concytec ‐E UNICODE dspace_concytec > pg_restore ‐U postgres ‐d dspace_concytec C:\dspace\dspace.backup