Despliegue de Creador de documentos en WebSphere Application Server

Puede desplegar el Creador de documentos de Rational Publishing Engine en WebSphere Application Server versión 8.x o posterior con IBM® DB2 u Oracle.

Antes de empezar

Debe instalar WebSphere Application Server V8.x o posterior y Rational Publishing Engine con la característica del Creador de documentos de RPE antes de desplegar el Creador de documentos.
Debe acceder a los siguientes archivos de Creador de documentos disponibles en el directorio RPE_HOME\document-builder:
  • com.ibm.rpe.web.app.ear (o los archivos rpeng.war y dgaas.war)
Recuerde: La aplicación empresarial com.ibm.rpe.web.app.ear es un paquete de dos aplicaciones web: rpeng.war y dgaas.war. Tiene una de las siguientes opciones de despliegue:
  • Desplegar sólo la aplicación empresarial com.ibm.rpe.web.app.ear
  • Desplegar las dos aplicaciones web rpeng.war y dgaas.war juntas
El escenario de despliegue y los ejemplos explican cómo desplegar sólo la aplicación empresarial com.ibm.rpe.web.app.ear.

Procedimiento

  1. Establecer seguridad global.
  2. Establecer JVM.
  3. Establecer gestión de sesiones.
  4. Establecer la variable de entorno.
  5. Reiniciar el servidor.
  6. Para DB2: Configuración de WebSphere Application Server con DB2 como origen de datos.
  7. Para Oracle: Configuración de WebSphere Application Server con Oracle como origen de datos.
  8. Desplegar el Creador de documentos en el servidor.
  9. Crear una biblioteca compartida para la aplicación dgaas.
  10. Configurar usuarios para el Creador de documentos en WebSphere Application Server.
  11. Asociar bibliotecas compartidas con aplicaciones.
  12. Configurar la variable de licencia.

Establecimiento de seguridad global en WebSphere Application Server

Procedimiento

  1. Inicie WebSphere Application Server.
  2. Abra la consola de administración en un navegador: https://servidor:puerto/ibm/console

    Por ejemplo: https://localhost:9043/ibm/console

  3. Expanda Seguridad y pulse Seguridad global.
  4. En la sección Seguridad de la aplicación, compruebe que el recuadro de selección Habilitar seguridad de la aplicación está marcado.
  5. En la sección Seguridad de Java™ 2, deseleccione todas las opciones. Si la opción Avisar si se otorga a las aplicaciones permisos personalizados está seleccionada y no se puede editar:
    1. Seleccione la opción Utilizar seguridad Java 2 para restringir el acceso a la aplicación a los recursos locales. La opción Avisar si se otorga a las aplicaciones permisos personalizados se habilita.
    2. Deseleccione la opción Avisar si se otorga a las aplicaciones permisos personalizados.
    3. Deseleccione la opción Utilizar seguridad Java 2 para restringir el acceso a la aplicación a los recursos locales.
  6. Pulse Aplicar.
  7. Pulse Guardar para guardar los cambios directamente en la configuración maestra.

Resultados

Captura de pantalla de la página de seguridad global en WebSphere Application Server

Establecimiento de JVM

Acerca de esta tarea

Defina los siguientes valores de máquina virtual Java (JVM) en las propiedades personalizadas del servidor de aplicaciones:
  • com.ibm.websphere.jaxrs.server.DisableIBMJAXRSEngine=true
  • org.eclipse.emf.common.util.URI.archiveSchemes=wsjar wszip jar zip

Procedimiento

  1. Abra la consola de administración en un navegador: https://servidor:puerto/ibm/console

    Por ejemplo: https://localhost:9043/ibm/console

  2. Expanda Servidores > Tipos de servidor y pulse Servidores de aplicaciones WebSphere.
  3. En la sección Servidores de aplicaciones, pulse el enlace del servidor, por ejemplo, server1.
  4. En el separador Configuración, en la sección Infraestructura del servidor, expanda Java y gestión de procesos y pulse el enlace Definición de proceso.
  5. En la sección Propiedades adicionales, pulse el enlace Máquina virtual Java.
  6. En la sección Propiedades adicionales, pulse Propiedades personalizadas.
  7. En la tabla Propiedades personalizadas, pulse Nueva.
  8. En la sección Propiedades generales, para cada entrada especifique los valores siguientes y pulse Aceptar:
    Tabla 1. Propiedades de JVM personalizadas para WebSphere Application Server
    Nombre Valor Descripción
    com.ibm.websphere.jaxrs.server.DisableIBMJAXRSEngine true Inhabilita IBM JAXRS
    org.eclipse.emf.common.util.URI.archiveSchemes wsjar wszip jar zip  
  9. Pulse Guardar para guardar los cambios directamente en la configuración maestra.

