Partager via

Dépannage du convertisseur ClearQuest

  • Article

Mise à jour : novembre 2007

Si des problèmes surviennent pendant la migration des éléments de travail de ClearQuest vers Team Foundation Server, le convertisseur ClearQuest enregistre les erreurs et les avertissements dans un fichier de rapport. La meilleure façon de résoudre les problèmes est d'examiner le fichier de rapport pour déterminer ce qui s'est passé. Les informations suivantes vous assistent dans la résolution des problèmes et des erreurs qui surviennent avec le convertisseur ClearQuest.

Dans cette section

Résolution des problèmes d'analyse

Le fichier license.dll est introuvable

L'analyse a échoué et aucun rapport d'analyse n'a été créé

Résolution des problèmes de migration

La commande Migrate échoue

Erreurs critiques lorsque le convertisseur se connecte

Erreurs critiques lors de l'activation des types d'éléments de travail

Les sections du rapport d'analyse ou du rapport de migration ne se développent pas

Les modifications du schéma d'élément de travail ne migrent pas vers Team Foundation Server

La migration d'éléments de travail échoue en raison de l'échec du téléchargement des pièces jointes

Résolution des problèmes d'analyse

Lorsque les problèmes naissent de l'exécution de la commande Analyze, une erreur est signalée à la console, et le fichier de rapport est généré avec les détails concernant les problèmes survenus. Le plus souvent, vous pouvez corriger la cause de l'erreur et redémarrer le convertisseur. Si vous n'êtes pas sûr de la cause d'une erreur, recherchez le numéro d'erreur ou le texte exact dans l'aide de Team Foundation. Certaines erreurs répertorient également une erreur interne qui a été signalée à partir de l'API ClearQuest que le convertisseur utilise. Pour ces erreurs, des informations supplémentaires sont disponibles dans la documentation ClearQuest.

Le fichier license.dll est introuvable

Lorsque vous exécutez la commande Analyze, vous pouvez recevoir l'erreur "Cette application n'a pas démarré car license.dll est introuvable. La réinstallation de cette application peut corriger ce problème." Une fois que vous avez cliqué sur OK, vous recevez une autre erreur, en l'occurrence "TF61118 : échec de l'appel de l'API ClearQuest, accompagné de l'erreur suivante : La récupération de la fabrique de classe COM pour le composant avec le CLSID {94773112-72E8-11D0-A42E-00A024DED613} a échoué en raison de l'erreur suivante : 8007007e. Consultez la documentation de ClearQuest pour obtenir de l'aide".

Ces erreurs se produisent lorsque le convertisseur ne parvient pas à charger les bibliothèques ClearQuest, parce que le chemin des bibliothèques n'est pas configuré correctement.

Solution

  • Vérifiez que le client ClearQuest est installé sur l'ordinateur. Cela installe les bibliothèques nécessaires.

  • Vérifiez que vous n'exécutez pas le convertisseur à partir d'une fenêtre de console lancée avant l'installation de ClearQuest. Si tel est le cas, ouvrez une nouvelle fenêtre de console et réexécutez le convertisseur.

  • Vérifiez que la variable d'environnement PATH n'a pas été modifiée après l'installation de ClearQuest. La variable d'environnement PATH doit contenir des chemins d'accès aux fichiers DLL installés par ClearQuest. Si ces chemins d'accès sont manquants, vous devez peut-être réinstaller ClearQuest.

L'Analyse a échoué et aucun rapport d'analyse n'a été créé

Si le convertisseur ne parvient pas à charger le fichier de configuration, la commande Analyze échoue et aucun rapport n'est créé.

Solution

  • Utilisez un éditeur ou outil XML et vérifiez que le fichier de configuration XML est correct.

  • Vérifiez que les éléments XML et les attributs du fichier de configuration sont spécifiés correctement. Si vous recevez des erreurs de validation, le message d'erreur indique la valeur non prise en charge, ainsi que le numéro de ligne où se trouve la valeur. Pour plus d'informations, consultez Fichier de configuration du convertisseur d'éléments de travail.

Résolution des problèmes de migration

Lorsque le convertisseur est exécuté avec la commande Migrate, une erreur peut survenir à plusieurs niveaux. Premièrement, le convertisseur lit le fichier de configuration et se connecte à la base de données ClearQuest à l'aide des informations de connexion spécifiées. Ensuite, le convertisseur active les types d'éléments de travail spécifiés sur Team Foundation Server. Enfin, le convertisseur effectue une migration des éléments de travail de ClearQuest à Team Foundation Server.

À mesure que le convertisseur s'exécute, il imprime des messages d'état sur la console. Vous pouvez utiliser les messages d'état pour déterminer à quel point la migration a échoué. Par exemple, si le dernier message d'état réussi était "Validation des utilisateurs dans Team Foundation", il est probable que l'erreur concerne le fichier de mappage de l'utilisateur.

