使用 VSSUpgrade 命令提示字元工具從 Visual SourceSafe 升級

發行項
03/01/2013

在大部分情況下，您應該使用 VSS 升級精靈，而不是 VssUpgrade 命令提示工具來升級您的 Visual SourceSafe 資料。不過，還是有少數的情況，您可能會想要在其中使用 VssUpgrade 命令提示工具來升級到內部部署 Team Foundation Server (TFS)。

若要使用 VSSUpgrade 升級您的 Visual SourceSafe 資料

了解工具如何轉換您的資料 TFS 和 Visual SourceSafe 在功能上有顯著的差異。因此，Visual SourceSafe 升級工具會在升級期間修改特定種類的資料。
準備升級開始升級程序之前，請務必預先規劃並準備您的資料。

重要事項

在您繼續之前，必須在 Visual SourceSafe 儲存機制上執行 Visual SourceSafe ANALYZE 公用程式。請參閱複製及準備您的 Visual SourceSafe 資料庫。
了解獨特的 VssUpgrade 功能。如果您不需要其中任何一個，則應該使用 VSS 升級精靈。
分析您的資料：在您將 Visual SourceSafe 中的資料升級至 Team Foundation 版本控制之前，您必須使用 [分析] 命令來判斷資料中是否有任何問題將會影響升級的結果。這個程序也會產生升級資料所需的使用者對應檔。
升級您的資料：若要升級資料，您必須指定如何升級使用者名稱、建立移轉設定檔案，然後執行 [移轉] 命令。
檢視和驗證結果，並視需要解決問題。

重要事項
在您繼續之前，必須在 Visual SourceSafe 儲存機制上執行 Visual SourceSafe ANALYZE 公用程式。請參閱複製及準備您的 Visual SourceSafe 資料庫。

VssUpgrade 功能

如果您想要將資料升級和移植到內部部署 Team 專案和下列目標，請使用 VssUpgrade：

做為自動化方法 (例如指令碼) 的一部分來執行升級。
使用您指定的資料夾結構，將多個 Visual SourceSafe 專案移轉至單一 Team 專案中。
指定如何轉換使用者資料，例如從 Visual SourceSafe 中的 Kim 轉換為 TFS 中的 EUROPE\KimT。
在 Visual SourceSafe 資料中忽略標籤。
當升級大量資料時，在程序中斷之後繼續 (例如，由於網路錯誤中斷)。

如果您不需要這其中任何一項功能，或是您需要將資料升級並移植到 Team Foundation Service 上的 Team 專案集合，則應用程式使用 VSS 升級精靈，而不是 VssUpgrade。

分析您的資料

將 Visual SourceSafe 中的資料升級至 TFS 版本控制之前，您必須先使用 [分析] 命令來判斷資料中是否有任何問題將會影響升級的結果。這個命令也會產生一個使用者對應檔，[移轉] 命令會使用這個檔案來升級資料。

建立分析設定檔

執行 [分析] 命令之前，您必須先建立分析設定檔。在這個檔案中，您會指定您將升級之 Visual SourceSafe 資料庫的路徑以及您想要升級的資料夾。

下列 XML 是分析設定檔的範例。

<?xml version="1.0" encoding="utf-8"?>
<SourceControlConverter>
<ConverterSpecificSetting>
     <Source name="VSS">
          <VSSDatabase name="c:\ourvss"></VSSDatabase>
          <UserMap name="c:\ourvss\migrate\Usermap.xml"></UserMap>
     </Source>
     <ProjectMap>
          <Project Source="$/Core"></Project>
          <Project Source="$/ProjectA"></Project>
          <Project Source="$/ProjectB"></Project>
     </ProjectMap>
</ConverterSpecificSetting>
<Settings>
     <Output file="c:\ourvss\migrate\logs\ContosoVSSAnalyze.xml"></Output>
</Settings>
</SourceControlConverter>

您可以複製上一個範例，並將它貼到自己的分析設定檔，然後加以修改。下列資訊可幫助您根據您的需求來改寫範例。

<?xml encoding> 屬性

<?xml encoding> 屬性必須符合分析設定檔中所使用的編碼方式。例如，如果此檔案儲存為 Unicode，則 <?xml encoding> 標記會如下所示：

<?xml version="1.0" encoding="unicode">

<VSSDatabase name> 屬性

在 <VSSDatabase name> 屬性中，針對您要升級之 Visual SourceSafe 資料庫的複本指定包含 srcsafe.ini 檔案的資料夾路徑。例如：

