Manual+de+Instalación+de+DSpace


 * 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:

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:
 * [*] LAMP server **
 * [*] PostgreSQL database **
 * [*] Tomcat Java server **




 * __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 :


 *  **
 *  **
 *  **
 *  **
 *  **
 *  **
 *  **


 * __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:

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

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:

code  code

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

code <Connector port="443" protocol="HTTP/1.1" SSLEnabled="true" code code maxThreads="150" scheme="https" secure="true" code code clientAuth="false" sslProtocol="TLS" code

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:

code  code code  code code code code code code  code code  code

Guardar los cambios hechos en el archivo.


 * 1) Agregar el usuario Tomcat dentro del grupo dspace

Realizaremos el siguiente comando:

**sudo adduser tomcat6 dspace**




 * __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.

<span style="color: #000000; display: block; font-family: 'Calibri','sans-serif'; text-align: justify;">Después se debe escribir:

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

<span style="color: #000000; display: block; font-family: 'Calibri','sans-serif'; text-align: justify;">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.



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**




 * 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:



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:



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.



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 **
 * __Creando el usuario Administrador__**

Seguido aparecerá en la pantalla los siguientes datos que deben ser registrados: 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.
 * E-mail address:**
 * First name:**
 * Last name:**
 * WARNI****NG: Password will appear on-screen.**
 * Password:**
 * Again to confirm:**
 * Is the above data correct? (y or n): y**
 * Administrator account created**