La solution pour résoudre les problèmes de migration est d'examiner toutes les erreurs signalées. Les erreurs sont signalées comme suit.

  1. Un message s'affiche sur la console et indique les erreurs survenues. Par exemple, s'il y a 2 avertissements et 1 erreur, vous recevez le message suivant : La migration s'est terminée avec 2 avertissement(s), 1 erreur(s).

  2. Un fichier de rapport de migration est créé et contient des informations plus spécifiques à propos des avertissements et des erreurs. Le nom du fichier de rapport est CQMigrationReport.xml.

Remarque :

Dans certains cas, le convertisseur peut ne pas générer de fichier de rapport, et vous ne verrez qu'une sortie de message d'erreur sur la console.

La commande Migrate échoue

Lors de la migration, le convertisseur peut rencontrer une erreur critique à n'importe quel moment. Une erreur critique arrête le convertisseur et plus aucun élément de travail n'est migré. Une erreur critique peut se produire avant que les éléments de travail ne soient réellement migrés, ou encore après que certains d'entre eux l'ont été. Lorsque la migration échoue, vous rencontrez l'un des deux symptômes suivants :

  • Vous constatez une erreur critique et le message "Échec de la migration" dans CQMigrationReport.xml, le fichier de rapport de migration. Vous remarquez une chaîne dans le fichier de rapport similaire à la suivante : Echec de la migration {1 Erreur critique | 2 Erreurs | 4 Avertissements }.

  • La migration échoue avec une sortie d'erreur sur la console, mais aucun rapport n'est généré.

Solution

  • Résolvez la source de l'erreur et redémarrez le convertisseur. Lorsque vous redémarrez le convertisseur, il n'effectue pas à nouveau la migration des éléments de travail déjà migrés. Le convertisseur ne crée pas d'éléments de travail en double.

  • Les causes d'échecs critiques varient. Il en est de même pour les messages d'erreur. La plupart des messages d'erreur fournissent des informations identifiant la raison de ce qui ne marche pas. En outre, vous trouverez plus d'informations sur certaines erreurs en recherchant le texte de l'erreur dans l'aide de Team Foundation. Enfin, examinez les problèmes de dépannage relatifs à la commande Analyze répertoriés précédemment dans cette rubrique. Bon nombre de ces mêmes problèmes s'appliquent à la commande Migrate.

Erreurs critiques lorsque le convertisseur se connecte

Les erreurs critiques peuvent se produire lorsque le convertisseur essaie de se connecter à ClearQuest ou à Team Foundation Server. Vous rencontrez un ou plusieurs messages d'erreur dans le rapport indiquant un problème de connexion.

Solution

Vérifiez que vous pouvez vous connecter à ClearQuest via le client ClearQuest et à Team Foundation Server via Team Explorer. Les problèmes de connexion sont fréquemment plus faciles à diagnostiquer via les messages de ces clients. En outre, n'oubliez pas de démarrer ces clients lorsque vous êtes connecté sous le compte d'utilisateur qui exécutera le convertisseur. Cela mettra en cache les données nécessaires pour que le convertisseur puisse s'exécuter correctement.

Erreurs critique lors de l'activation des types d'éléments de travail

Des erreurs critiques lors de l'activation des types d'éléments de travail peuvent survenir en raison des problèmes liés à la dénomination des champs. Vous rencontrez un message d'erreur qui ressemble au suivant :

"Échec de la migration en raison de "TF61013 : Le convertisseur n'a pas pu configurer le type d'élément de travail spécifié dans le fichier \\<NomOrdinateur>\e$\temp\CQOGF\Defect.xml en raison de l'erreur suivante : TF26177 : Le champ Microsoft.TeamFoundation.Converters.Priority_String ne peut pas être renommé de 'Priority String' en 'Priority String1'. Team Foundation ne prend pas en charge l'attribution de nouveaux noms aux champs."

Les champs de Team Foundation Server ont une portée d'attribution de nom au niveau serveur. La combinaison de Nom, Nom de référence, et Type pour un champ doit être unique sur le serveur. La phase d'analyse du convertisseur a une logique pour empêcher les conflits. Lorsque le convertisseur détecte un conflit, il modifie les noms de champs générés de manière appropriée. Toutefois, il peut y avoir un écart en termes de temps lorsque les noms de champs sont générés à partir de la commande Analysis et lorsque vous exécutez la commande Migration. Un type d'élément de travail sur le serveur peut être modifié dans cette période avant le conflit. Il se peut aussi que vous ayez modifié les types d'éléments de travail générés et que vous ayez choisi sans le savoir un nom qui entre en conflit avec un champ existant.

