Manual de instalacin de DSpace

ndice
1. PRERREQUISITOS DE SOFTWARE ....................................................................................... 2
1.1 SISTEMA OPERATIVO .................................................................................................................. 2
1.2 JAVA JDK 5 (EL ESTNDAR SDK EST BIEN, NO SE NECESITA J2EE) ..................................... 2
1.3 SETEAR JAVA_HOME .............................................................................................................. 2
1.4 APACHE MAVEN .......................................................................................................................... 4
1.5 APACHE ANT .............................................................................................................................. 6
1.6 BASE DE DATOS RELACIONAL: (POSTGRESQL) ....................................................................... 8
1.7 MOTOR DE SERVLET: (JAKARTA TOMCAT 5.5) .......................................................................... 9

2

1. Prerrequisitos de Software

La lista de abajo describe los componentes y herramientas que se necesitan necesitan para
correr el servidor de DSpace.

1.1 Sistema operativo

Es necesario tener instalado el sistema operativo como Windows o Linux.

1.2 Java JDK 5 (el estndar SDK est bien, no se necesita J2EE)

DSpace requiere de java 5 o mayor debido al uso de las nuevas capacidades de lenguaje
introducidas en 5 que hacen la codificacin ms fcil y ms limpia. Java 5 o mayor se puede
bajar de la siguiente direccin: http://java.sun.com/javase/downloads/index.jsp

1.3 Setear JAVA_HOME

Ir a Control Panel > System and Security






3

Seleccionar System > Change settings
Luego de que se abre la ventana que se muestra a continuacin, se debe seleccionar la
pestaa Advanced:


En la pestaa Advanced se debe presionar el botn Environment Variables para abrir la
siguiente ventana:


Luego al presionar el botn New se abre la ventana que se muestra a continuacin:
4


En dicha ventana se debe escribir en el campo de nombre de la variable: JAVA_HOME y en el
valor de la variable se debe escribir la ruta en donde est instalado el jdk.

1.4 Apache Maven

La instalacin de Apache Maven consiste en descargar un archivo, descomprimirlo en una
carpeta y agregar sus archivos ejecutables en el path del sistema operativo. Luego se deben
seguir los siguientes pasos:
1. Ir al sitio de descargas de Apache Maven en http://maven.apache.org/download.html y
descargar la versin en .zip (aunque no hay problema si se descarga otro formato comprimido).

2. Descomprimir el archivo en una carpeta de su sistema, por ejemplo c:\ o /opt/.
3. Crear una variable de entorno llamada MVN_HOME que apunte al directorio con el archivo
descomprimido. Por ejemplo C:\apache-maven-2.2.1 en Windows o /opt/apache-maven-
2.2.1 en Linux/Unix.
4. Agregar en el path de su sistema el valor %MVN_HOME%\bin.
Por ejemplo para Windows:
5


5. En una consola de comandos ejecutar mvn y se deber ver un mensaje como el siguiente:

6. Si se obtiene un mensaje como el anterior, la instalacin de Maven fue exitosa.
7. Si se realiza la conexin a Internet a travs de un proxy, se debe editar el
archivo $MAVEN_HOME/conf/settings.xml y agregar la configuracin del proxy con el siguiente
cdigo:
<proxies>
<!-- proxy
<proxy>
<protocol>http</protocol>
<active>true</active>
<host>proxy.ejemplo.com.co</host>
<port>3030</port>
<nonProxyHosts>localhost|127.0.0.1</nonProxyHosts>
</proxy>
</proxies>
Se debe modificar adecuadamente los valores host y port con los de su proxy
y nonProxyHosts con las direcciones que no se quiere acceder a travs de l.
6

1.5 Apache ANT

Primero que nada, se debe descargar Ant desde el sitio oficial (En el sitio ir a Download-
>Binary Distributions).
La instalacin del ant consiste nicamente en descomprimir el archivo zip, gz, o bz2,
dependiendo del que se haya elegido al descargar el ant. Al terminar de descomprimir el
archivo se deber tener un directorio como el siguiente:

