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

Article
08/22/2008

Mise à jour : novembre 2007

Cette procédure pas à pas décrit comment migrer de Visual SourceSafe à Team Foundation à l'aide de l'outil de conversion VSS, VSSConverter.exe. Pour plus d'informations sur la préparation de la base de données pour la migration, consultez Procédure pas à pas : préparation pour effectuer une migration de Visual SourceSafe vers Team Foundation. Cette procédure pas à pas contient des informations détaillées sur la préparation d'une base de données SourceSafe et d'une liste d'utilisateurs pour la migration vers Team Foundation. Elle vous permettra aussi de mieux comprendre le fonctionnement du processus de migration.

Dans cette procédure pas à pas, vous effectuerez les tâches suivantes :

modifier le fichier de paramètres pour spécifier les dossiers à migrer ;
exécuter le convertisseur pour effectuer une migration de la source de Visual SourceSafe vers Team Foundation et générer un rapport de migration.

Composants requis

Avant d'essayer d'exécuter cette procédure pas à pas :

Effectuez toutes les étapes comme décrit dans la Procédure pas à pas : préparation pour effectuer une migration de Visual SourceSafe vers Team Foundation.
Identifiez les dossiers vides du contrôle de version Team Foundation où vous souhaitez migrer vos dossiers Visual SourceSafe. Si le dossier de destination n'existe pas, le convertisseur le créera pour vous, à moins que le dossier de destination ne soit un projet d'équipe. Le dossier de destination doit être un projet d'équipe valide ou un sous-dossier d'un projet d'équipe valide. Pour plus d'informations, consultez Comment : créer un projet d'équipe.

Il vous faut également :

Un nom Team Foundation Server.
Installez SQL Server Express sur l'ordinateur où vous prévoyez d'exécuter le convertisseur.

SQL Express est installé par défaut lorsque vous installez Microsoft Visual Studio Team System.