Resultados

Captura de pantalla de la página Propiedades personalizadas de la consola de administración de WebSphere Application Server

Establecimiento de gestión de sesiones

Acerca de esta tarea

Defina los siguientes valores de gestión de sesiones en las propiedades personalizadas del servidor de aplicaciones:
  • InvalidateOnUnauthorizedSessionRequestException=true

Procedimiento

  1. Abra la consola de administración en un navegador: https://servidor:puerto/ibm/console

    Por ejemplo: https://localhost:9043/ibm/console

  2. Expanda Servidores > Tipos de servidor y pulse Servidores de aplicaciones WebSphere.
  3. En la sección Servidores de aplicaciones, pulse el enlace del servidor, por ejemplo, server1.
  4. En el separador Configuración, en la sección Valores de contenedor, pulse Gestión de sesiones.
  5. En la sección Propiedades adicionales, pulse Propiedades personalizadas.
  6. En la tabla Propiedades personalizadas, pulse Nueva.
  7. En la sección Propiedades generales, especifique el valor siguiente y pulse Aceptar:
    Tabla 2. Propiedad personalizada de gestión de sesiones para WebSphere Application Server
    Nombre Valor Descripción
    InvalidateOnUnauthorizedSessionRequestException true En respuesta a una solicitud no autorizada, el gestor de sesiones invalida una sesión en lugar de emitir un mensaje de error UnauthorizedSessionRequestException.
  8. Pulse Guardar para guardar los cambios directamente en la configuración maestra.

Resultados

Captura de pantalla de la página de propiedades de gestión de sesiones de la consola administrativa de WebSphere Application Server

Establecimiento de la variable de entorno

Procedimiento

  1. Abra la consola de administración en un navegador: https://servidor:puerto/ibm/console

    Por ejemplo: https://localhost:9043/ibm/console

  2. Expanda Servidores > Tipos de servidor y pulse Servidores de aplicaciones WebSphere.
  3. En la sección Servidores de aplicaciones, pulse el enlace del servidor, por ejemplo, server1.
  4. En el separador Configuración, en la sección Infraestructura del servidor, expanda Java y gestión de procesos y pulse el enlace Definición de proceso.
  5. En el separador Configuración, en la sección Propiedades adicionales, pulse el enlace Entradas de entorno.
  6. En la tabla Entradas de entorno, pulse Nueva.
  7. En la sección Propiedades generales, para cada entrada especifique los valores siguientes y pulse Aceptar:
    Tabla 3. Propiedades de variable de entorno para WebSphere Application Server
    Nombre Valor Descripción
    DGAAS_URL http://<IP de servidor>:<puerto>/dgaas/ Variable de entorno de servicio de generación de documentos
    VCAP_SERVICES {"sqldb":[{}]} Cuando utiliza DB2 u Oracle como la base de datos, debe establecer esta variable de entorno.
    Captura de pantalla de la página Entradas de entorno de la consola de administración de WebSphere Application Server.
  8. Pulse Guardar para guardar los cambios directamente en la configuración maestra.

Reinicie WebSphere Application Server

Acerca de esta tarea

Reinicie el perfil de WebSphere Application Server que desee para desplegar el Creador de documentos (com.ibm.rpe.web.app.ear o, alternativamente, los archivos rpeng.war y dgaas.war):

Procedimiento

  1. Detenga WebSphere Application Server.
  2. Inicie WebSphere Application Server.

Configuración de WebSphere Application Server con DB2 como origen de datos

Debe configurar una base de datos DB2 y la conexión con el Creador de documentos en WebSphere Application Server

Antes de empezar

Debe crear una base de datos IBM DB2 para el Creador de documentos de Rational Publishing Engine. La base de datos debe tener páginas de 16K y un conjunto de códigos UTF-8. Por ejemplo, para crear una base de datos denominada rpedb2 con páginas de 16K y un conjunto de códigos UTF-8, utilice el mandato siguiente:
db2 CREATE DATABASE rpedb1 AUTOMATIC STORAGE Yes USING CODESET UTF-8
    TERRITORY US COLLATE USING SYSTEM PAGESIZE 16384;
En este ejemplo, la base de datos se denomina rpedb1. Consulte en la documentación del producto de DB2 la información sobre cómo crear una base de datos.

Creación de un proveedor JDBC

