Partager via

Dépannage du convertisseur VSS

  • Article

Mise à jour : novembre 2007

Cette section contient des informations sur la résolution de problèmes courants que vous pouvez rencontrer lorsque vous effectuez une migration vers le contrôle de version Team Foundation à partir de Microsoft Visual SourceSafe 2005 à l'aide du convertisseur VSS.

Dans cette section

Limitations de l'espace disque

Une version incorrecte de Ssapi.dll est enregistrée

Les versions de fichiers et de dossiers ne sont pas migrées à cause d'une altération de VSS et de problèmes IVSS

Le convertisseur VSS ne prend pas en charge tous les scénarios Visual SourceSafe

L'espace disque de la couche Données Team Foundation est saturé pendant la migration

Le convertisseur VSS est arrêté

Le mot de passe de l'utilisateur qui exécute le convertisseur VSS a expiré

Messages d'erreur lors de l'ouverture des fichiers solution migrés

Limitations de l'espace disque

Si l'espace disque de l'ordinateur sur lequel le convertisseur VSS s'exécute est insuffisant ou saturé, l'erreur suivante s'affiche :

VSS Error: Disk out of space

Solution

  • Pendant la migration, le convertisseur VSS télécharge les fichiers dans un dossier local du lecteur système, puis les transfère vers Team Foundation. En outre, il a besoin d'un espace disque pour stocker un fichier journal, un fichier de rapport et des métadonnées dans SQL Express.

  • Si vous constatez que l'espace disque est faible, vous pouvez arrêter la migration en appuyant sur Ctrl-C. Vous pouvez la redémarrer au point où elle s'est arrêtée en utilisant la fonction de migration incrémentielle. Toutefois, vous devez créer un espace disque supplémentaire sur le lecteur système avant de redémarrer la migration.

  • Si aucun espace disque n'est disponible, vous constatez que les fichiers de taille nulle sont migrés. Dans ce cas, vous devez arrêter la migration en appuyant sur Ctrl+C puis recommencer l'opération.

  • Nous vous recommandons de maintenir 10Go d'espace disque disponible sur le lecteur où vous exécutez la migration.

Une version incorrecte de Ssapi.dll est enregistrée

Si une version incorrecte de ssapi.dll est enregistrée, le convertisseur VSS tombe en panne avec l'erreur suivante :

Unable to cast COM object of type 'Microsoft.VisualStudio.SourceSafe.Interop.VSSDatabaseClass' to interface type 'Microsoft.VisualStudio.SourceSafe.Interop.IVSSDatabase'. This operation failed because the QueryInterface call on the COM component for the interface with IID '{2A0DE0EE-2E9F-11D0-9236-00AA00A1EB95}' failed with HRESULT: 0x80004002 (No such interface supported (Exception from HRESULT: 0x80004002 (E_NOINTERFACE))). Unhandled exception caught.

En outre, le convertisseur VSS affiche le message d'erreur "le convertisseur VSS nécessite Microsoft Visual SourceSafe 2005 ou une version ultérieure" ou "Microsoft Visual SourceSafe 2005 n'est pas installé", bien que Microsoft Visual SourceSafe 2005 soit déjà installé.

Solution

Le convertisseur VSS nécessite Microsoft Visual SourceSafe 2005 ou une version supérieure sur l'ordinateur sur lequel vous exécutez la migration. Vous pouvez également rencontrer ce problème si vous avez installé une ancienne version de Visual SourceSafe, en plus de Microsoft Visual SourceSafe 2005. Ce problème se produit lorsque l'ancienne version de ssapi.dll est enregistrée à la place du ssapi.dll qui a été fourni avec Microsoft Visual SourceSafe 2005. Pour résoudre ce problème, désinstallez l'ancienne version de Visual SourceSafe et de Microsoft Visual SourceSafe 2005et réinstallez uniquement Microsoft Visual SourceSafe 2005.

Les versions de fichiers et de dossiers ne sont pas migrées à cause d'une altération de VSS et de problèmes IVSS

