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:
- 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 aplicaciones permite el inicio de sesión sin distinción entre mayúsculas y minúsculas,
es posible hacer que la aplicación Jazz también las acepte. 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 omitir 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 2 de seguridad de Java™ debe estar
desactivada. Si se activa esta opción en WebSphere Application Server,
Jazz Team
Server .war
no se podrá iniciar.
- Asegúrese de que el valor de seguridad de WAS "Utilizar datos de autenticación disponibles cuando se acceda a un URI sin protección" esté seleccionado. 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. (En WAS 7.0.0.7,
vaya a Seguridad -> Seguridad global -> Seguridad de Web y SIP ->
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.
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.
- 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).
- 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/.
- 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:
- 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 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.
- 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.
- 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 . (Para
WebSphere Application Server
7.0.0.7 y posteriores, pulse .)
- En Vía de acceso a aplicación nueva, pulse Sistema de archivos local.
- En Vía de acceso completa introduzca:
JazzInstallDir/server/tomcat/webapps/jazz.war
- 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.
- Pulse Siguiente y continúe los pasos restantes de Instalar aplicación nueva.
- Pulse Finalizar.
- Verifique que la aplicación jazz_war se haya instalado y 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.
Nota: Los pasos restantes son sólo para Rational Quality Manager.
- Regrese a la página Install New Application.
- 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.
- Continue pulsando Next hasta que vea la pantalla
Summary y pulse Finish para instalar
la nueva aplicación.
- Verifique que se ha instalado la aplicación help_war y pulse Save para guardar
los cambios en el archivo de configuración maestro.
- Pulse .
- 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