Setting up a 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.
Before you begin
Antes de empezar con estos pasos, debe haber finalizado los siguientes:
Tip: Cuando utiliza IBM® Installation Manager los archivos Jazz Team Server se pueden instalar en un directorio de 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 del servidor de aplicaciones web WebSphere, entonces no necesita mover manualmente los archivos tal y como se describe más arriba.
About this task
Note: 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
    Note: Este es un ejemplo de 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 IBM Java SDK 1.5 SR5 Cumulative Fix o superior aplicado o WebSphere Application Server Versión 7.0 con la versión 7.0.0.3 como mínimo instalada. 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 i-fixes se encuentran disponibles en sus APAR correspondientes 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 como mínimo el fixpack 19 de WebSphere Application Server 6.1 antes de instalar el i-fix 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.

    Primero, necesita saber dónde encontrar algunos de los archivos de configuración. Para ello, establezca la propiedad del sistema JAZZ_HOME. 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.

    La segunda propiedad que requiere el Jazz JVM es que se le proporcione más de una asignación de memoria máxima predeterminada, utilizando la configuración -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.

    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.

    Hay otro par de propiedades del sistema que necesitan establecerse para controlar el comportamiento del servidor, estas se especifican más abajo. Estos son los detalles de la configuración de las propiedades de la máquina virtual Java (JVM) en la WebSphere Administrative Console. Sustituya JazzInstallDir por su directorio de instalación para 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 Anotaciones y rastreo. Pulse Cambiar niveles de detalle de anotaciones. 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 anotaciones de WebSphere, establezca el nivel de anotaciones en grave para los paquetes org.eclipse.birt.*. Pulse Aplicar.
    9. Pulse Propiedades personalizadas
    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.
    Important: Sólo en Solaris, también debe añadir el siguiente argumento de línea de mandato Java:
    -XX:MaxPermSize=256m
    Para obtener información adicional, consulte el capítulo 2, "Configurar un entorno Solaris en WebSphere Application Server" del IBM WebSphere Application Server V6.1 en el red book del sistema operativo Solaris 10 .
  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 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.
    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/jazz.war
    5. Configure Raíz de contexto en /jazz.
    6. Pulse Siguiente y continúe los pasos restantes de Instalar aplicación nueva .
    7. Pulse Finalizar.
    8. 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.

What to do next
After the server is started, proceed to Ejecución del asistente de configuración.

For more information about this topic visit the following links:

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

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


Feedback

Did this help? You can provide feedback at Jazz.net (registration required): Comment in the forums or submit a bug