Solution

  • Modifiez vos types d'éléments de travail pour résoudre le conflit en modifiant le nom, le nom de référence, ou les deux. Souvent, vous pouvez simplement utiliser les noms de champs qui existent déjà. Pour consulter les types d'éléments de travail existants, vous devez exporter les fichiers de définition des types d'éléments de travail à partir de Team Foundation Server. Pour plus d'informations, consultez witexport.

  • Utilisez l'utilitaire en ligne de commande witfields pour renommer ou supprimer le champ en conflit sur Team Foundation Server. Toutefois, sachez que le changement de nom et la suppression de champs d'élément de travail existants n'est pas toujours possible. Pour plus d'informations, consultez witfields.

Les sections du rapport d'analyse ou du rapport de migration ne se développent pas

Les sections du rapport d'analyse ou de migration ne se développent pas correctement sous les paramètres de sécurité par défaut d'Internet Explorer. Les boutons Développer et Réduire sont contrôlés par les scripts et la sécurité Internet Explorer par défaut empêche les scripts de s'exécuter.

Solution

Vous pouvez résoudre ce problème en modifiant la sécurité Internet Explorer pour autoriser le contenu actif pour le rapport.

Pour modifier la sécurité en vue d'autoriser le contenu actif sur les rapports

  1. Recherchez la barre de sécurité jaune vers le haut du navigateur portant le message Pour vous aider à protéger votre ordinateur, votre navigateur Web a restreint l'affichage du contenu actif de ce fichier, qui pourrait accéder à votre ordinateur.

  2. Cliquez sur la barre de sécurité jaune, puis sur Autoriser le contenu bloqué.

  3. Dans la boîte de dialogue Avertissement de sécurité, cliquez sur Oui.

Les modifications du schéma d'élément de travail ne migrent pas vers Team Foundation Server

Les modifications du schéma d'élément de travail ne sont pas appliquées si le type d'élément de travail a déjà été activé. C'est ce qui se produit en général lorsque vous exécutez la commande Migrate une fois, modifiez les définitions du type d'élément de travail dans les fichiers de mappage de schéma, puis exécutez à nouveau la commande Migrate. Les modifications n'apparaissent pas dans Team Foundation Server. Par ailleurs, l'avertissement suivant apparaît dans le rapport de migration : "Impossible de créer le type d'élément de travail <NomType> car il existe déjà sur votre serveur Team Foundation Server."

Le convertisseur dispose de contrôles explicites pour s'assurer qu'il ne remplace pas un type d'élément de travail existant. Par conséquent, dès que le type d'élément de travail est activé par le convertisseur, même si vous modifiez le type d'élément de travail, les modifications ne sont pas incorporées car le type d'élément de travail a déjà été activé.

Solution

Pour mettre à jour les types d'élément de travail sur le serveur Team Foundation, utilisez l'utilitaire en ligne de commande witimport pour importer les types d'élément de travail vers Team Foundation Server. Le convertisseur utilise ensuite les types mis à jour lorsque vous effectuez une migration des éléments de travail. Veillez à ne pas modifier ou supprimer des données d'élément de travail lorsque vous utilisez l'utilitaire en ligne de commande witimport. Pour plus d'informations, consultez witimport.

La migration d'éléments de travail échoue en raison de l'échec du téléchargement des pièces jointes

Si les pièces jointes sont plus grandes que la taille autorisée, elles ne sont pas migrées. En outre, l'erreur suivante est répertoriée dans le fichier de rapport de migration : "TF61015 : l'enregistrement de la pièce jointe <NomFichier> a échoué pour l'élément de travail <ID>, accompagné de l'erreur suivante : la taille du fichier en cours de téléchargement est supérieure à la taille maximale de téléchargement autorisée (4 Mo)."

Solution

  • Pour résoudre ce problème, vous pouvez augmenter la taille maximale des pièces jointes sur le serveur Team Foundation. La taille par défaut est de 4 Mo, mais vous pouvez l'augmenter jusqu'à 2 Go (2147483648 octets).

Pour définir la taille maximale des pièces jointes pour les éléments de travail

  1. Dans Internet Explorer, recherchez l'URL suivante :

    http://<tfsserver>:8080/WorkItemTracking/v1.0/ConfigurationSettingsService.asmx?op=SetMaxAttachmentSize

    où <tfsserver> représente le nom du serveur Team Foundation.

  2. Dans la zone MaxSize, entrez la taille maximale des pièces jointes en octets, puis cliquez sur Appeler. La taille maximale des pièces jointes est de 2 gigaoctets.

Remarque :

Pour exécuter cette procédure, vous devez être membre du groupe Administrateurs sur le serveur de couche Application Team Foundation et membre du groupe Team Foundation Administrators. Pour plus d'informations, consultez Autorisations de Team Foundation Server.

Voir aussi

Concepts

Autorisations de Team Foundation Server

Autres ressources

Résolution des problèmes de migration d'élément de travail