Ver el código de «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.
__TOC__
== Requisitos ==

El prototipo de DPL requiere el siguiente software para funcionar:

* Eclipse SDK v3.7.x:
** [http://www.eclipse.org/downloads/packages/release/indigo/sr2 Descarga oficial]
** [http://archive.eclipse.org/eclipse/downloads/drops/R-3.7.2-201202080800/ Todas las versions 3.7.2]
** Copia en este sitio (SDK - Windows x86): [[Archivo:Eclipse-SDK-3.7.1-win32.zip]].
** Copia en este sitio (Platform - Windows x86): [[Archivo:Eclipse-platform-3.7.2-win32.zip]]. Esta descarga se recomienda para una instalación de DPLfw mínima, pero puede incrementar el tiempo de descarga de dependencias.
* Dita Open Toolkit. '''<span style="color: red">Sólo v0.4 o anterior</span>''':
** [http://sourceforge.net/projects/dita-ot/files/DITA-OT%20Stable%20Release/ Descarga oficial].
** Copia en este sitio: [[Archivo:DITA-OT1.5.4_full_easy_install_bin.zip]].
* PostgreSQL versión 8.x. '''<span style="color: red">Sólo para el servidor de DPLfw</span>''':
** [http://www.enterprisedb.com/products-services-training/pgdownload Descarga oficial].
** Copia en este sitio (Windows x86): [[Archivo:Postgresql-8.4.9-1-windows.exe]].

== 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.

<ol>
<li>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.</li>
<li>[[Descargas#Servidor CDO | Descargar]] y descomprimir en su ubicación final el servidor CDO. Elegir la compilación acorde al sistema donde se va a instalar.</li>
<li>Crear la base de datos de CDO conforme a la configuración por defecto del servidor de CDO (archivo <code>cdo-server.xml</code>). El servidor de CDO espera la siguiente configuración:
<pre>
<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"/>
</pre>
</li>
Para crear el usuario <code>cdo</code> y la base de datos asociada puede emplearse el archivo <code>config-db.sql</code> que se encuentra junto al ejecutable del servidor de CDO (<code>cdo-server.exe</code>). Se puede ejcutar las instrucciones SQL mediante la consola de PostgreSQL (<code>psql.exe</code>):
<pre>
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
</pre>
<li>En este punto ya se puede lanzar el servidor CDO. Se recomienta modificar el fichero <code>cdo-server.ini</code> e incluir la opción <code>-console</code> antes de <code>-vmargs</code>. Esta opción es necesaria para tener acceso al servidor:
<pre>
-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=.
</pre>
</li>
<li>Cuando se desee terminar la ejecución del servidor debe cerrarse de manera limpia proporcionando el comando <code>close</code> en el prompt the la consola ''osgi'':
<pre>
osgi> close
</pre></li>
</ol>
Para instalar el servidor como un servicio de sistema en un sistema Debian/Linux consulta [[Instalación del servidor CDO como servicio en Linux]].

=== 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:

# [[Descargas | Descargar]] y descomprimir en su ubicación definitiva Eclipse SDK.
# Ejecutar Eclipse y acceder a la interfaz de instalación de software (Help -> Install New Software...).
# Añadir un nuevo sitio de actualizaciones (botón ''Add...'').
#: Name: DPL
#: Location: http://dpl.dsic.upv.es/updates/latest/
## 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 (ver sección [[Descargar#Plugins_DPLfw]]) 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.).
# 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.
# '''<span style="color: red">Sólo v0.4 o anterior.</span>''' 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:
## [[Descargas | Descargar]] y descomprimir en su ubicación definitiva DITA Open Toolkit.
## Abrir las preferencias de Eclipse (''Window -> Preferences'').
## Navegar hasta ''Ant -> Runtime''.
## Pulsar ''Ant Home...''.
## Establecer como ''Ant home'' la ruta de ''Ant'' includo en DITA Open Toolkit (<code>''DIRECTORIO_DITA''\tools\ant</code>).
#  '''<span style="color: red">Sólo v0.4 o anterior.</span>''' Finalmente, se debe indicar a Eclipse dónde se encuentran los scripts de DITA Open Toolkit:
## En la ventana de preferencias (''Window -> Preferences'') navegar hasta ''DITA -> Open Toolkit''.
## En el formulario que aparece, pulsar ''Browse...'', y seleccionar la carpeta raiz donde hayamos descomprimido ''DITA Open Toolkit'' (<code>''DIRECTORIO_DITA''\</code>).
## Aceptar todos los cambios y cerrar las preferencias.