Procedimiento

  1. Inicie WebSphere Application Server.
  2. Abra la consola de administración en un navegador: https://servidor:puerto/ibm/console e inicie la sesión.

    Por ejemplo: https://localhost:9043/ibm/console

  3. Seleccione Recursos > JDBC > Proveedores JDBC.
  4. Defina el ámbito para que sea la célula.
    Célula
  5. Pulse Nuevo.
  6. En el asistente Crear nuevo proveedor JDBC, seleccione:
    1. Tipo de base de datos: DB2
    2. Tipo de proveedor: Proveedor de controlador JDBC de DB2 Universal
    3. Tipo de implementación: Origen de datos XA
    4. Tipo de implementación: Especifique un nombre, por ejemplo, RPE.
    Asistente Crear nuevo proveedor JDBC
  7. Pulse Siguiente.
  8. En la sección Especifique la información de classpath de la base de datos, especifique la classpath. Sustituya DB2UNIVERSAL_JDBC_DRIVER_PATH por el directorio donde se encuentran los archivos .jar dex DB2:
    <DB2UNIVERSAL_JDBC_DRIVER_PATH>/db2jcc.jar
    <DB2UNIVERSAL_JDBC_DRIVER_PATH>/db2jcc_license_cu.jar
    <DB2UNIVERSAL_JDBC_DRIVER_PATH>/db2jcc_license_cisuz.jar
  9. Especifique la ubicación del directorio del archivo "db2jcc.jar, db2jcc_license_cisuz.jar", que se guarda como la variable de WebSphere ${DB2UNIVERSAL_JDBC_DRIVER_PATH}, por ejemplo, C:\Program Files\IBM\SQLLIB\java.
  10. Especifique la vía de acceso de biblioteca nativa, por ejemplo, C:\Program Files\IBM\SQLLIB\java.
  11. Pulse Aplicar.
    Especifique la información de classpath de la base de datos
  12. Asegúrese de que la vía de acceso de biblioteca nativa sea correcta y pulse Siguiente.
    Vía de acceso de biblioteca nativa
  13. Revise la página de resumen y pulse Finalizar.
    Vía de acceso de la biblioteca nativa
  14. Guarde los cambios en la configuración maestra.

Creación de un origen de datos para la aplicación rpeng

Procedimiento

  1. Vaya al proveedor JDBC que acaba de crear.
    1. Pulse Orígenes de datos.
      Enlace Orígenes de datos
    2. En el campo Nombre de origen de datos, especifique rpeng.
    3. En el campo Nombre JNDI, especifique RPENG_DB y pulse Siguiente.
      Especifique la información de origen de datos básica
  2. Especifique las propiedades específicas de la base de datos para el origen de datos y pulse Siguiente.
    1. Establezca el valor de Tipo de controlador en 4.
    2. En el campo Nombre de base de datos, especifique el nombre de la base de datos.
    3. En el campo Nombre de servidor, especifique el nombre de host de la máquina donde se está ejecutando DB2.
    4. En el campo Número de puerto, especifique el número de puerto de la base de datos DB2.
      especifique las propiedades específicas de base de datos para el origen de datos
  3. En la sección Configurar alias de seguridad, pulse Siguiente.
  4. Revise la página de resumen y pulse Finalizar.
    Resumen del origen de datos
  5. Guarde los cambios en la configuración maestra.

Creación de un origen de datos para la aplicación dgaas

Procedimiento

Repita los pasos de Creación de un origen de datos para la aplicación rpeng, estableciendo DGAAS como el Nombre de origen de datos y DGAAS_DB como el Nombre JNDI.
Especifique la información básica del origen de datos

Creación de una entrada de datos de autenticación

Procedimiento

  1. Vaya al proveedor de datos JDBC de RPE y pulse Orígenes de datos.
  2. En la página Orígenes de datos, pulse el origen de datos rpeng.
  3. En la sección Elementos relacionados, pulse Datos de autenticación JAAS-J2C.
  4. Pulse Nuevo.
  5. Especifique los detalles de autenticación para la base de datos:
    • Para DB2: especifique el alias, ID de usuario y contraseña de DB2, y pulse Aceptar.
      Nuevos datos de autenticación
    • Para Oracle: especifique el alias, ID de usuario y contraseña de Oracle, y pulse Aceptar
      Nuevos datos de autenticación
  6. Guarde los cambios en la configuración maestra.
  7. Vuelva al origen de datos rpeng.
  8. En los Valores de seguridad, seleccione la base de datos rpedb1 para las opciones siguientes:
    1. Alias de autenticación para recuperación de XA
    2. Alias de autenticación gestionado por componentes
    3. Alias de autenticación gestionado por contenedor
    Valores de seguridad
  9. Pulse Aceptar y guarde.
  10. Vaya de nuevo al origen de datos rpeng y pulse Conexión de prueba para probar el origen de datos.
    Conexión de prueba satisfactoria
  11. Repita los pasos de 7 a 10 con el origen de datos dgaas.

