So konfigurieren Sie die automatische Zimbra-GAL-Synchronisierung und überprüfen deren Funktion

Was die GAL-Autosynchronisierung in Zimbra tatsächlich bewirkt

Wenn Benutzer die globale Adressliste (GAL) durchsuchen können, neu erstellte oder geänderte Kontakte aber erst viel später angezeigt werden, liegt das Problem in der Regel nicht darin, dass die GAL deaktiviert ist. Häufiger existiert das GAL-Synchronisierungskonto, aber sein Datenquellen-Abfrageintervall ist zu lang, die Datenquelle ist deaktiviert oder die letzte geplante Synchronisierung ist fehlgeschlagen.

Zimbras aktuelles Daffodil-Administratorhandbuch (Version 10) beschreibt das globale Adressbuch (GAL) als domänenspezifische Funktion mit drei Modi: Intern, Extern und Beide. Ein GAL-Synchronisierungskonto speichert synchronisierte GAL-Kontakte in einem Adressbuch, um Clients eine schnellere Autovervollständigung und ein optimiertes Durchsuchen zu ermöglichen. Zimbra weist außerdem darauf hin, dass das System bei Nichtverfügbarkeit eines GAL-Synchronisierungskontos auf die herkömmliche LDAP-basierte Suche zurückgreifen kann. Diese Unterscheidung ist wichtig: Eine erfolgreiche Suche beweist nicht, dass die geplante GAL-Synchronisierung erfolgreich ist.

Referenz: Zimbra Daffodil v10 Administratorhandbuch .

Bevor Sie irgendetwas ändern, ermitteln Sie den aktuellen GAL-Modus und synchronisieren Sie das Konto.

Führen Sie administrative Befehle als zimbraBetriebssystembenutzer aus:

su - zimbra
zmprov gd example.com | egrep 'zimbraGalMode|zimbraGalMaxResults|zimbraGalAccountId'

Ersetzen Sie dies example.comdurch die tatsächliche Zimbra-Domäne. Das erste nützliche Ergebnis ist der GAL-Modus:

• Intern : Die GAL-Daten stammen aus dem Zimbra LDAP-Verzeichnis.
• Extern : GAL-Lookup und -Synchronisierung verwenden ein externes LDAP-Verzeichnis wie Active Directory.
• Beides : Zimbra kombiniert interne und externe GAL-Quellen.

Häufiges Missverständnis: GAL-Modus und GAL-Synchronisierung sind nicht dasselbe. Der GAL-Modus teilt Zimbra mit, woher die Verzeichnisinformationen stammen. Die automatische Synchronisierung wird von der GAL-Datenquelle und deren Abfrageintervall gesteuert. Empfehlung: Überprüfen Sie zuerst den Domänenmodus und anschließend die Datenquelle, anstatt andere Einstellungen für die automatische Vervollständigung zu ändern.

Überprüfen Sie die GAL-Synchronisierungsdatenquelle, bevor Sie den Zeitplan bearbeiten.

Falls die Domäne bereits über ein GAL-Synchronisierungskonto verfügt, listen Sie deren Datenquellen auf:

zmprov gds galsync@example.com

Achten Sie auf Werte wie:

zimbraDataSourceName: InternalGAL
zimbraDataSourceEnabled: TRUE
zimbraDataSourcePollingInterval: 1d
zimbraGalLastSuccessfulSyncTimestamp: ...
zimbraGalLastFailedSyncTimestamp: ...
zimbraGalStatus: enabled

Der genaue Name der Datenquelle kann abweichen. ist ein üblicher Name für eine interne Datenquelle; eine externe Datenquelle kann beispielsweise , oder einen vom Administrator gewählten InternalGALNamen tragen .ExternalGALADGAL

Die Dokumentation im Zimbra Tech Center zeigt, dass das Abfrageintervall der Datenquelle die Häufigkeit automatisierter Importe bestimmt. Im aktuellen Administratorhandbuch (Version 10) wird außerdem angegeben, dass das Intervall in Tagen, Stunden, Minuten oder Sekunden angegeben und pro Datenquelle festgelegt werden kann.

