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é.
- Consultez le journal repotools-jts_importURLMappings.log.
Vérifiez que la commande a abouti.
- Arrêtez Jazz Team
Server.
- Exécutez repotools-jts -exportServerRenameURLMappingHistory
toFile=history.txt.
Le fichier history.txt
affiche l'historique des événements de mappage qui ont été créés. Vérifiez que les
résultats correspondent à vos attentes. Vérifiez également si l'événement de mappage indique
"TERMINE". Si tous les événements de mappage sont terminés,
cela signifie que Jazz Team
Server a achevé le traitement et qu'il n'existe plus aucun renommage en cours.
Pour plus de détails, voir Examen d'un historique des changements de noms de serveur.
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é
- 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.
- 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.
- 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.
- 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.
- Consultez les journaux de Jazz Team
Server et
des applications pour obtenir des informations détaillées sur les messages d'erreur.
- 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é.
- Consultez le journal d'application pour déterminer si le renommage a été effectué
intégralement.
- Arrêtez l'application.
- 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>
- 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.
- 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.
- Consultez le fichier journal de Jazz Team
Server
pour identifier l'étape de finalisation défaillante.
- 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.
- 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 :
- Arrêtez l'application.
- 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.
- 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.