逐步解說:從 Visual SourceSafe 移轉至 Team Foundation
更新:2007 年 11 月
本逐步解說將說明如何使用 VSS 轉換器工具 VSSConverter.exe,從 Visual SourceSafe 移轉至 Team Foundation。如需如何準備資料庫進行移轉的詳細資訊,請參閱逐步解說:準備從 Visual SourceSafe 移轉至 Team Foundation。在該逐步解說中,您會找到有關如何準備 SourceSafe 資料庫的詳細資訊以及移轉到 Team Foundation 的使用者清單,如此可以進一步了解移轉程序的運作方式。
在這個逐步解說中,您將完成下列工作:
修改設定檔,以指定要移轉那些資料夾。
執行轉換器,將來源從 Visual SourceSafe 移轉到 Team Foundation,並產生移轉報告。
必要條件
在您嘗試完成本逐步解說之前所要執行的工作:
執行逐步解說:準備從 Visual SourceSafe 移轉至 Team Foundation 中所概述的所有步驟。
指出 Team Foundation 版本控制中的空資料夾,讓您可以移轉 Visual SourceSafe 資料夾;如果目的資料夾不存在,轉換器將會為您建立一個資料夾,唯一的例外情形是在目的資料夾為 Team 專案時;目的資料夾應該是有效的 Team 專案或有效 Team 專案的子資料夾。如需詳細資訊,請參閱HOW TO:建立 Team 專案。
此外,您還需要:
Team Foundation Server 名稱。
在您打算要執行轉換器的電腦上安裝 SQL Server Express。
根據預設,當您安裝 Microsoft Visual Studio Team System 時,也會安裝 SQL Express。
您必須要有系統管理權限,才能連接到 SQLExpress 資料庫來使用轉換器工具。
在您執行 VSSConverter 的電腦上必須要有 Visual SourceSafe 2005。
必要的使用權限
您必須擁有即將移轉之 Visual SourceSafe 資料庫的系統管理權限,才能執行此逐步解說。如需詳細資訊,請參閱 Microsoft 網站中的「HOW TO: 指派專案權限」(網址 https://msdn2.microsoft.com/zh-tw/library/ms181065.aspx) (英文)。您也必須是 SQL Express 的 [sysadmin] 伺服器角色成員。根據預設,如果您是安裝 SQL Express 之電腦上的 [Administrators] 安全性群組成員,您就是 [sysadmin] 伺服器角色的成員。如需詳細資訊,請參閱 Microsoft 網站上 SQL Server 2005 文件中的 "sysadmin" (https://msdn2.microsoft.com/zh-tw/library//ms178032.aspx)。
移轉 SourceSafe 專案資料夾
在您繼續進行實際的轉換作業之前,請先自訂您的設定檔,使它包含當您準備轉換時指定之 SourceSafe 專案的目的資料夾;您必須完成逐步解說:準備從 Visual SourceSafe 移轉至 Team Foundation 中所概述的全部步驟,才能完成這項工作。
修改設定檔案建立移轉檔案
依序按一下 [開始]、[程式集],並依序指向 [Microsoft Visual Studio 2008]、[Visual Studio Tools],然後按一下 [Visual Studio 2008 命令提示字元]。
在命令提示字元下輸入 cd %DriveLetter%\VSS2TeamFoundation。這個資料夾是在您分析 Visual SourceSafe 資料庫以便進行移轉時所建立。如需詳細資訊,請參閱 逐步解說:準備從 Visual SourceSafe 移轉至 Team Foundation。
注意事項: 確定系統磁碟機有足夠的空間可以容納移轉中的最大檔案大小。
以新名稱儲存您為分析所建立的設定檔案 settings.xml,例如 migration_settings.xml。
在命令提示字元中,輸入 notepad migration_settings.xml,然後按 Enter 鍵。
您在分析資料庫以進行移轉時所建立的 settings.xml 檔會在 [記事本] 中顯示。
依下列步驟變更此設定檔。
在 <ProjectMap> 區段中,針對您要移轉的每一個 Visual SourceSafe 資料夾加入 Team Foundation 版本控制中的目的資料夾。請使用下列格式加入 Destination 區段,如下列範例所示。
<Project Source="$/FolderA" Destination="$/Team_Project"></Project>
若要移轉 Visual SourceSafe 資料庫中的所有內容,請改為插入下列 XML 程式碼。
<Project Source="$/" Destination="$/Team_Project/"></Project>
在 <Settings> 區段之下加入 <TeamFoundationServer> 區段,並指定移轉目標之 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_name"></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 替代為您的伺服器名稱,以及將 port number 替代為實際的通訊埠號碼。
儲存您的變更,然後關閉 [記事本]。
若要執行轉換器
將 Visual SourceSafe 資料庫複製到您想執行分析和移轉之電腦的本機資料夾上。雖然您可以在遠端電腦的共用資料夾內移轉 Visual SourceSafe 資料庫,但是完成移轉作業所花的時間會變得較長。
請依序按一下 [開始]、[所有程式]、依序指向 [Microsoft Visual Studio]、[Visual Studio Tools],然後按一下 [Visual Studio 命令提示字元]。
在命令提示字元中輸入下列命令。
VSSConverter Migrate migration_settings.xml
秘訣 請使用 /? 參數來檢視可用的命令列選項。
輸入 Y,確認要移轉。
轉換器工具會顯示移轉狀態。當完成轉換程序時,轉換器工具會在目前的目錄中儲存一份移轉報告,您可使用 Internet Explorer 來檢視這個檔案,以取得詳細資訊。
當您看到提示時,請提供 Visual SourceSafe Admin 使用者的密碼。
注意事項: VSSConverter 不會移轉 Visual Studio 方案的版本控制繫結。您必須手動變更這些繫結。如需詳細資訊,請參閱 HOW TO:從 Visual SourceSafe 移轉原始檔控制繫結。
請參閱
工作
概念
用於移轉原始檔控制的 VSSConverter 命令列公用程式