Manual de Instalación DSpace.docx

perchmysteriousΔιαχείριση Δεδομένων

1 Δεκ 2012 (πριν από 4 χρόνια και 11 μήνες)

433 εμφανίσεις





Manual de
Instalación
DSpace

ROAF

ROAF

Facultad de Ciencias, Ciencias Computacionales,
Universidad Autónoma de Baja California

DSpace System
Documentation:
Installation






AP

ROAF

UABC

2

Manual de Instalación DSpace














Proyecto ROAF



Administradora: Cristal Azalia Dena Flores

Priscila Acosta Medina

Iris Esther Arellano Balbuena

José Feliciano Díaz Beltrán

José Antonio Sánchez Guerra

Gustavo Méndez Espíritu

Octavio Avendaño Romero



2009
Administración

de Proyectos


Ciencias Computacionales

Facultad de Ciencias


Universidad Autónoma de Baja California

Campus Ensenada

Baja California

MEXICO









AP

ROAF

UABC

3

Manual de Instalación DSpace



1 Introducción

DSpace es uno de los programas de código abierto preferidos por las instituciones
académicas para ges
tionar repositorios de archivos

(textuales, audio, vídeo, etc.),
facilitando su depósito, organizándolos en comunidades, asignándoles metadatos y
permitiendo su difusión en recolectores o agregadores.

El objetivo de este manual es explic
ar la instalación, en c
ualquier servidor, de la
herramienta DSpace.
Sin ser el objetivo de este manual, en la primera parte se dan una
serie de

nociones en la instalación y configuración de todas las aplicaciones necesarias
para el correcto

f
uncionamiento
de DSpace
. En la segunda parte, se explicarán los
pasos necesarios

para instalar
un servidor con DSpace
.


Debemos co
mentar que la herramienta

es m
ultiplataforma, es decir, puede

ser
instalado y

Configurado

en un servidor Linux o en uno Windows (Wn32).

A continuación 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.

2.1 Linux

como SO



LINUX

como SO (Ubuntu 8.04): Muchas de las distribuciones de Linux/Unix
vienen con algunas de las dependencias de abajo pre instaladas o instalarlas
fácilmente vía actualización, puedes consultar la documentación de tu
distribución para determinar que esta real
mente disponible.

Nota:Es recomendable que vayas a las direcciones donde están los software y los
descargues.

2.2
Java JDK 5

(el estándar SDK esta bien, no
necesitas J2EE)

DSpace ahora requirió Java 5

o mayor debido al uso de
las nuevas capacidad
es de
lenguaje introducidas en 5

que hacen la codificación más fácil y más limpia.






AP

ROAF

UABC

4

Manual de Instalación DSpace

Java 5

o mayor lo puede bajar de la siguiente dirección:
http://java.sun.com/javase/downloads/index.jsp

2.
3 Apache M
aven 2.0.8 o mayor (Java built tool)

Maven es necesario en la primera etapa de la construcción del proceso de montar el
paquete de instalación de DSpace.

Este te da la flexibilidad de modificar DSpace usando el proyecto de Maven existente
que se encuentra

en el directorio [dspace
-
source]/ dspace/modules o agregando en
tu propio proyecto de Maven para construir el paquete de instalación para DSpace.

Maven puede ser descargado de la siguiente dirección:

http://maven.apache.org/download.html

2.
4 Apache Ant
1.6.2

o mayor (Java built tool)

Apache Ant es aun requerido
para la segunda etapa de la construcción del proceso.
Este es usado una ves que el paquete de instalación ha sido construido en [dspace
-
source]/dspace/target/dspace
-
<versión>
-
build.dir

Ant puede
ser descargado

de la siguiente dirección:
http://ant.apache.org
[http://ant.apache.org/]

2.5 Base de Datos Relacional: (PostgreSQL)



PostgreSQL 8.3.7 o mayor.

PostgreSQL puede ser descargado de la siguiente dirección:
http://www.postgresql.org/ [http://w
ww.postgresql.org/]

Es altamente recomendable trabajar con Postgre 8.x o mayor aunque puede trabajar
con anteriores.


Una
vez

instalado. Necesitas habilitar la
conexión

TCP/IP (usar DSpace JDBC)
.

Para 8.x+, editar postgresql.conf empiece quitando los
comentarios

(
ver el problema 1
de la instalación del PostgreSQL en la guía de problemas y acciones
)


listen_addresses = ‘localhost’


Después aumente un poco la seguridad editando pg_hba.conf y agregue esta
línea (ver
el problema 2 de la instalación del
PostgreSQL en la guía de problemas y acciones)
:


host dspace dspace 127.0.0.1 255.255.255.255 md5







AP

ROAF

UABC

5

Manual de Instalación DSpace

Después reinicia PostgreSQL






2.
6


Motor de Servlet
: (
Jakarta Tomcat 5.5
)



Jacarta Tomcat 5.5

o mayor

