Puede desplegar las aplicaciones web del Creador de documentos (rpeng.war y dgaas.war) en un servidor Apache Tomcat con Derby o DB2. Si desea ejecutar la aplicación Creador de documentos en una base de datos empresarial, el paso opcional de esta tarea le proporciona los valores de configuración adicionales para el soporte de DB2.
Antes de empezar
Debe instalar Apache Tomcat V7.0.x o V8.0.x y
Rational Publishing Engine con la característica Creador de documentos de
RPE antes de desplegar el
Creador de documentos.
Debe acceder a las siguientes aplicaciones web disponibles en el directorio
RPE_HOME\document-builder:
Procedimiento
- Prepare su servidor de aplicaciones Apache Tomcat:
- En el servidor de aplicaciones Tomcat, establezca la variable del sistema TELELOGIC_LICENSE_FILE en número_puerto@nombre_host, por ejemplo, 19353@licserver1. Para obtener más detalles, consulte Verificar la variable de entorno TELELOGIC_LICENSE_FILE
topic.
- Aumente el tamaño máximo de archivo y el tamaño de solicitud:
Para Tomcat 7:
- Abra el archivo web.xml de la aplicación Tomcat Manager, por ejemplo
<dir_instalación_Tomcat>/webapps/manager/WEB-INF/web.xml.
- Busque la siguiente sección:
<multipart-config>
<!-- 50 MB max -->
<max-file-size>52428800</max-file-size>
<max-request-size>52428800</max-request-size>
<file-size-threshold>0</file-size-threshold>
</multipart-config>
- Edite esta sección para aumentar la capacidad:
<multipart-config>
<!-- 70 MB max -->
<max-file-size>73400320</max-file-size>
<max-request-size>73400320</max-request-size>
<file-size-threshold>0</file-size-threshold>
</multipart-config>
- Guarde y cierre el archivo web.xml.
Para Tomcat 8:
- Detenga el servidor de aplicaciones Apache Tomcat.
- Suprima el directorio dgaas y dgaas.war del directorio
<dir_instalación_Tomcat>\webapps si ya existen.
- Copie el archivo dgaas.war en el directorio
<dir_instalación_Tomcat>\webapps.
- Opcional:
Si desea ejecutar la aplicación Creador de documentos con DB2, debe realizar estos pasos de configuración adicionales: - Copie el archivo db2jcc4.jar del controlador JDBC 4.0 del directorio
<dir_instalación_DB2>/java en el directorio
<dir_instalación_Tomcat>/lib.
- Abra el archivo de script de inicio de Apache Tomcat:
<dir_instalación_Tomcat>\bin\catalina.bat
<dir_instalación_Tomcat>/bin/catalina.sh
Y añada la siguiente línea de código:
set "VCAP_SERVICES={'sqldb':[{}]}"
- Prepare una sentencia XML que defina el origen de datos en el archivo
<dir_instalación_Tomcat>/conf/server.xml:
<Resource auth="Container"
driverClassName="com.ibm.db2.jcc.DB2Driver"
name="jdbc/RPENG_DB"
username="db2admin"
password="myDBpassword"
type="javax.sql.DataSource"
url="jdbc:db2://<servidor>:50000/rpedb1"/>
<Resource auth="Container"
driverClassName="com.ibm.db2.jcc.DB2Driver"
name="jdbc/DGAAS_DB"
username="db2admin"
password="myDBpassword"
type="javax.sql.DataSource"
url="jdbc:db2://<servidor>:50000/rpedb1"/>
Donde el valor
db2admin tras el atributo
usename es el nombre del usuario del sistema con acceso
CONNECT a la base de datos
rpedb1 y
myDBpassword tras
password es la contraseña de este usuario.
Si ha definido un nombre de usuario distinto, o una contraseña distinta, o ambos, sustituya
db2admin y
myDBpassword, según corresponda. Además, sustituya
<
servidor> por la dirección de la ubicación del servidor de base de datos.
Consejo: DB2
tiene un límite de longitud de nombre de usuario y contraseña de 8 caracteres para los sistemas operativos Linux y de 30
caracteres para los sistemas operativos Windows.
- Añada la declaración para este recurso en el archivo
<dir_instalación_Tomcat>/conf/context.xml:
<Context>
...
<ResourceLink name="jdbc/RPENG_DB" global="jdbc/RPEBG_DB" type="javax.sql.DataSource"/>
<ResourceLink name="jdbc/DGAAS_DB" global="jdbc/DGAAS_DB" type="javax.sql.DataSource"/>
</Context>
- Inicie el servidor de aplicaciones Apache Tomcat:

- Si ejecuta Apache Tomcat como un servicio Windows,
para iniciar el servidor, desde el directorio <dir_instalación_Tomcat>/bin, ejecute este mandato (para Apache Tomcat V7.0.x, sustituya con
Tomcat7.exe):
Tomcat8.exe start
Para detener el servidor, desde el directorio
<dir_instalación_Tomcat>/bin, ejecute este mandato (para
Apache Tomcat V7.0.x, sustituya con
Tomcat7.exe):
Tomcat8.exe stop
- Si ejecuta Apache Tomcat como un servicio Windows, para iniciar el servidor, desde el directorio
<dir_instalación_Tomcat>/bin, ejecute este mandato:
startup.bat
Consejo: Se abre una ventana separada de la consola de Apache
Tomcat. No cierre esta ventana o el servidor dejará de funcionar. Debe esperar un momento a que se inicie el servidor Tomcat. Cuando se inicia el servidor, el tiempo de inicio, en milisegundos, se visualiza en la ventana de Tomcat. Por ejemplo, Inicio del servidor en 25731
ms.
Para detener el servidor, desde el directorio
<dir_instalación_Tomcat>/bin, ejecute este mandato:
shutdown.bat