Referenz: Zimbra Tech Center: GAL Sync Account .

Legen Sie ein praktikables GAL-Abfrageintervall fest.

So ändern Sie die Synchronisierung einer bestehenden Datenquelle auf einmal pro Stunde:

zmprov mds galsync@example.com InternalGAL   zimbraDataSourcePollingInterval 1h

Weitere Beispiele sind 30m, 12h, oder 1d. Die veröffentlichte Schema-Dokumentation von Zimbra verwendet Dauereinheiten wie h, m, s, und d.

Ein kürzeres Intervall ist nicht automatisch besser. Für ein kleines internes Verzeichnis kann eine Stunde angemessen sein. Bei einem großen externen LDAP-Verzeichnis oder einem WAN-verbundenen Active Directory kann häufiges Abfragen jedoch unnötige Last auf Verzeichnis- und Mailbox-Servern verursachen. Empfehlung: Wählen Sie ein Intervall basierend darauf, wie schnell Verzeichnisänderungen sichtbar sein müssen und wie aufwändig eine vollständige oder inkrementelle Synchronisierung in Ihrer Umgebung ist.

Häufiges Missverständnis: forceSync Die automatische Synchronisierung wird nicht konfiguriert. Es wird eine sofortige Synchronisierung gestartet. Der wiederkehrende Zeitplan stammt von [Referenz einfügen] zimbraDataSourcePollingInterval. Vorgehensweise: Legen Sie zuerst das Intervall fest und verwenden Sie anschließend eine erzwungene Synchronisierung, um die Konfiguration sofort zu überprüfen.

Erzwingen Sie eine Synchronisierung, um die Konfiguration zu überprüfen.

Nach Festlegung des Intervalls wird eine sofortige Synchronisierung ausgelöst:

zmgsautil forceSync -a galsync@example.com -n InternalGAL

Verwenden Sie den exakten Datenquellennamen, der von zurückgegeben wird zmprov gds. Die offizielle Dokumentation des Zimbra Tech Centers verwendet diesen Befehl sowohl für interne als auch für externe GAL-Datenquellen.

Überprüfen Sie anschließend die Datenquelle erneut:

zmprov gds galsync@example.com | egrep 'zimbraDataSourceName|zimbraDataSourceEnabled|zimbraDataSourcePollingInterval|zimbraGalLastSuccessfulSyncTimestamp|zimbraGalLastFailedSyncTimestamp|zimbraGalStatus'

Ein aussagekräftiges Verifizierungsergebnis ist nicht einfach nur „der Befehl wurde ohne offensichtlichen Fehler zurückgegeben“. Man möchte einen aktuellen erfolgreichen Synchronisierungszeitstempel, eine aktivierte Datenquelle, das erwartete Abfrageintervall und keinen neueren fehlgeschlagenen Synchronisierungszeitstempel sehen, der darauf hinweist, dass der Vorgang wiederholt fehlschlägt.

So konfigurieren Sie die automatische GAL-Synchronisierung über die Administratorkonsole

Bei einer neuen oder neu konfigurierten Domäne erfolgt der unterstützte grafische Pfad in Zimbra v10 über die GAL-Konfiguration der Domäne:

1. Öffnen Sie die Zimbra-Administrationskonsole.
2. Gehen Sie zu Konfigurieren → Domänen .
3. Wählen Sie die gewünschte Domäne aus.
4. Öffnen Sie „GAL konfigurieren“ unter „Domänenaktionen“.
5. Wählen Sie je nach Sachlage „Intern“ , „Extern“ oder „Beides“ aus.
6. Bestätigen Sie die Namen des GAL-Synchronisierungskontos und der Datenquelle.
7. Legen Sie das GAL-Abfrageintervall fest.
8. Schließen Sie den Assistenten ab und verwenden Sie ihn dann zmgsautil forceSync, wenn Sie einen sofortigen Test benötigen.