Tomcat puede ser descargado de la siguiente dirección:
http://tomcat.apache.org
[http://tomcat.apache.org/whichversion.html]


Observe que DSpace necesitará funcionar como el mismo usuario que Tomcat
, puede
ser que quiera instalar y correr Tomcat como un us
uario llamado ‘dspace’. Fija
apropiadamente la variable de entorno TOMCAT_USER.

Modificaciones en [tomcat]/tomcat.conf

Necesitas asegurarte que Tomcat tiene a) suficiente memoria para correr DSpace y b)
usar UTF
-
8 como su codificación del archivo por defec
to
. Entonces asegúrate en tus
scripts que la siguie
nte variable de entorno se fije
:

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

Modificación en [tomcat]/config/server.xml

También necesitas alterar la configuración por default de Tomcat para sopo
rtar la
búsqueda y la lectura de multi bytes UTF
-
8 correctamente
.necesitas agregar a la
opción de configuración a el elemento<Connector> en [tomcat]/config/server.xml

URIEncoding =”UTF
-
8”

Ejemplo. Si estas usando la configuración que tiene por default el
Tomcat, se debería
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"

/>






AP

ROAF

UABC

6

Manual de Instalación DSpace




3 Opciones de Instalación

3
.
1


Visión general de las opciones de instalación

Con la llegada de un nuevo Apache Maven 2
[http://maven.apache.org/]

basado en
arquitectura de construcción en DSpace 1.5.1 ahora tienes dos opciones en como
podrías desear la instalación y manejo de tu instalación local de DSpace. Si has usado
DSpace 1.4.x , por favor reconoce que los procedimientos iníciales de construcc
ión ha
cambiado para permitir mayor adecuación.

Despues encontraras los pasos ‘basados
en Ant’ del proceso de instalación 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 términos idénticos de la lista
de procedimientos requeridos para completar la construcción del proceso, la única
diferencia es que el la versión incluye “more modules”

que se construirían dando sus
preceden
cias en el paquete de instalación.



Deafault Release (dspace
-
<versión>
-
release.zip)

o

Estos métodos permiten adecuar la configuración de DSpace

(en
dspace.cfg) o interfaces de usuario, usando interfaces preconstruidas
básicas.

o

Se descarga las librerías “pre
compiladas” para el nucleo del api
-
dspace,
soportando servlets, etiquetas de librería, aspectos y temas para el
dpsce
-
xmlui, dspace
-
xmlui y otros webservice/aplicaciones.

o

Las exposiciones de los acercamientos de las partes de la aplicación
que
los apegados

a DSpace prefieren mirarlo adecuado.


La estructura del directorio de esta versión es la siguiente:



[dspace
-
source]

o

Dspace/
-

‘construccion’ y modulo de configuración de DSpace

o

Pom.xml

la definición del proyecto padre.



Fuente de la version
(dspace
-
<version>
-
src
-
release.zip)

o

Este
método es recomendado para quienes

cuyo
s

deseo
s

de desarrollar
DSpace a futuro o alterar sus capacidades a un estado mas avanzado.






AP

ROAF

UABC

7

Manual de Instalación DSpace

o

Este contiene “todos” el codigo de dspace para el numero de dspace
-
api,
soportado

servlets, librerías etiquetas, aspectos y temas para el dspace
-
xmlui, dspace
-
xmlui y otros servicios web/aplicaciones.

o

Provee todas las mismas capacidades como la versión normal.

La estructura del directorio de esta version es mas detallada:



| [dspace
-
sou
rce]

o

dspace/
-
‘construccion ’ y modulo de configuración 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 Light
weight Network Interface

o

dspace
-
sword/
-
modulo fuente del deposito de servicio
SWORD
(Simple Web
-
service Offering Repository Deposit)

o

pom.xml
-
definición del proyecto padre de DSpace.

Ambos acercamientos te proveen con el mismo control sobre como DSpa
ce se
construye asi mismo (especialmente en términos de agregando adecuaciones
completamente/3er parte de los “modulos” de DSpace que desees usar). Ambos
métodos te permiten la habilidad para crear interfaces de usuario más complejas
“sobre capas” en Mave
n. Una interfaz “en capas” te permite solo manejar tu
adecuación de
código

local (
en tu local CVS o SVN
)
, y automáticamente descargas el
resto del código de la interfaz del repositorio central de maven. Este reduce la
cantidad de
código

desempacado de la i
nterfaz de DSpace mantenido en su CVS/SVN
local.

3
.
2


Visión general de los directorios de DSpace

Antes de comenzar con una instalación, es importante tomar conocimiento general de
los directorios de DSpace y los nombres de los cuales son referidos general
mente.

DSpace utiliza 3 arboles de directorio separados. Aunque no necesit
as saber todos los
detalles de estos para instalar DSpace, no necesitas saber que existen y tampoco como
se refieren en este documento:

1.

El directorio de instalación,
referido como
[dspace]
.
Esta es la ubicación en
donde esta instalado y ejecutado Dspace de el es la
ubicación

que esta definida
en el dspace.cfg como “dspace.dir”. En donde
están
todos los archivos de
configuración de D
s
pace
, líneas de comando, documentación y aplica
ciones
web que serán instaladas.






AP

ROAF

UABC

8

Manual de Instalación DSpace

2.

El directorio fuente,
referido como [dspace
-
source]. Esta es la ubicación
donde ha sido descomprimida la distribución de la versión de Dspace. Este
usualmente tiene el nombre de el archivo que expandirá como sigue
dspace
-
<v
ersión>
-
release
o
dspace
-
<versión>
-
src release
. Este es el directorio donde
todos tus comandos de “construccion” serán ejecutados.

3.

El directorio de implementación 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, podrías
decidir copiar las aplicaciones web de Dspace de [dspace]/webapps/ a
[tomcat]/webapps/ .


3
.
3
Instalación

Este método
te levanta y tiene corriendo Dsp
ace rápida y fácilmente. Este es idéntico
en ambas distribuciones la versión por default y la versión 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 versión

[http://sourceforge.net/projects/dspace/]

y
desempaquétalo. Aunque ahí hay dos versiones disponibles (dspace
-
1.5.1
-
release.zip y dspace
-
1.5.1
-
src
-
release.zip)
, solo necesitas escoger uno. Si
quieres copiar todo el código fuente de java, deberías descargar

la versión
dspace
-
1.5.1
-
src
-
release.zip

unzip dspace
-
1.5.1
-
release.zip

Para fácil referencia, referiremos a la ubicación de la versión descomprimida de
Dspace como [dspace
-
source] en el resto de estas instrucciones.

3.

Instalación de la base de datos.

Postg
res:

a)

El driver PostgreSQL 8.1
-
404 jdbc3 esta configurado como parte de la
construcción por default de Dspace.

b)

