Configuración de WebSphere Application Server

Este tema explica cómo configurar Jazz Team Server para que funcione con el servidor de aplicaciones WebSphere. Esta configuración presupone que está instalando Jazz Team Server en la misma máquina que el servidor de aplicaciones Websphere. Las instrucciones se basan en WebSphere Application Server versión 6.1.0.23. Existen pequeñas variaciones para la versión 7.0.0.7 y posteriores. Estas variaciones se indicarán en el texto, donde corresponda.
Antes de empezar
Antes de empezar con estos pasos, debe haber finalizado los siguientes:
Consejo: Cuando se utiliza IBM® Installation Manager para instalar Jazz Team Server para utilizar con Rational Team Concert, los archivos de Jazz Team Server se pueden instalar en un directorio de la aplicación web. Durante el proceso de instalación, no debe instalar el servidor de aplicaciones Apache Tomcat; esto hace que Installation Manager solicite un directorio de aplicación de web y solo instale los archivos necesarios para WebSphere. El directorio predeterminado es C:\Program Files\IBM\JazzTeamServer en Windows® o /opt/IBM/JazzTeamServer en Linux®. El directorio de instalación se denomina JazzInstallDir en este procedimiento. Si utiliza IBM Installation Manager para instalar los archivos en el directorio de aplicaciones web de WebSphere Application Server, no necesitará mover manualmente los archivos como se ha descrito anteriormente.
Por qué y cuándo se efectúa esta tarea
Nota: En este documento no se explica la configuración de la autenticación WebSphere o SSL, lo cual es un tema complicado. La información sobre las distintas opciones de cifrado y autenticación de WebSphere se explica de forma más detallada en el centro de información de WebSphere. Para obtener más información vaya a WebSphere Centro de información y busque Seguridad en las aplicaciones y sus entornos. La UI de Jazz requiere que la autenticación se configure para que lleve a cabo la autorización y personalice 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: Este es un ejemplo dde configuración de DB2. El archivo teamserver.properties debe actualizarse en función del proveedor de bases de datos (Oracle/MS-SQL).
  2. Verifique o actualice el nivel del servidor de aplicaciones WebSphere.

    Jazz Team Server requiere WebSphere Application Server versión 6.1 con el Arreglo acumulativo de IBM Java SDK 1.5 SR5 o posterior 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 en http://www-1.ibm.com/support/docview.wss?rs=180&uid=swg24017492. Con WebSphere 6.1 y el kit de desarrollo de software (SDK) GA IBM Java, Jazz empieza a informar de "errores de proxy" tras realizar algunas operaciones.

    Debe obtener los correspondientes i-fixes deWebSphere Application Server de los arreglos de IBM Java SDK 1.5 SR9 o IBM Java SDK 1.6 SR4 que son necesarios para que IBM Rational Team Concert 2.0 se ejecute correctamente. En caso contrario, es posible que algunos de los servicios del servidor no se inicien correctamente. Los arreglos i están disponibles en sus correspondientes APAR de WebSphere Application Server. En el caso de IBM Java SDK 1.5/WebSphere Application Server 6.1, el APAR es PK85942 y los archivos pueden descargarse en 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. En el caso de IBM Java SDK 1.6/WebSphere Application Server 7.0, el APAR es PK 86771 y los archivos pueden descargarse en ftp://ftp.software.ibm.com/software/websphere/appserv/support/fixes/PK86771/.

  3. Actualizar los argumentos JVM.

    El Jazz Team Server necesita algunas configuraciones específicas en la máquina virtualJava en la que se ejecuta.

    La primera propiedad que es necesario establecer en los argumentos JVM genéricos es la asignación máxima de memoria predeterminada, utilizando el valor -Xmx. Esto debe configurarse de acuerdo al tamaño del equipo soportado por el servidor y la capacidad de memoria del servidor, donde Jazz Team Server está ejecutándose. Un equipo de tamaño medio típico puede utilizar un valor de -Xmx1536M, que proporciona 1536 MB de memoria dinámica para el proceso Jazz Team Server.

    Una segunda propiedad que es necesario establecer en los argumentos JVM genéricos, 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 va a conectase a una base de datos Oracle o SQL Server, necesitará añadir una propiedad llamada "ORACLE_JDBC" o "SQLSERVER_JDBC". Establezca la propiedad como la vía de acceso absoluta del archivo (no una dirección URL) de los controladores jdbc correspondientes.

    Los ejemplos siguientes muestran los argumentos JVM genéricos para conectar a bases de datos Oracle y SQL Server, junto con la asignación máxima de memoria 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

    Existen varias otras propiedades del sistema que es necesario establecer para controlar determinados comportamientos del servidor. Se incluyen a continuación. A continuación se muestran los detalles 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 Servidores > Servidores de aplicaciones.
    2. Pulse server1.
    3. Pulse Gestión de proceso y Java > Definición de proceso.
    4. Pulse máquina virtual Java.
    5. Añada el valor 100 al campo Almacenamiento dinámico inicial.
    6. Añada el valor 1000 al campo Tamaño máximo de almacenamiento dinámico.
    7. Pulse Aplicar.
    8. Pulse Registro y rastreo. Pulse Cambiar niveles de detalle de registro. El Jazz Team Server utiliza el motor de elaboración de informes BIRT. Para impedir que las entradas informativas de BIRT se escriban en el archivo de registro de WebSphere, establezca el nivel de registro en severe para los paquetes org.eclipse.birt.*. Pulse Aplicar.
    9. Pulse Servidores de aplicaciones > {nombre_servidor} > Definición de proceso > Java Virtual Machine > Propiedades personalizadas. Una de las propiedades personalizadas que debe añadir es JAZZ_HOME, una propiedad del sistema que especifica dónde encontrar determinados archivos de configuración. Esta propiedad utiliza una dirección URL en lugar de una vía de acceso sencilla, por lo que el valor debe especificarse como un archivo://-style URL.
    10. Añada las siguientes propiedades: Pulse Nuevo; introduzca el Nombre y el Valor; a continuación pulse Aceptar.
      • Nombre: java.awt.headless Valor: verdadero
      • Nombre: org.eclipse.emf.ecore.plugin.EcorePlugin.doNotLoadResourcesPlugin Valor: verdadero
      • Nombre: JAZZ_HOME Value: file:///JazzInstallDir/server/conf
    11. Pulse Guardar directamente en la configuración maestra.
    Importante: Sólo para Solaris, debe añadir también el siguiente argumento de línea de mandatos Java
    -XX:MaxPermSize=256m
    Para obtener información adicional, consulte el capítulo 2, "Configuring a Solaris environment for WebSphere Application Server" del redbook IBM WebSphere Application Server V6.1 on the Solaris 10 Operating System.
  4. Reinicie Websphere para instalar la aplicación de Jazz.
    En los siguientes ejemplos de líneas de mandatos, WASInstallDir representa la ubicación de instalación del servidor de aplicaciones de WebSphere en su servidor.
    • En Windows, el valor predeterminado del directorio de instalación WebSphere es:
      C:\Program Files\IBM\WebSphere\AppServer
      Puede reiniciar el servidor con el siguiente mandato 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 del directorio de instalación predeterminado de WebSphere es:
      /opt/IBM/WebSphere/AppServer
      Puede reiniciar el servidor con los siguientes mandatos 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 Admin del servidor de aplicaciones WebSphere.
    2. Pulse Aplicaciones > Instalar aplicación nueva. (Para WebSphere Application Server 7.0.0.7 y posteriores, pulse Aplicaciones > Nueva aplicación > Nueva aplicación empresarial.)
    3. En Vía de acceso a aplicación nueva, pulse Sistema de archivos local.
    4. En Vía de acceso completa introduzca:
      JazzInstallDir/server/tomcat/webapps/jazz.war
    5. Establezca Raíz de contexto en /jazz y a continuación pulse Siguiente.
      Nota: Este paso aparece casi al final de la instalación en WebSphere Application Server 7.0.0.7 y posteriores.
    6. Pulse Siguiente y continúe los pasos restantes de Instalar aplicación nueva.
    7. Pulse Finalizar.
    8. Verifique que la aplicación jazz_war se haya instalado y pulse Guardar directamente en la configuración maestra.
    9. Pulse Aplicaciones > Aplicaciones Enterprise .
    10. Seleccione el recuadro junto a jazz_war; pulse Iniciar.

      Debería aparecer una flecha verde indicando que la aplicación se ha iniciado con éxito.

      Nota: Los pasos restantes son sólo para Rational Quality Manager.
    11. Regrese a la página Install New Application.
    12. Vaya a la ubicación del archivo help.war en el sistema de archivos local y seleccione el archivo. Escriba la raíz de contexto como /help y pulse Next.
      Nota: Puede encontrar el archivo help.war en DirInstalaciónJazz\server\tomcat\webapps\help.war.
    13. Continue pulsando Next hasta que vea la pantalla Summary y pulse Finish para instalar la nueva aplicación.
    14. Verifique que se ha instalado la aplicación help_war y pulse Save para guardar los cambios en el archivo de configuración maestro.
    15. Pulse Aplicaciones > Aplicaciones Enterprise .
    16. Seleccione help_ war y pulse Start.
Qué hacer a continuación
Si es un usuario de Rational Team Concert, continúe con el tema Ejecución del asistente de configuración. Para Rational Quality Manager, continúe con el tema "Configuración de LDAP en WebSphere Application Server" y a continuación "Ejecución del asistente de configuración de Jazz Team Server".

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

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

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


Comentarios