<Source name="VSS">
   ...
   <VSSDatabase name="c:\ourvss"></VSSDatabase>
   ...
</Source>

此路徑不得包含 srcsafe.ini 字串。例如，下列 <VSSDatabase name> 屬性不正確，而且會導致 VssUpgrade 命令失敗：

<Source name="VSS">
   ...
   <VSSDatabase name="c:\ourvss\srcsafe.ini"></VSSDatabase>
   ...
</Source>

<UserMap name> 屬性

[分析] 命令會收集和編譯有關 Visual SourceSafe 使用者的資料，並將其儲存在 XML 檔案中。您也可以選擇指定檔案的路徑和名稱，您希望此資料儲存在這個檔案的 <UserMap name> 屬性中。如果您未指定這個屬性，[分析] 命令會建立名為 UserMap.xml 的檔案，將其放置在目前的目錄中。

<ProjectMap> 區段

在 <ProjectMap> 區段中，於 <Project> 項目的 Source 屬性中指定您想要升級之每一個 Visual SourceSafe 專案的路徑。

若要升級 Visual SourceSafe 資料庫中的所有資料，請讓 <ProjectMap> 區段符合以下範例：

<ProjectMap>
   <Project Source="$/"></Project>
</ProjectMap>

您可以在不同時間升級選取的專案，而不用同時升級整個 Visual SourceSafe 資料庫。

提示
如果您有許多要升級的資料，請使用這個選項用避免在升級時封鎖您的小組。

Source 屬性中的路徑不得重疊。例如，下列 <ProjectMap> 區段無效：

<ProjectMap>
   <Project Source="$/ProjectA"></Project>
   <Project Source="$/ProjectA/Controller"></Project>
</ProjectMap>

<Output file> 屬性

在 <Settings> 區段的 <Output file> 屬性中，您可以指定您想要寫入分析報表的目標檔案路徑和名稱。如果您不指定這個選項，您可以省略 <Output> 標記。在這個案例中，轉換器會將報表寫入名為 VSSAnalysisReport.xml 的檔案，並將它放在目前的目錄中。

<SQL> 元素

您必須將 <SQL> 項目加入至分析設定檔的 <Source> 區段來指定 VssUpgrade 的資料庫，以便用來儲存暫存資料。此元素會使用下列語法：<SQL Server="SQL_Server_name"></SQL>.

例如，假設您是在名為 FABRIKAM-2 的電腦上執行 VssUpgrade，若要使用同一台電腦上的本機 SQL Server Express 執行個體：

<Source name="VSS">
   ...
   <SQL Server="fabrikam-2\sqlexpress"></SQL>
   ...
</Source>

若要指示轉換器使用 SQL Server (例如名為 FabrikamSQLServer 的伺服器)

<Source name="VSS">
   ...
   <SQL Server="fabrikamsqlserver"></SQL>
   ...
</Source>

執行分析命令

從 Windows [開始]，以系統管理員身分執行 [命令提示字元]。
在 [系統管理員: 命令提示字元] 視窗中，輸入：

VssUpgrade Analyze settings.xml

使用您所建立之分析設定檔的路徑和名稱取代 settings.xml。
出現提示時，輸入您的 Visual SourceSafe 資料庫的系統管理員密碼。如果資料庫沒有密碼，請按 Enter。

VssUpgrade 會在 [分析] 命令進行時顯示進行中狀態。當程序完成時，系統會摘要說明結果。例如：

Analyze complete.
Analyzed 859 files and 941 folders.
Warnings 0 and Errors 0
Pre-migration report file: C:\VSS\migrate\VSSAnalysisReport.xml

如果有任何警告或錯誤，您可以在 ConverterErrors.txt 和 VSSUpgrade.log 中找到相關的詳細資料。

[分析] 命令會產生：

報告，您可以用來取得 [移轉] 命令可能產生之問題和變更的詳細資料。
使用者對應檔 (Usermap.xml)，您可以使用這個檔案來指定如何在升級程序中轉換使用者資料。

這些檔案將在下面詳細說明。

檢閱及解決分析命令找到的問題

分析報表會提供您的 Visual SourceSafe 資料庫在升級過程中，可能會導致問題發生之相關問題的資訊。請嘗試盡量解決多一點的這類問題，讓升級程序的問題減至最少，如下一節所述。

某些檔案已簽出

此報表會列出目前已簽出的檔案。升級程序不會保存簽出資訊。嘗試確保在升級前簽入盡可能多的檔案。

