以下說明如何排解您在設定 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」訊息,請確認以下事項:
- 您已為目標帳戶啟用所有 API 範圍。詳情請參閱「使用 Google Cloud Console 啟用 API」。
- 已透過 Google 管理控制台將所需範圍的權限授予服務帳戶。請使用 OAuth 2.0 用戶端 ID 授權,而非服務帳戶的用戶端 ID。詳情請參閱「建立 OAuth 網路用戶端 ID」。
如果遷移作業的執行速度緩慢或完全無法運作,則錯誤可能與 Google Workspace 的 API 配額標準有關。詳情請參閱「使用配額」。
追蹤遷移作業的健康狀態與進度
監控分區您可以在執行掃描或橋接設定時監控分區狀態。
- 在 Google Workspace Migrate 平台中,按一下「Scans」(掃描) 或「Bridges」(橋接設定)。
- 在您要檢查的掃描或橋接設定上,依序按一下「Logs」(記錄) 圖示 「Partition log」(分區記錄)。
- 在「State」(狀態) 之下查看分區的狀態:
- Ready (就緒):準備開始使用。
- Starting (啟動中):準備遷移或掃描。
- Crawling (檢索中):正在讀取來源系統的資料。
- Processing (處理中):準備將資料寫入目標系統。
- Committing (執行中):正在將資料寫入目標系統。
- Cancelled (已取消):失敗。請參閱「排解已取消分區的問題」一節。
- Completed (已完成):作業已完成。
- Skipped (已略過,會在重試失敗時顯示):因沒有發生失敗而略過。
如果您在分區記錄中發現狀態顯示為「Canceled」(已取消) 的分區,請按照下列做法排解問題。
做法 1:檢查錯誤代碼
如要找出錯誤代碼,請將游標移至分區記錄中任一資料列,然後依序點選「More」(更多) 圖示 「Partition log」(分區記錄)。請使用與失敗相關的錯誤代碼排解問題。詳情請參閱「解讀 Google Workspace Migrate 錯誤訊息」。
做法 2:檢查節點
使用分區記錄檢查節點上的所有分區是否已取消。所有節點已取消通常代表連線問題,例如來源服務暫時無法使用。請完成「為節點建立關聯時發生錯誤」章節中所述的步驟。接著,請重試掃描或執行差異遷移。
做法 3:檢查分區執行記錄
如果問題會影響多個節點,您可以檢查分區執行記錄。如要查看與分區相關聯的執行記錄,請按照下列步驟操作:
- 開啟分區記錄。
- 將游標移至記錄中的任一資料列,然後依序點選「More」(更多) 圖示 「Execution log」(執行記錄)。
- 依序按一下「State」(狀態) 「Failed」(失敗)。
- 查看失敗狀態識別發生問題的原因,並進行疑難排解。
- 重試掃描或遷移作業。
如果遷移摘要中類似的失敗次數增加,表示您的遷移設定可能有誤。
請檢查下列設定項目,確認設定正確無誤:
- 確認您已在 Google 管理控制台中正確啟用 API (尤其是 Admin SDK)。詳情請參閱「使用 Google Cloud Console 啟用 API」。
- 確認來源帳戶和 Google Workspace 中已有使用者帳戶。請確認帳戶並未遭到凍結、停權或重新命名。
- 確認所有使用者已開啟必要的 Google Workspace 服務 (例如 Gmail 或 Google 雲端硬碟)。詳情請參閱「Google Workspace 需求。
如果在主機記錄中看到這則錯誤訊息,您可能需要允許第三方應用程式存取雲端硬碟檔案。
如要修正這個問題,請按照「允許第三方應用程式使用儲存在雲端硬碟中的檔案」一文的步驟操作。
排解橋接設定錯誤
將橋接設定做為差異遷移執行您通常可透過執行差異遷移來修正許多錯誤。差異遷移會找出一再發生的錯誤,並清除暫時性問題,例如頻率限制和配額層級、網路問題和 401 錯誤。您可以多次執行差異遷移來排解這類問題。詳情請參閱「準備開始使用」。
60008 錯誤或關鍵字 | 疑難排解步驟 |
---|---|
No mapping found (找不到對應). | 如果您將共用雲端硬碟資料從某個 Google Workspace 帳戶遷移至另一個帳戶,且您已在新帳戶中手動建立共用雲端硬碟,就可能收到這則錯誤訊息。疑難排解方式:
|
受影響項目所依賴的交易失敗。 | 找出相同橋接設定中的其他失敗項目,並排解相關問題。解決問題時,請執行差異遷移橋接設定。 |
無法遷移上層物件。 系統可能也會顯示「The bridge execution was halted or completed prior to dependency of the transaction being completed.」(執行的橋接設定在交易依賴完成前已暫停或已完成)。 |
無法遷移受影響項目的上層物件,或下層物件已在上層物件之前遷移。疑難排解方式:
|
目標父系實體在遷移後會遭到移除、重新命名或移至其他位置。如果其他橋接設定嘗試再次遷移來源父系或子系實體,系統可能找不到這些實體。 |
|
不支援來源與目標對應組合。 | 檢查對應項目,確認來源和目標位置皆有效。詳情請參閱「針對 Exchange、SharePoint、檔案共用區、Box 或 Google Workspace 建立及管理對應關係」。 |
LocationNotFound | 目標使用者沒有可以包含共用雲端硬碟的 Google Workspace 授權,因此無法將 Google Workspace 共用雲端硬碟遷移至目標帳戶的共用雲端硬碟。請檢查目標帳戶的授權,然後再試一次。 |
OrphanedContent |
如果對應中沒有將孤立項目的擁有者指定為來源帳戶,也可能會顯示這則錯誤訊息。Google Workspace Migrate 不會遷移這個項目,並且顯示 60008 錯誤代碼。在此情況下,這個錯誤無法避免。 注意:位於其他目標位置的孤立檔案,錯誤可能是其他問題所導致。舉例來說,如果未在孤立項目的對應中指定目標資料夾,而這些項目位於目標使用者的「我的雲端硬碟」根資料夾,就會發生這種情況。 |
- 在 Google Workspace Migrate 平台中,按一下「Scans」(掃描) 或「Bridges」(橋接設定)。
- 在您要檢查的掃描或橋接設定上,依序按一下「Logs」(記錄) 圖示 「Transaction log」(交易記錄)。
- 將游標移至交易,並依序按一下「More」(更多) 圖示 「Transaction details」(交易詳細資料)。
- 使用下表找出常見的交易錯誤,並瞭解相關疑難排解步驟。
錯誤訊息和代碼 | 疑難排解步驟 |
---|---|
交易狀態為「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:即時通訊訊息 (位於「即時通訊」標籤之下的項目) 會遭到略過。
其他支援資源
請參閱「就 Google Workspace Migrate 問題與支援團隊聯絡」。
Google、Google Workspace 與相關符號和標誌均為 Google LLC 的商標。所有其他公司名稱和產品名稱則為相關公司的商標。