與支援團隊聯絡前應備妥哪些 GCDS 資訊?

如果您無法設定及執行 Google Cloud Directory Sync (GCDS),請先嘗試自行解決問題:

  • 您可以使用設定管理員來建立、測試及執行同步處理作業。瞭解詳情
  • 參閱說明中心文章,排解 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:收集追蹤層級同步處理記錄檔

如何啟用追蹤層級記錄功能:

  1. 在「設定管理員」的「Logging」(記錄) 頁面中,將「Log Level」(記錄層級) 變更為「TRACE」(追蹤)。
  2. 更改記錄檔名稱,以便系統在下次同步處理時建立新的記錄檔。這可確保先前不相關的同步內容不會包括在內。
  3. 在「設定管理員」中開啟「Sync」(同步處理) 頁面。
  4. 如果問題只有在執行以下作業時才會發生:
    • 模擬:按一下「Simulate sync」(模擬同步處理)
    • 完整同步處理:按一下「Sync & apply changes」(同步處理與套用變更)

下一步

與 Google Workspace 支援團隊聯絡


Google、Google Workspace 和其他相關符號及標誌均為 Google LLC 的商標,所有其他公司和產品名稱則是與個別公司關聯的商標。