Configuración de WebSphere Application Server con Oracle como origen de datos

Debe configurar una base de datos Oracle y configurar la conexión al Creador de documentos en WebSphere Application Server

Antes de empezar

  • Para crear y configurar una base de datos Oracle, se supone que el usuario que prepara una base de datos debe tener autoridad de administración en la base de datos y que la base de datos, el almacenamiento del espacio de tabla y la configuración de almacenamiento apropiada los crea un usuario con autoridad de administración del sistema.
  • En función de la versión de Oracle que utilice, el controlador JDBC (Java Database Connectivity) necesario es ojdbc7.jar.
  • Para generar una lista de los versiones de base de datos y los controladores JDBC soportados, consulte http://www.ibm.com/software/reports/compatibility/clarity/softwareReqsForProduct.html.
  • Los parámetros de configuración y las opciones de espacio de tabla utilizados en este tema son ejemplos y podrían no ser completamente aplicables a su entorno. Por ejemplo, si no puede utilizar el valor AUTOEXTEND, los archivos tendrán que ser lo suficientemente grandes como para permitir el crecimiento. O bien, si no puede utilizar la cuota de tamaño UNLIMITED para la base de datos, asegúrese de que tiene espacio suficiente paraun rápido crecimiento.
  • La base de datos que crea para la aplicación Creador de documentos debe estar formateada para utilizar UTF-8 como juego de caracteres. De forma predeterminada, Oracle no crea una base de datos con el juego de caracteres UTF-8. Al crear una base de datos nueva, asegúrese de seleccionar AL32UTF8 en la configuración de BD de Oracle.

Crear una base de datos y un espacio de tabla

