以下說明如何排解您在設定 Google Workspace Migrate 及執行遷移作業時可能遇到的問題。
排解關聯或連線錯誤
查看服務主機記錄- 如何找到記錄：
- 平台安裝 - 前往 C:\Program Files\Google Workspace Migrate\Google Workspace Migrate Platform\AppBridgeServiceHost.log。
- 節點安裝 - 前往 C:\Program Files\Google Workspace Migrate\Google Workspace Migrate Platform Node\AppBridgeServiceHost.log。
注意：如果您使用的是舊版 Google Workspace Migrate，可能需要在路徑中使用「G Suite」，而不是「Google Workspace」。
- 開啟記錄並捲動至底部。
- 如果有任何相關問題，請排解問題。
您可以放心忽略「Access denied: Symmetric encryption is required for this service request but not configured」(存取遭拒：這項服務要求需要對稱加密，但尚未設定) 訊息。
- 如果無法修正問題，請參閱「就 Google Workspace Migrate 問題與支援團隊聯絡」。
- 登入 Google Workspace Migrate 平台，按一下右上角的「Servers」。
- 確認節點顯示在清單中。
- 檢查節點狀態是否顯示為「Ready」(綠色)。
嘗試將節點與 Google Workspace Migrate 平台建立關聯時，如果系統顯示錯誤訊息，請檢查該節點是否正在執行：
- 在執行平台的電腦瀏覽器中，輸入節點的 IP 位址和通訊埠 (例如 http://192.0.2.1:5131)。
- 如果平台可以連上節點，且節點服務正在執行，系統會顯示「Node is running」(節點正在執行) 訊息。
- 如果系統顯示錯誤訊息，請嘗試下列做法：
- 如果是網路錯誤，請解決問題後再試一次。
- 重新啟動節點服務。
- 重新安裝節點應用程式。詳情請參閱「安裝節點伺服器」章節中的操作步驟。
如果發生這項錯誤，請按照下列步驟操作：
- 前往節點伺服器的服務主機記錄。
詳情請參閱「檢查服務主機記錄」。
- 檢查是否有下列錯誤：The provided platform host address https://platformserver:443/Hub was unreachable (提供的平台主機位址 https://<平台伺服器>:443/Hub 無法連線)。
- 如果您看到錯誤訊息，請嘗試下列做法：
- 檢查與平台伺服器的網路連線。如果發生網路問題，請修正問題並重新啟動節點服務。
- 如果平台使用傳輸層安全標準 (TLS) 憑證進行設定，請在搭載平台的電腦上使用瀏覽器，輸入平台的 IP 位址和通訊埠 (例如 https://192.0.2.1:5131)。此外，也請檢查 TLS 憑證是否有效，且尚未過期。
如果主機記錄顯示「invalid_grant」invalid_grant訊息，請確認以下事項：
- 您已為目標帳戶啟用所有 API 範圍。詳情請參閱「使用 Google Cloud Console 啟用 API」。
- 已透過 Google 管理控制台將所需範圍的權限授予服務帳戶。請使用 OAuth 2.0 用戶端 ID 授權，而非服務帳戶的用戶端 ID。詳情請參閱「建立 OAuth 網路用戶端 ID」。
如果遷移作業的執行速度緩慢或完全無法運作，則錯誤可能與 Google Workspace 的 API 配額標準有關。詳情請參閱「使用配額」。
追蹤遷移作業的健康狀態與進度
監控分區您可以在執行掃描或橋接設定時監控分區狀態。
- 在 Google Workspace Migrate 平台中，按一下「Scans」或「Bridges」。
- 在您要檢查的掃描或橋接設定上，依序按一下「記錄」圖示
。
- 在「State」(狀態) 之下查看分區的狀態：
- Ready (就緒)：準備開始使用。
- Starting (啟動中)：準備遷移或掃描。
- Crawling (檢索中)：正在讀取來源系統的資料。
- Processing (處理中)：準備將資料寫入目標系統。
- Committing (執行中)：正在將資料寫入目標系統。
- Cancelled (已取消)：失敗。請參閱「排解已取消分區的問題」一節。
- Completed (已完成)：作業已完成。
- Skipped (已略過，會在重試失敗時顯示)：因沒有發生失敗而略過。
如果您在分區記錄中發現狀態顯示為「Canceled」(已取消) 的分區，請按照下列做法排解問題。
做法 1：檢查錯誤代碼
如要找出錯誤代碼，請將游標移至分區記錄中任一資料列，然後依序點選「More」(更多) 圖示 。請使用與失敗相關的錯誤代碼排解問題。詳情請參閱「解讀 Google Workspace Migrate 錯誤訊息」。
做法 2：檢查節點
使用分區記錄檢查節點上的所有分區是否已取消。所有節點已取消通常代表連線問題，例如來源服務暫時無法使用。請完成「為節點建立關聯時發生錯誤」章節中所述的步驟。接著，請重試掃描或執行差異遷移。
做法 3：檢查分區執行記錄
如果問題會影響多個節點，您可以檢查分區執行記錄。如要查看與分區相關聯的執行記錄，請按照下列步驟操作：
- 開啟分區記錄。
- 將游標移至記錄中的任一資料列，然後依序點選「More」(更多) 圖示
- 依序按一下「State」(狀態)
- 查看失敗狀態識別發生問題的原因，並進行疑難排解。
- 重試掃描或遷移作業。
如果遷移摘要中類似的失敗次數增加，表示您的遷移設定可能有誤。
請檢查下列設定項目，確認設定正確無誤：
- 確認您已在 Google 管理控制台中正確啟用 API (尤其是 Admin SDK)。詳情請參閱「使用 Google Cloud Console 啟用 API」。
- 確認來源帳戶和 Google Workspace Migrate 中已有使用者帳戶。請確認帳戶並未遭到凍結、停權或重新命名。
- 確認所有使用者已啟用必要的 Google Workspace Migrate 服務 (例如 Gmail 或 Google 雲端硬碟)。詳情請參閱「Google Workspace 需求。
如果在主機記錄中看到這則錯誤訊息，您可能需要允許第三方應用程式存取雲端硬碟檔案。
如要修正這個問題，請按照「允許第三方應用程式使用儲存在雲端硬碟中的檔案」一文的步驟操作。
排解橋接設定錯誤
將橋接設定做為差異遷移執行您通常可透過執行差異遷移來修正許多錯誤。差異遷移會找出一再發生的錯誤，並清除暫時性問題，例如頻率限制和配額層級、網路問題和 401 錯誤。您可以多次執行差異遷移來排解這類問題。詳情請參閱「準備開始使用」。
| 60008 錯誤或關鍵字 | 疑難排解步驟 |
|---|---|
| No mapping found (找不到對應). | 如果您正在從某個 Google Workspace Migrate 帳戶遷移共用雲端硬碟資料，而且已在目標帳戶中手動建立共用雲端硬碟，就可能收到這則錯誤訊息。疑難排解方式：
|
| 受影響項目所依賴的交易失敗。 | 找出相同橋接設定中的其他失敗項目，並排解相關問題。解決問題時，請執行差異遷移橋接設定。 |
|
無法遷移上層物件。 系統可能也會顯示「The bridge execution was halted or completed prior to dependency of the transaction being completed.」(執行的橋接設定在交易依賴完成前已暫停或已完成)。 |
無法遷移受影響項目的上層物件，或下層物件已在上層物件之前遷移。疑難排解方式：
|
| 目標父系實體在遷移後會遭到移除、重新命名或移至其他位置。如果其他橋接設定嘗試再次遷移來源父系或子系實體，系統可能找不到這些實體。 |
|
| 不支援來源與目標對應組合。 | 檢查對應項目，確認來源和目標位置皆有效。詳情請參閱 Exchange、SharePoint、檔案共用區、Box 或 Google Workspace Migrate |
| LocationNotFound | Google Workspace 共用雲端硬碟無法遷移至目標帳戶，因為目標使用者不具有包含共用雲端硬碟的 Google Workspace 授權。請檢查目標帳戶的授權，然後再試一次。 |
| OrphanedContent |
如果對應設定未指定孤立項目的擁有者為來源帳戶，也可能顯示這則錯誤訊息。Google Workspace Migrate 不會遷移這個項目，並且顯示 60008 錯誤代碼。在此情況下，這個錯誤無法避免。 注意：位於其他目標位置的孤立檔案，錯誤可能是其他問題所導致。舉例來說，如果未在孤立項目的對應中指定目標資料夾，而這些項目位於目標使用者的「我的雲端硬碟」根資料夾，就會發生這種情況。 |
| No mapping found for user |
|
如果檔案無法遷移並顯示此錯誤訊息，請按照下列步驟操作：
- 開啟交易記錄。
- 在「錯誤代碼」部分搜尋「1029」，判斷上層資料夾是否遷移失敗。
- 如果上層資料夾未遷移，請檢查錯誤代碼並修正問題。
- 執行差異遷移橋接設定
如要在不同共用雲端硬碟之間遷移檔案，請務必使用識別資訊對應檔，將來源對應至橋接設定中的目標使用者。
- 在 Google Workspace Migrate 平台中，按一下「Scans」或「Bridges」。
- 在您要檢查的掃描或橋接設定上，依序按一下「記錄」圖示
- 將游標移至交易，並依序按一下「更多」圖示
- 使用下表找出常見的交易錯誤，並瞭解相關疑難排解步驟。
| 錯誤訊息和代碼 | 疑難排解步驟 |
|---|---|
| 交易狀態為「Failed」(失敗) | 找出該筆交易，並利用交易詳細資料中的資訊排解問題。 |
| 錯誤訊息：The request type does not allow write operations (要求類型不允許寫入作業)
錯誤代碼：1048640 |
物件類型的要求處理常式無法將物件寫入目標帳戶 (例如來源項目在 Google Workspace 中沒有對等的類型)。
請檢查您的位置對應是否設定正確，以及對應關係是否合理。 |
| 錯誤訊息：An internal connector error occurred (發生內部連接器錯誤) 錯誤代碼：2097125 |
查看交易和執行記錄中的錯誤訊息。如果錯誤訊息無法協助您解決問題，請查看平台或節點服務主機記錄瞭解詳情。 |
| The bridge execution was halted or completed prior to dependency of the transaction being completed (執行的橋接設定在交易依賴完成前已暫停或已完成) | 項目未轉移，因為此項目依賴另一個先遷移的項目，但該項目未成功遷移。舉例來說，如果雲端硬碟中未建立某個資料夾，系統就不會遷移該資料夾中的檔案。
您可以在該錯誤中找出 ABHierarchicalPath.Path，並記下相關項目。接著，在交易記錄中找出該項目，瞭解無法遷移的原因。 |
系統可能會略過交易記錄中的交易，原因如下：
- 您正在執行差異遷移，但物件在上次遷移後並未異動。
- 設定範本中的篩選條件將物件排除。
- 您將電子郵件內容遷移至群組，且略過大型郵件的附件。
- 您要將內容遷移至「我的雲端硬碟」，但目前使用的是共用雲端硬碟的設定範本。
視遷移來源而定，系統會略過項目的其他原因如下：
- SharePoint：略過不屬於文件庫的資料夾。
- Exchange：遷移至 Google 網路論壇時，系統會略過電子郵件草稿。
- Box：略過空白的檔案修訂版本。
- 檔案共用區：略過因為節點權限不足，無法存取的項目。
- Gmail：略過即時通訊訊息 (具有「即時通訊」標籤的項目)。
使用「預設」設定範本在共用雲端硬碟之間遷移資料時，GWM 會在目標帳戶中建立新的共用雲端硬碟，但可能不會遷移來源共用雲端硬碟的資料。可能的原因如下：
- 沒有來源和目標之間的識別資訊對應檔。
- 未勾選範本中的「允許未對應的使用者」選項。
有兩種方法可以修正這個問題：
- 透過「Default」設定範本建立自訂範本，然後勾選「Allow unmapped users」。
- 新增識別資訊對應檔。
交易報表檔案可能過大，因此無法下載。請嘗試下列疑難排解方法：
方法 1：在遷移前新增篩選條件
如要縮減報表大小，可以篩選交易記錄，只搜尋特定資料，例如完成狀態或錯誤代碼。詳情請參閱「監控遷移進度」。
方法 2：下載套用篩選條件的記錄
您可以使用指令列指定交易記錄的下載方式：
- 如要減少記錄中的項目數量，請使用 transactionState 選項。
- 如要延長記錄下載作業的允許時長，請使用 queryTimeout 選項。
詳情請參閱「使用指令列下載記錄」。
如果遷移作業比預期慢，請確認是否符合下列系統需求。
Google API 配額等級
配額設定可能會導致出現錯誤代碼，例如 403 Forbidden Error、429 Too Many Requests 或 503 Service Unavailable。如要確認配額等級是否會影響遷移速度，請按照下列步驟操作：
- 在 Google Cloud 控制台中查看配額。相關步驟請參閱「在 Google Cloud 控制台中查看配額」。
- 調整配額，支援資源用量。相關步驟請參閱「使用控制台管理配額」。
用戶端節流設定
節流設定可管理用戶端向 Google 服務傳送要求的速度。有時設定會導致出現錯誤代碼，例如 403 Forbidden Error、429 Too Many Requests 或 503 Service Unavailable。
如果 Google Workspace Migrate (GWM) 的節流率過高，可能會導致這些錯誤代碼。如果用戶端節流限制偏高，但伺服器端節流限制不高，建議調整 GWM 的緩衝設定。
事前準備
- 更新相關設定可能導致意料之外的結果，因此建議只由經驗豐富的管理員嘗試。
- 下列步驟會設定 Google 節流策略，但您可能也需要使用其他資料來源，包括 googleThrottlingStrategy、exchangeThrottlingStrategy 和 sharepointThrottlingStrategy。
如要覆寫 GWM 2.1.54.0 以上版本的預設節流策略，請按照下列步驟操作：
- 在 Platform 伺服器上建立目錄：C:\ProgramData\AppBridge\Overrides。
- 新增名為 throttling_settings.json 的 JSON 檔案。
- 使用記事本將下列文字新增至 JSON 檔案：
{
"googleThrottlingStrategy": {
"throttlingModel": "ADAPTIVE_THROTTLING",
"adaptiveThrottlePadding": 32,
"adaptiveThrottleAcceptanceRatio": 1.1,
"adaptiveThrottleIntervalMs": 60000
}
} - 儲存 JSON 檔案。
- 在 Windows 系統匣中按一下
。
- 停止 GWM 服務，然後重新啟動。
防火牆限制
為減少對磁碟和網路作業的干擾，請從 Workspace 伺服器解除安裝防毒軟體、安全性掃描程式和其他非必要軟體。
Google Workspace Migrate 會使用 MySQL 儲存設定和記錄詳細資料。如果 MySQL 連線不穩定或沒有回應，請參閱「查看服務主機記錄」，然後執行平台安裝步驟。
如果 AppBridgeServiceHost.log 顯示 MySQL 錯誤：
- 請參閱「排解 MySQL 相關問題」。
- 如果仍需要協助，請參閱「就 Google Workspace Migrate 問題與支援團隊聯絡」。
其他支援資源
請參閱「就 Google Workspace Migrate 問題與支援團隊聯絡」。
Google、Google Workspace 與相關符號和標誌均為 Google LLC 的商標。所有其他公司名稱和產品名稱則為相關公司的商標。