Procédure pas à pas : préparation pour effectuer une migration de Visual SourceSafe vers Team Foundation
Mise à jour : novembre 2007
L'outil Convertisseur Visual SourceSafeTeam Foundation transfère des fichiers, dossiers, un historique des versions et des informations utilisateur d'une base de données Visual SourceSafe à un serveur de contrôle de version Team Foundation. Avant de déplacer des fichiers et des informations sur l'historique vers Team Foundation, vous devez analyser et effectuer une copie de sauvegarde de la base de données, archiver autant de fichiers que possible et savoir quelles informations ne peuvent pas être transférées de Visual SourceSafe vers Team Foundation.
Cette procédure pas à pas explique comment préparer la conversion de votre base de données Visual SourceSafe et comment utiliser VSSConverter pour planifier efficacement la migration de la source.
Dans cette procédure pas à pas, vous effectuerez les tâches suivantes :
Réaliser une sauvegarde de votre base de données Visual SourceSafe.
Identifier et résoudre des problèmes d'intégrité des données dans votre base de données existante à l'aide de l'outil d'analyse de Visual SourceSafe.
Exécuter l'outil de conversion pour identifier les sources potentielles d'une perte d'information.
Spécifier les dossiers Visual SourceSafe à migrer.
Créer un fichier de mappage d'utilisateur pour mapper des utilisateurs Visual SourceSafe à des utilisateurs Team Foundation.
Composants requis
Pour exécuter cette procédure pas à pas, vous devez installer les logiciels suivants sur l'ordinateur où vous envisagez d'exécuter VSSConverter.exe :
Team Explorer
Ouvrez une session sur l'ordinateur en fournissant des informations d'identification administrative
SQL Server Express
.gif "Remarque")
Remarque :Par défaut, SQL Server Express est installé en même temps que Visual Studio 2005 ou Visual Studio 2008
Visual SourceSafe 2005 ou versions ultérieures.
Base de données Visual SourceSafe que vous souhaitez analyser. Le format de base de données doit être de version 6.0 ou ultérieure. Vous devez exécuter le convertisseur sur le même ordinateur que votre base de données Visual SourceSafe pour effectuer cette procédure pas à pas.
Il vous faut également :
Le mot de passe de l'administrateur de la base de données Visual SourceSafe qui contient les projets que vous souhaitez analyser.
Remarque :Les autres utilisateurs ne doivent pas accéder à la base de données Visual SourceSafe pendant le processus d'analyse. Ne verrouillez pas la base de données car cela empêcherait le convertisseur d'y accéder pour effectuer la migration.
Autorisations requises
Pour exécuter cette procédure pas à pas, vous devez avoir les autorisations administratives pour la base de données Visual SourceSafe que vous allez migrer. Pour plus d'informations, consultez « Comment : assigner des droits sur le projet » sur le site Web Microsoft (https://go.microsoft.com/fwlink/?LinkId=99103).
Préparation de la base de données Visual SourceSafe
Avant de transférer des fichiers sous contrôle de code source de Visual SourceSafe à Microsoft Visual Studio Team System, effectuez les tâches suivantes dans Visual SourceSafe.
Demandez à tous les utilisateurs de la base de données d'archiver leurs fichiers.
Créez une copie de sauvegarde de votre base de données Visual SourceSafe à migrer. Pour plus d'informations, consultez l'article « Comment sauvegarder une base de données Visual SourceSafe » (en anglais) sur le site Web Microsoft (https://go.microsoft.com/fwlink?linkid=51358).
Utilisez l'utilitaire Analyze de Visual SourceSafe pour rechercher et résoudre des problèmes d'intégrité des données dans la base de données. Pour plus d'informations sur l'utilisation de cet utilitaire, consultez les articles « Utilitaire ANALYZE » (https://go.microsoft.com/fwlink/?LinkId=99129) et « Comment : Détecter et résoudre les erreurs de corruption de base de données dans Visual SourceSafe » (https://go.microsoft.com/fwlink/?linkid=51357) (en anglais).
Analyse des projets
VSSConverter.exe est un outil de ligne de commande qui requiert les entrées suivantes :
Un chemin d'accès au dossier qui contient le fichier srcsafe.ini de la base de données Visual SourceSafe en cours de migration.
Un fichier XML qui contient des paramètres.
VSSConverter.exe est stocké dans <racine>: \Program \Common7\IDE de Files\Microsoft Visual Studio 9.0, mais est appelé à partir de l'invite de commande Visual Studio.
Cette procédure pas à pas suppose que votre base de données Visual SourceSafe se trouve dans c:\VSSDatabase.
Après avoir sélectionné les projets que vous souhaitez analyser, créez un fichier pour contenir les paramètres. Ce fichier répertorie les projets que vous souhaitez que le convertisseur analyse.
Pour créer le fichier de paramètres pour l'analyse
Cliquez sur Démarrer, puis sur Tous les programmes, pointez sur Microsoft Visual Studio 2008, sur Visual Studio Tools, puis cliquez sur Invite de commandes de Visual Studio 2008.
À l'invite de commandes, tapez mkdir %DriveLetter%\VSS2TeamFoundation, où %DriveLetter% est le lecteur actif. Appuyez sur ENTRÉE.
À l'invite de commandes, tapez cd %DriveLetter%\VSS2TeamFoundation. Appuyez sur ENTRÉE.
Tapez notepad settings.xml, puis appuyez sur Entrée.
Sélectionnez Oui pour créer le fichier.
Copiez les données XML suivantes, où $/FolderA et $/FolderB représentent les noms des dossiers qui contiennent les projets à migrer.
<?xml version="1.0" encoding="utf-8"?> <SourceControlConverter> <ConverterSpecificSetting> <Source name="VSS"> <VSSDatabase name="c:\VSSDatabase"></VSSDatabase> </Source> <ProjectMap> <Project Source="$/FolderA"></Project> <Project Source="$/FolderB"></Project> </ProjectMap> </ConverterSpecificSetting> <Settings> <Output file="Analysis.xml"></Output> </Settings> </SourceControlConverter>Remarque :Pour migrer l'intégralité de la base de données, utilisez <Project Source="$/"></Project>.
Pour la balise < VSSDatabase name >, entrez le chemin d'accès à votre base de données Visual SourceSafe.
Enregistrez vos modifications et fermez le Bloc-notes.
Ensuite, exécutez l'outil de conversion à partir de l'invite de commandes de Visual Studio pour analyser le projet, comme le montrent les étapes suivantes.
L'utilisateur qui effectue l'analyse doit être administrateur système pour SQLExpress. Par défaut, l'utilisateur qui installe Visual Studio reçoit les autorisations requises pour SQLExpress.
Lorsque vous disposez du fichier des paramètres de migration et des droits d'administrateur système, vous pouvez exécuter l'outil de conversion pour analyser le projet.
Pour analyser le projet à l'aide du convertisseur
À l'invite de commande Visual Studio, tapez la commande suivante :
VSSConverter Analyze settings.xml
Lorsque vous y êtes invité, fournissez le mot de passe d'administrateur Visual SourceSafe.
L'outil de conversion affiche l'état de l'analyse préalable à la conversion. Lorsque l'analyse est terminée, il génère un rapport (VSSAnalysisReport.xml) et un fichier de mappage utilisateur (usermap.xml) avant de les enregistrer dans le répertoire actif. Vous pouvez utiliser le fichier de mappage utilisateur pour mapper des utilisateurs Visual SourceSafe à des utilisateurs Team Foundation. Pour plus d'informations, consultez Comment : modifier le fichier de mappage utilisateur relatif à la migration du contrôle de code source.
Étapes suivantes
Vous pouvez désormais migrer les informations contenues dans votre base de données Visual SourceSafe vers le serveur de contrôle de version Team Foundation. Pour plus d'informations, consultez Procédure pas à pas : migration de Visual SourceSafe vers Team Foundation.
Voir aussi
Tâches
Procédure pas à pas : migration de Visual SourceSafe vers Team Foundation
Comment : créer un fichier de paramètres pour l'analyse et la migration du contrôle de code source
Concepts
VSSConverter, utilitaire en ligne de commande pour la migration du contrôle de code source