Configuración de un servidor de aplicaciones WebSphere

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.

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 almacena los registros de usuario con los ID tales como se han importado. Cuando inicia sesión en el Jazz Team Server, se extraen los registros del usuario de la lista de usuarios y la fuente debe coincidir de forma exacta.
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.
El Jazz Team Server incluye los archivos requeridos para ejecutar un servidor basado en Apache Tomcat en su totalidad. Para una instalación WebSphere sólo 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ónJazz Team Server, o JazzInstallDir para abreviar. Desde este directorio, utilice:
- El archivo JazzInstallDir/server/teamserver.properties.
- El archivo JazzInstallDir/server/log4j.properties. Si utiliza un servidor de aplicaciones Websphere, en este archivo podrá cambiar la vía de acceso del archivo jazz.log, que sólo registra mensajes del Jazz Team Server. La vía de acceso predeterminada es tomcat/logs/jazz.log.
- El archivo JazzInstallDir/server/tomcat/webapps/jazz.war.
- El directorio JazzInstallDir/server/provision_profiles.
- El directorio JazzInstallDir/server/update-site.
- La base de datos de repositorio predeterminada de JazzInstallDir/repositoryDB.
- Las herramientas del repositorio en JazzInstallDir/repotools.

Consejo: 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 sólo instale los archivos necesarios para WebSphere. El 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.

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 interfaz de usuario de Jazz requiere que la autenticación se configure para que lleve a cabo la autorización y personalice la aplicación.

Modifique los archivos profile.ini y license-profile.ini:
Modifique cada uno de los perfiles en JazzInstallDir/server/provision_profiles/ y establezca una vía de acceso absoluta para la propiedad de la dirección URL.
Por ejemplo:
- Cambie esta línea:
```
url=file:./update-site
```
- A algo así:
```
url=file:/opt/IBM/JazzTeamServer/server/update-site
```
Nota: El directorio JazzInstallDir/server/provision_profiles/ sólo debe contener los archivos .ini incluidos y no debe contener archivos de copias de seguridad. Algunos editores guardan automáticamente un archivo de seguridad que debe eliminarse.

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:fullyMaterializeLobData=false;user=db2admin;password={password};
com.ibm.team.repository.db.jdbc.password=db2admin

Verifique o actualice el nivel del servidor de aplicacionesWebSphere.
Jazz Team Server requiere el servidor de aplicaciones versión 6.1WebSphere con el IBM Java SDK 1.5 SR5 o superior Cumulative Fix aplicado. 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.
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 los archivos de configuración para el servidor y para log4j, la infraestructura de conexión que utiliza el servidor. Esto se realiza estableciendo las propiedades de sistema com.ibm.team.server.configURL y log4j.configuration. Estas propiedades utilizan una dirección URL en lugar de una vía de acceso sencilla, con lo que el valor debe estar especificado estilo dirección 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 -Xmx1000M, que proporciona 1000 MB de memoria dinámica para el proceso Jazz Team Server.

Si se está conectando a una base de datos de Oracle entonces necesitará añadir una propiedad llamada "ORACLE_JDBC". Establezca la propiedad en la vía de acceso del archivo absoluto (no una dirección URL) a los controladores Oracle jdbc.

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. Pulsemá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: com.ibm.team.repository.provision.profile Valor: archivo:///JazzInstallDir/server/provision_profiles (como dirección URL)
    Nota: El archivo property com.ibm.team.repository.provision.profile debe señalar al directorio que contiene provision_profiles.
  - Nombre: com.ibm.team.server.configURL Valor: archivo:///JazzInstallDir/server/teamserver.properties (como dirección URL)
  - Nombre: log4j.configuration Valor: archivo:///JazzInstallDir/server/log4j.properties (como dirección URL)
  - Nombre: java.awt.headless Valor: verdadero
  - Nombre: org.eclipse.emf.ecore.plugin.EcorePlugin.doNotLoadResourcesPlugin Valor: verdadero
11. 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.
- 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 reinicar 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 deInstalar 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.

Qué hacer a continuación

Después de haber iniciado el servidor, continúe con Ejecución del asistente de configuración.