Vous devez disposer d'autorisations administratives pour vous connecter à une base de données SQLExpress afin d'utiliser l'outil de conversion.
Visual SourceSafe 2005 sur l'ordinateur où vous exécutez VSSConverter.

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). Vous devez également être membre du rôle de serveur sysadmin pour SQL Express. Par défaut, vous êtes membre du rôle de serveur sysadmin si vous êtes membre du groupe de sécurité Administrateurs sur l'ordinateur où SQL Express est installé. Pour plus d'informations, consultez « sysadmin » sur le site Web de Microsoft (https://go.microsoft.com/fwlink/?LinkId=60405) dans la documentation SQL Server 2005.

Migration des dossiers de projet SourceSafe

Avant de passer à la conversion à proprement parler, personnalisez votre fichier de paramètres de façon à inclure les dossiers de destination pour les projets SourceSafe que vous avez spécifiés au cours de la préparation de la conversion. Vous devez effectuer toutes les étapes décrites dans la Procédure pas à pas : préparation pour effectuer une migration de Visual SourceSafe vers Team Foundation pour exécuter cette tâche.

Pour modifier le fichier de paramètres pour créer un fichier de migration

Cliquez sur Démarrer, puis sur Programmes, pointez sur Microsoft Visual Studio 2008, pointez sur Visual Studio Tools, puis cliquez sur Invite de commandes de Visual Studio 2008.
À l'invite de commandes, tapez cd %DriveLetter%\VSS2TeamFoundation. Ce dossier a été créé lorsque vous avez analysé la base de données Visual SourceSafe pour la migration. Pour plus d'informations, consultez Procédure pas à pas : préparation pour effectuer une migration de Visual SourceSafe vers Team Foundation.

Remarque :

Assurez-vous que le lecteur système a suffisamment d'espace pour héberger le fichier le plus volumineux en cours de migration.
Enregistrez le fichier de paramètres settings.xml que vous avez créé pour l'analyse sous un nouveau nom, par exemple migration_settings.xml.
À l'invite de commandes, tapez notepad migration_settings.xml, puis appuyez sur Entrée.

Le fichier settings.xml que vous avez créé lorsque vous avez analysé votre base de données pour la migration s'affiche dans le Bloc-notes.

Remarque :
Assurez-vous que le lecteur système a suffisamment d'espace pour héberger le fichier le plus volumineux en cours de migration.

Modifiez le fichier de paramètres comme suit.

Dans la section <ProjectMap>, pour chaque dossier Visual SourceSafe migré, ajoutez les dossiers de destination dans le contrôle de version Team Foundation. Utilisez le format suivant, en ajoutant la section Destination comme indiqué dans l'exemple suivant.
```
<Project Source="$/FolderA" Destination="$/Team_Project"></Project>
```
Pour migrer l'intégralité de votre base de données Visual SourceSafe, insérez plutôt le code XML suivant.
```
<Project Source="$/" Destination="$/Team_Project/"></Project> 
```

Sous la section <Settings>, ajoutez une section <TeamFoundationServer> et spécifiez le nom, le port et le protocole du serveur Team Foundation Server vers lequel vous migrez. Utilisez le format suivant.

<TeamFoundationServer name="TFS_server_name" port="port_number" protocol="http"></TeamFoundationServer>

Par exemple :

<TeamFoundationServer name="AdventureWorks" port="8080" protocol="http"></TeamFoundationServer>

Remarque :
Si vous possédez une base de données Visual SourceSafe importante, votre migration peut échouer en raison de la limite de 4 Go imposée par SQLExpress. Pour résoudre cette erreur, définissez le convertisseur pour qu'il utilise SQL Server en ajoutant la ligne suivante : <SQL Server="Nom_SQL_Server"></SQL>.

Supprimez <Output file="Analysis.xml"></Output> de la section <Settings> ou renommez le fichier de sortie en "migration_Analysis.xml."

Votre fichier migration_settings.xml doit ressembler à ce qui suit :

<?xml version="1.0" encoding="utf-8"?>
<SourceControlConverter>
      <ConverterSpecificSetting>
            <Source name="VSS">
                  <VSSDatabase name="c:\VSSDatabase"></VSSDatabase>
                  <UserMap name="c:\Migrate\Usermap.xml"></UserMap>
            </Source>
            <ProjectMap>
                  <Project Source="$/FolderA" Destination="$/TeamProjectA"></Project>
                  <Project Source="$/FolderB" Destination ="$/TeamProjectB/ProjectB"></Project>
            </ProjectMap>
      </ConverterSpecificSetting>
      <Settings>
            <TeamFoundationServer name="server_name" port="port_number" protocol="protocol"></TeamFoundationServer>
      </Settings>
</SourceControlConverter>

Veillez à remplacer votre nom de serveur par server name et un numéro de port réel par port number.

Enregistrez vos modifications et fermez le Bloc-notes.

Pour exécuter le convertisseur

Copiez votre base de données Visual SourceSafe dans un dossier local sur l'ordinateur sur lequel vous souhaitez exécuter l'analyse et la migration. Bien que vous puissiez migrer une base de données Visual SourceSafe dans un dossier partagé sur un ordinateur distant, la migration prend beaucoup plus de temps.
Cliquez sur Démarrer, sur Tous les programmes, pointez sur Microsoft Visual Studio, pointez sur Visual Studio Tools, puis cliquez sur Invite de commandes Visual Studio.
À l'invite de commandes, tapez la commande suivante.

VSSConverter Migrate migration_settings.xml

Conseil :

Utilisez le commutateur /? pour afficher les options de ligne de commande disponibles.
Tapez Y pour confirmer la migration.

L'outil de conversion affiche l'état de migration. Une fois le processus de conversion terminé, l'outil enregistre un rapport de migration dans le répertoire actif. Vous pouvez utiliser Internet Explorer pour afficher le fichier pour plus d'informations.

Conseil :
Utilisez le commutateur /? pour afficher les options de ligne de commande disponibles.

Lorsque vous y êtes invité, saisissez le mot de passe de l'utilisateur Admin de Visual SourceSafe.

Remarque :
VSSConverter ne migre pas les liaisons de contrôle de version pour les solutions Visual Studio. Vous devez modifier ces liaisons manuellement. Pour plus d'informations, consultez Comment : effectuer la migration des liaisons du contrôle de code source provenant de Visual SourceSafe.

Voir aussi

Partager via

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

Composants requis

Migration des dossiers de projet SourceSafe

Pour modifier le fichier de paramètres pour créer un fichier de migration

Pour exécuter le convertisseur

Voir aussi

Tâches

Concepts

Autres ressources

Ressources supplémentaires