Documentos de Académico
Documentos de Profesional
Documentos de Cultura
ROAF
ROAF
DSpace System Documentation: Installation
Proyecto ROAF
Administradora: Cristal Azalia Dena Flores Priscila Acosta Medina Iris Esther Arellano Balbuena Jos Feliciano Daz Beltrn Jos Antonio Snchez Guerra Gustavo Mndez Espritu Octavio Avendao Romero
2009 Administracin de Proyectos Ciencias Computacionales Facultad de Ciencias Universidad Autnoma de Baja California Campus Ensenada Baja California MEXICO
AP
ROAF
UABC
1 Introduccin
DSpace es uno de los programas de cdigo abierto preferidos por las instituciones acadmicas para gestionar repositorios de archivos (textuales, audio, vdeo, etc.), facilitando su depsito, organizndolos en comunidades, asignndoles metadatos y permitiendo su difusin en recolectores o agregadores. El objetivo de este manual es explicar la instalacin, en cualquier servidor, de la herramienta DSpace. Sin ser el objetivo de este manual, en la primera parte se dan una serie de nociones en la instalacin y configuracin de todas las aplicaciones necesarias para el correcto funcionamiento de DSpace. En la segunda parte, se explicarn los pasos necesarios para instalar un servidor con DSpace. Debemos comentar que la herramienta es multiplataforma, es decir, puede ser instalado y Configurado en un servidor Linux o en uno Windows (Wn32). A continuacin comentamos los programas necesarios para que funcione DSpace, en Linux.
2 Prerrequisitos de Software
La lista de abajo describe los componentes y herramientas que necesitaras para correr el servidor de DSpace.
Nota:Es recomendable que vayas a las direcciones donde estn los software y los descargues.
2.2 Java JDK 5 (el estndar SDK esta bien, no necesitas J2EE)
DSpace ahora requiri 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.
AP
ROAF
UABC
AP
ROAF
UABC
AP
ROAF
UABC
3 Opciones de Instalacin
3.1 Visin general de las opciones de instalacin
Con la llegada de un nuevo Apache Maven 2 [http://maven.apache.org/] basado en arquitectura de construccin en DSpace 1.5.1 ahora tienes dos opciones en como podras desear la instalacin y manejo de tu instalacin local de DSpace. Si has usado DSpace 1.4.x , por favor reconoce que los procedimientos inciales de construccin ha cambiado para permitir mayor adecuacin. Despues encontraras los pasos basados en Ant del proceso de instalacin familiares. Maven es usado para resolver las dependencias de DSpace online para el servidor Repositorio Central de Maven. Esto es importante para notar que las estrategias son en trminos idnticos de la lista de procedimientos requeridos para completar la construccin del proceso, la nica diferencia es que el la versin incluye more modules que se construiran dando sus precedencias en el paquete de instalacin. Deafault Release (dspace-<versin>-release.zip) o Estos mtodos permiten adecuar la configuracin de DSpace (en dspace.cfg) o interfaces de usuario, usando interfaces preconstruidas bsicas. o Se descarga las libreras precompiladas para el nucleo del api-dspace, soportando servlets, etiquetas de librera, aspectos y temas para el dpsce-xmlui, dspace-xmlui y otros webservice/aplicaciones. o Las exposiciones de los acercamientos de las partes de la aplicacin que los apegados a DSpace prefieren mirarlo adecuado. La estructura del directorio de esta versin es la siguiente: [dspace-source] o Dspace/ - construccion y modulo de configuracin de DSpace o Pom.xml la definicin del proyecto padre. Fuente de la version (dspace-<version>-src-release.zip) o Este mtodo es recomendado para quienes cuyos deseos de desarrollar DSpace a futuro o alterar sus capacidades a un estado mas avanzado.
AP
ROAF
UABC
o Este contiene todos el codigo de dspace para el numero de dspace-api, soportado servlets, libreras etiquetas, aspectos y temas para el dspacexmlui, dspace-xmlui y otros servicios web/aplicaciones. o Provee todas las mismas capacidades como la versin normal. La estructura del directorio de esta version es mas detallada: | [dspace-source] o dspace/ -construccion y modulo de configuracin de DSpace o dspace-api/ -modulo de la fuente de java API o dspace-jspui/ -modulo fuente JSP-UI o dspace-oai/ -modulo fuente OAI-PMH o dspace-xmlui/ -modulo fuente XML-UI o dspace-lni/ -modulo fuente de Lightweight Network Interface o dspace-sword/ -modulo fuente del deposito de servicio SWORD (Simple Web-service Offering Repository Deposit) o pom.xml -definicin del proyecto padre de DSpace. Ambos acercamientos te proveen con el mismo control sobre como DSpace se construye asi mismo (especialmente en trminos de agregando adecuaciones completamente/3er parte de los modulos de DSpace que desees usar). Ambos mtodos te permiten la habilidad para crear interfaces de usuario ms complejas sobre capas en Maven. Una interfaz en capas te permite solo manejar tu adecuacin de cdigo local (en tu local CVS o SVN), y automticamente descargas el resto del cdigo de la interfaz del repositorio central de maven. Este reduce la cantidad de cdigo desempacado de la interfaz de DSpace mantenido en su CVS/SVN local.
AP
ROAF
UABC
2. El directorio fuente, referido como [dspace-source]. Esta es la ubicacin donde ha sido descomprimida la distribucin de la versin de Dspace. Este usualmente tiene el nombre de el archivo que expandir como sigue dspace<versin>-release o dspace-<versin>-src release. Este es el directorio donde todos tus comandos de construccion sern ejecutados. 3. El directorio de implementacin web. Este es el directorio que contiene las aplicaciones web de Dspace. En Dspace 1.5.1 y anterior, le corresponde a [dspace]/webapps por default. Sin embargo, si tu estas usando Tomcat, podras decidir copiar las aplicaciones web de Dspace de [dspace]/webapps/ a [tomcat]/webapps/ .
3.3 Instalacin
Este mtodo te levanta y tiene corriendo Dspace rpida y fcilmente. Este es idntico en ambas distribuciones la versin por default y la versin fuente. 1. Crear un usuario Dspace. Este necesita ser el mismo usuario que Tomcat correr como por ejemplo: useradd -m dspace 2. Descarga la ultima versin [http://sourceforge.net/projects/dspace/] y desempaqutalo. Aunque ah hay dos versiones disponibles (dspace -1.5.1release.zip y dspace-1.5.1-src-release.zip), solo necesitas escoger uno. Si quieres copiar todo el cdigo fuente de java, deberas descargar la versin dspace-1.5.1-src-release.zip unzip dspace-1.5.1-release.zip Para fcil referencia, referiremos a la ubicacin de la versin descomprimida de Dspace como [dspace-source] en el resto de estas instrucciones. 3. Instalacin de la base de datos.
Postgres:
a) El driver PostgreSQL 8.1-404 jdbc3 esta configurado como parte de la construccin por default de Dspace. b) Crear una base de datos Dspace, propietaria del usuario de dspace PostgreSQL:
AP
ROAF
UABC
Introducir una contrasea para la base de datos de Dspace. (Esta no es la misma que la contrasea del usuario de Linux)
4.
dspace.dir debe ser conjunto de el directorio [dspace](instalacion). dspace.url completa el URL de la pgina inicial del servidor de Dspace. dspace.hostname completamente calificado el nombre del dominio del
web server.
feedback.recipient -- bandeja para la regeneracin de correos. mail.admin -- bandeja de correos para el sitio de administrador de Dspace. alert.recipient -- bandeja de correo para los errores o alertas del servidor. registration.notify -- bandeja de correo para los emails de usuarios
registrados (opcional). NOTA: Puedes interpolar el valor de una variable de configuracin con el valor de otra. Por ejemplo, para feedback.recipient al mismo valor como mail.admin, la lnea se mirara como:
AP
ROAF
UABC
10
feedback.recipient = ${mail.admin}
mira el archivo dspace.cfg para mas ejemplos.
5. Crear el directorio para la instalacin de Dspace (i.e. [dspace]). Como raz , correr as:
cd [dspace-source]/dspace/ mvn package NOTA: sin ningn argumento extra, el paquete de instalacin de Dspace es inicializado por PostgreSQL.
7. Como dspace usuario de Linux ,inicializa la base de datos de Dspace e instala Dspace a [dspace]:
ant help
Lo ms probable es que vaya a salir un error en la conexin de la base de datos. Mira la seccin de problemas comunes. 8. Dile a la instalacin de Tomcat donde encontrar tu aplicacin web de Dspace. Como ejemplo, en la seccin <Host> de tu [tomcat]/conf/server.xml podras agregar lneas similares a lo siguiente (pero sustituya [dspace] con tu instalacin local):
AP
ROAF
UABC
11
<!-- DEFINE A CONTEXT PATH FOR DSpace JSP User Interface --> <Context path="/jspui" docBase="[dspace]\webapps\jspui" debug="0" reloadable="true" cachingAllowed="false" allowLinking="true"/> <!-- DEFINE A CONTEXT PATH FOR DSpace OAI User Interface --> <Context path="/oai" docBase="[dspace]\webapps\oai" debug="0" reloadable="true" cachingAllowed="false" allowLinking="true"/>
Alternativamente, podras copiar solo las aplicaciones Web de Dspace que desees usar de [dspace]/webapps al directorio apropiado en su instalacin de Tomcat, por ejemplo: cp -r [dspace]/webapps/jspui [tomcat]/webapps cp -r [dspace]/webapps/oai [tomcat]/webapps
9. Crea una cuenta inicial de administrador [dspace]/bin/create-administrator 10. Ahora el momento de la verdad! Reinicia Tomcat. Visita el URL de la base de su servidor, dependiendo de cual aplicacin web de Dspace utilizaste. Deberas de ver la pgina inicial de Dspace. Y Felicidades! URL de la base de la aplicacin web de Dspace: JSP interfaz de usuario --(ej.)http://dspace.myu.edu:8080/jspiu XML interfaz de usuario -- (ej.) http://dspace.myu.edu:8080/xmlui OAI-PMH intefaz -- (ej.) http://dspace.myu.edu:8080/oai/request?verb=identify
Para fijar algunas comunidades y colecciones, necesitaras iniciar sesin como administrador de Dspace (la cual ya creaste arriba con create-administrator) y entrar a la UI del administrador en cualquiera de las interfaces de usuario de JSP o XML
AP
ROAF
UABC