Manual de instalacin y configuracin

de Dspace para Cybertesis

ndice de contenido

1. Introduccin................................................................................................................ 3
2. Instalacin................................................................................................................... 3
a. Linux ........................................................................................................................ 3
i. Instalacindesoftwarerequerido ....................................................................... 4
b. Windows.................................................................................................................. 7
i. Instalacindesoftwarerequerido ....................................................................... 9
3. Configuracindeopcionesadicionales..................................................................... 25
4. Procesodebackupyrestauracin ............................................................................ 26
a. Backup................................................................................................................... 26
i. Basededatos ..................................................................................................... 26
ii. Creacindelpaquete ......................................................................................... 27
b. Restauracin.......................................................................................................... 28
i. Linux................................................................................................................... 28
ii. 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:

<Connectorport="80"protocol="HTTP/1.1"
connectionTimeout="20000"
URIEncoding="UTF8"
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:

#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://<ip-del-servidor>. 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://<ip-del-servidor>. 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"`.backup
dspace_concytec

(obtendremosunarchivodspace_yyyymmdd.backupeneldirectorio/dspace
quecontendrelbackupdelabasededatos)

2. Windows

>pg_dumpUpostgresEUNICODEFcfC:\dspace\dspace_yymmdd.backup
dspace_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/dspace
quecontendrelbackupdelabasededatosyelbackupdelosarchivos
subidos)

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 la
carpetaC:\dspaceycopiarlosarchivosaltomcatcomosemuestraenla
figura:





















Luego crear la base de datos, entrando a una consola y dando los comandos:

>createdbUpostgresOconcytecEUNICODEdspace_concytec
>pg_restoreUpostgresddspace_concytecC:\dspace\dspace.backup