Im Administratorhandbuch zu Version 10 wird ausdrücklich darauf hingewiesen, dass im GAL-Modus „ Beide“ für jede LDAP-Datenquelle ein Adressbuch erstellt wird. Administratoren werden außerdem davor gewarnt, diese synchronisierten Adressbücher direkt zu bearbeiten, da die Synchronisierung manuelle Änderungen überschreiben kann. Empfehlung: Änderungen am Verzeichnis sollten in der autoritativen LDAP-Quelle und nicht im vom GAL-Synchronisierungskonto generierten Adressbuch vorgenommen werden.

Was passiert, wenn das GAL-Synchronisierungskonto nicht existiert?

Bei Neuinstallationen sollten Sie nach Möglichkeit die Admin-Konsole verwenden, da diese die Konsistenz der Beziehungen zwischen Domäne, GAL-Konto und Datenquelle gewährleistet.

Das Tech Center von Zimbra dokumentiert auch die CLI-Erstellung zmgsautil createAccount. Ein dokumentiertes Beispiel für die interne globale Adressliste (GAL) ist:

zmgsautil createAccount   -a galsync@example.com   -n InternalGAL   --domain example.com   -s mailstore.example.com   -t zimbra   -f _InternalGAL

Die -sOption „mailbox-server“ ist für ZCS 8 und höher im Tech Center-Artikel dokumentiert. Da das genaue Verhalten der Befehlszeile je nach Version und Paket variieren kann, sollten Sie zmgsautilvor dem Erstellen eines neuen Kontos die Hilfe des installierten Servers konsultieren, anstatt einen alten Befehl einfach zu kopieren.

Häufiges Missverständnis: Das Löschen eines fehlerhaften GAL-Kontos mit einem allgemeinen Befehl zum Löschen von Konten ist nicht dasselbe wie das Entfernen mit dem GAL-Dienstprogramm. Das Zimbra Tech Center warnt davor, dass das fehlerhafte Löschen eines GAL-Kontos dazu führen kann, dass die Domain zimbraGalAccountIdauf ein ungültiges Konto verweist. Handlungsempfehlung: Wenn Sie ein GAL-Konto tatsächlich entfernen und neu erstellen müssen, befolgen Sie die dokumentierte zmgsautil deleteAccountVorgehensweise, anstatt es wie ein normales Postfachkonto zu behandeln.

Referenz: Zimbra Tech Center: Entfernen, Erstellen und erzwungenes Synchronisieren eines GAL-Kontos .

Externes LDAP oder Active Directory: Was ändert sich?

Bei Verwendung eines externen GAL ist der geplante Mechanismus weiterhin das Abfrageintervall der GAL-Datenquelle, aber eine erfolgreiche Synchronisierung hängt auch von der externen LDAP-Konfiguration ab: Server-URL, Bind-DN, Bind-Passwort, Suchbasis und Filter.

Zimbra dokumentiert, dass die erste externe Datenquelle die GAL-Konfiguration von der Domäne übernehmen kann. Weitere Datenquellen lassen sich mit eigenen LDAP-Verbindungseinstellungen konfigurieren. Schlägt die externe Synchronisierung fehl, behebt eine Reduzierung des Abfrageintervalls weder ein falsches Bindungspasswort, einen nicht erreichbaren LDAP-Host, eine fehlerhafte Suchbasis, ein TLS-Problem noch einen Filter, der die erwarteten Benutzer ausschließt.

Maßnahme: Falls forceSyncdies fehlschlägt, überprüfen Sie die Verbindung zum externen Verzeichnis und filtern Sie, bevor Sie das Intervall weiter verringern.

So erkennen Sie, ob die automatische Synchronisierung wirklich funktioniert

Verwenden Sie nach der Konfiguration diese kurze Validierungscheckliste:

Verwenden Sie die Autovervollständigung nicht als alleinige Systemprüfung. Da Zimbra bei Nichtverfügbarkeit des Synchronisierungskontos auf die LDAP-basierte Suche im globalen Adressbuch (GAL) zurückgreifen kann, finden Benutzer möglicherweise weiterhin Namen, selbst wenn die geplante GAL-Adressbuchsynchronisierung veraltet ist.

