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
   

Instalación del cliente: IDE para DPL

El IDE para DPL está formado por un conjunto de plugins que se ejecutan sobre Eclipse. Para instalar el IDE/cliente se deben seguir los siguientes pasos:

1. Descargar y descomprimir en su ubicación definitiva Eclipse SDK.
2. Ejecutar Eclipse y acceder a la interfaz de instalación de software (Help -> Install New Software...).
3. Añadir un nuevo sitio de actualizaciones (botón Add...).

   Name: DPL

   Location: http://dpl.dsic.upv.es/updates/

   1. Notas:

      Si no aparece ningún elemento para ser seleccionado, asegurarse de que la casilla Group items by category está desmarcada.

      Si no se puede conectar al sitio de actualizaciones, o se producen errores por una mala conexión con http://dpl.dsic.upv.es, es posible instalar el prototipo en modo archivo. Para ello se ha de descargar el sitio de actualizaciones archivado (Archivo:Dpl-updates-v0.2.zip) y utilizar la opción Archive... al añadir el nuevo sitio de actualizaciones. La conexión de red sigue siendo necesaria para descargar las dependencias de Eclipse si estas no se encuentran ya instaladas (EMF, GMF, CDO, etc.).

4. Seleccionar los componentes deseados (se recomienda seleccionar todos), pulsar Next > y continuar con el proceso de instalación. El proceso de instalación puede durar algunos minutos mientras se descargan todas las dependencias. Esperar hasta que la instalación complete y solicite reiniciar Eclipse.
5. Una vez se ha reiniciado Eclipse debemos cambiar la configuración de Apache Ant. La versión de Ant incluida en Eclipse es incompatible con DITA Open Toolkit. Para ello deberemos:
   1. Descargar y descomprimir en su ubicación definitiva DITA Open Toolkit.
   2. Abrir las preferencias de Eclipse (Window -> Preferences).
   3. Navegar hasta Ant -> Runtime.
   4. Pulsar Ant Home....
   5. Establecer como Ant home la ruta de Ant includo en DITA Open Toolkit (DIRECTORIO_DITA\tools\ant).
6. Finalmente, se debe indicar a Eclipse dónde se encuentran los scripts de DITA Open Toolkit:
   1. En la ventana de preferencias (Window -> Preferences) navegar hasta DITA -> Open Toolkit.
   2. En el formulario que aparece, pulsar Browse..., y seleccionar la carpeta raiz donde hayamos descomprimido DITA Open Toolkit (DIRECTORIO_DITA\).
   3. Aceptar todos los cambios y cerrar las preferencias.

Screencast

Screencast de la instalación del cliente de DPL