VSS2005升级到TFS2010

准备环境，安装TFS，VSS什么的就都不说了。假设都已经安装OK了，不过这里VSS的版本可能会有问题，最好和本机的VS语言版本一致，我升级的时候就遇到这个问题，本来装的是VSS 中文版，结果第一步就出了问题，说是语言不一致，无法进行分析，只好把VSS中文版卸载了，又装了英文版才可以用。

Step1:分析VSS，编写一个XML文件,文件名为analy.xml

<?xml version="1.0" encoding="utf-8"?>
<SourceControlConverter>
<ConverterSpecificSetting>
<Source name="VSS">
<VSSDatabase name = "e:\vss"></VSSDatabase>    //这一行是说明VSS数据库路径，可以直接用网络共享路径
</Source>
<ProjectMap>
<Project Source="$/"></Project> //这一行配置的是需要把哪些项目（也就是VSS的目录）迁移至TFS。
</ProjectMap>
</ConverterSpecificSetting>
<Settings>
<Output file="E:\VSS\Result.xml"/>  //第一步的分析结果文件保存在哪。
</Settings>
</SourceControlConverter>

　　运行vssconverter Analyze analy.xml,进行分析，分析报告中会给个错误和警告。我的分析中有一个错误提示：

The error section is about loss of data or information during migration. Errors do not indicate that migration failed, they only alert you to information that the converter was not able to migrate, for example, specific versions of a file or folder, so you can migrate these files manually. The error message gives a brief description of the error and a link to an MSDN document with more details about the error.

Visual SourceSafe updates are not installed Detail TF227032: VSSConverter has detected that Visual SourceSafe does not have the recommended updates installed. To ensure optimal results, install the updates referred to in Knowledge Base Article 950185 .

看意思好像是需要安装一个更新，可找了半天没找到安装哪一个，先进行下一步试试看。

STEP 2：执行迁移过程

将上面的analy.xml文件增加几个配置项，最后的内容如下

<?xml version="1.0" encoding="unicode"?> //因为我在TFS里的项目是中文的，无法识别，用UNICODE编码可以识别中文
<SourceControlConverter>
<ConverterSpecificSetting>
<Source name="VSS">
<VSSDatabase name = "e:\vss\"></VSSDatabase>

<UserMap name="E:\VSS\Usermap.xml"></UserMap>
</Source>
<ProjectMap>
<Project Source="$/Project" Destination="$/项目"></Project>
</ProjectMap>
</ConverterSpecificSetting>
<Settings>
<Output file="E:\VSS\Result.xml"/>
<TeamFoundationServer name="localhost" port="8080" protocol="http" collection="tfs/DefaultCollection"></TeamFoundationServer>

 

</Settings>
</SourceControlConverter>

//上面的 collection配置项很关键，估计不少人卡在了这里。不加这一项的话工具会找localhost：8080而不是localhost:8080/tfs，在这里不得不鄙视一下微软的文档，既然有这个配置项目，在MSDN里居然没有只言片语，最后还是看英文的博客才找到了：

http://social.msdn.microsoft.com/Forums/vstudio/en-US/6dea88dc-8482-40f3-ab96-8db608360aab/vssconverter-2010-migration-unable-to-connect-to-this-team-foundation-server-wrong-url?forum=tfsversioncontrol

最后执行vssconverter migrate analy.xml，这一步操作最好是在TFS服务器上执行，因为VSSCONVERTER工具需要TFS的administrator权限。

终于跑起来了。