Crear una base de datos Dspace, propietaria del usuario de dspace
PostgreSQL:

createuser

-
U postgres
-
d
-
A
-
P dspace

createdb
-
U
dspace
-
E UNICODE dspace






AP

ROAF

UABC

9

Manual de Instalación DSpace


Introducir una contraseña para la base de datos de Dspace. (Esta no es
la misma que la contraseña

del

usuario de Linux)



4.

Edita
[dspace
-
source]/dspace/config/dspace.cfg
, en particular necesitas un
conjunto de estas propiedad
es:


dspace.dir



debe ser conjunto de el directorio [dspace](instalacion).


d
space.url



completa

el URL de

la página inicial del servidor de Dspace.


dspace.hostname


completamente calificado el nombre del dominio del
web server.


dspace.name
--

“apropiado” nombre de tu servidor, por ejemplo “My Digital
Library”.


db.password
--

La contraseña de la base de datos que introdujiste en el paso
anterior.


mail.server
--

nombre de dominio completamente calificado

del correo del
servidor.


feedback.
recipient
--

bandeja para la regeneración 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 configuración con el valor de
otra. Por ejemplo, para feedback.recipient
al

mismo valor como mail.admin, la línea se
miraría
como:






AP

ROAF

UABC

10

Manual de Instalación DSpace

feedback.recipient = ${mail.admin}

mira el archivo dspace.cfg para mas ejemplos.



5.

Crear el directorio para la instalación de Dspace (i.e. [dspace]). Como raíz ,
correr
así
:

mkdir [dspace]

chown dspace [dspace]

(Asumiendo que el nombre de usuario de LINUX es
dspace
)

6.

Como usuario de LINUX
dspace ,

genera el paquete de instalación de Dspace
en el
directorio
[dspace
-
source]/dspace/target/dspace
-
[versión].dir/:


cd
[dspace
-
source]
/dspace/

mvn package


NOTA:

sin ningún argumento extra
, el paquete de instalación de Dspace es
inicializado por PostgreSQL.



7.

Como
dspace

usuario de Linux
,inicializa la base de datos de Dspace e instala
Dspace a [dspace]:


cd

[dspace
-
source]
/dspace/target/dspace
-
[version].dir/

ant
fresh_install


ant help


Lo más probable es que vaya a salir un error en la conexión de la base de datos. Mira
la sección de problemas comunes.


8.

Dile a la instalación de Tomcat donde encontrar tu aplicación web de Dspace.
Como ejemplo, en la sección <Host
> de tu [tomcat]/conf/server.xml

podrías
agregar líneas similares a lo siguiente (pero sustituya [dspace] con tu
instalación local):






AP

ROAF

UABC

11

Manual de Instalación DSpace


<!
--

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, podrías copiar solo las aplicaciones Web de Dspace que desees usar
de [dspace]/webapps al directorio apropiado en su instalación 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 aplicación web de Dspace utilizaste. Deberías de
ver la
página inicial de Dspace. Y Felicidades!


URL de la base de la aplicación 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 sesión como
administrador de Dspace (la cual ya creaste arriba con
create
-
adm
inistrator
) y
entrar a la UI del administrador en cualquiera de las interfaces de usuario de JSP o
XML