Versión de evaluación de xmLibris

• Pasos a seguir
• Requerimientos
• Descargas

Pasos a seguir

1. Instalar Java SDK 1.4 o superior [Java SDK]
   
2. Instalar Apache Tomcat 4.1 o superior [Tomcat]
3. Descargar el contexto de la base de datos eXist e instalarlo en Tomcat [exist.war 19.6 Mb]
   
4. Descargar el contexto de xmLibris [xm-dist.war 2.1 Mb]
5. Incializar la aplicacion y registro de información de contacto
6. Agregar documentos
   
7. Ejecutar consultas de prueba
8. Aplicacion en Java para agregar múltiples imágenes  y carpetas [ updbx.jar 2.13Mb ]

1. Instalación de Java JDK

Se requiere de el ambiente de desarrollo de Java SDK 1.4 o superior para la instalación de xmLibris.  Una vez instalado el Java SDK es necesario tener definida la variable de ambiente de JAVA_HOME apuntando al directorio raíz de la instalación de Java. Para verificar la instalación completa de Java SDK y la definición de la variable JAVA_HOME, en cualquier consola del sistema (ejecutar cmd en Windows) teclear "javac" esto debe de presentar un mensaje del compilador de Java. En caso de no aparecer, realizar lo siguiente:

en Unix

1. definir variable de ambiente de Java y agregar al path el comando de java , ya sea en consola o en el archivo .cshrc  (rutas de ejemplo) 
• setenv JAVA_HOME /usr/local/java
• set path = ( $JAVA_HOME/bin $path )

en Windows

1. definir variable de ambiente de Java y agregar al path el comando de java
   
• Mi PC-Propiedades-Opciones Avanzadas-Variables de entorno
• Presionar el Botón: Nueva
• Nombre de la variable: JAVA_HOME
• Valor de la variable (directorio de ejemplo puede variar):
  
•  C:\Archivos de programa\Java\jdk1.5.0_02
• Mi PC-Propiedades-Opciones Avanzadas-Variables de entorno
• Seleccionar "Path"
• Presionar el Botón: Modificar
• Agregar al final del valor de la variable Path lo siguiente, incluido el punto y coma al principio:
  
•  ;%JAVA_HOME%\bin

2. Instalación de Apache Tomcat

Se requiere de Java JDK y tener definida la variable de ambiente JAVA_HOME  para la instalación de Tomcat.  Tomcat es el servidor de aplicaciones y servidor Web del sistema xmLibris. Para descargar la versión de Tomcat,  de acuerdo a la plataforma y realizar lo siguiente:

en Unix

1. extraer Tomcat en un directorio
   
• por ejemplo /usr/local/tomcat
2. definir variable de ubicación de Tomcat (de preferencia en el .cshrc)
   
• setenv CATALINA_HOME  /usr/local/tomcat
3. ejecutar tomcat, en consola
   
1. $CATALINA_HOME/bin/startup.sh
4. para detener tomcat, en consola
   
1. $CATALINA_HOME/bin/shutdown.sh

en Windows

1. usar el instalador de Tomcat,  asignar el directorio, configurar puerto y password de administrador
   
2. ejecutar Tomcat
• Inicio -  Todos los programas - Apache Tomcat 5.0 - Monitor Tomcat
  
• Monitor de Tomcat sobre la barra de tareas (circulo blanco con cuadrado negro) - botón derecho del ratón, seleccionar: Start service
  
3. para detener tomcat
• Monitor de Tomcat  sobre la barra de tareas (circulo blanco con triángulo verde) - botón derecho del ratón, seleccionar: Stop service

Una vez levantado el servidor, se localiza en el puerto 8080 de la máquina el servicio de Tomcat

http://localhost:8080/

3. Contexto de la base de datos eXist, instalación en Tomcat

1. Una vez instalado el servidor de Tomcat se requiere detener el servicio. 
   
2. Colocar en la carpeta de "webapps" de Tomcat el archivo exist.war 
• por ejemplo C:\Archivos de programa\Apache Software Foundation\Tomcat 5.0\webapps
3. Reiniciar el servidor de Tomcat.
4. Verificar la existencia del servidor de eXist
• http://localhost:8080/exist

4. Contexto de xmLibris de evaluación

1. Detener el servicio de Tomcat. 
   
2. colocar en la carpeta de "webapps" el archivo xm-dist.war
• por ejemplo C:\Archivos de programa\Apache Software Foundation\Tomcat 5.0\webapps
3. Reiniciar el servidor de Tomcat.
4. Verificar la existencia del servicio de xmLibris
   
• http://localhost:8080/xm-dist

5.  Incializar la aplicacion y registro de información de contacto

En la página incial hay una liga que permite incializar el sistema usando la base de datos eXist, basicamente se crea la carpeta xmlibris y su carpeta de sistema (system). La liga es la siguiente: http://localhost:8080/xm_v841/init_base.jsp?collection=/db/xmlibris&crea_carpeta=si&nombre_carpeta=xmlibris

Ya estando en el administrador

6.  Agregar documentos

Usando la opción de administración (http://localhost:8080/xm-dist/show_base.jsp) de xmLibirs se definen las colecciones necesarias y se agregan los documentos (imágenes JPG generalmente). Una vez registradas las imágenes se agregan los metadatos del libro en la carpeta correspondiente. Los documentos se componen de una secuencia de imágenes correspondientes a las páginas del libro digitalizadas nombradas de acuerdo a un número secuencial o folio alfanumérico.

7. Realizar consultas de prueba

Consultar la colección ( http://localhost:8080/xm-dist/principal.jsp) verificar documentos agregados y que el servicio de búsqueda y consulta  funcione.

8. Aplicacion en Java para agregar múltiples imágenes  y carpetas

En caso de requerir subir varias imágenes a la vez, se ha desarrollado una aplicación en Java que permite consultar una carpeta de forma local, localizar todas las imágenes y carpetas y agregar esa información a un servidor y carpeta dados. Esta aplicación viene en un paquete JAR [ updbx.jar 2.13Mb ]

Para un servidor en la máquina local (localhost) es suficiente con dar doble click al archivo, suponiendo que Java esta bien instalado se abrirá una ventana.



De otra forma se puede llamar desde la consola la aplicación para apuntar a un servidor en otra máquina con los siguientes parámetros. O directamente modificando los valores.

>java -classpath updbx.jar mx.udlap.util.SimpleFileChooser xmldb:exist://140.148.52.23:8080/exist/xmlrpc /db/xmlibris/uson

También es posible consultar la última versión de desarrollo de xmLibirs, estas versiones pueden no ser estables. [ última versión ]

Requerimientos

Java JDK 1.4 o superior

http://java.sun.com/

Apache Tomcat

http://jakarta.apache.org/tomcat/

eXist Open Source Native XML Database

http://exist-db.org/

Descargas

WAR de eXist

exist.war  19.6 Mb

WAR de xmLibris evaluación

xm-dist.war 2.1 Mb

UPDBX para conexión a eXist
updbx.jar 2.1Mb

Responsable del sitio: antonio.razo @ udlap.mx
Fecha de última actualización:  31 de marzo 2006