Manual de instalacin y configuracin de Dspace para Cybertesis

ndice de contenido

1. Introduccin................................................................................................................ 32. Instalacin................................................................................................................... 3a. Linux ........................................................................................................................ 3i. Instalacindesoftwarerequerido ....................................................................... 4

b. Windows.................................................................................................................. 7i. Instalacindesoftwarerequerido ....................................................................... 9

3. Configuracindeopcionesadicionales..................................................................... 254. Procesodebackupyrestauracin ............................................................................ 26a. Backup ................................................................................................................... 26i. Basededatos ..................................................................................................... 26ii. Creacindelpaquete ......................................................................................... 27

b. Restauracin.......................................................................................................... 28i. Linux ................................................................................................................... 28ii. Windows ............................................................................................................ 28

Pgina 3 de 31

Manual de instalacin y configuracin de Dspace

para Cybertesis

1. Introduccin El siguiente documento tiene como finalidad mostrar el proceso de instalacin y configuracin del producto Dspace para el uso como portal Cybertesis. Se ver la instalacin del software necesario para el despliegue de la aplicacin y la instalacin de la misma. Se explicar este proceso de instalacin 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 aplicacin. De esta manera se podr contar con algn punto de regresin en caso de que ocurra algn problema con el servidor donde est desplegada la aplicacin. Finalmente se mostrar cmo restaurar uno de estos backups generados.

2. Instalacin 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 cdigo abierto. Esto significa que cualquier persona puede descargar el cdigo fuente completo de la aplicacin y hacer las modificaciones que crea necesarias. Debido a la arquitectura del software, existen los siguientes programas de cdigo libre que son necesarios instalar previamente a Dspace:

Java (versin mnima 1.6) Postgresql (versin mnima 8.3) Apache Tomcat (versin mnima 5.5)

La versin de DSpace que se instalar es la 3.0 y el paquete de instalacin provisto cuenta con todas las modificaciones necesarias para Cybertesis.

a. Linux Antes de iniciar la instalacin 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 sesin en el sistema:

Pgina 4 de 31

$sudosu Se nos pedir que se ingrese la contrasea de usuario. Una vez que estemos con el usuario root descomprimiremos el paquete provisto para la instalacin ( dspace linux.tar.bz2 ) ejecutando la siguiente secuencia de comandos (uno a la vez):

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

i. Instalacin de software requerido Para la instalacin del software requisito basta con ejecutar el siguiente comando:

#aptgetinstalltomcat7postgresqlauthbind

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

1. Tomcat Por defecto la instalacin 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 lnea a la vez):

#touch/etc/authbind/byport/80 #touch/etc/authbind/byport/443 #chmod0755/etc/authbind/byport/80 #chmod0755/etc/authbind/byport/443 #chowntomcat7:tomcat7/etc/authbind/byport/80 #chowntomcat7:tomcat7/etc/authbind/byport/443

Seguidamente debemos editar el archivo de configuracin de la instalacin del Tomcat. Para esto ejecutamos el siguiente comando:

#nano/etc/default/tomcat7

Pgina 5 de 31

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

JAVA_OPTS="Djava.awt.headless=true Xmx1024m

XX:MaxPermSize=1024mXX:+UseConcMarkSweepGC" AUTHBIND=yes JAVA_HOME=/usr/lib/jvm/[carpetajavainstalado]

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

#nano/etc/tomcat7/server.xml Modificamos la lnea que contiene el siguiente texto:

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

#servicetomcat7stop

2. Postgresql Bsicamente la nica configuracin necesaria para el Postgresql es la creacin del usuario de base de datos, la creacin de la propia base de datos y la restauracin de la misma. Para esto primero deberemos autenticarnos como el usuario postgres del sistema:

#supostgres Una vez que estemos con el usuario postgres ejecutamos los siguientes comandos (uno a la vez) para la creacin del usuario, la creacin de la base de datos y la restauracin de la copia de seguridad respectivamente:

Pgina 6 de 31

$cd $createuserdPconcytec $createdbOconcytecEUNICODEdspace_concytec $pg_restoreddspace_concytec/dspace/dspace.backup $exit

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

La instalacin 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 #rmRf* #cpR/dspace/dspace/webapps/*. #chownRtomcat7:tomcat7* #chownRtomcat7:postgres/dspace #chmodg+w/dspace

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

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

#tailf/var/log/tomcat7/catalina.out (ctrl+cparacerrarsalida)

Una vez que hayan terminado de cargar todos los mdulos de Dspace aparecer un mensaje como el siguiente: Server startup in xxxx ms, con esto se da por culminada la instalacin. Para la verificacin de la instalacin se puede acceder al servidor desde cualquier otra PC desde un navegador de la siguiente manera: http://. Deber aparecer la siguiente pantalla:

Pgina 7 de 31

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

Pgina 8 de 31

Con esto deberan quedar los archivos de la siguiente manera:

Pgina 9 de 31

i. Instalacin de software requerido La instalacin del software requerido para Dspace es bastante sencilla y no requiere de mayor configuracin adicional.

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

Pgina 10 de 31

Pgina 11 de 31

Pgina 12 de 31

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

Pgina 13 de 31

Pgina 14 de 31

Pgina 15 de 31

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

