Migrer une base Visual Source Safe vers Team Foundation Server

Prérequis

Voici quelques prérequis :

• Vous devez connaitre le mot de passe administrateur de la base de données de Visual Source Safe.
• La machine sur laquelle vous allez exécuter la migration doit avoir Microsoft Visual Studio 2005 d'installé.
• La machine sur laquelle vous allez exécuter la migration doit avoir Microsoft Visual Source Safe 2005 d'installé.
• Une base de données doit être accessible (pas forcément sur la machine d'où vous exécutez la migration) et l'utilisateur avec lequel vous êtes connecté doit avoir les droits d'administrations (faire partie du groupe sysadmin) dessus.

Copie et sauvegarde

Tout d'abord, commencez par récupérer le répertoire Source Safe contenant les sources du projet que vous souhaitez migrer (celui contenant le fichier srcsafe.ini). Mettez-le sur la machine d'où vous souhaitez faire la migration.

Cela permet de travailler sur une copie et donc de conserver une sauvegarde au cas ou ...

Création du projet team project

La migration va prendre un projet de la base Source Safe pour l'exporter vers une base Team Foundation.

Cette dernière doit exister. L'outil de migration de le créera pas pour vous.

Créer donc un projet Team Project.

Création du fichier de configuration de la migration

Ce fichier de configuration permet de spécifier à l'outil de migration ce que l'on souhaite faire.

Créer un fichier settings.xml et copiez/collez l'exemple ci-dessous :

<?xml version="1.0" encoding="utf-8"?>
<SourceControlConverter>
<ConverterSpecificSetting>
     <Source name="VSS">
          <VSSDatabase name="D:RepertoireSourceSafeOuIlYAsrcsafe.ini"></VSSDatabase>
     <SQL Server="NomDuServeurSQLNomDeLInstance" />
     </Source>
     <ProjectMap>
          <Project Source="$/NomDuProjetSurVss" Destination="$/NomDuProjetSurTFS"></Project>
     </ProjectMap>
</ConverterSpecificSetting>
<Settings>
     <TeamFoundationServer name="NomDuServeur" port="8080" protocol="http"></TeamFoundationServer>
     <Output file="Migration.xml"></Output>
</Settings>
</SourceControlConverter>

Voici les points à configurer :

• VSSDatabase : C'est le répertoire qui contient les projets de VSS (celui où le fichier srcsafe.ini est présent)
• SQL : Etrangement, l'outil de migration à besoin d'une base de donnée SQL pour fonctionner. Par défaut, il tente de se connecter à une base SQL local. Si une base SQL express créé par l'installation Visual Studio 2005 est présente, cette ligne n'est pas nécessaire. Sinon, compléter les informations. Sachez également que l'utilisateur avec lequel vous êtes connecté à la machine doit avoir les droits sur la base (être dans le groupe sysadmin de SQL Server).
• Project : Ce noeud permet de définir quel(s) projet(s) de VSS doit allez dans quel projet de TFS. Vous pouvez dont ajouter plusieurs lignes en fonction du nombre de projet que vous souhaiter migrer. Si vous suivez cet article depuis le début, le nom du projet TFS est le nom du projet Team Project que vous avez créé à l'étape précédente.
• TeamFoundationServer : Il s'agit du nom du serveur Team Foundation Server à utiliser.

Lancement de la migration

L'outil de migration s'appel se présente sous la forme d'un exécutable VSSConverter.exe.

Pour lancer la migration, ouvrez d'abord l'invite de commande de Visual Studio 2005 : Démarrer -> Programmes -> Microsoft Visual Studio 2005 -> Visual Studio Tools -> Visual Studio 2005 Command Prompt

Placez-vous au niveau du répertoire contenant votre fichier settings.xml

Lancez la commande suivante :

vssconverter migrate settings.xml

Répondez oui à la question qui vous est posée et entrez le mot de passe de l'administrateur de la base Source Safe quand il vous est demandé.

Si vous avez bien suivi l'article depuis le début, tout devrait se passer correctement (en tout cas ça à marcher pour moi).

Quelques liens utiles

Pour une procédure plus détaillée : Comment : effectuer une migration de Visual SourceSafe vers Team Foundation

Un outil visuel pour faire les migrations :http://bloggingabout.net/blogs/mglaser/archive/2007/03/03/migrate-vss-projects-to-tfs-projects.aspx

Publié le  16/05/2007 Auteur:  Aleks