Errores de la interfaz de usuario en el estado de redenominación del servidor

En este tema se describen los procedimientos de resolución de problemas y de recuperación de anomalías durante el proceso de redenominación en línea.

La interfaz de usuario del estado de redenominación del servidor sondea las aplicaciones para comprobar los estados individuales de la redenominación. Si falla alguna redenominación de aplicación, no se llevará a cabo la acción completa de redenominación del servidor. Si detecta una anomalía, lo primero que debe hacer es comprobar el Jazz Team Server y los registros de aplicaciones para ver qué ha ido mal. A continuación se muestra una lista de errores habituales y cómo corregirlos.

La interfaz de usuario indica que no se ha iniciado ninguna redenominación

Tras ejecutar importURLMappings, verá /serverRenameStatus que indica que no se ha iniciado la redenominación de un servidor.

No se le redirige a la página serverRenameStatus tras una redenominación.

Este comportamiento es el previsto si ya se ha completado la redenominación. Para comprobarlo, vaya a https://jts.example.org:9443/jts/serverRenameStatus y compruebe que todo esté al 100% y de color verde.

Anomalía en la redenominación de aplicación

  1. Compruebe que la aplicación se está ejecutando y que se puede realizar la acción ping desde el Jazz Team Server.
  2. Compruebe que puede llegar a cada rootservices de las aplicaciones en el navegador. En el caso de CCM, consulte https://ccm.example.org:9443/ccm/rootservices. Repita los pasos para las demás aplicaciones.
  3. Si la aplicación no está en ejecución, iníciela. No es necesario iniciar el Jazz Team Server. Se continuará el sondeo de la aplicación para comprobar el estado. Cuando la aplicación vuelva a estar en línea, el estado se actualizará en la interfaz de usuario.
  4. Si la aplicación se está ejecutando, verifique que puede ponerse en contacto con la aplicación como, por ejemplo CCM, en https://ccm.example.org:9443/ccm/appServerRenameStatus. Si obtiene un error 404, indica que la aplicación no es una aplicación de la versión 4.0. Una aplicación debe ser de la versión 4.0 o posterior para dar soporte a la redenominación del servidor. Puede llevar a cabo una actualización antes de redenominar un servidor. Para obtener detalles, consulte roadmap_clm_upgrade.html.
  5. Consulte el Jazz Team Server y los registros de la aplicación para obtener los mensajes de error más detallados.
  6. Compruebe que haya un archivo .mappingEvent en el directorio server/conf/ de todas las aplicaciones.

La interfaz de usuario muestra que se ha completado la acción de redenominación pero que hay errores

En este caso, la interfaz de usuario muestra que se ha completado la redenominación, pero que hay errores cuando se realiza una acción en la aplicación. Esto indica que la redenominación no se ha completado.

  1. Busque en el registro de la aplicación para determinar si se ha completado la redenominación global.
  2. Detenga la aplicación.
  3. Abra el archivo WAR de la aplicación y vaya a WEB/web.xml. Busque los elementos siguientes en el XML:
    
    <filter>
       <filter-name>bridgefilter</filter-name>
       <filter-class>com.ibm.team.repository.server.servletbridge.BridgeFilter</filter-class>        
    </filter>
             
    <filter-mapping>
       <filter-name>bridgefilter</filter-name>
       <servlet-name>equinoxbridgeservlet</servlet-name>
    </filter-mapping>
  4. Si no existen estas entradas, las aplicaciones nunca sabrán que se ha completado la redenominación global. Añada las entradas y vuelva a desplegar el archivo WAR. Reinicie el servidor de aplicaciones y abra una página en el navegador que desencadenará que se inicie la aplicación. Por ejemplo, vaya a https://ccm.example.org:9443/ccm/admin para la aplicación CCM.
  5. Compruebe que los otros archivos WAR de la aplicación contengan las entradas y lleve a cabo el mismo conjunto de pasos si las entradas no existen.

Anomalía en la finalización de la redenominación del servidor

Se producen una serie de acciones en el Jazz Team Server tras finalizar todas las redenominaciones de aplicaciones.

  1. Compruebe el registro del Jazz Team Server para determinar qué paso de la finalización ha fallado.
  2. Es posible que se produzca un error en la actualización del almacén de datos. Verifique que la configuración del almacén de datos sea correcta y que el servidor de bases de datos esté disponible.
  3. Tras identificar el problema, siga los procedimientos generales de recuperación. No es posible volver a intentar el paso de finalización.

Falta un archivo de suceso de correlación

Si su entorno es distribuido, es posible que no se haya copiado un archivo de suceso de correlación en el directorio de configuración de la aplicación. Compruebe que el directorio server/conf/ de la aplicación que falla contenga un archivo .mappingEvent. Si no hay ningún archivo .mappingEvent, haga lo siguiente:

  1. Detenga la aplicación.
  2. Copie el archivo .mappingEvent del directorio server/conf/jts en el directorio server/conf de la aplicación.
    Nota: Todos los archivos .mappingEvent de una determinada topología JTS son idénticos.
  3. Reinicie el servidor de aplicaciones. No es necesario reiniciar el Jazz Team Server. Se continuará el sondeo de la aplicación para comprobar el estado. Una vez de nuevo la aplicación en línea, se actualizará el estado en la interfaz de usuario.

Comentarios