Instrucciones de Instalación

A continuación se lista en primer lugar el software de terceros que es necesario para ejecutar el prototipo de DPL. A continuación, se detalla el proceso de instalación.

Requisitos

El prototipo de DPL requiere el siguiente software para funcionar:

• PostgreSQL versión 8.x:
  • Descarga oficial.
  • Copia en este sitio (Windows x86): Archivo:Postgresql-8.4.9-1-windows.exe.
• Dita Open Toolkit:
  • Descarga oficial.
  • Copia en este sitio: Archivo:DITA-OT1.5.4 full easy install bin.zip.
• Eclipse SDK:
  • Descarga oficial
  • Copia en este sitio (Windows x86): Archivo:Eclipse-SDK-3.7.1-win32.zip.

Instalación

El prototipo de DPL usa una arquitectura Cliente/Servidor. El servidor actúa como el repositorio de fragmentos de documentos que pueden ser reutilizados. El cliente proporciona la interfaz para acceder al repositorio de fragmentos para poner en marcha una DPL.

Instalación del servidor

Para poner en marcha un repositorio de fragmentos que pueda ser accedido por el cliente hay que ejecutar los siguientes pasos.

1. Instalar la base de datos PostgreSQL 8.x. PostgreSQL DEBE ser alguna versión dentro de la rama v8.x. Instalar con las opciones por defecto es suficiente.
2. Descargar y descomprimir en su ubicación final el servidor CDO. Elegir la compilación acorde al sistema donde se va a instalar.</li
3. Crear la base de datos de CDO conforme a la configuración por defecto del servidor de CDO (archivo cdo-server.xml). El servidor de CDO espera la siguiente configuración:

   <property name="hibernate.connection.url" value="jdbc:postgresql://localhost/cdo"/>
   <property name="hibernate.connection.username" value="cdo"/>
   <property name="hibernate.connection.password" value="cd0_us3r_p4ss"/>
   

Para crear el usuario cdo y la base de datos asociada puede emplearse el archivo config-db.sql que se encuentra junto al ejecutable del servidor de CDO (cdo-server.exe). Se puede ejcutar las instrucciones SQL mediante la consola de PostgreSQL (psql.exe):

Server [localhost]:
Database [postgres]:
Port [5432]:
Username [postgres]:
psql (8.4.9)
ADVERTENCIA: El código de página de la consola (850) difiere del código
            de página de Windows (1252).
            Los caracteres de 8 bits pueden funcionar incorrectamente.
            Vea la página de referencia de psql «Notes for Windows users»
            para obtener más detalles.
Digite «help» para obtener ayuda.

postgres=# CREATE ROLE cdo_group
postgres-#   NOSUPERUSER INHERIT NOCREATEDB NOCREATEROLE;
CREATE ROLE
postgres=#
postgres=# CREATE ROLE cdo LOGIN
postgres-#   PASSWORD 'cd0_us3r_p4ss'
postgres-#   NOSUPERUSER INHERIT NOCREATEDB NOCREATEROLE;
CREATE ROLE
postgres=#
postgres=# GRANT cdo_group TO cdo;
GRANT ROLE
postgres=#
postgres=# CREATE DATABASE cdo
postgres-#   WITH OWNER = cdo_group
postgres-#        ENCODING = 'UTF8'
postgres-#        TABLESPACE = pg_default
postgres-#        LC_COLLATE = 'Spanish_Spain.1252'
postgres-#        LC_CTYPE = 'Spanish_Spain.1252'
postgres-#        CONNECTION LIMIT = -1;
CREATE DATABASE
postgres=#
postgres=# GRANT ALL ON DATABASE cdo TO cdo_group;
GRANT
postgres=# \q

4. En este punto ya se puede lanzar el servidor CDO. Se recomienta modificar el fichero cdo-server.ini e incluir la opción -console antes de -vmargs. Esta opción es necesaria para tener acceso al servidor:

   -startup
   plugins/org.eclipse.equinox.launcher_1.2.0.v20110502.jar
   --launcher.library
   plugins/org.eclipse.equinox.launcher.win32.win32.x86_1.1.100.v20110502
   --launcher.XXMaxPermSize
   128M
   -console
   -vmargs
   -Xms256M
   -Xmx1024M
   -Dnet4j.config=.
   

5. Cuando se desee terminar la ejecución del servidor debe cerrarse de manera limpia proporcionando el comando close en el prompt the la consola 'osgi':

   osgi> close