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:
- WebSphere Application server ya está
instalado.
- La base de datos está creada y el archivo teamserver.properties está actualizado con los valores de la base de datos.
- Habilitación del inicio de sesión que no distingue entre mayúsculas y minúsculas (opcional): si el método de autenticación del servidor de aplicaciones permite el inicio de sesión que no distingue entre mayúsculas y minúsculas, es posible
hacer que la aplicación de Jazz también las acepte. Se puede habilitar Permitir el inicio de sesión
que no distingue entre mayúsculas y minúsculas mediante la propiedad "Utilizar concordancia de ID de usuario que no distingue entre mayúsculas y minúsculas" en la página Propiedades avanzadas de la UI web de administrador. El valor predeterminado permanece sin cambios; los administradores deben sustituir explícitamente
esta propiedad para habilitar el inicio de sesión que no distingue entre mayúsculas y minúsculas.
- La opción de seguridad de Java™ 2 se debe desactivar.
Si esta opción está activada en WebSphere Application Server, hará que
Jazz Team Server .war
falle al iniciar.
- Asegúrese de que el valor de seguridad de WAS "Utilizar datos de autenticación disponibles
cuando se acceda a un URI desprotegido" esté seleccionado. Si está utilizando
WAS Integrated Solutions Console, puede hacerlo:
- Navegando a Seguridad -> Asegurar administración, aplicaciones
e infraestructura -> Seguridad web - Valores generales.
- Seleccionando el recuadro de selección correspondiente a "Utilizar datos de autenticación disponibles cuando
se acceda a un URI desprotegido".
- Jazz Team Server incluye
los archivos necesarios para ejecutar un servidor completo basado en Apache Tomcat. Para
una instalación de WebSphere, sólo necesita un subconjunto
de los archivos de Jazz Team Server y debe colocarlos en un directorio de su máquina del servidor de WebSphere. Más instrucciones se refieren a esto como el directorio de instalación de Jazz Team Server, o JazzInstallDir, abreviado. 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 en JazzInstallDir/repositoryDB.
- Las herramientas de repositorio en JazzInstallDir/repotools.
- El directorio JazzInstallDirserver/license-update-site.
- El directorio JazzInstallDir/server/nl1-update-site.
- El directorio JazzInstallDir/server/nl2-update-site.
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.
- 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).
- 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/.
- 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:
- Pulse en .
- Pulse en server1.
- Pulse en .
- Pulse en Java Virtual Machine.
- Añada el valor 100 al Almacenamiento inicial.
- Añada el valor 1000 al Tamaño máximo de almacenamiento.
- Pulse Aplicar.
- 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.
- 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.
- 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
- Pulse Guardar directamente en la configuración maestra.
- 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.
- Abra la Consola de administración para su WebSphere Application
Server.
- Pulse en .
- En Vía de acceso a la nueva aplicación,
pulse Sistema de archivos local.
- En Vía de acceso completa, especifique:
JazzInstallDir/server/jazz.war
- Configure la Raíz de contexto como /jazz.
- Pulse Siguiente y continúe por el resto
de los pasos de Instalar nueva aplicación.
- Pulse Finalizar.
- Pulse Guardar directamente en la configuración maestra.
- Pulse en .
- 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
Una vez iniciado el servidor, siga con
Ejecución del asistente de configuración.
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