如果您無法設定及執行 Google Cloud Directory Sync (GCDS),請先嘗試自行解決問題:
準備聯絡支援團隊
如果問題持續發生,請先收集下列資訊,再向支援團隊尋求協助。
步驟 1:檢查 GCDS 版本
與支援團隊聯絡前,請確認您執行的 GCDS 是最新版本。在許多情況下,只要使用新版 GCDS 就可以解決問題。如需最新版本資訊,請參閱「Google Cloud Directory Sync 版本資訊」。
如要找出版本號碼,請採取下列任一做法:
- 開啟「設定管理員」,然後依序前往「說明」
「關於」。
- 執行 sync-cmd -V 指令。
步驟 2:使用 Directory API Explorer 再次嘗試同步
GCDS 會與 Directory API 互動,在貴機構的目錄與您在目錄中設定的使用者、群組和其他外部聯絡人之間同步資料。如果問題發生在同步期間,您可以使用 Directory API Explorer 再次嘗試同步,並判斷問題是出在 GCDS 還是 Directory API。詳情請參閱「Admin SDK:Directory API」。
步驟 3:提供問題說明和受影響的實體
您預期的目標為何?實際發生的情況為何?哪些類型的資料受到影響?
範例
- 預期的目標是不要修改使用者 Alex (alex@example.com),但 GCDS 刪除了這位使用者。
- 預期的目標是讓 GCDS 將 alex@example.com 的住家地址設為 1800 Amphibious Blvd, Mountain View, CA 94045,但 GCDS 卻將其設為加州。
步驟 4:匯出 LDAP 資料交換格式 (LDIF) dump
如果問題會影響特定物件,請匯出屬性;如有必要,請一併提供受影響物件的屬性資料。如果您使用的是 Microsoft Active Directory,可以透過 LDIFDE 指令匯出這份資料。詳情請參閱「如何從 LDAP 目錄匯出資料?」。
步驟 5:回報目前的 XML 設定檔
回報您目前的 XML 設定檔。這個檔案的預設名稱是 Untitled-1.xml,位在 GCDS 使用者的設定檔資料夾 (Windows) 或 homedir (Linux) 中。
步驟 6:提供 LDAP 伺服器和 OS 詳細資料
- 包括您目前使用的 LDAP 目錄伺服器廠牌和版本
- 請提供您執行 GCDS 所用的電腦作業系統
步驟 7:收集追蹤層級同步處理記錄檔
如何啟用追蹤層級記錄功能:
- 在「設定管理員」的「Logging」(記錄) 頁面中,將「Log Level」(記錄層級) 變更為「TRACE」(追蹤)。
- 更改記錄檔名稱,以便系統在下次同步處理時建立新的記錄檔。這可確保先前不相關的同步內容不會包括在內。
- 在「設定管理員」中開啟「Sync」(同步處理) 頁面。
- 如果問題只有在執行以下作業時才會發生:
- 模擬:按一下「Simulate sync」(模擬同步處理)。
- 完整同步處理:按一下「Sync & apply changes」(同步處理與套用變更)。
下一步
Google、Google Workspace 和其他相關符號及標誌均為 Google LLC 的商標,所有其他公司和產品名稱則是與個別公司關聯的商標。