MANUAL DE INSTALACIÓN DE DSPACE


Comprobación e instalación de faltantes

Teniendo instalado Ubuntu 10.04 LTS, debemos asegurarnos que los siguientes paquetes se encuentren instalados, de lo contrario, deben ser instalados.

Para realizar la comprobación, escribir en la terminal:
sudo service tomcat6 status
sudo service postgresql‐8.3 status
java –version
ant –version
mvn –version

Si no se encuentran, entonces se debe realizar lo descrito a continuación:

sudo apt-get install tomcat6 maven2 ant

Después debemos llevar a cabo la instalación de Postgresql y de Tomcat, para lo cual realizaremos lo siguiente:

sudo apt-get install tasksel
sudo tasksel

Aparece un cuadro donde debemos seleccionar las siguientes opciones:

[*] LAMP server
[*] PostgreSQL database
[*] Tomcat Java server
A continuación se muestra una imagen de cómo puede salir el cuadro descrito anteriormente, y donde se deben seleccionar las opciones a instalar:

dsw1.png

Arreglo de un problemita en Postgresql

Cuando se ha instalado postgresql y se quiere añadir un usuario, no se permite porque primero debe realizarse la siguiente configuración:

sudo gedit /etc/postgresql/8.4/main/postgresql.conf

En el archivo de configuración que aparece, se debe buscar la siguiente línea:

#listen_addresses=’localhost’

La cual se debe cambiar por:

listen_addresses=’localhost’

Luego se debe reiniciar el servicio de Postgresql, el cual se realiza de la siguiente manera:

sudo /etc/init.d/postgresql-8.4 restart

Agregar al usuario DSpace

Se debe realizar el siguiente procedimiento:
sudo useradd –m dspace
sudo passwd dspace

Crear el directorio de instalación

Se debe realizar el siguiente paso:
sudo mkdir /opt/dspace

Luego se cambia el dueño del directorio de instalación a usuario DSpace
sudo chown –R dspace.dspace /opt/dspace/

Debemos detener el servicio Tomcat, para lo cual se digita el siguiente comando:
sudo service tomcat6 stop

Una vez hecho esto, debemos configurar el archivo server.xml para que Tomcat reconozca los webapps de DSpace. Para lo cual se realizará el siguiente comando:
sudo gedit /etc/tomcat6/server.xml

Allí aparecerá un editor al cual debemos agregarle las siguientes líneas antes de </Host>:

<!-- Define a newcontext path forall DSpace web apps -->
<Context path="/xmlui"docBase="/dspace/webapps/xmlui"allowLinking="true"/>
<Context path="/sword"docBase="/dspace/webapps/sword"allowLinking="true"/>
<Context path="/oai" docBase="/dspace/webapps/oai" allowLinking="true"/>
<Context path="/jspui"docBase="/dspace/webapps/jspui"allowLinking="true"/>
<Context path="/lni" docBase="/dspace/webapps/lni" allowLinking="true"/>
<Context path="/solr" docBase="/dspace/webapps/solr" allowLinking="true"/>


INSTALACIÓN DE TOMCAT JAVA WEBAPP SERVER

  1. AUTHBIND para Tomcat

Después de haber instalado Tomcat6, se debe habilitar authbind, el cual permitirá que el servidor “escuche” por diferentes puertos. Para habilitarlo debemos editar el siguiente archivo:

sudo gedit /etc/default/tomcat6

Se remueve el signo del frente del parámetro authbind como sigue:

# If you run Tomcat on port numbers that are all higher than 1023, then you
# do not need authbind. It is used for binding Tomcat to lower port numbers.
# NOTE: authbind works only with IPv4. Do not enable it when using IPv6.
# (yes/no, default: no)
AUTHBIND=yes

Ahora se debe permitir el uso de los puertos. Para esto se debe realizar lo siguiente:

touch /etc/authbind/byport/80
touch /etc/authbind/byport/443
chmod 0755 /etc/authbind/byport/80
chmod 0755 /etc/authbind/byport/443
chown tomcat6.tomcat6 /etc/authbind/byport/80
chown tomcat6.tomcat6 /etc/authbind/byport/443

Ahora tomcat ya tiene permiso para utilizar los puertos 80 y 443.

  1. Puertos

Ahora se debe decir al servidor que puede “escuchar” por dichos puertos. Para esto debemos:

sudo gedit /etc/tomcat6/server.xml

En el archivo, se debe buscar los conectores para el puerto 8080 y cambiarlos por el puerto 80. También se debe añadir la codificación UTF-8. Como se ve en el siguiente ejemplo:

<span style="color: #000000;"><Connector port="80" protocol="HTTP/1.1" </span>
<span style="color: #000000;">               connectionTimeout="20000" </span>
<span style="color: #000000;">               URIEncoding="UTF-8"</span>
<span style="color: #000000;">               redirectPort="8443" /></span>

Se debe realizar el mismo procedimiento con el puerto 8443 por 443. Como se muestra en el siguiente ejemplo:

<span style="color: #000000;"><Connector port="443" protocol="HTTP/1.1" SSLEnabled="true"</span>
<span style="color: #000000;">               maxThreads="150" scheme="https" secure="true"</span>
<span style="color: #000000;">               clientAuth="false" sslProtocol="TLS"</span>

Se guardan las modificaciones realizadas, y de esta manera se han habilitado los puertos correspondientes.


  1. Usuarios –admin para Tomcat

En la terminal escribir:

sudo gedit /etc/tomcat6/Tomcat-users.xml