Una vez descomprimida la estructura de directorios a una carpeta, hay que asegurarse que la
carpeta bin est disponible en el PATH, es decir, hay que agregarla a las variables de entorno.

En windows, ir a MyComputer o MiPc y hacer click con el botn derecho y seleccionar
propiedades:


Seleccionar la pestaa "Advanced" y el botn "Environment Variables".
7


En la seccin System Variables, se debe seleccionar la variable PATH y presionar el botn
Editar (en caso de que no exista esa variable se debe presionar el botn New).


Por ltimo se debe agregar al valor de la variable, la ruta completa de la carpeta bin de donde
est instalado el ant.

8


Para verificar que las variables de entorno estn configuradas correctamente, desde una
ventana de comando se debe ejecutar lo siguiente:

d:\>antTutorial>ant -version

Si se despliega la informacin de la versin, como la que se muestra a continuacin, la
configuracin se llev a cabo correctamente.

D:\mario\desarrollo\antTutorial>ant -version
Apache Ant version 1.7.0 compiled on December 13 2006

1.6 Base de Datos Relacional: (PostgreSQL)

Se debe descargar la base de datos relacional PostgreSQL 8.3.7 o mayor. PostgreSQL puede
ser descargado de la siguiente direccin: http://www.postgresql.org/ [http://www.postgresql.org/]
Es altamente recomendable trabajar con Postgre 8.x o mayor aunque se puede trabajar con
anteriores.

Una vez instalado, es necesario habilitar la conexin TCP/IP (usar DSpace JDBC).
Para 8.x+, se debe editar postgresql.conf quitando los comentarios (ver el problema 1 de la
instalacin del PostgreSQL en la gua de problemas y acciones).

listen_addresses = localhost

Despus se debe aumentar un poco la seguridad editando pg_hba.conf y se debe agregar
esta lnea (ver el problema 2 de la instalacin del PostgreSQL en la gua de problemas y
acciones):
9


host dspace dspace 127.0.0.1 255.255.255.255 md5

Despus se debe reiniciar PostgreSQL.

1.7 Motor de Servlet: (Jakarta Tomcat 5.5)

Se debe descargar Jacarta Tomcat 5.5 o mayor. Tomcat puede ser descargado de la siguiente
direccin: http://tomcat.apache.org [http://tomcat.apache.org/whichversion.html]

Se debe tener en cuenta que DSpace necesitar funcionar como el mismo usuario que Tomcat,
puede ser que quiera instalar y correr Tomcat como un usuario llamado dspace. Se debe fijar
apropiadamente la variable de entorno TOMCAT_USER.

Modificaciones en [tomcat]/tomcat.conf

Es necesario asegurarse que Tomcat tiene:

a) suficiente memoria pra correr DSpace.

b) usar UTF-8 como su codificacin del archivo por defecto. Se debe asegurar que en los
scripts la siguiente variable de entorno se fije:

JAVA_OPTS=-Xmx512M -Xms64M -Dfile.encoding=UTF-8

Modificacin en [tomcat]/config/server.xml

Tambin se debe alterar la configuracin por default de Tomcat para soportar la bsqueda y la
lectura de multi bytes UTF-8 correctamente. Es necesario agregar a la opcin de configuracin
el elemento <Connector> en [tomcat]/config/server.xml

URIEncoding =UTF-8

Ejemplo: Si estas usando la configuracin que tiene por default el Tomcat, se debera leer:


<!-- Define a non-SSL HTTP/1.1 Connector on port 8080 -->
<Connector port="8080"
maxThreads="150" minSpareThreads="25"
maxSpareThreads="75"
enableLookups="false" redirectPort="8443"
acceptCount="100"
connectionTimeout="20000"
disableUploadTimeout="true"
URIEncoding="UTF-8"
/>

10

Falta instalar el dspce por ahora hasta ah.