Prochaines étapes après la mise à niveau à partir de Visual SourceSafe

  • Article

Une fois la mise à niveau terminée, vous devez vous assurer que les résultats répondent à vos attentes et que les données sont prêtes pour que votre équipe puisse utiliser :

  • Vérifier les résultats de la mise à niveau

  • Résolvez les problèmes

    • Corrigez l'erreur provoquée par la limite de stockage pour SQL Server Express

    • Convertir des fichiers au format de nom court (8.3) compatible MS-DOS (TF227014)

Vérifier les résultats de la mise à niveau

Examinez le rapport et, si nécessaire, les journaux générés par l'outil de mise à niveau. Vérifiez les données sur votre serveur Team Foundation Server pour vérifier que les données de votre base de données Visual SourceSafe ont été mises à niveau de la manière attendue.

Afficher le rapport de migration

TFS et Visual SourceSafe présentent des différences fonctionnelles significatives. Par conséquent, les outils visuels de mise à niveau Visual SourceSafe modifient certains types de données pendant la mise à niveau. Et, dans certains cas, des erreurs ou des problèmes peuvent survenir. Le rapport de migration peut vous conseiller sur ces problèmes.

Pour ouvrir le rapport de migration :

  • Si vous avez utilisé l'Assistant Mise à niveau VSS : dans la page Terminé, cliquez sur le lien Rapport de mise à niveau.

  • Si vous avez utilisé l'outil VssUpgrade : ouvrez le rapport VSSAnalysisReport.xml dans le répertoire actif ou utilisez le nom de fichier et l'emplacement vous avez spécifié à l'aide de l'attribut <Output file>.

Rapport de migration

Afficher les journaux

Si des avertissements ou des erreurs ont été signalés, vous souhaitez peut-être consulter les journaux. Vous pouvez également afficher les journaux pour obtenir des informations sur la façon dont vos données ont été modifiées pendant la mise à niveau. Pour consulter les journaux :

  • Si vous avez utilisé l'Assistant Mise à niveau VSS : sur la page Terminé, cliquez sur le lien Journal complet.

  • Si vous avez utilisé l'outil VssUpgrade : ouvrez ConverterErrors.txt et VSSUpgrade.log.

Examinez les données dans votre projet d'équipe

Utilisez l'Explorateur du contrôle de code source pour examiner les données sur votre serveur Team Foundation Server afin de vérifier que les données de votre base de données Visual SourceSafe ont été mises à niveau de la manière attendue.

Résolvez les problèmes

Après avoir examiné les résultats de la mise à niveau, vous devrez peut-être résoudre des problèmes.

Corrigez l'erreur provoquée par la limite de stockage pour SQL Server Express

Les outils de mise à niveau utilisent une base de données pour stocker les métadonnées temporaires. En règle générale, ces métadonnées requièrent un faible pourcentage de la taille totale des données à mettre à niveau. Dans le cas improbable où votre mise à niveau échoue parce que la limite de 4 Go de SQL Server Express est atteinte, vous pouvez utiliser SQL Server au lieu de SQL Server Express. Consultez Préparer une mise à niveau à partir de Visual SourceSafe à l'aide de l'Assistant or VssUpgrade <SQL> Element.

Convertir des fichiers au format de nom court (8.3) compatible MS-DOS (TF227014)

TFS n'autorise pas les noms de fichiers au format de nom court (8.3) compatible MS-DOS (par exemple abcdef~1.txt). Lorsque vous analysez ou tentez de mettre à niveau des fichiers qui portent ce type de nom, une erreur TF227014 s'affiche.

Pour contourner ce problème, vous pouvez appliquer temporairement un paramètre à votre serveur Team Foundation Server afin de l'obliger à autoriser les fichiers ayant de tels noms. Pour ce faire, vous devez affecter la valeur True à Allow8Dot3Paths dans la base de données de configuration de TFS.

Important

Pour éviter les problèmes liés aux ordinateurs clients qui prennent en charge les noms courts compatibles MS-DOS, il est fortement recommandé d'affecter False à Allow8Dot3Paths à l'issue du processus de mise à niveau, comme décrit dans la procédure suivante.

Pour exécuter la procédure suivante, vous devez activer Windows PowerShell sur le serveur de couche Application pour TFS. Voir les scripts avec Windows PowerShell.

Autorisations requises

Vous devez être membre du groupe Administrateurs sur le serveur de couche Application pour TFS. Pour plus d'informations, consultez Référence des autorisations pour Team Foundation Server.

Pour mettre à niveau une base de données Visual SourceSafe qui contient des fichiers nommés à l'aide du format de nom court compatible MS-DOS

  1. Connectez-vous au serveur de couche Application de Team Foundation.

  2. Créez un script Windows PowerShell appelé Allow8Dot3Paths.

    1. Copiez le texte contenu dans le Script PowerShell Allow8Dot3Paths plus loin dans cette rubrique, puis collez-le dans le script.

    2. Modifiez ServerPath de sorte qu'il corresponde au chemin d'accès de l'URL utilisé pour la connexion à Team Foundation Server. Par défaut, le chemin d'accès du serveur est "tfs".

    3. Modifiez CollectionName de sorte qu'il corresponde au nom de la collection de projets d'équipe dans laquelle vous mettez à niveau vos données (par exemple, DefaultCollection).

      Le résultat final correspond à la ligne suivante dans le script :

      $collectionBaseUrl = "https://localhost:8080/tfs/DefaultCollection/";

  3. Exécutez le script Allow8Dot3Paths.

  4. Recyclez le pool d'applications pour votre serveur Team Foundation Server.

    1. À partir de l'écran d'accueil de Windows, exécutez Gestion de l'ordinateur.

    2. Dans le volet de navigation, développez Services et applications.

    3. Choisissez Gestionnaire des services Internet (IIS), développez l'ordinateur local, puis double-cliquez sur Pools d'applications.

    4. Ouvrez le menu contextuel du pool d'applications, puis choisissez Recycler.

  5. Exécutez la commande Migrate.

  6. Modifiez le script Windows PowerShell Allow8Dot3Paths que vous avez créé précédemment, en remplaçant "true" par "false".

  7. Exécutez le script Allow8Dot3Paths modifié.

  8. Recyclez le pool d'applications pour votre serveur Team Foundation Server (comme indiqué ci-dessus).

  9. Dans Visual Studio, si vous n'êtes pas encore connecté, connectez-vous alors au projet d'équipe dans lequel vous avez mis à niveau les données.

  10. Dans l'Explorateur du contrôle de code source, renommez tous les fichiers dont les noms sont au format de nom court (8.3) compatible MS-DOS.

Script PowerShell Allow8Dot3Paths

# Load client OM assembly.
[Reflection.Assembly]::Load("Microsoft.TeamFoundation.Client, Version=10.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a");

$collectionBaseUrl = "https://localhost:8080/ServerPath/CollectionName/";

$tfs = [Microsoft.TeamFoundation.Client.TeamFoundationServerFactory]::GetServer($collectionBaseUrl);
$collectionHive = $tfs.GetService([Microsoft.TeamFoundation.Framework.Client.ITeamFoundationRegistry]);

# Set some version control settings in the collection hive.
$collectionHive.SetValue("/Service/VersionControl/Settings/Allow8Dot3Paths", "True");

# Display all version control settings as a table.
$collectionHive.ReadEntries("/Service/VersionControl/Settings/...") | ft -a