Erreurs d'interface utilisateur de statut de renommage de serveur

Cette rubrique décrit les procédures de traitement des incidents et de reprise à appliquer à la suite d'erreurs survenues lors du renommage en ligne.

L'interface utilisateur de statut de renommage de serveur interroge les applications afin de déterminer leur statut de renommage individuel. En cas d'échec d'une partie de renommage de serveur, le renommage de serveur global est interrompu. Si vous constatez une anomalie, la première chose à faire consiste à consulter les journaux de Jazz Team Server et les journaux des applications pour en connaître la cause. Voici la liste des erreurs les plus fréquentes et leurs solutions.

L'interface utilisateur indique qu'un renommage n'a pas démarré

Après avoir exécuté la commande importURLMappings, vous constatez dans /serverRenameStatus qu'un renommage de serveur n'a pas démarré.

Vous n'êtes pas redirigé vers la page serverRenameStatus après un renommage

Ce comportement est attendu si le renommage est déjà terminé. Pour vérifier, accédez à https://jts.exemple.org:9443/jts/serverRenameStatus et vérifiez que tous les éléments sont marqués à 100 % et qu'ils s'affichent en vert.

Le renommage de l'application a échoué

  1. Vérifiez que l'application est en cours d'exécution et que vous pouvez lui appliquer la commande ping à partir de Jazz Team Server.
  2. Vérifiez que vous pouvez accéder à chaque application rootservices dans le navigateur. Pour CCM, vérifiez https://ccm.exemple.org:9443/ccm/rootservices. Répétez la procédure pour les autres applications.
  3. Si l'application n'est pas en cours d'exécution, redémarrez-la. Il n'est pas nécessaire de redémarrer Jazz Team Server. Ce serveur continue d'interroger l'application afin de connaître son statut. Lorsque l'application revient en ligne, son statut est mis à jour dans l'interface utilisateur.
  4. Si l'application est en cours d'exécution, vérifiez que vous pouvez la contacter. Pour CCM par exemple, utilisez l'emplacement https://ccm.exemple.org:9443/ccm/appServerRenameStatus. Si une erreur 404 s'affiche, cela signifie que le niveau de version de l'application n'est pas 4.0. Une application doit être au niveau de version 4.0 ou ultérieur pour prendre en charge le renommage de serveur. Vous devez effectuer une mise à niveau avant d'effectuer le renommage de serveur. Pour plus de détails, voir roadmap_clm_upgrade.html.
  5. Consultez les journaux de Jazz Team Server et des applications pour obtenir des informations détaillées sur les messages d'erreur.
  6. Vérifiez qu'un fichier .mappingEvent est présent dans le répertoire server/conf/ de toutes les applications.

L'interface utilisateur montre que le renommage est terminé mais avec des erreurs

Dans ce cas, l'interface utilisateur montre que le renommage est terminé mais que des erreurs se sont produites lorsqu'une action a été effectuée sur l'application. Cela indique que le renommage n'est pas terminé.

  1. Consultez le journal d'application pour déterminer si le renommage a été effectué intégralement.
  2. Arrêtez l'application.
  3. Ouvrez le fichier war de l'application et accédez à WEB/web.xml. Recherchez les éléments suivants dans le fichier 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 ces entrées n'existent pas, les applications ne sont pas en mesure de déterminer que le renommage global est terminé. Ajoutez les entrées et redéployez le fichier war. Redémarrez le serveur d'applications et ouvrez une page dans le navigateur qui va lancer le démarrage de l'application. Par exemple, accédez à https://ccm.exemple.org:9443/ccm/admin pour l'application CCM.
  5. Vérifiez si les fichiers war des autres applications contiennent ces entrées et appliquez la même procédure si ces entrées n'existent pas.

L'étape de finalisation du renommage de serveur a échoué

Un certain nombre d'événements peuvent se produire sur Jazz Team Server une fois que tous les renommages de serveur sont terminés.

  1. Consultez le fichier journal de Jazz Team Server pour identifier l'étape de finalisation défaillante.
  2. Il est possible qu'une erreur se soit produite lors de la mise à jour de l'entrepôt de données. Vérifiez que la configuration de votre entrepôt de données est correcte et que le serveur de base de données est disponible.
  3. Après avoir identifié le problème, suivez les procédures de reprise générales. Il est possible de recommencer l'étape de finalisation.

Un fichier d'événement de mappage est manquant

Si vous travaillez dans un environnement réparti, il est possible qu'un fichier d'événement de mappage n'ait pas été copié dans le répertoire de configuration de l'application. Vérifiez que le répertoire server/conf/ de l'application en échec contient un fichier .mappingEvent. Si aucun fichier .mappingEvent n'est présent, procédez comme suit :

  1. Arrêtez l'application.
  2. Copiez le fichier .mappingEvent du répertoire server/conf/jts dans le répertoire server/conf de l'application.
    Remarque : Tous les fichiers .mappingEvent pour une topologie JTS donnée sont identiques.
  3. Redémarrez le serveur d'applications. Il n'est pas nécessaire de redémarrer Jazz Team Server. Ce serveur continuera d'interroger l'application pour connaître son statut. Lorsque l'application revient en ligne, son statut est mis à jour dans l'interface utilisateur.

Commentaires