Si les versions de fichiers et de dossiers ne sont pas migrées à cause d'une altération de Visual SourceSafe et de problèmes IVSS, de nombreux avertissements de perte de données et erreurs peuvent s'afficher dans les fichiers de rapport. Ceci est dû au fait qu'une ou les deux erreurs suivantes se sont produites :

  • Les versions tip dans Visual SourceSafe ne correspondent pas aux versions tip dans Team Foundation.

  • Les versions de fichiers et de dossiers associées à une étiquette dans Visual SourceSafe ne correspondent pas exactement aux versions de fichiers et de dossiers dans Team Foundation.

Solution

  • Visual SourceSafe peut subir une altération lorsqu'il est utilisé pendant une longue période. En raison de cette altération, le convertisseur VSS ne peut pas migrer certaines versions de fichiers et de dossiers. Il utilise l'API IVSS pour accéder à la base de données Visual SourceSafe, alors que l'interface utilisateur et la ligne de commande Visual SourceSafe n'utilisent pas IVSS. Dans quelques cas, vous pouvez récupérer les versions Visual SourceSafe par le biais de l'interface utilisateur ou de la ligne de commande, mais vous ne pouvez pas les récupérer par le biais d'IVSS. La migration de ces versions de fichiers et de dossiers risque d'échouer.

  • Après une migration réussie, vous devez comparer les dernières versions de fichiers et de dossiers dans Visual SourceSafe aux dernières versions de fichiers et de dossiers migrées dans le contrôle de version Team Foundation à l'aide d'un utilitaire de comparaison de fichier tel que l'outil WinDiff. Si vous détectez des différences entre les versions de fichiers et de dossiers, migrez manuellement la version la plus récente.

    Remarque :

    Après la migration, il n'existe aucune méthode pour mettre en correspondance les versions de fichiers et de dossiers associées à une étiquette dans Visual SourceSafe avec les versions de fichiers et de dossiers dans le contrôle de version Team Foundation.

Le convertisseur VSS ne prend pas en charge tous les scénarios Visual SourceSafe

Le convertisseur VSS ne prend pas en charge tous les scénarios ou toutes les séquences d'actions dans Visual SourceSafe. Si vous avez des versions tip ou des étiquettes dissociées, de nombreuses erreurs, ou éventuellement aucune erreur, peuvent s'afficher dans les fichiers de rapport. En examinant les fichiers et les dossiers migrés, l'une des conditions suivantes peut s'afficher :

  • Les versions tip dans Visual SourceSafe ne correspondent pas à la version la plus récente dans le contrôle de version Team Foundation.

  • Les versions de fichiers et de dossiers associées à une étiquette dans Visual SourceSafe ne correspondent pas exactement aux versions de fichiers et de dossiers dans le contrôle de version Team Foundation.

  • Les fichiers et les dossiers sont migrés avec des noms incorrects.