Procedimiento

  1. Como administrador del sistema, cree una base de datos, por ejemplo, rpedb con codificación UTF-8 para el Creador de documentos.
    1. Inicie el asistente de configuración de base de datos y en la página de bienvenida pulse Siguiente.
    2. En la página Operaciones, seleccione Crear una base de datos y a continuación pulse Siguiente.
    3. En la página Plantillas, seleccione Base de datos personalizada y pulse Siguiente.
    4. En los campos Nombre de base de datos global y SID, especifique el nombre de la base de datos de almacenamiento de contenido como, por ejemplo, CLMDB. Pulse Siguiente.
    5. Para configurar el control de la base de datos, especifique la información necesaria para la notificación de alertas y, opcionalmente, habilite la planificación de copia de seguridad de disco diaria. Para continuar sin configuración de control de la base de datos, quite la marca del recuadro de selección que aparece junto a Configurar Enterprise Manager y luego pulse Siguiente.
    6. En la página Credenciales de base de datos, elija una opción para su cuenta de usuario y a continuación pulse Siguiente.
      Nota: La política de complejidad de contraseñas de Oracle requiere que las contraseñas tengan una longitud mínima de 8 caracteres. Además, la contraseña deberá contener al menos un carácter en mayúscula, un carácter en minúscula y un dígito.
    7. En la página siguiente, seleccione un tipo de almacenamiento y la ubicación de los archivos de la base de datos. Pulse Siguiente.
    8. En la página siguiente, elija una opción de recuperación para la base de datos y a continuación pulse Siguiente.
    9. En la página siguiente, especifique si desea añadir los esquemas de ejemplo a la base de datos. Pulse Siguiente.
    10. En la página siguiente, pulse en el separador Juegos de caracteres y seleccione Utilizar Unicode (AL32UTF8). Pulse Siguiente.
      Nota: establecer el juego de caracteres a Unicode (AL32UTF8) permite almacenar varios grupos de idiomas.
    11. En la página Almacenamiento de base de datos verifique o cambie los objetos de base de datos y pulse Siguiente.
    12. En la página siguiente, pulse Finalizar para crear la base de datos.
    13. En la ventana Confirmación que se abre, guarde la página como un archivo HTML si lo desea y pulse a continuación Aceptar. Aparecerá una barra de progreso para mostrar el progreso de la creación de la base de datos.
  2. Abra una ventana SQL *Plus e inicie sesión como SYSTEM o SYSDBA.
  3. Vaya a [OracleInstallDir]/dbhome_1/bin, por ejemplo /u01/app/oracle/product/12.1.0/dbhome_1/bin y especifique el mandato siguiente, donde contraseña es su contraseña:
    ./sqlplus sys/[contraseña]@RPEDB as sysdba
    Iniciar sesión en Oracle
  4. Cree un espacio de tabla para Rational Publishing Engine

    Para crear una espacio de tabla para Rational Publishing Engine, especifique el mandato siguiente. Sustituya RPE por el nombre de espacio de tabla, ORACLE_BASE con la vía de acceso absoluta donde está instalado Oracle, RPEDB con el nombre de base de datos que ha creado en el paso 1, y RPE.DBF con el nombre de archivo de datos que desea crear.

    CREATE TABLESPACE RPE 
    DATAFILE 'ORACLE_BASE/oradata/RPEDB/RPE.DBF' 
    SIZE 1G AUTOEXTEND ON EXTENT MANAGEMENT LOCAL AUTOALLOCATE;
    Por ejemplo:
    CREATE TABLESPACE RPEDB_TS DATAFILE '/u01/app/oracle/oradata/RPEDB/RPEDB_TS.dbf' SIZE 1G
            AUTOEXTEND ON EXTENT MANAGEMENT LOCAL AUTOALLOCATE;
  5. Cree un espacio de tabla temporal para Rational Publishing Engine Para crear un espacio de tabla temporal para Rational Publishing Engine, especifique el mandato siguiente. Sustituya RPE_TEMP por el nombre de espacio de tabla temporal, ORACLE_BASE con la vía de acceso absoluta donde está instalado Oracle, RPEDB con el nombre de base de datos que ha creado en el paso 1, y RPE_TEMP.DBF con el nombre de archivo temporal que desea crear.
    CREATE TEMPORARY TABLESPACE RPE_TEMP 
    TEMPFILE 'ORACLE_BASE/oradata/RPEDB/RPE_TEMP.DBF' 
    SIZE 20M AUTOEXTEND ON EXTENT MANAGEMENT LOCAL UNIFORM SIZE 1M;
    Por ejemplo:
    CREATE TEMPORARY TABLESPACE RPEDB_TEMP TEMPFILE
            '/u01/app/oracle/oradata/RPEDB/RPEDB_TEMP.DBF' SIZE 20M AUTOEXTEND ON EXTENT MANAGEMENT
            LOCAL UNIFORM SIZE 1M
  6. Inicie sesión en el portal Database Control de Oracle Enterprise Manager como usuario sys. Pulse Almacenamiento > Espacios de tabla y compruebe que el espacio de tabla que ha creado se visualiza y está accesible.
    Oracle Enterprise Manager
  7. Tras crear los espacios de tabla, se deberá crear un usuario Oracle especial para cada aplicación que vaya a utilizar la base de datos Oracle. En este ejemplo, se crea y se otorga permiso a un usuario denominado RPE_USER. El usuario de base de datos Oracle debe poder crear los objetos de la base de datos en su espacio de tabla (de forma no limitada o con cuota de espacios) con privilegios para crear la sesión, la tabla, los procedimientos y las vistas. Para crear un usuario de base de datos Oracle para cada nuevo espacio de tabla, especifique el mandato siguiente. Sustituya USER_NAME por el usuario que desee crear, PASSWORD por la contraseña del usuario, RPEDB_TS por el nombre de espacio de tabla que ha creado en el paso 4, y RPEDB_TEMP por el espacio de tabla temporal que desea crear.
    CREATE USER  USER_NAME IDENTIFIED BY PASSWORD DEFAULT TABLESPACE RPEDB_TS QUOTA UNLIMITED ON
          RPEDB_TS TEMPORARY TABLESPACE RPEDB_TEMP;
    Por ejemplo:
    CREATE USER  RPE_USER IDENTIFIED BY RPEt3st123 DEFAULT TABLESPACE RPEDB_TS QUOTA UNLIMITED
            ON RPEDB_TS TEMPORARY TABLESPACE RPEDB_TEMP;
  8. Para otorgar los permisos necesarios al espacio de tabla, especifique los mandatos siguientes:
    GRANT CREATE PROCEDURE, CREATE SESSION, CREATE TABLE, CREATE VIEW TO RPE_USER
  9. Ahora inicie sesión en SQL *Plus Editor utilizando RPE_USER y asegúrese de que se puede autenticar correctamente, por ejemplo:
    ./sqlplus.sh rpe_user/RPEt3st123@RPEDB

Creación de un proveedor JDBC