Fehlerbehebung, wenn der Zeitplan korrekt aussieht, die Daten aber veraltet sind.

Prüfen Sie, ob ein Synchronisierungszeitstempel fehlgeschlagen ist.

Ist zimbraGalLastFailedSyncTimestampder Zeitstempel neuer als der letzte erfolgreiche, läuft der Scheduler möglicherweise korrekt, aber die Datenquelle ist fehlerhaft. Dies ist etwas anderes als „Automatische Synchronisierung ist deaktiviert“. Maßnahme: Beheben Sie das Problem an der Datenquelle, anstatt das Abfrageintervall wiederholt zu ändern.

Überprüfen Sie die Postfachprotokolle rund um den Synchronisierungsversuch.

Zimbra dokumentiert /opt/zimbra/log/mailbox.logdie Hauptaktivitätsprotokolle von mailboxd. Verwenden Sie diese, um Fehler im Zusammenhang mit erzwungenen oder geplanten GAL-Operationen zu korrelieren:

tail -f /opt/zimbra/log/mailbox.log

Bei einem Produktionssystem sollten Sie die Aktivierung der umfassenden Debug-Protokollierung vermeiden, es sei denn, Sie benötigen sie und sind sich des zusätzlichen Protokollvolumens bewusst.

Prüfen Sie überlappende Datenquellen, wenn Sie doppelte Kontakte sehen.

Zimbra weist darauf hin, dass mehrere GAL-Datenquellen mit sich überschneidenden Suchbereichen doppelte Einträge importieren können; das System gleicht diese Duplikate nicht automatisch ab. Abhilfe: Schränken Sie die LDAP-Suchbasis oder den Filter so ein, dass jede Datenquelle einen eindeutigen Suchbereich hat, und führen Sie anschließend eine neue Synchronisierung durch.

Benennen Sie ein bestehendes GAL-Synchronisierungskonto nicht um.

Laut dem aktuellen Zimbra v10-Administratorhandbuch kann eine Namensänderung nach der Erstellung die Synchronisierung beeinträchtigen. Um den Namen zu ändern, entfernen Sie die GAL-Konfiguration und erstellen Sie sie anschließend mithilfe des unterstützten Verfahrens neu. Hinweis: Lassen Sie den Namen eines funktionierenden GAL-Synchronisierungskontos unverändert, es sei denn, es besteht ein triftiger betrieblicher Grund für eine Neuerstellung.

Empfohlenes Konfigurationsmuster

Für eine typische Einzeldomänen-Bereitstellung ist folgender Ansatz zuverlässig:

• Stellen Sie sicher, dass der korrekte GAL-Modus für die Verzeichnisarchitektur beibehalten wird.
• Verwenden Sie ein dediziertes GAL-Synchronisierungskonto, das über den GAL-Konfigurationsworkflow von Zimbra erstellt wurde.
• Alle Datenquellen müssen aktiviert bleiben.
• Legen Sie ein Abfrageintervall fest, das der akzeptablen Verzögerung bei Verzeichnisänderungen entspricht.
• zmgsautil forceSyncNur zur unmittelbaren Überprüfung oder Fehlerbehebung verwenden .
• Den Erfolg anhand der Zeitstempel der Datenquelle bestätigen, nicht nur durch die automatische Vervollständigung des Benutzers.
• Bei externen LDAP-Servern sollten Konnektivität, Anmeldeinformationen, Suchbasis und Filter als separate Abhängigkeiten behandelt werden.

Wenn diese Prüfungen erfolgreich sind, aktualisiert Zimbra sein GAL-Synchronisierungsadressbuch gemäß dem konfigurierten Zeitplan. Falls die Zeitstempel nicht mehr fortschreiten oder die erzwungene Synchronisierung fehlschlägt, besteht der nächste Schritt nicht in einem kürzeren Intervall, sondern darin, den Datenquellen- oder LDAP-Fehler zu identifizieren, der die Ausführung des geplanten Auftrags verhindert.