Erreurs importURLMappings

Cette rubrique décrit les procédures de reprise à appliquer si des erreurs se produisent lors de l'exécution de la commande importURLMappings.

Si une erreur se produit lors de l'exécution de la commande importURLMappings, vous pouvez consulter le fichier RépInstallJazz/server/repotools-jts_importURLMappings.log.

Il manque une entrée de mappage dans le fichier de mappages

Si vous constatez qu'il manque une entrée dans le fichier de mappages d'origine, comme par exemple une paire source-cible pour l'une des applications CLM, procédez comme suit :

  1. Arrêtez votre serveur.
  2. Créez un fichier de mappages qui comporte uniquement l'entrée manquante.
  3. Appliquez le nouveau fichier de mappages en exécutant à nouveau la commande repotools-jts -importUrlMappings.

L'URL cible d'un mappage comporte une erreur

Si vous avez fait une erreur dans une URL cible, appliquez la procédure corrective suivante. Les corrections sont cumulatives, c'est-à-dire que vous pouvez les effectuer à tout moment tant que le serveur n'est pas arrêté. Ces corrections peuvent concerner plusieurs entrées mais les entrées ajoutées doivent se limiter à la correction des erreurs. N'ajoutez pas les URL qui, selon vous, sont mappées correctement. Supposons que votre fichier de mappages d'origine comporte l'entrée suivante :
...
source=https://myOriginalUrl
target=https://myTargetUrlWithATypo
...
  1. Arrêtez le serveur.
  2. Créez un fichier de mappages qui comporte le mappage correctif. N'ajoutez pas cette entrée dans le fichier de mappages d'origine. L'entrée doit ressembler à ceci :
    source=https://myTargetUrlWithATypo
    target=https://myCorrectTargetUrl
  3. Appliquez le nouveau fichier de mappages en exécutant à nouveau la commande repotools-jts -importUrlMappings.

L'URL source d'un mappage comporte une erreur

Le processus est similaire à celui décrit dans la section précédente mais il est un peu plus compliqué car vous devez effectuer deux mappages correctifs séparément. Supposons que votre fichier de mappages d'origine comporte l'entrée suivante :

...
source=https://myOriginalUrlWithATypo
target=https://myTargetUrl
...
  1. Créez un fichier de mappages qui comporte le mappage correctif suivant. L'objectif de ce fichier de mappages est d'écarter la cible, myTargetUrl.
    source=https://myTargetUrl
    target=dummy://aDummyUrl
  2. Appliquez le nouveau fichier de mappages en exécutant à nouveau la commande repotools-jts -importUrlMappings. Appliquez le mappage correct de la façon suivante :
    source=https://myOriginalUrl
    target=https://myTargetUrl

Ne tentez pas de combiner ces mappages en un seul fichier. Les mappages correctifs ci-dessus doivent être appliqués séparément de sorte que le système puisse se corriger tout seul sans ambiguités.

Vous avez involontairement inversé la source et la cible dans le fichier de mappage

Par exemple, votre postulat initial est le suivant :

...
source=https://myTargetUrl
target=https://mySourceUrl
...
Important : Ce scénario ne peut être mis en oeuvre que par le biais des procédures de reprise générales.

Pour remédier à cette situation, vous devez suivre les règles de reprise générales. Le problème est le suivant : un tel mappage indique que l'application située à l'adresse https://myTargetUrl réside également à l'adresse https://mySourceUrl. Comme c'est l'endroit où réside également votre application, une ambiguité ne pouvant être levée est créée.

Le mappage comporte une erreur de syntaxe

Corrigez l'erreur et exécutez à nouveau la commande importURLMappings.

La commande échoue sur l'erreur CRJAZ2436E

Le renommage de serveur n'est pas pris en charge dans un cluster. Jazz Team Server et les serveurs d'applications CLM doivent rester en dehors du cluster pour les parties hors ligne et en ligne de l'opération de renommage.

La commande échoue sur l'erreur CRJAZ2449E

Une mise à niveau a démarré mais n'a pas abouti. Cette situation se produit généralement lorsqu'une opération de renommage est tentée avant la fin d'une mise à niveau en ligne. Une migration en ligne doit être effectuée pour l'application Gestion des exigences (RM) à la fin de la mise à niveau hors ligne. Achevez la mise à niveau en ligne. Pour plus de détails, voir roadmap_clm_upgrade.html. Arrêtez le serveur et exécutez à nouveau la commande importURLMappings.

La commande affiche l'avertissement CRJAZ2425W

Cet avertissement indique que le fichier d'événements de mappage ne contient pas de nouveaux mappages. Cela arrive si le même fichier de mappage est importé deux fois ou que le fichier d'événements de mappage généré initialement n'a pas été mis à jour pour spécifier les URL cible. Vérifiez que l'argument du fichier de mappage pointe sur le fichier correct et validez le contenu du fichier.

La commande affiche le message CRJAZ2197E

Des erreurs sont consignées dans le journal importURLMappings avec un message CRJAZ2197E, ou le message CRJAZ2197E apparaît lorsque vous démarrez le serveur après avoir exécuté la commande importURLMappings.

Ce message indique : L'URI public de ce serveur est déjà défini sur https://jts.source.exemple.org:9443/jts. Il ne peut pas être remplacé par https://jts.target.exemple.org:9443/jts une fois le serveur configuré. Si le serveur a été placé à un nouvel emplacement : https://jts.target.exemple.org:9443/jts, suivez les instructions de renommage du serveur.

Chaque fois que la commande importURLMappings échoue, les URL contenues dans le fichier JTS teamserver.properties sont restaurées à leurs valeurs d'origine. Si ce n'est pas le cas, vous pouvez mettre à jour manuellement le fichier teamserver.properties pour qu'il contienne l'adresse URL d'origine et exécuter à nouveau importURLMappings, ou redémarrer le serveur.


Commentaires