從 Visual SourceSafe 升級後繼續執行後續步驟

發行項
03/01/2013

升級完成後，您應該確認結果符合您的預期，而且資料已準備好可供您的小組使用：

檢查升級程序的結果
解決問題
- 解決 SQL Server Express 儲存限制所造成的失敗
- 轉換 MS-DOS 相容簡短名稱 (8.3) 格式的檔案 (TF227014)

檢查升級程序的結果

檢閱報表，並且視需要檢視升級工具所產生的記錄。檢查 Team Foundation Server 上的資料，以確定 Visual SourceSafe 資料庫中的資料已依照您預期的方式升級。

檢視移轉報告

TFS 和 Visual SourceSafe 在功能上有顯著的差異。因此，Visual SourceSafe 升級工具會在升級期間修改特定種類的資料。而在某些情況下，可能會發生錯誤或問題。移轉報告可以通知您有關這些問題。

若要開啟移轉報表：

如果您使用了 VSS 升級精靈：在 [完成] 頁面上，請選擇 [升級報告] 連結。
如果您使用了 VssUpgrade 工具：開啟在目前目錄中，或您使用 <Output file> 屬性所指定之任何檔案名稱和位置上的 VSSAnalysisReport.xml 報表。

移轉報告

檢視記錄檔

如果有警告或錯誤回報，您可能會想要檢視記錄。您充也要檢視記錄來取得您的資料在升級過程中遭修改情形的詳細資訊。若要檢視記錄檔：

如果您使用了 VSS 升級精靈：在 [完成] 頁面上，請選擇 [完整記錄] 連結。
如果您使用了 VssUpgrade 工具：開啟 ConverterErrors.txt 和 VSSUpgrade.log。

檢查 Team 專案中的資料

使用原始檔控制總管來檢查 Team Foundation Server 上的資料，以確定 Visual SourceSafe 資料庫中的資料已依照您預期的方式升級。

解決問題

檢查過升級程序的結果之後，您可能需要對問題進行疑難排解。

解決 SQL Server Express 儲存限制所造成的失敗

升級工具會使用資料庫來儲存暫存中繼資料。此中繼資料通常只需要您所升級之資料大小總計的少量百分比。萬一升級因為達到 SQL Server Express 的 4 GB 限制而失敗，您可以使用 SQL Server 而不使用 SQL Server Express。請參閱使用精靈從 Visual SourceSafe 升級或 VssUpgrade <SQL> 項目。

轉換 MS-DOS 相容簡短名稱 (8.3) 格式的檔案 (TF227014)

TFS 不允許使用 MS-DOS 相容簡短名稱 (8.3) 格式的檔案名稱 (例如，abcdef~1.txt)。當您分析或嘗試升級具有這類名稱的檔案時，將會出現 TF227014 錯誤。

若要解決此問題，您可以暫時將一項設定套用至 Team Foundation Server，好讓它允許具有這類名稱的檔案。若要這麼做，您必須在 TFS 的組態資料庫中，將 Allow8Dot3Paths 設定為 True。

重要事項
為了避免支援 MS-DOS 相容簡短名稱的用戶端機器發生問題，當您完成升級程序之後，強烈建議您將 Allow8Dot3Paths 設定為 False，如下列程序所述。

若要執行下列程序，TFS 的應用程式層伺服器上必須啟用 Windows PowerShell。請參閱使用 Windows PowerShell 撰寫指令碼。

必要的使用權限

您必須是 TFS 應用程式層伺服器上的 [Administrators] 群組成員。如需詳細資訊，請參閱Team Foundation Server 使用權限。

若要升級包含 MS-DOS 相容簡短名稱格式檔案的 Visual SourceSafe 資料庫

登入 Team Foundation 的應用程式層伺服器。
建立名為 Allow8Dot3Paths 的 Windows PowerShell 指令碼。
1. 複製本主題後面 Allow8Dot3Paths PowerShell 指令碼中的文字，並將該文字貼到指令碼中。
2. 變更 ServerPath，使其符合您用來連接 Team Foundation Server 之 URL 中的路徑。依預設，伺服器路徑為 "tfs"。
3. 變更 CollectionName，使其符合您要將資料升級至其中的 Team 專案集合名稱 (例如 DefaultCollection)。
  
  舉例來說，最後結果會是指令碼中的以下這一行：
```
$collectionBaseUrl = "https://localhost:8080/tfs/DefaultCollection/";
```
執行 Allow8Dot3Paths 指令碼。
回收 Team Foundation Server 的應用程式集區。
1. 從 Windows [開始] 執行 [電腦管理]。
2. 在瀏覽窗格中，展開 [服務及應用程式]。
3. 選擇 [Internet Information Services (IIS) 管理員]，展開本機電腦，然後按兩下 [應用程式集區]。
4. 開啟應用程式集區的捷徑功能表，然後選擇 [回收]。
執行移轉命令。
修改您之前建立的 Allow8Dot3Paths Windows PowerShell 指令碼，以 "false" 取代 "true"。
執行修改過的 Allow8Dot3Paths 指令碼。
回收 Team Foundation Server 的應用程式集區 (如上所述)。
在 Visual Studio 中，如果您尚未連接，請連接到 Team 專案，而這是您已將資料升級至其中的專案。
在 [原始檔控制總管] 中，將名稱為 MS-DOS 相容簡短名稱 (8.3) 格式的任何檔案重新命名。

Allow8Dot3Paths PowerShell 指令碼

# Load client OM assembly.
[Reflection.Assembly]::Load("Microsoft.TeamFoundation.Client, Version=10.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a");

$collectionBaseUrl = "https://localhost:8080/ServerPath/CollectionName/";

$tfs = [Microsoft.TeamFoundation.Client.TeamFoundationServerFactory]::GetServer($collectionBaseUrl);
$collectionHive = $tfs.GetService([Microsoft.TeamFoundation.Framework.Client.ITeamFoundationRegistry]);

# Set some version control settings in the collection hive.
$collectionHive.SetValue("/Service/VersionControl/Settings/Allow8Dot3Paths", "True");

# Display all version control settings as a table.
$collectionHive.ReadEntries("/Service/VersionControl/Settings/...") | ft -a

共用方式為