Configuración de WebSphere Application Server para Rational Engineering Lifecycle Manager

El despliegue e inicio de Jazz Team Server empieza con la selección del servidor de aplicaciones, que aloja Jazz Team Server y sus aplicaciones. Para poder desplegar los archivos war de aplicaciones de Rational Engineering Lifecycle Manager, debe configurar WebSphere Application Server.

Antes de empezar

Importante: Si está actualizando desde una versión anterior del producto, siga las instrucciones de actualización para configurar el servidor de aplicaciones.
Asegúrese de haber completado las siguientes tareas:

La interfaz web de Jazz requiere que la autenticación se configure para que lleve a cabo la autorización y personalice la aplicación.

Nota:
  • Rational Engineering Lifecycle Manager v1.x debe compartir un servidor de aplicaciones con Lifecycle Query Engine.
  • Rational Engineering Lifecycle Manager v4.x puede compartir un servidor de aplicaciones con Lifecycle Query Engine o desplegarse en un servidor de aplicaciones diferente. Sin embargo, ambas aplicaciones se deben registrar en el mismo Jazz Team Server.

Acerca de esta tarea

Este documento no proporciona detalles para la configuración de la autenticación de WebSphere o SSL, que es un tema complejo. La información detallada sobre las distintas opciones de cifrado y autenticación se describen en la documentación del producto WebSphere Application Server. Para obtener más información, vaya a la documentación del producto WebSphere y utilice esta frase en la búsqueda: Seguridad en las aplicaciones y sus entornos.