某些項目有資料完整性問題

此報表列出資料完整性受到影響的項目。Visual SourceSafe ANALYZE 公用程式或許能夠修正這類問題。無法修復的項目將不會升級。如需詳細資訊，請參閱 Microsoft 網站的下列網頁：ANALYZE 公用程式 (英文) 和如何在 Visual SourceSafe 中偵測及修正資料庫損毀錯誤 (機器譯文)。

對應專案中的某些資料夾包含了 <ProjectMap> 區段中所未包含的記錄

如果將資料夾從某個專案移到 Visual SourceSafe 資料庫中的另一個專案，該資料夾的記錄會同時包含在原始專案和目前專案中。若要升級這類資料夾以及其所有記錄，您必須同時升級原始專案和目前專案。

例如，您要升級 Visual SourceSafe 專案 Project2。此專案包含 $/Project2/FeatureA 資料夾，這個資料夾在其記錄中的某個時間點從 Project1 移動而來。

如果您的 <ProjectMap> 區段包含…	例如…	則…
兩個專案。	`<ProjectMap> <Project Source="$/Project1"></Project> <Project Source="$/Project2"></Project> </ProjectMap>`	將資料夾及其完整記錄一起升級。
原本包含此資料夾的專案，而不是目前包含此資料夾的專案。	`<ProjectMap> <Project Source="$/Project1"></Project> </ProjectMap>`	未升級此資料夾。
目前包含此資料夾的專案，而不是原本包含此資料夾的專案。	`<ProjectMap> <Project Source="$/Project2"></Project> </ProjectMap>`	升級資料夾連同其記錄 (從資料夾移到目前專案開始的記錄)。資料夾移到目前專案之前發生的記錄將不會升級。

如需設定檔之 <ProjectMap> 區段的詳細資訊，請參閱本主題稍早的 <ProjectMap> 區段。

Team Foundation 版本控制不支援某些標籤名稱

此報表會列出升級時將會變更的標籤名稱，因為這些標籤名稱包含了 TFS 版本控制所不支援的字元。請參閱 Team Foundation 中的命名限制。

升級您的資料

執行 [分析] 命令之後，您幾乎已就緒可以將資料升級。執行 [移轉] 命令之前，您必須先建立設定檔。或者，您可以選擇指定如何升級使用者名稱。

指定如何升級使用者名稱

您可以控制如何將使用者資訊從 Visual Source Safe 升級到 TFS 版本控制。您可以明確指定，[移轉] 命令應該將哪一個使用者名稱與 TFS 版本控制中每個項目記錄的每個變更集產生關聯。其作法是編輯當您執行 [分析] 命令時所建立的使用者對應檔，如同本主題稍早所說明。

使用者對應檔為選擇性。如果您省略分析設定檔中的 <UserMap name> 屬性，就會依下列方式建立每一個變更集：

[使用者] 欄位會設定為執行 VssUpgrade 所使用的帳戶名稱。
在您的 Visual SourceSafe 資料庫中執行此動作的使用者名稱會儲存在 [註解] 欄位中。

使用者對應檔範例

當您執行 [分析] 命令時，它會編譯有關 Visual SourceSafe 使用者的資料，並將其儲存在 XML 檔案中。這個檔案會列出在您要升級的 Visual SourceSafe 專案中，曾經執行版本控制作業的每個 Visual SourceSafe 使用者。

下列範例顯示之前由 [分析] 命令所建立的使用者對應檔。

<?xml version="1.0" encoding="utf-8"?>
<UserMappings>
   <UserMap From="Admin" To=""></UserMap>
   <UserMap From="Guest" To=""></UserMap> 
   <UserMap From="Kim" To=""></UserMap>
   <UserMap From="Satomi" To=""></UserMap>
   <UserMap From="Mark" To=""></UserMap>
</UserMappings>

您可以在使用者對應檔中，將 To 屬性指定為無、部分或所有 UserMap 項目。例如，您可以依下列方式修改上述範例：

<?xml version="1.0" encoding="utf-8"?>
<UserMappings>
   <UserMap From="Admin" To="NORTHAMERICA\KenM"></UserMap>
   <UserMap From="Guest" To="Test1"></UserMap> 
   <UserMap From="Kim" To="EUROPE\KimT"></UserMap>
   <UserMap From="Satomi" To="ASIA\SatomiH"></UserMap>
   <UserMap From="Mark" To=""></UserMap>