Procedimiento

  1. Inicie WebSphere Application Server.
  2. Abra la consola de administración en un navegador: https://servidor:puerto/ibm/console e inicie la sesión.

    Por ejemplo: https://localhost:9043/ibm/console

  3. Seleccione Recursos > JDBC > Proveedores JDBC.
  4. Defina el ámbito para que sea la célula.
    Célula
  5. Pulse Nuevo.
  6. En el asistente Crear nuevo proveedor JDBC, seleccione:
    1. Tipo de base de datos: Oracle
    2. Tipo de proveedor: Controlador JDBC de Oracle
    3. Tipo de implementación: Origen de datos XA
    4. Tipo de implementación: Especifique un nombre, por ejemplo, RPE_Oracle.
    Asistente Crear nuevo proveedor JDBC
  7. Pulse Siguiente.
  8. En la sección Especifique la información de classpath de la base de datos, asegúrese de que la sección de classpath apunta a la ubicación de ojdbc7.jar. Si muestra ojdbc6.jar, actualícela como ojdbc7.jar y pulse Aplicar. Por ejemplo:
    ${ORACLE_JDBC_DRIVER_PATH}/odjbc7.jar 
  9. Especifique la ubicación del directorio del archivo "ojdbc7.jar", que se guarda como la variable de WebSphere ${ORACLE_JDBC_DRIVER_PATH}, por ejemplo, /oracle_jdbc .
    Especifique la información de classpath de la base de datos
  10. Revise la página de resumen y pulse Finalizar.
    Vía de acceso de la biblioteca nativa
  11. Guarde los cambios en la configuración maestra.

Creación de un origen de datos para la aplicación rpeng

Procedimiento

  1. Vaya al proveedor JDBC que acaba de crear.
    1. Pulse Orígenes de datos.
      Enlace Orígenes de datos
    2. En el campo Nombre de origen de datos, especifique rpeng.
    3. En el campo Nombre JNDI, especifique RPENG_DB y pulse Siguiente.
      Especifique la información de origen de datos básica
  2. Especifique las propiedades específicas de la base de datos para el origen de datos y pulse Siguiente.
    1. En el campo URL, especifique el URL de la base de datos Oracle, por ejemplo, jdbc:oracle:thin:@[servidor]:1521/RPEDB.
    2. Quite la marca del recuadro de selección Utilizar este origen de datos en persistencia gestionada por contenedor y pulse Siguiente.
      Especifique las propiedades específicas de la base de datos para el origen de datos
  3. En la sección Configurar alias de seguridad, pulse Siguiente.
  4. Revise la página de resumen y pulse Finalizar.
    Resumen del origen de datos
  5. Guarde los cambios en la configuración maestra.

Creación de un origen de datos para la aplicación dgaas

Procedimiento

Repita los pasos de Creación de un origen de datos para la aplicación rpeng, estableciendo DGAAS como el Nombre de origen de datos y DGAAS_DB como el Nombre JNDI.
Especifique la información básica del origen de datos

Creación de una entrada de datos de autenticación

Procedimiento

  1. Vaya al proveedor de datos JDBC de RPE y pulse Orígenes de datos.
  2. En la página Orígenes de datos, pulse el origen de datos rpeng.
  3. En la sección Elementos relacionados, pulse Datos de autenticación JAAS-J2C.
  4. Pulse Nuevo.
  5. Especifique el alias, ID de usuario y contraseña de Oracle y pulse Aceptar.
    Nuevos datos de autenticación
  6. Guarde los cambios en la configuración maestra.
  7. Vuelva al origen de datos rpeng.
  8. En los Valores de seguridad, seleccione la base de datos rpedb para las opciones siguientes:
    1. Alias de autenticación para recuperación de XA
    2. Alias de autenticación gestionado por componentes
    3. Alias de autenticación gestionado por contenedor
    Valores de seguridad
  9. Pulse Aceptar y guarde.
  10. Vaya de nuevo al origen de datos rpeng y pulse Conexión de prueba para probar el origen de datos.
    Conexión de prueba satisfactoria
  11. Repita los pasos de 7 a 10 con el origen de datos dgaas.

Despliegue del Creador de documentos para WebSphere Application Server

Antes de empezar

Compruebe que se crean los activos siguientes:
  • Una base de datos para Rational Publishing Engine en DB2 u Oracle
  • Un origen de datos rpeng con el nombre JNDI: RPENG_DB
  • Un origen de datos DGAAS con el nombre JNDI: DGAAS_DB

