Guía de instalación

Aquí puede encontrar información sobre como instalar los paquetes de cliente y de servidor de jLibrary

Instalación del cliente

Los siguientes pasos explican como instalar el cliente de jLibrary. Es importante reseñar que jLibrary no necesita un servidor dedicado para funcionar perfectamente. El cliente de jLibrary trae embebido su propio servidor, y también su propia base de datos (HypersonicSQL), por lo que es ideal para catalogar información de manera local.

Lo primero que hay que hacer es descargar los últimos paquetes desde la página del proyecto. Se pueden encontrar en: http://www.javahispano.net/projects/jlibrary
Una vez descargado el paquete de cliente, se debe descomprimir en un directorio del disco duro. jLibrary viene ya por defecto instalada en un subdirectorio llamado jlibrary-client.
Después de descomprimir el paquete de cliente, simplemente hay que ejecutar el fichero binario para la plataforma correspondiente. Por ejemplo, en plataformas Linux se debería ejecutar./jlibrary y en plataformas Windows jlibrary.exe.

Instalación del servidor

Cuando descargue los paquetes de servidor de jLibrary se encontrará que viene configurado para utilizar MySQL, con una base de datos llamada jlibrary y un usuario administrador de la base de datosllamado martin sin contraseña asignada. Es muy probable que su configuración no se ajuste con estos parámetros, o lo que también sería muy normal, que no le gusten. Debido a ello, es importantísimo que lea el apartado justo siguiente al que está leyendo, en el que se explica como utilizar una base de datos diferente o como configurar su base de datos para escoger el usuario con el que se conectará jLibrary.

Para instalar el servidor de jLibrary son necesarios los siguientes pasos:

Descargarse los últimos paquetes de servidor desde: http://www.javahispano.net/projects/jlibrary
Una vez descargados los ficheros, descomprimirlos en un directorio del disco duro. Por defecto jLibrary creará un subdirectorio llamado jlibrary-server.
jLibrary trae incluido Tomcat 5.0. Para lanzar el servidor de jLibrary simplemente hay que ir al directorio bin y ejecutar el fichero de arranque de su plataforma. Por ejemplo en plataformas Linux sería ./startup.sh y en plataformas Windows startup.bat.

Asegurese de haber configurado correctamente la base de datos antes de iniciar el servidor de jLibrary.

El servidor de jLibrary se puede detener utilizando los ficheros del directorio bin. Por ejemplo en plataformas Linux habría que ejecutar ./shutdown.sh y en plataformas Windows ./shutdown.bat.
El servidor de jLibrary se instala por defecto en el puerto 8080. Para asegurarse de que jLibrary está funcionando, puede intentar chequear los descriptores de los diferentes servicios web del servidor, accesibles desde: http://localhost:8080/axis.

jLibrary se puede instalar en cualquier otro puerto, simplemente debe configurar el motor interno de Tomcat para ello. Diríjase a la documentación de este producto para más información.

Una vez que el servidor de jLibrary esté funcionando, éste será accesible desde cualquier cliente de jLibrary utilizando una URL del tipo jlibrary://servidor:puerto. Por ejemplo jLibrary://localhost:8080.

Configurando jLibrary

Esta información está destinada sólo para administradores y usuarios avanzados

Tanto el cliente como el servidor de jLibrary se pueden configurar utilizando el fichero jlibrary.properties. La localización de este fichero varía según la distribución:

Cliente de jLibrary: $INSTALL_DIR/workspace/org.jlibrary.client/conf/jlibrary.properties
Servidor de jLibrary: $INSTALL_DIR/conf/jlibrary.properties

A continuación se describen algunas de las opciones de configuración más interesantes. Puede consultar el fichero de configuración para obtener más información

Configurando la base de datos

Escoja su base de datos entre aquellas que aparezcan comentadas en el fichero. Descomente las líneas que necesite para su base de datos, y comente las líneas de la base de datos que estaba activa en el momento de editar el documento. jLibrary utiliza esta información para cargar los drivers JDBC.

Aquí puede ver un ejemplo de las entradas de un fichero de configuración para MySQL:

jlibrary.sql.schema=org/jlibrary/core/persistence/data/MySQL-schema.sql
jlibrary.driver.username=martin
jlibrary.driver.password=
jlibrary.driver.name=org.gjt.mm.mysql.Driver
jlibrary.driver.url=jdbc:mysql://localhost/jlibrary
#jlibrary.autostart=true
Iniciando la base de datos interna automáticamente

El cliente de jLibrary incluye una base de datos embebida, basada en HypersonicSQL. Por defecto, esta base de datos se inicia al tiempo en el que se inicia el cliente. Si desea utilizar una base de datos diferente, además de configurar sus parámetros como en el caso anterior, es muy importante que comente la línea jlibrary.autostart o que establezca su valor a false.

Por el contrario, si no dispone de base de datos, es importante que se asegure que el valor del parámetro jlibrary.autostart sea true, y que esta línea esté descomentada. De este modo, el cliente de jLibrary tendrá habilitada su propia base de datos.
Configurando el idioma

jLibrary soporta internacionalización. En la versión 1.0, los idiomas soportados son el castellano y el inglés. Desde le fichero de configuración puede modificar el idioma de la aplicación cliente, simplemente modificando el valor de la propiedad jlibrary.locale.
Configurando el almacenamiento de archivos

Por defecto, jLibrary almacena los documentos de los diferentes repositorios en el directorio /jlibrary/Mis Repositorios. Puede modificar el lugar en el que se almacena dicha información modificando la línea jlibrary.repositories.home. En caso de modificarla, sería conveniente también modificar el valor de la variable jlibrary.home, aunque no es un requisito indispensable.
Limitando el número de versiones creadas

Cuando realiza cambios en algún documento, jLibrary almacena esos cambios creando nuevas versiones de dicho documento. Estas versiones sirven para recuperar los cambios con posterioridad a la modificación, en caso de que se haya detectado algún problema.

En caso de que el almacenamiento en disco sea un problema, puede limitar el número de versiones que crea jLibrary utilizando el parámetro jlibrary.version.limit.

-martin