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:
- El servidor de aplicaciones WebSphere ya está instalado.
- Se crea la base de datos y el archivo teamserver.properties se actualiza con los valores de la base de datos.
- Habilitar el inicio de sesión sin distinción entre mayúsculas y minúsculas (opcional): Si el método de autenticación del servidor de la aplicación permite el inicio de sesión sin distinción entre mayúsculas y minúsculas, entonces es posible hacer que la aplicación de Jazz también lo permita. Es posible habilitar el permiso de inicio de sesión sin distinción entre mayúsculas y minúsculas a través de la propiedad "Utilizar coincidencia de ID de usuario no sensible a las mayúsculas y minúsculas" en la páginas Propiedades avanzadas de la IU de web del administrador. Por defecto no se cambia; los administradores deben ignorar de forma explícita esta propiedad para habilitar el inicio de sesión sin distinción entre mayúsculas y minúsculas.
- La opción Java™ 2 Security debe desactivarse.
Si se activa esta opción en el servidor de aplicaciones WebSphere, esto hará que el Jazz Team
Server .war
falle al iniciarse.
- Asegúrese de que la configuración de seguridad WAS "Utilizar datos de autenticación disponibles cuando se acceda a un URI sin protección" esté seleccionada. Si va a utilizar la consola de soluciones integradas de WAS (Integrated Solutions Console), realice lo siguiente:
- Navegue hasta Seguridad -> Administración, aplicaciones e infraestructura seguras -> Seguridad web - Valores generales.
- Seleccione la casilla de verificación "Utilizar datos de autenticación disponibles
cuando se acceda a un URI sin protección".
- El Jazz Team
Server incluye los archivos requeridos para ejecutar un servidor basado en Apache Tomcat en su totalidad. Para una instalación WebSphere solo necesita un
subconjunto de los archivos Jazz Team
Server y los deberá colocar en un directorio en la máquina del servidor WebSphere. Más instrucciones se refieren a esto como el directorio de instalación Jazz Team
Server, o JazzInstallDir para abreviar. Desde este directorio, utilice:
- El archivo JazzInstallDir/server/tomcat/webapps/jazz.war.
- El directorio JazzInstallDir/server/update-site.
- El directorio JazzInstallDir/server/conf.
- La base de datos de repositorio predeterminada de JazzInstallDir/repositoryDB.
- Las herramientas del repositorio en JazzInstallDir/repotools.
- El directorio JazzInstallDirserver/license-update-site.
- El directorio JazzInstallDir/server/nl1-update-site.
- El directorio JazzInstallDir/server/nl2-update-site.
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.
- 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).
- 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/.
- 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:
- Pulse .
- Pulse server1.
- Pulse .
- Pulse máquina virtual Java.
- Añada el valor 100 al campo Almacenamiento dinámico inicial.
- Añada el valor 1000 al campo Tamaño máximo de almacenamiento dinámico.
- Pulse Aplicar.
- 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.
- Pulse Propiedades personalizadas
- 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
- Pulse Guardar directamente en la configuración maestra.
- 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.
- Abra la consola Admin del servidor de aplicaciones WebSphere.
- Pulse .
- En Vía de acceso a aplicación nueva, pulse Sistema de archivos local.
- En Vía de acceso completa introduzca:
JazzInstallDir/server/jazz.war
- Configure Raíz de contexto en /jazz.
- Pulse Siguiente y continúe los pasos restantes de Instalar aplicación nueva .
- Pulse Finalizar.
- Pulse Guardar directamente en la configuración maestra.
- Pulse .
- 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