演练：准备从 Visual SourceSafe 迁移到 Team Foundation

项目
08/18/2008

更新：2007 年 11 月

Team FoundationVisual SourceSafe 转换器工具可将文件、文件夹、版本历史记录和用户信息从 Visual SourceSafe 数据库转移到 Team Foundation 版本控制服务器。在将文件和历史记录信息转移到 Team Foundation 之前，应先分析并生成数据库的备份副本、尽可能多地签入文件，然后了解哪些信息不能从 Visual SourceSafe 转移到 Team Foundation。

本演练描述如何准备 Visual SourceSafe 数据库以进行转换以及如何使用 VSSConverter 有效地计划源内容的实际迁移。

在本演练中，您将完成以下任务：

备份 Visual SourceSafe 数据库。
使用 Visual SourceSafe Analyze 工具标识并解决现有数据库中存在的数据完整性问题。
运行转换器工具以识别可能造成信息丢失的潜在因素。
指定要迁移的 Visual SourceSafe 文件夹。
创建一个用户映射文件以将 Visual SourceSafe 用户映射到 Team Foundation 用户。

先决条件

若要完成本演练，您需要在计划运行 VSSConverter.exe 的计算机上安装以下软件：

团队资源管理器
使用管理凭据登录到计算机上
SQL Server Express

说明：

默认情况下，在安装 Visual Studio 2005 或 Visual Studio 2005 期间将安装 SQL Server Express。
Visual SourceSafe 2005 或更高版本
要分析的 Visual SourceSafe 数据库。数据库格式必须是 6.0 版或更高版本。为了完成本演练，必须在 Visual SourceSafe 数据库所在的计算机上运行转换器。

此外，还需要以下信息：
- 包含待分析项目的 Visual SourceSafe 数据库的管理员密码。
  
  说明：
  
  在分析过程中，其他用户不应访问 Visual SourceSafe 数据库。不要锁定数据库，因为锁定会阻止转换器访问待迁移的数据库。

说明：
默认情况下，在安装 Visual Studio 2005 或 Visual Studio 2005 期间将安装 SQL Server Express。

说明：
在分析过程中，其他用户不应访问 Visual SourceSafe 数据库。不要锁定数据库，因为锁定会阻止转换器访问待迁移的数据库。

必需的权限

若要执行本演练，必须对要迁移的 Visual SourceSafe 数据库具有管理权限。有关更多信息，请参见 Microsoft 网站 (https://go.microsoft.com/fwlink/?LinkId=99103)。

准备 Visual SourceSafe 数据库

将受源代码管理的文件从 Visual SourceSafe 传输到 Microsoft Visual Studio Team System 之前，请在 Visual SourceSafe 中完成以下任务。

请所有数据库用户签入他们的文件。
创建要迁移的 Visual SourceSafe 数据库的备份副本。有关更多信息，请参见 Microsoft 网站 (https://go.microsoft.com/fwlink?linkid=51358) 上的“How To Back Up a Visual SourceSafe Database”（如何备份 Visual SourceSafe 数据库）。
使用 Visual SourceSafe 分析实用工具查找并修复数据库中的数据完整性问题。有关如何使用此工具的更多信息，请参见“ANALYZE Utility”(https://go.microsoft.com/fwlink/?LinkId=99129)（ANALYZE 实用工具）和“How to: Detect and Fix Database Corruption Errors in Visual SourceSafe”(https://go.microsoft.com/fwlink/?linkid=51357)（如何：检测和修复 Visual SourceSafe 中的数据库损坏错误）。

分析项目

VSSConverter.exe 是一个需要以下输入的命令行工具：

一个文件夹路径，该文件夹中包含待迁移的 Visual SourceSafe 数据库的 srcsafe.ini 文件。
包含设置的基于 XML 的文件。
VSSConverter.exe 存储在“<根>:\Program Files\Microsoft Visual Studio 9.0\Common7\IDE”中，但是从 Visual Studio 命令提示符进行调用。

本演练假定 Visual SourceSafe 数据库位于 c:\VSSDatabase。

在您决定要分析的项目之后，请创建一个文件以包含这些设置。此文件列出您希望转换器分析的项目。

创建要分析的设置文件

单击“开始”，单击“所有程序”，指向“Microsoft Visual Studio 2008”，指向“Visual Studio Tools”，然后单击“Visual Studio 2008 命令提示”。
在命令提示处，键入 mkdir %驱动器号%\VSS2TeamFoundation，其中 %驱动器号% 为当前驱动器。按 Enter。
在命令提示处，键入 cd %驱动器号%\VSS2TeamFoundation。按 Enter。
键入 notepad settings.xml，然后按 Enter。
选择“是”创建文件。

复制下面的 XML，其中 $/FolderA 和 $/FolderB 表示包含待迁移项目的文件夹的名称。

<?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>

说明：
若要迁移整个数据库，请使用 <Project Source="$/"></Project>。

对于 <VSSDatabase name> 标记，输入 Visual SourceSafe 数据库的路径。

保存所做的更改并关闭记事本。

接下来，从 Visual Studio 命令提示符处运行转换器工具以分析项目，如下列步骤所示。

将要执行分析的用户必须是 SQLExpress 的系统管理员。默认情况下，安装 Visual Studio 的用户将会获得对于 SQLExpress 的所需权限。

获得迁移设置文件和授予的系统管理员权限后，即可运行转换器工具以分析项目。

使用转换器分析项目

在 Visual Studio 命令提示符处，键入以下命令：

VSSConverter Analyze settings.xml
当出现提示时，请提供 Visual SourceSafe 管理员密码。

转换器工具将显示预转换分析的状态。分析完成后，该工具将生成一个报告 (VSSAnalysisReport.xml) 和一个用户映射文件 (usermap.xml)，并将其保存在当前目录中。可使用用户映射文件将 Visual SourceSafe 用户映射为 Team Foundation 用户。有关更多信息，请参见如何：编辑源代码管理迁移用户映射文件。

后续步骤

现在，即可将 Visual SourceSafe 数据库中的信息迁移到 Team Foundation 版本控制服务器中。有关更多信息，请参见演练：从 Visual SourceSafe 迁移到 Team Foundation。

请参见

通过