Procedimiento

  1. Abra la consola de administración en un navegador: https://servidor:puerto/ibm/console

    Por ejemplo: https://localhost:9043/ibm/console

  2. Expanda Aplicaciones y pulse Nueva aplicación.
  3. Pulse Nueva aplicación empresarial.
  4. En la ventana Preparando la instalación de la aplicación, especifique la vía de acceso de com.ibm.rpe.web.app.ear en un sistema de archivos local o remoto:
    • Si utiliza un archivo local, seleccione Sistema de archivos local.
    • Si utiliza un archivo remoto, seleccione Sistema de archivos remoto.
    Especifique o pulse Examinar para especificar la vía de acceso del archivo com.ibm.rpe.web.app.ear. e forma predeterminada, el archivo de archivado se encuentra en RPE_HOME\document-builder\com.ibm.rpe.web.app.ear.
  5. Pulse Siguiente.
  6. Seleccione Vía rápida - Preguntar sólo cuando se requiera información adicional y pulse Siguiente.
  7. En la página Seleccionar estas opciones de instalación, acepte los valores predeterminados y pulse Siguiente.
    Captura de pantalla de la página Seleccionar estas opciones de instalación de la consola de administración de WebSphere Application Server
  8. En la página Correlacionar módulos con servidores, seleccione los módulos Rational Publishing Engine y DGaaS y pulse Siguiente.
  9. En la página Correlacionar referencias de recursos y recursos, debe especificar el origen de datos para los módulos Rational Publishing Engine y DGaaS.
    1. Para la entrada de módulo Rational Publishing Engine, en la columna Nombre JNDI de recurso de destino, pulse Examinar.
      Captura de pantalla de la página Correlacionar referencias de recursos y recursos de la consola de administración de WebSphere Applicaiton Server.
    2. En la página Nueva aplicación, seleccione la opción rpeng con el nombre JNDI establecido en RPENG_DB.
      Captura de pantalla de la página Nueva aplicación de la consola de administración de WebSphere Application Server.
    3. Pulse Aplicar.
    4. Repita los pasos de forma similar para la entrada de módulo DGaaS, en la columna Nombre JNDI de recurso de destino, pulse Examinar.
    5. En la página Aplicación nueva, seleccione la opción DGAAS con el nombre JNDI especificado en DGAAS_DB.
    6. Pulse Aplicar.
    7. Pulse Siguiente.
    Captura de pantalla de la página Correlacionar referencias de recursos y recursos en la consola de administración de WebSphere Application Server.
  10. En la página Correlacionar hosts virtuales con módulos web, seleccione Rational Publishing Engine y DGaaS y pulse Siguiente.
  11. Revise el Resumen y pulse Finalizar.
    Captura de pantalla de la página Resumen de la consola de administración de WebSphere Application Server.
  12. Para confirmar que el Creador de documentos se ha desplegado correctamente en el servidor, busque el mensaje de salida siguiente que se muestra en el registro de proceso:
    La aplicación com.ibm.rpe.web.app se ha instalado correctamente.
  13. Pulse Guardar para guardar los cambios directamente en la configuración maestra.
    Captura de pantalla de la página de registro de proceso de la consola de administración de WebSphere Application Server.
  14. Expanda Aplicaciones > Tipos de aplicación y pulse Aplicaciones de empresa de WebSphere. La aplicación com.ibm.rpe.web.app que ha añadido se lista como el nombre de aplicación que ha especificado.
  15. En la columna Nombre, pulse el enlace com.ibm.rpe.web.app.
    Captura de pantalla de la página Aplicaciones empresariales de la consola de administración de WebSphere Application Server.
  16. En la sección Propiedades detalladas, pulse el enlace Carga de clases y detección de actualizaciones.
  17. En la sección Orden del cargador de clases, seleccione Clases cargadas con el cargador de clases locales primero (padre primero), y pulse Aceptar.
    Captura de pantalla de la página Cargador de clases de la consola de administración de WebSphere Application Server.
  18. Compruebe las raíces de contexto de la aplicación com.ibm.rpe.web.app:
    1. En la sección Propiedades de módulo web, pulse Raíz de contexto para módulos web.
    2. Compruebe que la raíz de contexto especificada para los módulos web coincida con los valores siguientes y a continuación pulse Aceptar:
      Tabla 4. Verificación de las raíces de contexto para la aplicación com.ibm.rpe.web.app
      Módulo web URI Raíz de contexto
      Rational Publishing Engine com.ibm.rpe.web.ui.war, WEB-INF/web.xml rpeng
      DGaaS com.ibm.rpe.web.service.docgen.war, WEB-INF/web.xml dgaas
      Captura de pantalla de la página Raíz de contexto de la consola de administración de WebSphere Application Server
    3. En el separador Configuración, pulse Aceptar.
  19. Pulse Guardar para guardar los cambios directamente en la configuración maestra.
  20. Inicie el Creador de documentos en el servidor:
    1. Seleccione el recuadro com.ibm.rpe.web.app y pulse Iniciar.
    2. Si el Creador de documentos se inicia correctamente en el servidor, se muestra el mensaje siguiente:
      La aplicación com.ibm.rpe.web.app en el servidor nombre_servidor y el nodo nombre_nodo se ha iniciado correctamente.  Es posible que la colección se deba renovar para mostrar el estado actual.
      Captura de pantalla de la página Aplicaciones empresariales de la consola de administración de WebSphere Application Server.

Configure los usuarios del Creador de documentos en WebSphere Application Server

Acerca de esta tarea

Para completar esta tarea, debe realizar los pasos de Configuración de usuarios para Creador de documentos en WebSphere Application Server