En el archive, debemos eliminar todo el contenido del archive y asignar los siguientes roles de usuario y administrador con su respectivo password como sigue:

<span style="color: #000000;"><?xml version='1.0' encoding='utf-8'?></span>
<span style="color: #000000;"><tomcat-users></span>
<span style="color: #000000;"> <role rolename="manager"/></span>
<span style="color: #000000;"> <role rolename="admin"/></span>
<span style="color: #000000;"><user username="dspace" password="dspace" roles="admin,manager"/></span>
<span style="color: #000000;"></tomcat-users></span>

Guardar los cambios hechos en el archivo.

  1. Agregar el usuario Tomcat dentro del grupo dspace

Realizaremos el siguiente comando:

sudo adduser tomcat6 dspace

dsw2.jpg

Creando el usuario DSpace en la Base de Datos Postgres

Se realiza el siguiente procedimiento:

sudo –u postgres createuser –U Postgres –d –A –P dspace

CAMBIE SUN/ORACLE JAVA JDK - CANONICAL

Sun Java está disponible para los usuarios de Ubuntu, y permite además que la instalación sea fácil y rápida, para lo cual habilite la opción de actualizar el repositorio mediante canonical.
Para esto debemos realizar lo siguiente:

En la terminal escribir:

sudo gedit /etc/apt/sources.list

Allí debemos buscar la siguiente línea y quitarle el # para quitarla como comentario, si no se encuentra, entonces debemos ingresarla al archivo.

# Uncomment the line: deb http://archive.canonical.com/ubuntu natty partner

Después, se debe realizar lo siguiente:

sudo apt-get Update

Para que los cambios que se hicieron en el documento hagan efecto, y se actualicen los repositorios de done estamos obteniendo la información.

Después se debe escribir:

sudo apt-get install sun-java6-jdk sun-java6-plugin

Para lo cual me salió el siguiente error:

debconf: DbDriver "config": /var/cache/debconf/config.dat is locked by another process: Resource temporarily unavailable

Entonces para solucionarlo escribí en la consola:

sudo rm –rf /var/cache/debconf/*
sudo apt-get install -f

Después volví a escribir el mismo comando

sudo apt-get install sun-java6-jdk sun-java6-plugin

y obtuve como resultado lo que se muestra en la siguiente figure, lo cual me permite saber que se ha instalado correctamente lo que se necesitaba.

dsw3.jpg

Acto seguido debemos:

sudo update-java-alternatives –s java-6-sun

Tomcat va a ignorar que el sistema continúa usando OPENJDK, por eso se debe configurar el archivo tomcat6 para que reconozca Sun Java. Para esto:

sudo gedit /etc/default/tomcat6

Y se agrega la siguiente línea al archivo:

JAVA_HOME=/usr/lib/jvm/java-6-sun

En necesario reiniciar Tomcat para que reconozca el cambio.

sudo service tomcat6 restart

dsw4.jpg

COMO USUARIO DSPACE...

Aquí se realizará la instalación y configuración de la carpeta de DSpace.

Primero que todo debemos iniciar sesión como usuario dspace, para lo cual en la terminal donde nos encontramos digitaremos el siguiente comando:

sudo su dspace
cd
wget http://sourceforge.net/projects/dspace/files/DSpace%20Stable/1.7.2/dspace-1.7.2-src-release.tar.bz2

A continuación se pueden ver los comandos escritos anteriormente:

dsw5.jpg

Aquí se muestra como se descarga el archivo que necesitamos para la instalación de dspace.
Después de finalizar la descarga, debemos descomprimir el archivo que hemos descargado previamente, para lo cual ejecutaremos el siguiente comando:

tar -xvjf dspace-1.7.2-src-release.tar.bz2


Compilando y construyendo DSpace

El código que hemos obtenido de la descarga es código fuente que debe ser compilado por la máquina para que el servidor pueda ejecutarlo después. El encargado de realizar la compilación será MVN y ANT se encargará de realizar el trabajo necesario para inicializar el esquema de la BD y de DSpace para que estos puedan trabajar.

Para realizar esto, debemos seguir los siguientes pasos:

cd dspace=1.7.2-src-release
mvn –U package

Así se muestra lo anteriormente hecho:

dsw6.jpg

Después debemos dirigirnos al siguiente directorio, para así realizar la compilación completa de dspace:
cd dspace=1.7.2-src-release/dspace/target/dspace=1.7.2-build.src

Cuando nos encontremos ubicados allí, entonces digitaremos el siguiente comando:
ant fresh_install

Esperaremos hasta que la compilación del src sea correcta, para luego definir el usuario administrador de dspace, encargado de hacer las modificaciones que sean necesarias.

dsw7.jpg

Creando el usuario Administrador
Como se muestra a continuación en la imagen, se debe iniciar el usuario root y situarse en la carpeta del usuario dspace, donde se debe buscar el directorio bin y luego ingresar el siguiente comando:
root@ubuntu:/dspace/bin ./dspace create-administrator

Seguido aparecerá en la pantalla los siguientes datos que deben ser registrados:
E-mail address:
First name:
Last name:
WARNING: Password will appear on-screen.
Password:
Again to confirm:
Is the above data correct? (y or n): y
Administrator account created
dsw8.jpg
Como se puede ver en la imagen, el usuario administrador ha sido creado exitosamente, lo que nos permitirá realizar las modificaciones necesarias a la aplicación, así mismo como determinar los tipos de datos a manejar, los roles y usuarios permitidos, y demás cosas que puedan surgir en el camino.