共用方式為


逐步解說:從 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 中所概述的全部步驟,才能完成這項工作。

修改設定檔案建立移轉檔案

  1. 依序按一下 [開始]、[程式集],並依序指向 [Microsoft Visual Studio 2008]、[Visual Studio Tools],然後按一下 [Visual Studio 2008 命令提示字元]。

  2. 在命令提示字元下輸入 cd %DriveLetter%\VSS2TeamFoundation。這個資料夾是在您分析 Visual SourceSafe 資料庫以便進行移轉時所建立。如需詳細資訊,請參閱 逐步解說:準備從 Visual SourceSafe 移轉至 Team Foundation

    注意事項:

    確定系統磁碟機有足夠的空間可以容納移轉中的最大檔案大小。

  3. 以新名稱儲存您為分析所建立的設定檔案 settings.xml,例如 migration_settings.xml。

  4. 在命令提示字元中,輸入 notepad migration_settings.xml,然後按 Enter 鍵。

    您在分析資料庫以進行移轉時所建立的 settings.xml 檔會在 [記事本] 中顯示。

  5. 依下列步驟變更此設定檔。

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

  6. 移除 <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 替代為實際的通訊埠號碼。

  7. 儲存您的變更,然後關閉 [記事本]。

若要執行轉換器

  1. 將 Visual SourceSafe 資料庫複製到您想執行分析和移轉之電腦的本機資料夾上。雖然您可以在遠端電腦的共用資料夾內移轉 Visual SourceSafe 資料庫,但是完成移轉作業所花的時間會變得較長。

  2. 請依序按一下 [開始]、[所有程式]、依序指向 [Microsoft Visual Studio]、[Visual Studio Tools],然後按一下 [Visual Studio 命令提示字元]。

  3. 在命令提示字元中輸入下列命令。

    VSSConverter Migrate migration_settings.xml

    秘訣

    請使用 /? 參數來檢視可用的命令列選項。

  4. 輸入 Y,確認要移轉。

    轉換器工具會顯示移轉狀態。當完成轉換程序時,轉換器工具會在目前的目錄中儲存一份移轉報告,您可使用 Internet Explorer 來檢視這個檔案,以取得詳細資訊。

  5. 當您看到提示時,請提供 Visual SourceSafe Admin 使用者的密碼。

    注意事項:

    VSSConverter 不會移轉 Visual Studio 方案的版本控制繫結。您必須手動變更這些繫結。如需詳細資訊,請參閱 HOW TO:從 Visual SourceSafe 移轉原始檔控制繫結

請參閱

工作

HOW TO:建立原始檔控制分析和移轉的設定檔

概念

用於移轉原始檔控制的 VSSConverter 命令列公用程式

其他資源

Team Foundation