Configuración de un WebSphere Application Server

En este tema se describe cómo configurar Jazz Team Server para que funcione con WebSphere Application Server. Esta configuración asume que va a instalar Jazz Team Server en la misma máquina que Websphere Application Server.
Antes de empezar
Antes de empezar estos pasos, debe haber realizado lo siguiente:
Consejo: Al utilizar IBM® Installation Manager, los archivos de Jazz Team Server se pueden instalar en un directorio de aplicación web. Durante el proceso de instalación, no debería instalar el servidor de aplicaciones Apache Tomcat incluido; esto hace que Installation Manager pida un directorio de aplicación web e instale sólo los archivos necesarios para WebSphere. El directorio predeterminado es C:\Archivos de programa\IBM\JazzTeamServer en Windows® o /opt/IBM/JazzTeamServer en Linux®. Se referirá al directorio de instalación como JazzInstallDir en este procedimiento. Si utiliza IBM Installation Manager para instalar los archivos en el directorio de aplicaciones web de WebSphere Application Server, no necesita mover manualmente los archivos como se describió anteriormente.
Por qué y cuándo se efectúa esta tarea
Nota: Este documento no enseña la configuración de la autenticación de WebSphere o SSL, que es un tema complejo. La información detallada sobre las varias opciones de autenticación y cifrado para WebSphere is incluida en el Information Center de WebSphere. Para obtener más información, vaya al Information Center de WebSphere y busque Asegurar aplicaciones y su entorno. La UI web de Jazz requiere que la autenticación se configure para realizar la autorización y personalizar la aplicación.
  1. Revise y actualice la ubicación de la base de datos en el archivo teamserver.properties.
    com.ibm.team.repository.db.vendor = DB2
    com.ibm.team.repository.db.jdbc.location=//localhost:50000/JAZZ:user=db2admin;password={password};
    com.ibm.team.repository.db.jdbc.password=db2admin
    Nota: Esta es una configuración de ejemplo de DB2. teamserver.properties debe actualizarse en función del proveedor de la base de datos (Oracle/MS-SQL).
  2. Verifique o actualice el nivel de WebSphere Application Server.

    Jazz Team Server requiere WebSphere Application Server Versión 6.1 con el Arreglo acumulativo de IBM Java SDK 1.5 SR5 o superior aplicado o WebSphere Application Server Versión 7.0 con al menos 7.0.0.7 instalado. La actualización de IBM Java SDK 1.5 SR6 SDK está disponible desde http://www-1.ibm.com/support/docview.wss?rs=180&uid=swg24017492. Con WebSphere 6.1 y el GA de IBM Java SDK, Jazz comienza a informar de "errores de proxy" tras algunas operaciones.

    Debe obtener el correspondiente número de arreglos i de WebSphere Application Server para arreglos a IBM Java SDK 1.5 SR9 o a IBM Java SDK 1.6 SR4 que sean necesarios para que IBM Rational Team Concert 2.0 se ejecute correctamente. En caso contrario, algunos servicios del servidor no se iniciarán correctamente. Los arreglos i están disponibles en sus correspondientes APAR de WebSphere Application Server. Para IBM Java SDK 1.5/WebSphere Application Server 6.1, el APAR es PK85942 y puede descargar los archivos desde ftp://ftp.software.ibm.com/software/websphere/appserv/support/fixes/PK85942/. Instale al menos el fixpack 19 de WebSphere Application Server 6.1 antes de instalar el arreglo i de JRE. Para IBM Java SDK 1.6/WebSphere Application Server 7.0, el APAR es PK 86771 y puede descargar los archivos desde ftp://ftp.software.ibm.com/software/websphere/appserv/support/fixes/PK86771/.

  3. Actualice los argumentos JVM.

    Jazz Team Server necesita algunos valores específicos en Java Virtual Machine en la que se ejecuta.

    La primera propiedad que necesita configurarse en los Argumentos genéricos JVM es la asignación de memoria máxima predeterminada, utilizando el valor -Xmx. Ello debería configurarse basándose en el tamaño del equipo soportado por el servidor y en la capacidad de memoria del servidor donde Jazz Team Server se ejecuta. Un equipo típico de tamaño medio puede utilizar un valor de -Xmx1536M, proporcionando 1536 MB de memoria de almacenamiento para el proceso de Jazz Team Server.

    Una segunda propiedad que necesita configurarse en los Argumentos genéricos JVM, específicamente para Rational Quality Manager, es el tamaño de pila de hebra. Un tamaño de pila típico para Rational Quality Manager es -Xss786K.

    Si está conectando a una base de datos Oracle o SQL Server, necesita añadir una propiedad denominada "ORACLE_JDBC" o "SQLSERVER_JDBC". Configure la propiedad a la vía de acceso de archivo absoluta (no un URL) hacia los controladores JDBC adecuados.

    Los ejemplos siguientes muestran los Argumentos genéricos JVM para conectar a las bases de datos Oracle y SQL Server, junto con la asignación de memoria máxima predeterminada y el tamaño de pila de hebra. Sustituya JazzInstallDir por el directorio de instalación de Jazz Team Server.

    -DORACLE_JDBC=JazzInstallDir\server\oracle -Xmx1536M -Xss768k
    -DSQLSERVER_JDBC=JazzInstallDir\server\sqlserver -Xmx1536M -Xss768k

    Hay otras muchas propiedades del sistema que necesitan configurarse para controlar ciertos comportamientos del servidor. Éstas se incluyen a continuación. A continuación se encuentran los detalles específicos de la configuración de estas propiedades JVM en la Consola administrativa de WebSphere. Sustituya JazzInstallDir por el directorio de instalación de Jazz Team Server:

    1. Pulse en Servidores > Servidores de aplicaciones.
    2. Pulse en server1.
    3. Pulse en Gestión de Java y procesos > Definición de proceso.
    4. Pulse en Java Virtual Machine.
    5. Añada el valor 100 al Almacenamiento inicial.
    6. Añada el valor 1000 al Tamaño máximo de almacenamiento.
    7. Pulse Aplicar.
    8. Pulse Registro y rastreo. Pulse Cambiar niveles de detalles de registro. Jazz Team Server utiliza el motor de informes BIRT. Para impedir que las entradas informativas BIRT se escriban en el archivo de registro de WebSphere, configure el nivel de registro en grave para los paquetes de org.eclipse.birt.*. Pulse Aplicar.
    9. Pulse Propiedades personalizadas. Una de las Propiedades personalizadas que necesita añadir es JAZZ_HOME, una propiedad del sistema que especifica dónde encontrar ciertos archivos de configuración. Esta propiedad utiliza un URL en lugar de una vía de acceso simple, por lo que el valor debería especificarse como un URL archivo://-style.
    10. Añada las propiedades siguientes: Pulse Nuevo; especifique el Nombre y el Valor; a continuación, pulse Aceptar.
      • Nombre: java.awt.headless Valor: true
      • Nombre: org.eclipse.emf.ecore.plugin.EcorePlugin.doNotLoadResourcesPlugin Valor: true
      • Nombre: JAZZ_HOME Valor: archivo:///JazzInstallDir/server/conf
    11. Pulse Guardar directamente en la configuración maestra.
    Importante: Sólo para Solaris, también debe añadir el argumento de línea de mandatos de Java siguiente:
    -XX:MaxPermSize=256m
    Para obtener información adicional, consulte el Capítulo 2, "Configuración de un entorno Solaris para WebSphere Application Server" de IBM WebSphere Application Server V6.1 en el redbook del sistema operativo Solaris 10.
  4. Reinicie Websphere para instalar la aplicación Jazz
    En los siguientes ejemplos de línea de mandatos, WASInstallDir representa la ubicación en la que WebSphere Application Server está instalado en el servidor.
    • En Windows, el valor predeterminado para el directorio de instalación de WebSphere es:
      C:\Archivos de programa\IBM\WebSphere\AppServer
      Puede reiniciar el servidor con los mandatos siguientes en Windows:
      cd WASInstallDir\bin 
      stopServer.bat server1 [for a secure server, include: -username {LDAP_User} -password {LDAP_Password}] 
      startServer.bat server1
    • En Linux, el valor predeterminado para el directorio de instalación de WebSphere es:
      /opt/IBM/WebSphere/AppServer
      Puede reiniciar el servidor con los mandatos siguientes en Linux:
      cd WASInstallDir/bin 
      ./stopServer.sh server1 [for a secure server, include: -username {LDAP_User} -password {LDAP_Password}] 
      ./startServer.sh server1
    1. Abra la Consola de administración para su WebSphere Application Server.
    2. Pulse en Aplicaciones > Instalar nueva aplicación.
    3. En Vía de acceso a la nueva aplicación, pulse Sistema de archivos local.
    4. En Vía de acceso completa, especifique:
      JazzInstallDir/server/jazz.war
    5. Configure la Raíz de contexto como /jazz.
    6. Pulse Siguiente y continúe por el resto de los pasos de Instalar nueva aplicación.
    7. Pulse Finalizar.
    8. Pulse Guardar directamente en la configuración maestra.
    9. Pulse en Aplicaciones > Aplicaciones Enterprise.
    10. Seleccione el recuadro junto a jazz_war; pulse Iniciar.

      Debería aparecer una flecha verde, que indicará que la aplicación se ha iniciado satisfactoriamente.

Qué hacer a continuación
Si es un usuario de Rational Team Concert, siga hasta el tema Ejecución del asistente de configuración. Para Rational Quality Manager, siga hasta el tema situado en "Ejecución del Asistente de configuración de Jazz Team Server".

Para obtener más información sobre este tema, visite los enlaces siguientes:

http://jazz.net/library/techtip/95

https://jazz.net/wiki/bin/view/Main/WASSetupFAQ


Comentarios