Pgina 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 pestaa Java y deberemos dejar la configuracin que figura en la siguiente imagen:

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

Pgina 18 de 31

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

Pgina 19 de 31

Pgina 20 de 31

Asignamos la contrasea del usuario postgres con el valor postgres.

Pgina 21 de 31

Pgina 22 de 31

Aadir al path del sistema la ruta de los binarios del Postgres

Pgina 23 de 31

Seguidamente deberemos abrir una lnea de comandos para proceder con la creacin del usuario de base de datos, la base de datos misma y la restauracin de dicha base de datos con los siguientes comandos:

>createuserUpostgresdPconcytec >createdbUpostgresOconcytecEUNICODEdspace_concytec >pg_restoreUpostgresddspace_concytecC:\dspace\dspace.backup

Con esto queda ya todo listo para la instalacin de Dspace.

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

Pgina 24 de 31

Seguidamente deberemos volver a la pantalla de administracin del servicio del Tomcat y en la pestaa principal iniciar el servicio.

Una vez que haya culminado el proceso de inicializacin 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://. Deber aparecer la siguiente pantalla:

Pgina 25 de 31

3. Configuracin de opciones adicionales El paquete provisto para la instalacin 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 configuracin de la cuenta de correo para el envo de notificaciones y registro de usuarios que se explicar a continuacin. El archivo principal de configuracin de Dspace se llama dspace.cfg y est ubicado en la carpeta config dentro de la instalacin de Dspace: /dspace/dspace/config/dspace.cfg para Linux y C:\dspace\dspace\config\dspace.cfg para Windows. Para configurar adecuadamente el envo y recepcin 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 institucin. El archivo de configuracin mencionado contiene toda la configuracin 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 administracin del sistema estn familiarizadas con este archivo.

Pgina 26 de 31

4. Proceso de backup y restauracin Se ha diseado el proceso de backup de tal manera que al momento de restaurar una copia de seguridad se haga lo ms parecido al mismo proceso de instalacin.

a. Backup Para el proceso de backup son bsicamente 2 elementos que se deben tener en consideracin: 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 excepcin de que en Linux se debe acceder con el usuario postgres. A continuacin se muestran los pasos para la generacin del backup, ntese de que se generar el nombre del archivo con la fecha del sistema para evitar sobreescribir backups anteriores:

1. Linux

$sudosu #supostgres $cd $pg_dumpEUNICODEFcf/dspace/dspace_`date+"%Y%m%d"`.backupdspace_concytec (obtendremosunarchivodspace_yyyymmdd.backupeneldirectorio/dspacequecontendrelbackupdelabasededatos)

2. Windows

>pg_dumpUpostgresEUNICODEFcfC:\dspace\dspace_yymmdd.backupdspace_concytec(dondeyy,mm,dddebeserreemplazadoporlosdatosdefechaactual.)

Pgina 27 de 31

ii. Creacin 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 generacin entre Linux y Windows.

1. Linux

$sudosu #cd/dspace #tarjcvfdspace_`date+"%Y%m%d"`.tar.bz2dspace/dspace_`date+"%Y%m%d"`.backup (obtendremosunarchivodspace_yyyymmdd.tar.bz2eneldirectorio/dspacequecontendrelbackupdelabasededatosyelbackupdelosarchivossubidos)

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

Pgina 28 de 31

b. Restauracin Como ya se ha mencionado, el proceso de restauracin es bastante similar al de instalacin. Hay que tener en consideracin que el paquete generado est configurado para residir en la misma ubicacin donde ha sido instalado Dspace y no pueden haber dos ambientes iguales funcionando al mismo tiempo. A continuacin se muestra la manera en que se debe limpiar el sistema para poder realizar una nueva instalacin tomando en consideracin algn backup en especfico (identificado por una fecha dada).

i. Linux

$sudosu #servicetomcat7stop #rmRf/dspace/dspace #rmRf/var/lib/tomcat7/webapps #supostgres $psql postgres=#DROPDATABASEdspace_concytec; postgres=#\q $exit

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

Pgina 29 de 31

Seguidamente se debe eliminar los mdulos de Dspace que estn dentro de la ruta C:\dspace\tomcat\webapps.

Pgina 30 de 31

A continuacin 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=#DROPDATABASEdspace_concytec; postgres=#\q

Luego de haber realizado la eliminacin de todo lo que se instal originalmente, basta con realizar nuevamente el proceso de instalacin utilizando algn 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 #chownRtomcat7:postgres/dspace/dspace #cpR/dspace/dspace/webapps/var/lib/tomcat7/ #chownRtomcat7:tomcat7/var/lib/tomcat7/webapps

Pgina 31 de 31

#sudopostgres$createdbOconcytecEUNICODEdspace_concytec $pg_restoreddspace_concytec/dspace/dspace_20130918.backup $exit #servicetomcat7start Para el caso de Windows, descomprimir el paquete de backup en lacarpetaC:\dspaceycopiarlosarchivosaltomcatcomosemuestraenlafigura:

Luego crear la base de datos, entrando a una consola y dando los comandos: >createdbUpostgresOconcytecEUNICODEdspace_concytec >pg_restoreUpostgresddspace_concytecC:\dspace\dspace.backup