Puede desplegar Design Management Server en WebSphere Application Server en vez del servidor Apache Tomcat que se suministra con el servidor.
Las instrucciones están basadas en WebSphere Application Server
versión 8.0 o posterior, con ligeras variaciones para la versión 7.0.
Antes de empezar
Importante: Hay un potencial para la exposición de seguridad al utilizar WS-Security; esto podría resultar en que un usuario obtuviera privilegios elevados. Esto tiene un impacto en aplicaciones que utilizan JAX-WS y JAX-RPC.
Para obtener información completa sobre cómo obtener e instalar este parche de seguridad, lea este
flash de noticias. Además, considere la posibilidad de suscribirse en las actualizaciones de
WebSphere Application Server a través de Mis notificaciones y recibirá avisos sobre actualizaciones y parches relacionados con la seguridad.
Asegúrese de que el entorno esté configurado correctamente:
- WebSphere Application Server está instalado.
Jazz Team Server,
que proporciona la base para Design Management Server,
necesita WebSphere Application Server
Versión 8.0 o posterior, o WebSphere Application Server
Versión 7.0.
- Si utiliza una base de datos distinta de Apache Derby, la base de datos se configura de acuerdo con lo que se describe en el tema Configuración de la base de datos.
- Design Management Server se instala tal como se describe en Instalación de Design Management, extensiones de cliente y motores.
Acerca de esta tarea
Si utiliza una topología departamental o de negocio, debe configurar
Websphere Application Server para cada servidor y aplicación que se ejecute en esa
máquina.
Procedimiento
- En la consola de administración de WebSphere Application Server, especifique los siguientes valores de seguridad:
- Inhabilite la seguridad de Java™ 2. Para
ello pulse y deseleccione la casilla Utilizar
seguridad de Java 2 para restringir el acceso de aplicaciones a recursos
locales.
- En el campo Definición de dominio actual, asegúrese de que el dominio de seguridad correcto esté configurado y establecido como el dominio actual. A continuación, marque los recuadros de selección Habilitar seguridad administrativa y Habilitar seguridad de aplicación.
- Pulse y, en Autenticación, pulse
y seleccione la casilla Utilizar
datos de autenticación disponibles cuando se accede a un URI no
protegido.
- Especifique los valores de la máquina virtual Java para WebSphere Application Server:
- En la consola de administración, pulse y a continuación, pulse el servidor. De forma predeterminada, el servidor se llama server1.
- Debajo de Infraestructura del servidor,
pulse .
- Debajo de Propiedades adicionales, pulse Máquina virtual Java.
- En el campo Almacenamiento dinámico inicia, especifique 4096. Las cifras utilizadas
para los tamaños de almacenamiento dinámicos y los argumentos JVM son únicamente una sugerencia; debe establecer el
valor de acuerdo con su entorno. Un equipo normal de tamaño medio puede utilizar un
valor de 4096 MB, siempre que haya 4 GB de almacenamiento dinámico para el proceso
de Jazz Team Server en un sistema de 64 bits con un mínimo de 8 GB de memoria
física. Es importante utilizar la misma cantidad para los tamaños de almacenamiento dinámico inicial y máximo.
Cuando aumente el tamaño del almacenamiento dinámico de Java, asegúrese de que haya suficiente memoria física sin utilizar en la máquina para el aumento. Si no hay disponible suficiente memoria física, instale la memoria adicional o tenga en cuenta el efecto que produciría en el rendimiento general. También es importante tener más memoria física que la necesaria para todos los procesos en la máquina para evitar la paginación o el intercambio. La paginación reduce el rendimiento del sistema y afecta al rendimiento del sistema de gestión de memoria Java.
- En el campo Tamaño máximo de almacenamiento dinámico, especifique la memoria máxima para el servidor en MB. Para sistemas de 64 bits, especifique una cantidad de memoria que sea apropiada para el entorno, como por ejemplo, 4096 para 4GB de memoria.
- En el campo Argumento genéricos de JVM, añada lo
siguiente:
| Sistema operativo |
Datos entrados por el usuario |
| Windows |
-Xmx4g -Xms4g -Xmn512m -Xgcpolicy:gencon -Xcompressedrefs
-Xgc:preferredHeapBase=0x100000000 -XX:MaxDirectMemorySize=1G |
| Linux |
-Xmx4g -Xms4g -Xmn512m -Xgcpolicy:gencon -Xcompressedrefs
-Xgc:preferredHeapBase=0x100000000 -XX:MaxDirectMemorySize=1G |
| AIX |
-Xmx4g -Xms4g -Xmn512m -Xgcpolicy:gencon -Xnocompressedrefs
-XX:MaxDirectMemorySize=1G |
Sugerencia: Si necesita más almacenamiento dinámico, puede utilizar
el valor siguiente, sustituyendo {N} por la cantidad de memoria que se utilizará y
{N/8} por 1/8 de la memoria total. Por ejemplo,
si -Xmx se establece en 8g, -Xmn se debe establecer en 1g.
-Xgcpolicy:gencon -Xmx{N} -Xms{N} -Xmn{N/8} -Xcompressedrefs -Xgc:preferredHeapBase=0x100000000
-XX:MaxDirectMemorySize=1G
- Pulse Aplicar.
- En la página Máquina virtual Java, debajo de Propiedades adicionales, pulse Propiedades personalizadas.
- Pulse Nuevo y especifique la propiedad JAZZ_HOME que identifica la ubicación de archivos configurables para Design Management Server,
incluidas las carpetas jts y dm.
Esta propiedad utiliza un URI en lugar de una vía de acceso al archivo simple y siempre empieza por
file:///. La ubicación predeterminada de un sistema
Windows es el siguiente:
file:///C:/PROGRA~1/IBM/JazzTeamServer/server/conf
Un un sistema Linux, la ubicación predeterminada es la siguiente:
file:///opt/ibm/JazzTeamServer/server/conf
Nota: Para evitar problemas, no utilice espacios en las vías de acceso de archivos. En las carpetas Archivos de programa en instalaciones de 32 bits de Windows, puede utilizar PROGRA~1 y en las carpetas Archivos de programa (x86) en instalaciones de 64 bits de Windows,
puede utilizar PROGRA~2.
- Vuelva a pulsar Nuevo y especifique una propiedad
llamada log4j.configuration. Utilice como valor la ubicación del
archivo startup_log4j.properties. Esta propiedad utiliza el mismo formato que la propiedad JAZZ_HOME.
En la mayoría de los casos, ese archivo está en la carpeta JAZZ_HOME.
El valor predeterminado en un sistema Windows es el siguiente:
file:///C:/PROGRA~1/IBM/JazzTeamServer/server/conf/startup_log4j.properties
El valor predeterminado en un sistema Linux es el siguiente:
file:///opt/ibm/JazzTeamServer/server/conf/startup_log4j.properties
Nota: Los valores de startup_log4j.properties se utilizan en las primeras etapas del proceso de inicio para transferir mensajes al archivo SystemOut.log.
Tras las primeras etapas, cada aplicación pasa a utilizar los valores específicos de la aplicación del archivo server/conf/<app_context>/log4j.properties.
- Vuelva a pulsar Nuevo y especifique una propiedad llamada java.awt.headless con el valor true.
- Vuelva a pulsar Nuevo y especifique una propiedad llamada org.eclipse.emf.ecore.plugin.EcorePlugin.doNotLoadResourcesPlugin con el valor true.
- Si utiliza una base de datos de SQL Server, pulse de nuevo Nuevo y especifique una propiedad denominada SQLSERVER_JDBC_DRIVER_FILE con la ubicación del archivo sqljdbc4.jar.
- Si utiliza una base de datos Oracle, pulse de nuevo Nuevo y especifique una propiedad denominada ORACLE_JDBC_DRIVER_FILE con la ubicación del archivo ojdbc5.jar.
Las propiedades personalizadas son similares a las de la siguiente figura.
Observe que algunas propiedades están presentes de forma predeterminada además de las propiedades que añada.
- Guarde los cambios en la configuración maestra y vuelva a iniciar WebSphere Application Server.
Ahora el servidor está preparado para desplegar los archivos de aplicación
Design Management Server.
Nota: En un sistema UNIX o bien Linux, si WebSphere Application Server se instala en un entorno que no es root, el usuario que instala Design Management Server debe disponer de acceso de lectura y escritura al directorio de instalación y todos los subdirectorios.
- Instale la aplicación JazzTeam Server:
- En la consola de administración, pulse .
- Debajo de Vía de acceso a la nueva aplicación, pulse Examinar para especificar la ubicación del archivo jts.war y pulse Siguiente. Si no ha instalado Apache Tomcat cuando instaló Design Management Server,
la ubicación predeterminada de este archivo es
dir_instalación/server/webapps.
Si ha instalado Tomcat, la ubicación predeterminada es dir_instalación/server/tomcat/webapps.
- Debajo de ¿Cómo desea instalar la aplicación?,
pulse FastPath y a continuación, pulse Siguiente.
- En la página Paso 1: Seleccionar opciones de instalación, acepte las opciones predeterminadas y pulse Siguiente.
- En la página Paso 2: Correlacionar módulos con servidores,
seleccione la casilla situada junto a <app>.war, donde
<app> es el nombre de la aplicación que está instalando.
Asegúrese de que el servidor o clúster de destino sean correctos y pulse
Siguiente.
- En la página Paso 3: Correlacionar hosts virtuales para módulos
web, seleccione la casilla situada junto a
<app>war y pulse Siguiente.
- En la página Paso 4: Correlacionar raíces de contexto para módulos
web, establezca Raíz de contexto en
/<app>, donde <app> es la raíz
de contexto de las aplicaciones.
Por ejemplo, si instala dm.war, la raíz de contexto puede ser
dm, pulse Siguiente.
- Pulse Finalizar.
- Dependiendo de las aplicaciones que instale en el servidor, repita los pasos de
instalación para los archivos war siguientes y las raíces de contexto
correspondientes:
| Opción |
Descripción |
| dm.war (aplicación Design Management) |
/dm |
| admin.war (aplicación Jazz Team Server) |
/admin |
| vvc.war (aplicación Design Management) |
/vvc |
| rdmhelp.war (aplicación Design Management) |
/rdmhelp |
| clmhelp.war (aplicación Jazz Team Server) |
/clmhelp |
| rsadm.war (aplicación Design Management) |
/rsadm |
| vvchelp.war (aplicación Configuration Management) |
/vvchelp |
| jts.war (aplicación Jazz Team Server) |
/jts |
- En el servidor donde reside Jazz Team Server (jts.war), necesitará asignar
roles de seguridad en el servidor de aplicaciones Websphere. Asigne los roles de
seguridad de la aplicación JazzTeam Server
a usuarios y grupos del dominio de seguridad. Configurar la seguridad sobrepasa el ámbito de esta tarea, pero en la mayoría de los casos en los que el dominio de seguridad real utiliza un registro LDAP, debe correlacionar grupos en el registro LDAP con los siguientes roles de seguridad de la aplicación:
- JazzAdmins
- JazzDWAdmins
- JazzProjectAdmins
- JazzGuests
- JazzUsers
- Pulse .
- Debajo de Propiedades detalladas, pulse Rol de seguridad para la correlación de usuarios/grupos. Esta página muestra los grupos de usuarios para Design Management Server que hay que correlacionar con usuarios o grupos del dominio de seguridad.
- Seleccione un rol y pulse Correlacionar grupos para correlacionar ese rol con un grupo en el dominio de seguridad.
Nota: No habilite la opción ¿Todo autenticado?.
- Verifique si las instalaciones se han instalado satisfactoriamente y a continuación, guarde los cambios en la configuración maestra para WebSphere Application Server.
- Añada la siguiente propiedad personalizada de gestión de sesión para evitar el mensaje de error SESN0008E cuando un usuario cierra
sesión sin terminar la sesión:
- En WebSphere Integrated Solutions Console, pulse .
- Pulse server1 y en la sección Valor del contenedor, pulse Gestión de la sesión.
- En la sección Propiedades adicionales, pulse Propiedades personalizadas.
- Pulse Nuevo y especifique la siguiente información: Nombre: InvalidateOnUnauthorizedSessionRequestException Valor: true
- Pulse Aplicar y guarde directamente en la configuración maestra.
- Después de guardar en la configuración maestra, detenga y reinicie el servidor.
- En la consola de administración de WebSphere Application Server, pulse para confirmar que todas las aplicaciones están en ejecución.
Resultados
Aparecen unas flechas verdes junto a las aplicaciones para indicar que se han iniciado correctamente.
Qué hacer a continuación
Ahora puede configurar
Design Management Server tal como se describe en
Instalación y configuración de Design Management Server.