</UserMappings>

請注意，在上述範例中，Guest 會對應到 Test1 而且未指定任何網域。在這些案例中，VssUpgrade 假設帳戶屬於預設網域。

如果您未指定 <UserMap To> 屬性，就會依下列方式建立每一個變更集：

[使用者] 欄位會設定為執行 VssUpgrade 所使用的帳戶名稱。
在您的 Visual SourceSafe 資料庫中執行此動作的使用者名稱會儲存在 [註解] 欄位中。
如果您指定 <UserMap To> 屬性，而此值是在 Team Foundation Server 上的有效使用者，則 [使用者] 欄位會設定為該帳戶的名稱。如果這個值不是 Team Foundation Server 上的有效使用者，則 VssUpgrade 將會顯示錯誤並結束升級程序。

建立移轉設定檔

您可使用移轉設定檔來指定您想要升級哪些 Visual SourceSafe 資料，並控制您想要升級該資料之方式的幾個層面。建立這個檔案有一個最簡單的方法，就是複製您在本主題稍早的建立分析設定檔中所建立的檔案。然後您可在檔案中加入更多資料，好讓它可供 [移轉] 命令使用。

下列範例顯示移轉設定檔。

<?xml version="1.0" encoding="utf-8"?>
<SourceControlConverter>
<ConverterSpecificSetting>
     <Source name="VSS">
          <VSSDatabase name="c:\ourvss"></VSSDatabase>
          <UserMap name="c:\ourvss\migrate\Usermap.xml"></UserMap>
     </Source>
     <ProjectMap>
          <Project Source="$/Core" Destination="$/CoreTeamProject"></Project>
          <Project Source="$/ProjectA" Destination="$/ClientTeamProject/ProjectA"></Project>
          <Project Source="$/ProjectB" Destination="$/ClientTeamProject/ProjectB"></Project>
     </ProjectMap>
</ConverterSpecificSetting>
<Settings>
     <TeamFoundationServer name="My_Server" port="8080" protocol="http" collection="tfs/DefaultCollection"></TeamFoundationServer>
     <Output file="c:\ourvss\migrate\logs\ContosoVSSMigrate.xml"></Output>
</Settings>
</SourceControlConverter>

下列資訊可幫助您修改移轉設定檔，以指定 [移轉] 命令升級資料的方式。

<ProjectMap>

針對移轉設定檔之 <ProjectMap> 區段中的每個 <Project> 項目，提供 Destination 屬性來指定 Team Foundation Server 上的位置路徑，也就是您想要在 Visual SourceSafe 資料庫中升級專案內容的地方 (在 Source 屬性中指定)。

例如，您想要將 Visual SourceSafe 資料庫中的 ProjectA 內容升級到 Team 專案 (稱為 Client) 根部的 ProjectA 。

<ProjectMap>
   <Project Source="$/ProjectA" Destination="$/ClientTeamProject/ProjectA"></Project>
</ProjectMap>

如果要讓 Destination 屬性中的值有效，下列條件必須成立：

Destination 屬性中的 Team 專案 (在上述範例中，Team 專案為 ClientTeamProject) 必須已經位於 Team 專案集合中，您才能開始升級程序。

<Project> 元素之 Destination 屬性中的路徑不得與任何其他 <Project> 元素之 Destination 屬性中的路徑重疊。例如，下列 <ProjectMap> 區段無效：

<ProjectMap>
   <Project Source="$/ProjectA" Destination="$/ClientTeamProjectA/"></Project>
   <Project Source="$/ProjectB" Destination="$/ClientTeamProjectA/ProjectB"></Project>
</ProjectMap>

注意事項
如果 Destination 屬性中的資料夾包含任何項目，而且有任何一個 Visual Source Safe 項目的路徑與任何這些項目的版本控制路徑重疊時，升級程序將會失敗。

<TeamFoundationServer> 標記

在 <Settings> 區段中加入 <TeamFoundationServer> 標記，並使用下列格式指定 Team 專案集合在 Team Foundation Server 上的名稱、連接埠、通訊協定和路徑：

<TeamFoundationServer name="ServerName" port="PortNumber" protocol="http" collection="path/collection name></TeamFoundationServer>

<Label migrate="false" /> 標記

如果您的 Visual SourceSafe 資料庫包含許多會套用到許多檔案的標籤，升級程序的作業時間可能會延長。如果您的小組不需要此資料，您可以將 <Label migrate="false" /> 標記加入至 <Settings> 區段來設定 VssUpgrade 忽略標籤。