Quelques-uns des scénarios Visual SourceSafe non pris en charge par le convertisseur VSS sont :

  • Un fichier ou dossier est renommé et déplacé plusieurs fois.

  • Le dossier archivé est restauré sur un autre dossier qui figure dans la même base de données ou dans une base de données Visual SourceSafe différente.

  • Les fuseaux horaires peuvent poser des problèmes. Le convertisseur VSS résout certains problèmes de fuseau horaire éventuels. Mais il ne peut pas les résoudre tous. Pour plus d'informations sur les problèmes de fuseau horaire, consultez l'article « BUG: Using SourceSafe in Multiple Time Zones » de la Base de connaissances Microsoft (https://go.microsoft.com/fwlink/?LinkId=59976).

Solution

Après une migration réussie, vous devez comparer les dernières versions de fichiers et de dossiers dans Visual SourceSafe aux dernières versions de fichiers et de dossiers migrées dans le contrôle de version Team Foundation à l'aide d'un utilitaire de comparaison de fichier tel que l'outil WinDiff. Si vous détectez des différences entre les versions de fichiers ou de dossiers, vous devez migrer manuellement la version la plus récente.

Remarque :

Après la migration, il n'existe aucune méthode pour mettre en correspondance les versions de fichiers et de dossiers associées à une étiquette dans Visual SourceSafe et les versions de fichiers et de dossiers dans le contrôle de version Team Foundation.

L'espace disque de la couche Données Team Foundation est saturé pendant la migration

Si l'espace disque de la couche Données Team Foundation est saturé pendant la migration, les erreurs suivantes s'affichent à plusieurs reprises sur la console :

  • Migration impossible en raison d'une erreur Team Foundation : erreur SQL xxxx : espace disque insuffisant.

  • Team Foundation ne répond pas. Nouvelle tentative……

  • Migration impossible en raison d'une erreur Team Foundation : erreur SQL xxxx : journal des transactions plein. TF30042 : la base de données est pleine. Contactez votre administrateur Team Foundation Server.

Solution

Les données de contrôle de code source sont stockées sur la couche Données Team Foundation. Étant donné que le convertisseur VSS migre l'historique des mois ou des années dans la plage d'heures ou de jours, l'espace disque de la couche Données est parfois saturé.

  • Vous pouvez redémarrer la migration au point où elle s'est arrêtée à l'aide de la fonction de migration incrémentielle. Pour plus d'informations, consultez Comment : effectuer une migration par incrément vers Team Foundation. Toutefois, vous devez créer un espace disque supplémentaire sur la couche Données avant de recommencer la migration.

  • Si le journal des transactions est plein, vous devez l'effacer en supprimant son contenu.

    Remarque importante :

    Sauvegardez le journal des transactions avant de l'effacer.

Le convertisseur VSS est arrêté

Le convertisseur VSS peut être arrêté à cause d'un incident ou parce que l'ordinateur sur lequel il s'exécute est redémarré à cause d'une panne d'alimentation, d'une mise à jour de sécurité ou une autre raison.

Solution

Vous pouvez redémarrer la migration au point où elle s'est arrêtée à l'aide de la fonction de migration incrémentielle. Pour plus d'informations, consultez Comment : effectuer une migration par incrément vers Team Foundation. Toutefois, vous devez déterminer si la défaillance du convertisseur VSS est due à un problème transitoire ou persistant. S'il s'agit d'un problème persistant, vous devez résoudre manuellement l'historique de l'élément à l'origine de la défaillance dans Visual SourceSafe.

Le mot de passe de l'utilisateur qui exécute le convertisseur VSS a expiré

Si le mot de passe de l'utilisateur a expiré, le message "Team Foundation ne répond pas. Nouvelle tentative……" * s'affiche à plusieurs reprises. En outre, le fichier journal répertorie SoapException pour les erreurs d'accès non autorisé ou d'autorisation refusée.

Solution

Si le mot de passe de l'identité de l'utilisateur avec lequel le convertisseur VSS s'exécute a expiré, arrêtez la migration en appuyant sur Ctrl+C. Déconnectez-vous puis reconnectez-vous avec un nouveau mot de passe. Vous pouvez redémarrer la migration au point où elle s'est arrêtée à l'aide de la fonction de migration incrémentielle. Pour plus d'informations, consultez Comment : effectuer une migration par incrément vers Team Foundation.

Messages d'erreur lors de l'ouverture des fichiers solution migrés

Si la liaison du contrôle de code source des fichiers migrés n'a pas été mise à jour, un message d'erreur s'affiche lorsqu'un utilisateur essaie d'ouvrir un fichier solution qui est lié à la base de données Visual SourceSafe.

Solution

Le convertisseur VSS ne modifie pas les informations de liaison du contrôle de code source dans le fichier solution. Par conséquent, le fichier solution est encore lié à Visual SourceSafe à partir de Team Foundation.

Pour corriger ce problème, vous devez migrer la liaison du contrôle de code source de Visual SourceSafe vers le contrôle de version Team Foundation. Pour plus d'informations, consultez Comment : effectuer la migration des liaisons du contrôle de code source provenant de Visual SourceSafe.

Remarque :

Vous pouvez également rencontrer des problèmes lors de l'ouverture des fichiers solution, qui sont dus à des problèmes de réseau transitoires ou à une panne du serveur Team Foundation Server.

Voir aussi

Tâches

Procédure pas à pas : migration de Visual SourceSafe vers Team Foundation

Concepts

Migration à partir de Visual SourceSafe