演练：从 Visual SourceSafe 迁移到 Team Foundation

2008-08-18

更新：2007 年 11 月

本演练介绍如何使用 VSS 转换器工具 VSSConverter.exe 从 Visual SourceSafe 迁移到 Visual SourceSafe。有关如何准备数据库以便进行迁移的信息，请参见演练：准备从 Visual SourceSafe 迁移到 Team Foundation。在该演练中，您将了解到有关如何为迁移到 Team Foundation 准备 SourceSafe 数据库和用户列表的详细信息，并更好地了解迁移过程的原理。

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

修改设置文件以指定要迁移的文件夹。
运行转换器，将源文件夹从 Visual SourceSafe 迁移到 Visual SourceSafe 并生成迁移报告。

先决条件

在尝试完成本演练之前：

执行演练：准备从 Visual SourceSafe 迁移到 Team Foundation 中列出的所有步骤。
标识 Team Foundation 版本控制中的空文件夹作为迁移 Team Foundation 版本控制文件夹的目标位置。如果目标文件夹不存在，转换器会为您创建它。唯一的例外情况是目标文件夹为团队项目。目标文件夹应该是有效的团队项目或有效的团队项目的子文件夹。有关更多信息，请参见如何：创建团队项目。

此外，还需要以下信息：

一个 Team Foundation Server 名称。
在计划要运行转换器的计算机上安装 SQL Server Express。

安装 Microsoft Visual Studio Team System 时，默认情况下会安装 SQL Express。

您必须拥有管理员权限才能连接到 SQLExpress 数据库以使用转换器工具。
运行 VSSConverter 的计算机上的 Visual SourceSafe 2005。

必需的权限

若要执行本演练，必须对要迁移的 Visual SourceSafe 数据库具有管理权限。有关更多信息，请参见 Microsoft 网站 (https://go.microsoft.com/fwlink/?LinkId=99103) 上的“How to: Assign Project Rights”（如何：分配项目权限）。您还必须是 SQL Express 的“sysadmin”服务器角色的成员。默认情况下，如果您是安装了 SQL Express 的计算机上“Administrators”安全组的成员，您便是“sysadmin”服务器角色的成员。有关更多信息，请参见 Microsoft 网站上 SQL Server 2005 文档中的“sysadmin”(https://go.microsoft.com/fwlink/?LinkId=60405)。

迁移 SourceSafe 项目文件夹

在继续执行实际转换之前，请自定义设置文件，使其含有在为转换做准备时指定的 SourceSafe 项目目标文件夹。必须完成演练：准备从 Visual SourceSafe 迁移到 Team Foundation 中列出的所有步骤才能完成此任务。

修改设置文件以创建迁移文件

单击“开始”，单击“程序”，指向“Microsoft Visual Studio 2008”，指向“Visual Studio Tools”，然后单击“Visual Studio 2008 命令提示”。
在命令提示处，键入 cd %驱动器号%\VSS2TeamFoundation。此文件夹在分析要迁移的 Visual SourceSafe 数据库时创建。有关更多信息，请参见演练：准备从 Visual SourceSafe 迁移到 Team Foundation。

说明：

确保系统驱动器有足够的空间能够容纳待迁移最大文件的大小。
使用新的名称（如 migration_settings.xml）保存为该分析创建的设置文件 (settings.xml)。
在命令提示符处键入 notepad migration_settings.xml，然后按“Enter”键。

在分析要迁移的数据库时创建的 settings.xml 文件会出现在“记事本”中。

说明：
确保系统驱动器有足够的空间能够容纳待迁移最大文件的大小。

按如下方式更改设置文件。

在 <ProjectMap> 部分中，对于每个要迁移的 Visual SourceSafe 文件夹，在 Visual SourceSafe中添加目标文件夹。使用以下格式添加 Destination 部分，如下面的示例所示。
```
<Project Source="$/FolderA" Destination="$/Team_Project"></Project>
```
若要迁移 Visual SourceSafe 数据库中的所有内容，则改为插入下面的 XML。
```
<Project Source="$/" Destination="$/Team_Project/"></Project> 
```

在 <Settings> 节下，添加一个 <Settings> 节，并指定要迁移到的 Team Foundation Server 的名称、端口和协议。使用以下格式。

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

例如，

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

说明：
如果 Visual SourceSafe 数据库很大，则由于 SQLExpress 具有 4 GB 限制，迁移可能会失败。若要解决此问题，请添加以下行，将转换器设置为改用 SQLServer：<SQL Server="SQL Server 名称"></SQL>

从 <Settings> 节中移除 <Output file="Analysis.xml"></Output>，或将输出文件重命名为“migration_Analysis.xml”。

您的 migration_settings.xml 文件应与下面的内容类似：

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

请确保用您的服务器名称替换 server name，并用实际端口号替换 server name。

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

运行转换器

将 Visual SourceSafe 数据库复制到一个本地文件夹，该文件夹位于要在其上运行分析和迁移的计算机上。虽然可以迁移远程计算机上的共享文件夹中的 Visual SourceSafe 数据库，但是要花长得多的时间才能完成迁移。
单击“开始”，单击“所有程序”，指向“Microsoft Visual Studio”，指向“Visual Studio Tools”，然后单击“Visual Studio 命令提示”。
在命令提示处，键入以下命令：

VSSConverter Migrate migration_settings.xml

提示：

使用 /? 开关可查看可用的命令行选项。
键入 Y 确认迁移。

转换器工具将显示迁移状态。当转换过程完成时，该工具在当前目录中保存迁移报告。可以使用 Internet Explorer 查看该文件以了解详细信息。

提示：
使用 /? 开关可查看可用的命令行选项。

当出现提示时，请提供 Visual SourceSafe 管理员用户的密码。

说明：
VSSConverter 不迁移 Visual Studio 解决方案的版本控制绑定。必须手动更改这些绑定。有关更多信息，请参见如何：从 Visual SourceSafe 中迁移源代码管理绑定。

请参见

通过