Creación de una biblioteca compartida para la aplicación dgaas

Procedimiento

  1. Vaya a la página Bibliotecas compartidas.
  2. Pulse Entorno > Bibliotecas compartidas en el árbol de navegación de la consola.
  3. Seleccione un ámbito de biblioteca compartida. Cambie el ámbito de la tabla de la colección para ver qué bibliotecas compartidas están una célula, un nodo o un servidor determinados. Seleccione las opciones Nodo y Servidor.
    Página Ámbito de bibliotecas compartidas
  4. Pulse Nuevo.
  5. Especifique el nombre, por ejemplo, dgaas.ear.
  6. Especifique la classpath para los siguientes archivos .jar HTTP:
    <WAS_HOME>\profiles\AppSrv01\installedApps\<nombre de célula>\com.ibm.rpe.web.app.ear\dgaas.war\WEB-INF\lib\org.apache.httpcomponents.httpclient_<versión>.jar
    <WAS_HOME>\profiles\AppSrv01\installedApps\<nombre de célula>\com.ibm.rpe.web.app.ear\dgaas.war\WEB-INF\lib\org.apache.httpcomponents.httpcore_<versión>.jar
  7. Seleccione la opción de carga de clase Utilizar un cargador de clases aislado para esta biblioteca compartida y pulse Aceptar.
    Página Bibliotecas compartidas para biblioteca compartida de todo el contenedor
  8. Pulse Guardar para actualizar los cambios a la configuración maestra.

Qué hacer a continuación

Consejo: A partir de Rational Publishing Engine versión 2.0.1, ya no es necesario crear la biblioteca compartida adicional, rpe.lib, para consumir una licencia. Ahora el producto automatiza esta tarea.

Asociación de bibliotecas compartidas con aplicaciones

Procedimiento

  1. Pulse Aplicaciones > Tipos de aplicación > Aplicaciones de empresa de WebSphere > com.ibm.rpe.web.app > Referencias de biblioteca compartida para acceder a la página Referencias de biblioteca compartida.
    Página Bibliotecas compartidas para rpe.lib
  2. En la página Referencias de biblioteca compartida, seleccione una aplicación a la que desee asociar una biblioteca compartida, en este caso com.ibm.rpe.web.app.
  3. Pulse Referenciar bibliotecas compartidas.
    Página Referencias de bibliotecas compartidas
  4. En la página Correlación de bibliotecas compartidas, seleccione la biblioteca compartida dgaas.ear que el módulo o aplicación utiliza.
  5. Pulse >> para mover las bibliotecas de la lista Disponibles a la lista Seleccionadas.
    Página Correlación de bibliotecas compartidas
  6. En la página Referencias de bibliotecas compartidas, pulse Aceptar.
  7. Guarde los cambios en la configuración maestra.

Configuración de la variable de licencias

Procedimiento

  1. Compruebe la variable de entorno TELELOGIC_LICENSE_FILE. Por ejemplo, puede copiar una variable de entorno para el archivo de licencia en WebSphere Application Server en la página Entradas de entorno:
    Adición de la variable de entorno Telelogic
    Para Linux, el registro se encuentra en $HOME/.flexlmrc para TELELOGIC_LICENSE_FILE.
  2. Reinicie WebSphere Application Server.

Resultados

Puede confirmar que el Creador de documentos está desplegado abriendo el siguiente URL en un navegador: http://servidor:port/rpeng/
Consejo: Es posible que se encuentre el siguiente mensaje de error en el navegador web:
Error 500: com.ibm.websphere.servlet.session.UnauthorizedSessionRequestException:
    SESN0008E: Un usuario autenticado como anónimo ha intentado acceder a una sesión propiedad del
    usuario: defaultWIMFileBasedRealm/uid=rpe_designer,o=defaultWIMFileBasedRealm.
Para resolver este mensaje de error, compruebe que ha establecido la propiedad de gestión de sesiones InvalidateOnUnauthorizedSessionRequestException en true en las propiedades personalizadas para WebSphere Application Server. Para obtener más información, consulte la sección Establecimiento de gestión de sesiones de este tema.

Puede iniciar la sesión proporcionando el nombre de usuario y la contraseña del usuario adecuado, por ejemplo, rpe_admin, rpe_designer o rpe_user, y pulse Iniciar sesión.

Captura de pantalla del registro de la aplicación web en pantalla.

Se debe mostrar en el navegador el siguiente Creador de documentos para Rational Publishing Engine:

Página de inicio de la aplicación web

Puede comprobar el estado del servicio de generación de documentos especificando http://servidor:port/dgaas/debug en un navegador.

Página de inicio de la aplicación web

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.