Este tema explica cómo configurar
Jazz Team Server for System z para que funcione con WebSphere Application Server.
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.
- Consulte la documentación de WebSphere para la configuración de seguridad y desactivar la propiedad de distinción entre mayúsculas y minúsculas.
Nota: Aunque WebSphere y muchos directorios LDAP le permiten iniciar sesión sin distinguir las mayúsculas de las minúsculas, Jazz Team Server for System z almacena los registros de usuario con los ID tal y como se han
importado. Cuando se inicia una sesión en
Jazz Team Server for System z, el registro de usuario se recupera de la lista de usuarios y el tipo de letra tiene que ser el mismo.
- La opción Java™ 2 Security debe desactivarse.
Si se activa esta opción en WebSphere Application Server hará que Jazz Team Server for System z .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".
- Jazz Team Server for System z incluye los archivos necesarios para ejecutar un servidor basado en Apache Tomcat en su totalidad. Para una instalación de WebSphere solo necesitará un
subconjunto de los archivos de Jazz Team Server for System z y deberá colocarlos en un directorio de la máquina del servidor de WebSphere.
Más instrucciones se refieren a esto como el directorio de instalación de Jazz Team Server
for System z 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 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.
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 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. Consulte el apartado Requisitos de sistema detallados para los entornos de servidor de Rational Team
Concert for System z.
- Actualizar los argumentos JVM.
Jazz Team Server
for System z necesita algunas configuraciones específicas en la máquina virtual Java 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 for System z está ejecutándose. Un equipo de tamaño medio típico puede utilizar un valor de -Xmx1000M, que proporciona 1000 MB de memoria dinámica al proceso de Jazz Team Server for System z .
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 WebSphere Administrative
Console; sustituya JazzInstallDir por el directorio de instalación de
Jazz Team Server for System z:
- 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. Jazz Team Server for System z utiliza el motor 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 Valor: archivo:///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 de WebSphere Application Server
en el 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.