Procedimiento

  1. Configure la máquina virtual Java en la que se ejecuta Rational Engineering Lifecycle Manager.

    Pulse Servidores > Tipos de servidor > Servidores de aplicaciones WebSphere > Server1. Debajo de Infraestructura del servidor, pulse Java y gestión de procesos > Definición de proceso. Bajo de Propiedades adicionales, pulse Máquina virtual Java. Especifique los siguientes valores. Pulse Aplicar y, a continuación, Guardar directamente en la configuración maestra.

    Tabla 1. Configuración de la máquina virtual Java
    Campo Valor Comentarios
    Almacenamiento inicial 4096  
    Tamaño máximo de almacenamiento dinámico 24576
    • La figura que se muestra es un solo una sugerencia, debería establecer el valor dependiendo de su entorno. Un equipo de tamaño medio puede utilizar un valor de 4096 MB, siempre que haya 4 GB de memoria máxima para el proceso de Rational Engineering Lifecycle Manager en una máquina de 64 bits. Si el valor de Tamaño máximo de almacenamiento dinámico es demasiado pequeño, el origen de datos de Rational Engineering Lifecycle Manager para Lifecycle Query Engine podría dejar de procesar el registro de reserva existente y cualquier cambio nuevo que cree, modifique o suprima productos.
    • Es importante tener más memoria física que la necesaria para todos los procesos en la máquina para evitar la paginación o el intercambio. La paginación reduce el rendimiento del sistema y afecta al rendimiento del sistema de gestión de memoria Java.
    • Cuando aumente el tamaño de almacenamiento dinámico de Java, asegúrese de que haya disponible suficiente memoria física sin utilizar en la máquina para el aumento. Si no hay disponible suficiente memoria física, instale la memoria adicional o tenga en cuenta el efecto que produciría en el rendimiento general.
    Argumentos de JVM genéricos Linux
    -Xmx4g -Xms4g -Xmn512m
    -Xgcpolicy:gencon -Xcompressedrefs
    -Xgc:preferredHeapBase=0x100000000
    Windows
    -Xmx4g -Xms4g -Xmn512m
    -Xgcpolicy:gencon -Xcompressedrefs
    -Xgc:preferredHeapBase=0x100000000
    Linux
    Si necesita más tamaño de almacenamiento dinámico, puede utilizar el valor siguiente, sustituyendo {N} por la cantidad de memoria que se utilizará y {N/8} por 1/8 de la memoria total. Por ejemplo, si -Xmx se establece en 8g, -Xmn debe establecerse en 1g.
    -Xgcpolicy:gencon -Xmx{N} -Xms{N} -Xmn{N/8}
    -Xcompressedrefs  -Xgc:preferredHeapBase=0x100000000
  2. Configure las propiedades personalizadas.

    En Propiedades adicionales, pulse Propiedades personalizadas > Nueva. Especifique la información de las propiedades generales para cada propiedad personalizada siguiente y pulse Aceptar para guardar la información para cada propiedad personalizada. A continuación, pulse Guardar directamente en la configuración maestra.

    Tabla 2. Información de las propiedades personalizadas
    Nombre de propiedad personalizada Valor de propiedad personalizada Comentarios
    JAZZ_HOME file:///JazzInstallDir/server/conf

    Sustituya JazzInstallDir por el directorio de instalación de Jazz Team Server.

    Recuerde:
    • Debe utilizar tres barras inclinadas (///) después de file:
    • Para evitar problemas, no utilice espacios en las vías de acceso de los archivos. Para el directorio Archivos de programa puede utilizar PROGRA~1, y para el directorio Archivos de programa (x86) puede utilizar PROGRA~2.
    Ejemplos:

    Linux file:///opt/IBM/JazzTeamServer/server/conf

    Windows file:///C:/PROGRA~1/IBM/JazzTeamServer/server/conf

    Esta propiedad del sistema especifica dónde encontrar determinados archivos de configuración. Esta propiedad utiliza un URL en lugar de una vía de acceso simple. Especifique un valor como un URL de estilo de archivo: file:///vía_acceso_archivo.
    Importante: En un entorno distribuido, cuando está utilizando un servidor de aplicaciones independiente para cada una de las aplicaciones web, debe añadir estas propiedades personalizadas en cada una de las instancias de WebSphere Application Server.
    java.awt.headless true  
    org.eclipse.emf.ecore.plugin.EcorePlugin.doNotLoadResourcesPlugin true  
    Oracle

    ORACLE_JDBC_DRIVER_FILE

    Vía de acceso absoluta a controlador_JDBC/ojdbc6.jar La vía de acceso al controlador JDBC debe ser una vía de acceso absoluta. No utilice la vía de acceso URL (file:///). Para obtener más información sobre las conexiones Java Database Connectivity (JDBC) de Oracle, consulte Configuración de una base de datos Oracle para Rational Engineering Lifecycle Manager y Lifecycle Query Engine

    SQL_JDBC_DRIVER_FILE

    Vía de acceso absoluta a controlador_JDBC/sqljdbc4.jar La vía de acceso al controlador JDBC debe ser una vía de acceso absoluta. No utilice la vía de acceso URL (file:///). Para obtener más información acerca de cómo conectarse a una base de datos de SQL Server, consulte la documentación de la solución Rational for Collaborative Lifecycle Management.
    log4j.configuration file:///JazzInstallDir/server/conf/startup_log4j.properties  
  3. Aumente la agrupación de hebras predeterminada admitir varios usuarios.

    Pulse Servidores > Tipos de servidor > Servidores de aplicaciones WebSphere > Server1. En Propiedades adicionales, pulse Agrupaciones de hebras > Contenedor webAgrupaciones de hebras. Aumente el tamaño máximo predeterminado de 50 a 200 hebras y pulse Guardar directamente en la configuración maestra.

  4. Configure la propiedad personalizada InvalidateOnUnauthorizedSessionRequestException.
    Pulse Servidores > Tipos de servidor > Servidores de aplicaciones > Server1 > Gestión de sesiones > Propiedades personalizadas > Nueva. Especifique el par de nombre y valor para la propiedad personalizada. Pulse Aceptar o Aplicar y, a continuación, pulse Guardar en la barra de tareas de la consola para guardar los cambios realizados en la configuración.
    Tabla 3. Información de propiedades personalizadas
    Nombre de propiedad personalizada Valor de propiedad personalizada Comentarios
    InvalidateOnUnauthorizedSessionRequestException true El valor predeterminado para esta propiedad personalizada de gestión de sesiones es false.
  5. Establezca la biblioteca compartida de Jazz Reporting Service.
    1. En la consola administrativa, vaya a Entorno > Bibliotecas compartidas. Cambie el desplegable ámbito a server y pulse Nuevo.
    2. Especifique el nombre de biblioteca compartida como Biblioteca compartida JRS, añada una descripción y establezca la vía de acceso de clases en dir_instalación_5.0.1/server/conf/rs/SharedLibrary. En Carga de clases, seleccione el recuadro de selección para utilizar un cargador de clases aislado para la biblioteca compartida y pulse Aplicar.
    3. Pulse Guardar en la configuración maestra.
  6. Reinicie el servidor de aplicaciones para que los cambios entren en vigor.
    • Linux Ejecute los mandatos stopServer.sh y startServer.sh.
    • Windows Ejecute los mandatos stopServer.bat y startServer.bat.

Qué hacer a continuación

  1. Despliegue los archivos de aplicaciones.
    1. En la consola administrativa de WebSphere Application Server, vaya a Aplicaciones > Aplicación nueva > Aplicación empresarial nueva.
    2. En el asistente Preparación para instalación de aplicación, en Vía de acceso a la aplicación nueva, seleccione Sistema de archivos local y especifique la vía de acceso completa al archivo de aplicación. En el asistente Instalar aplicación nueva, establezca la raíz de contexto de aplicación y siga los pasos de instalación. En la página de resumen de Instalar aplicación nueva, verifique las opciones de instalación seleccionadas y pulse Finalizar.
      Tabla 4. Archivos de aplicaciones y valores
      Aplicación Valor de vía de acceso completa Raíz de contexto
      Rational Engineering Lifecycle Manager dir_instalación_RELM/server/webapps/relm.war /relm
      Documentación de Rational Engineering Lifecycle Manager dir_instalación_RELM/server/webapps/relmhelp.war /relmhelp
      Aplicación Gestión de configuración dir_instalación_RELM/server/webapps/vvc.war /vvc
      Jazz Reporting Service dir_instalación_RELM/server/webapps/rs.war /rs
    3. Pulse Guardar directamente en la configuración maestra.

  2. Añada la referencia de biblioteca de Jazz Reporting Service.
    1. Vaya a Aplicaciones > Tipos de aplicaciones > Aplicaciones empresariales de WebSphere y pulse rs_war en la lista de aplicaciones.
    2. En la sección Referencia, pulse Referencias de bibliotecas compartidas.
    3. Seleccione el recuadro de selección situado junto a rs_war y pulse Hacer referencia a bibliotecas compartidas.
    4. Seleccione Biblioteca compartida JRS y pulse la flecha derecha.
    5. Pulse Aceptar. A continuación, pulse de nuevo Aceptar para guardar los valores en la configuración maestra.

  3. Asegúrese de que el orden de carga de clases de Jazz Reporting Service esté configurado correctamente.
    1. Vaya a Aplicaciones > Tipos de aplicaciones > Aplicaciones empresariales de WebSphere y pulse rs_war en la lista de aplicaciones.
    2. En la sección Propiedades detalladas, pulse Carga de clases y detección de actualizaciones.
    3. En la sección Orden de cargadores de clases, seleccione Clases cargadas con cargador de clases local primero (padre último).
    4. Pulse Aceptar y Guardar en configuración maestra.

  4. En la página Aplicaciones empresariales, seleccione las aplicaciones que acaba de desplegar en WebSphere Application Server y seleccione Iniciar.
Nota: Este documento no proporciona detalles para la configuración de la autenticación de WebSphere o SSL, que es un tema complejo. La información detallada sobre las distintas opciones de cifrado y autenticación se describen en la documentación del producto WebSphere Application Server. Para obtener más información, vaya a la documentación del producto WebSphere y utilice esta frase en la búsqueda: Seguridad en las aplicaciones y sus entornos.

Comentarios