- Para iniciar el servidor, desde el directorio <dir_instalación_Tomcat>/bin,
ejecute este mandato:
startup.sh
Para detener el servidor, desde el directorio
<dir_instalación_Tomcat>/bin, ejecute este mandato:
shutdown.sh
- Seleccione una de las opciones siguientes para desplegar el Creador de documentos:
- Si desea desplegar Creador de documentos utilizando una interfaz gráfica de usuario, continúe con el paso siguiente para obtener información sobre cómo realizar el despliegue utilizando la interfaz de Apache Tomcat
Manager.
- Si desea desplegar el Creador de documentos utilizando el sistema de archivos, copie los archivos rpeng.war y dgaas.war desde el directorio
RPE_HOME\document-builder en el directorio
webapps de Tomcat, por ejemplo,
<dir_instalación_Tomcat>\webapps. A continuación, siga con las secciones
Resultados y Qué hacer a continuación de este tema.
- Abra Apache Tomcat Manager en un navegador en
http://servidor:puerto/manager/html
Ejemplo:
http://localhost:8080/manager/htmlConsejo: Se abre una ventana que le solicita un nombre de usuario y contraseña para la autenticación de la aplicación Tomcat Manager. Debe añadir el rol
manager-gui al archivo
<dir_instalación_Tomcat>/conf/tomcat-user.xml, donde
<dir_instalación_Tomcat> es el directorio de instalación de
Apache Tomcat. El ejemplo siguiente añade un rol
manager-gui con
my_username como nombre de usuario y
my_password para la contraseña:
<user username="my_username" password="my_password" roles="manager-gui"/>
- Despliegue las aplicaciones rpeng.war y dgaas.war en Apache Tomcat.
- En la sección Desplegar, especifique los detalles del archivo rpeng.war y a continuación pulse Desplegar:
- Si el archivo WAR está en un servidor distinto a Apache Tomcat, especifique la siguiente información en la sección Desplegar directorio o archivo WAR ubicado en el servidor:
- Vía de acceso de contexto: Especifique /rpeng como nombre del
Creador de documentos.
Esta entrada forma parte del URL utilizado para configurar el cliente.
- URL del archivo de configuración XML: No es necesario.
- URL del directorio o WAR: La vía de acceso del archivo rpeng.war. Ejemplo: RPE_HOME\document-builder\rpeng.war
- Si el archivo .war está en el mismo servidor que Apache Tomcat, especifique la siguiente información en la sección Archivo WAR para desplegar:
- Seleccione WAR para cargar: La vía de acceso del archivo rpeng.war. Ejemplo: RPE_HOME\document-builder\rpeng.war
- En la sección Desplegar, especifique los detalles del archivo dgaas.war y a continuación pulse Desplegar:
- Si el archivo .war se encuentra en un servidor distinto a Apache Tomcat, especifique la siguiente información en la sección Desplegar directorio o archivo WAR ubicado en el servidor:
- Vía de acceso de contexto: Especifique /dgaas como nombre del
Creador de documentos.
Esta entrada forma parte del URL utilizado para configurar el cliente.
- URL del archivo de configuración XML: No es necesario.
- URL del directorio o WAR: La vía de acceso del archivo dgaas.war. Ejemplo: RPE_HOME\document-builder\dgaas.war
- Si el archivo .war está en el mismo servidor que Apache Tomcat, especifique la siguiente información en la sección Archivo WAR para desplegar:
- Seleccionar WAR para cargar: La vía de acceso de dgaas.war.
Ejemplo: RPE_HOME\document-builder\dgaas.war
Resultados
Puede confirmar que Creador de documentos se ha desplegado abriendo la página de introducción en un navegador en
http://servidor:puerto/rpeng/Importante: De forma predeterminada, la aplicación rpeng.war busca la aplicación
dgaas.war en el mismo servidor, en la vía de acceso de contexto de /dgaas. Si despliega la aplicación dgaas.war en un servidor distinto o en una vía de acceso de contexto distinta, debe configurar la variable de entorno de tiempo de ejecución DGAAS_URL en la aplicación rpeng.war.
Para configurar la variable de entorno de tiempo de ejecución
DGAAS_URL:
- Debe iniciar sesión en el Creador de documentos,
http://servidor:puerto/rpeng/, con un usuario con acceso de administrador
(rpe_admin). Para obtener más información sobre cómo configurar un usuario con el rol de administrador
rpe_admin, consulte el tema Configuración de usuarios para el Creador de documentos en Apache
Tomcat.
- En la barra de herramientas del usuario del Creador de documentos, seleccione
Administrar. Esta opción de menú Administrar está disponible para los usuarios con el rol rpe_admin.
- Seleccione Variables de tiempo de ejecución.
- Establezca el valor de la variable de entorno de tiempo de ejecución DGAAS_URL en un URL, como por ejemplo http://servidor:puerto/dgaas.
Qué hacer a continuación
Opcionalmente, puede desplegar y ejecutar la aplicación de ejemplo Newskeeper que utiliza la tecnología de servicio de generación de documentos para generar documentos y proporciona una interfaz de almacenamiento para activos y documentos del servicio de generación de documentos. Para obtener más información, consulte Ejecución del ejemplo de Newskeeper.
Configure el Creador de documentos de
Rational Publishing Engine
que se lista en la página
http://servidor:puerto/rpeng/. Consulte en
URL del Creador de documentos la explicación de cómo se utiliza cada URL y las tareas para configurar cada una de las características.