yaosansi's Blog

原文：http://www.yaosansi.com/post/1439.html
VS2010、TFS2010正式发布了，但自从VSS2005版以后微软就没发布过新版，并且VS2010中的Team工具已经和TFS整合到一块了，看来微软已经决心用TFS替代VSS了。

这里简单介绍一下yaosansi源代码管理由VSS2005迁移到TFS2010的主要过程，及遇到的问题和解决方案。

目录：

1.准备Visual SourceSafe 2005
a、请所有数据库用户签入他们的文件
b、备份Visual SourceSafe 数据库文件
c、使用 Visual SourceSafe 分析实用工具查找并修复数据库中的数据完整性问题
2.分析Visual SourceSafe 数据库文件
a.在VSS数据库根目录中，新建如下所示分析配置文档AnalyzeResult.xml（XML格式）
b.在Visual Studio 2008/2010 命令提示行中执行以语句，并按要求输入VSS管理员密码。
3.安装IIS 、SQL SERVER Express 2010  和 Team Foundation Server 2010 （注意先后顺序）
a.配置TFS2010工作模式
b.在服务器上建立相应的TFS用户组及要迁移的用户，修改上面生成的用户映射文件 (usermap.xml），保留将需要迁移的用户，删除其它用户。
4.迁移 Visual SourceSafe 2005项目
a.在VSS数据库根目录中，新建如下所示迁移配置文档Migrate.xml（XML格式）
b.在Visual Studio 2008/2010 命令提示行中执行以语句进行迁移，并按要求输入VSS管理员密码。
相关链接

正文：

1.准备Visual SourceSafe 2005

a、请所有数据库用户签入他们的文件
b、备份Visual SourceSafe 数据库文件
c、使用 Visual SourceSafe 分析实用工具查找并修复数据库中的数据完整性问题

以下是yaosansi使用的批处理方式进行的数据修复和整理，也可以直接使用命令行方式进行修复。
fixvss.bat

net stop ssservice
net start ssservice
"d:\Program Files\Microsoft Visual SourceSafe\analyze.exe" -f E:\yaosansi_Vss\data
exit

注意：路径 E:\yaosansi_Vss\ 为yaosansi的VSS数据库路径，请改为对应的数据库路径，以下相同。

 

2.分析Visual SourceSafe 数据库文件

a.在VSS数据库根目录中，新建如下所示分析配置文档AnalyzeResult.xml（XML格式）

 

<?xml version="1.0" encoding="utf-8"?> 
<SourceControlConverter> 
<ConverterSpecificSetting> 
<Source name="VSS"> 
<VSSDatabase name = "E:\yaosansi_Vss"></VSSDatabase> －这里是你的VSS数据库路径
</Source> 
<ProjectMap> 
<Project Source="$/"></Project> －这里是要迁移的项目路径，多个项目写多行 <Project Source="$/FolderA"></Project> ，$/表示整个数据库
</ProjectMap> 
</ConverterSpecificSetting> 
<Settings> 
<Output file="E:\yaosansi_Vss\AnalyzeResult.xml"/>   －这里指分析后生成结果文档的路径 
</Settings> 
</SourceControlConverter>

 

b.在Visual Studio 2008/2010 命令提示行中执行以语句，并按要求输入VSS管理员密码。

 

VSSConverter analyze E:\Maxtv_Vss\analyzeSetting.xml

 

分析完成后该工具将生成一个报告 (AnalyzeResult.xml) 和一个用户映射文件 (usermap.xml）。




注意：


1）usermap.xml生成的路径默认在Visual Studio 2008/2010 命令提示行目录下，VS2010默认为以下路径：

 

Program Files\Microsoft Visual Studio 10.0\VC>

 

2) 如果使用VSSConverter在初始化时推荐安装VSS2005相关补丁，请将补丁打全，再进行分析。如：

 

Initializing...
VSSConverter has detected that Visual SourceSafe does not have the recommended u
pdates installed.  To ensure optimal results, install the updates referred to in
 Knowledge Base Article 950185.  Proceeding without these updates may lead to pr
oblems during migration.  Continue the migration without the updates (Y/N)?

Visual SourceSafe 2005 Update 下载地址为:http://www.microsoft.com/downloads/details.aspx?displaylang=en&FamilyID=8a1a68d8-db11-417c-91ad-02aab484776b


950185的下载地址为：http://code.msdn.microsoft.com/KB950185/Release/ProjectReleases.aspx?ReleaseId=1123

 

3.安装IIS 、SQL SERVER Express 2010  和 Team Foundation Server 2010 （注意先后顺序）

a.配置TFS2010工作模式

如果是小型开发团队或是不打算使用TFS2010更多功能只使用其源代码管理，请将Team Foundation Server 2010 配置为BASIC模式。

b.在服务器上建立相应的TFS用户组及要迁移的用户，修改上面生成的用户映射文件 (usermap.xml），保留将需要迁移的用户，删除其它用户。

修改后的用户映射文件 (usermap.xml）如下所示

<?xml version="1.0" encoding="utf-8"?>
<UserMappings xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema">
  <!--
This file is automatically created by VSS Converter. You can optionally use the file to map
a VSS user to a Team Foundation user. For example, <UserMap From="Jane" To="MyDomain\Janep"></UserMap> 
This mapping causes all actions logged by VSS user “Jane” to be changed to Team
Foundation user “ MyDomain\Janep ” during migration. 
-->
  <UserMap From="abc" To="abc" />
  <UserMap From="yaosansi" To="yaosansi" />
</UserMappings>

 

4.迁移 Visual SourceSafe 2005项目

 

a.在VSS数据库根目录中，新建如下所示迁移配置文档Migrate.xml（XML格式）

<?xml version="1.0" encoding="UTF-8"?>
<SourceControlConverter>
       <ConverterSpecificSetting>
              <Source name="VSS">
                     <VSSDatabase name="E:\yaosansi_Vss"/> -这里是VSS数据库路径
                     <UserMap name="E:\yaosansi_Vss\Usermap.xml"/> －这里是前面修改过的用户映射文件 (usermap.xml）
                     <SQL Server="WIN-WM62K5YY4H9"/> －这里是SQL Server默认实例名称，当然也可以是其它名称
              </Source>
              <ProjectMap>
                   <Project Source="$/ProjectA.root" Destination="$/Yaosansi.ProjectA/"/> - 这里是要迁移的源项目和TFS对应的目标项目路径
                   <Project Source="$/ProjectB.root" Destination="$/Yaosansi.ProjectB/"/>
              </ProjectMap>
       </ConverterSpecificSetting>
       <Settings>
              <TeamFoundationServer name="WIN-WM62K5YY4H9" port="8080" protocol="http"  collection="tfs/DefaultCollection"/> －TFS信息
              <Output file="E:\yaosansi_Vss\MigrationResult.xml"/>  －这里是生成的迁移结果
       </Settings>
</SourceControlConverter>

 

注意：当出现 “Unable to connect to this Team Foundation Server:”提示时，请在TFS信息中加载属性collection="tfs/DefaultCollection"/（TFS默认集合的路径）


参考：http://social.msdn.microsoft.com/Forums/en/tfsversioncontrol/thread/6dea88dc-8482-40f3-ab96-8db608360aab

b.在Visual Studio 2008/2010 命令提示行中执行以语句进行迁移，并按要求输入VSS管理员密码。

 

VSSConverter.exe Migrate E:\Maxtv_Vss\Migrate.xml

 

相关链接:

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


演练：从 Visual SourceSafe 迁移到 Team Foundation


Migrating VSS 2005 to TFS 2008


VSS迁移至TFS


实战TFS2008第二部分：将代码从VSS迁移到TFS


TFS 2010 for SourceSafe Users


Team Foundation Installation Guide for Visual Studio 2010


TFS 2010 让安装更简单，也让VSS成为历史


VS 2008如何连接TFS 2010


VSTS 2010体验 - TFS 2010变化巨大


Teamprise 3.3 如何連 TFS 2010 ( 小技巧 )


Installing TFS 2010 on Windows Server 2008 R2 RC


Tutorial: Getting Started with TFS in VS2010