<Output file> 屬性

在 <Settings> 區段的 <Output file> 屬性中，您可以指定您想要寫入升級報表的路徑和檔案。如果您未包含此屬性，轉換器會將報表寫入名為 VSSMigrationReport.xml 的檔案，並將它放在目前的目錄中。

執行移轉命令

從 Windows [開始]，以系統管理員身分執行 [命令提示字元]。
在 [系統管理員: 命令提示字元] 視窗中，輸入：

VssUpgrade Migrate settings.xml

使用您所建立之移轉設定檔的路徑和名稱取代 settings.xml。

[移轉] 命令會顯示您從 Visual SourceSafe 資料庫升級的每一個專案，以及 Team Foundation 版本控制伺服器上將用來升級資料的每一個目標資料夾。
出現提示時，輸入您的 Visual SourceSafe 資料庫的系統管理員密碼。如果資料庫沒有密碼，請按 Enter。

系統會摘要說明其將如何執行升級程序，並要求您確認是否要執行。例如：

This will start migration with following inputs:

SourceSafe Folders -> Team Foundation Server Folders

$/ -> $/Sequence2

Full history migration of VSS Database: c:\vss

Team Foundation Server: http://fabrikam-4:8080/tfs/DefaultCollection
Migration Settings File: migrate_settings.xml
Migration Report: C:\VSS\migrate\VSSMigrationReport.xml

Depending on the VSS database size, migration may take few hours to complete.
Please verify all inputs are correct and confirm.
Start migration (Y/N)?

按下 Y 以繼續。

VssUpgrade 會在移轉命令進行時顯示進行中狀態。當程序完成時，系統會摘要說明結果。例如：

Verification of pinned versions: 0 file(s) added, 0 file(s) edited and 86 file(s) label updated
Verification of latest tip versions: No change was required (No fixes required. All latest tip versions were migrated successfully)

Started: Creating label "Pinned_Latest".
Finished: Creating label "Pinned_Latest".

Migration complete.
Migrated 6397 Actions
Warnings 7 and Errors 0
Post migration report file: C:\VSS\migrate\VSSMigrationReport.xml

如果有任何警告或錯誤，您可以在 ConverterErrors.txt 和 VSSUpgrade.log 中找到相關的詳細資料。

[移轉] 命令會產生一份報告，您可以用來取得 [移轉] 命令可能造成之問題和變更的詳細資料。請參閱從 Visual SourceSafe 升級後繼續執行後續步驟。

使用累加升級繼續此程序

如果升級程序因某個原因而中斷，您可以從之前結束程序的那一點，以累加升級方式繼續進行程序。如果升級程序因為錯誤或網路問題而失敗，累加升級可能會很實用。在累加升級期間，轉換器將只會升級未在先前工作階段中升級的資料。

若要開始累加升級，請遵循執行移轉命令中的步驟執行。當 [移轉] 命令詢問您是否要執行累加移轉時，請按 Y。

累加升級的限制

只有當您遵守以下限制時，累加升級才會成功：

在您的 Visual SourceSafe 資料庫中，不可以有執行終結、清除、封存或還原的活動。
您不可以變更移轉設定檔的 <ProjectMap> 區段。
在您的 Team Foundation Server 上，不得修改移轉設定檔之 <ProjectMap> 區段中所指定的任何資料夾 (或是資料夾中的任何內容)。

後續步驟

檢視和驗證結果，並視需要解決問題。

共用方式為

使用 VSSUpgrade 命令提示字元工具從 Visual SourceSafe 升級

若要使用 VSSUpgrade 升級您的 Visual SourceSafe 資料

VssUpgrade 功能

分析您的資料

建立分析設定檔

<?xml encoding> 屬性

<VSSDatabase name> 屬性

<UserMap name> 屬性

<ProjectMap> 區段

<Output file> 屬性

<SQL> 元素

執行分析命令

檢閱及解決分析命令找到的問題

某些檔案已簽出

某些項目有資料完整性問題

對應專案中的某些資料夾包含了 <ProjectMap> 區段中所未包含的記錄

Team Foundation 版本控制不支援某些標籤名稱

升級您的資料

指定如何升級使用者名稱

使用者對應檔範例

建立移轉設定檔

<ProjectMap>

<TeamFoundationServer> 標記

<Label migrate="false" /> 標記

<Output file> 屬性

執行移轉命令

使用累加升級繼續此程序

後續步驟

其他資源