Comment configurer la synchronisation automatique du GAL Zimbra et vérifier son bon fonctionnement

Que fait réellement la synchronisation automatique GAL dans Zimbra ?

Si les utilisateurs peuvent effectuer des recherches dans la liste d'adresses globale (GAL) mais que les contacts nouvellement créés ou modifiés n'apparaissent que bien plus tard, le problème n'est généralement pas que la GAL est désactivée. Le plus souvent, le compte de synchronisation de la GAL existe, mais son intervalle d'interrogation de la source de données est trop long, la source de données est désactivée ou la dernière synchronisation planifiée a échoué.

Le guide d'administration de Zimbra Daffodil (v10) décrit la GAL comme une fonctionnalité par domaine proposant trois modes : interne, externe et mixte. Un compte de synchronisation GAL stocke les contacts GAL synchronisés dans un carnet d'adresses, permettant ainsi aux clients de bénéficier d'une saisie semi-automatique et d'une navigation plus rapides. Zimbra précise également qu'en cas d'indisponibilité d'un compte de synchronisation GAL, le système peut utiliser la recherche LDAP traditionnelle. Cette distinction est importante : une recherche réussie ne garantit pas le bon fonctionnement de la synchronisation GAL planifiée.

Référence : Guide de l'administrateur Zimbra Daffodil v10 .

Avant toute modification, identifiez le mode GAL actuel et le compte de synchronisation.

Exécuter les commandes d'administration en tant zimbraqu'utilisateur du système d'exploitation :

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

Remplacez example.compar le domaine Zimbra réel. Le premier résultat utile est le mode GAL :

• Données internes : les données GAL proviennent de l'annuaire LDAP Zimbra.
• Externe : La recherche et la synchronisation GAL utilisent un annuaire LDAP externe tel qu'Active Directory.
• Les deux : Zimbra combine des sources GAL internes et externes.

Erreur fréquente : le mode GAL et la synchronisation GAL sont deux paramètres distincts. Le mode GAL indique à Zimbra la provenance des informations d’annuaire. La synchronisation automatique est gérée par la source de données GAL et son intervalle d’interrogation. Action : vérifiez d’abord le mode de domaine, puis examinez la source de données avant de modifier des paramètres de saisie semi-automatique non pertinents.

Vérifiez la source de données de synchronisation GAL avant de modifier la planification.

Si le domaine possède déjà un compte de synchronisation GAL, veuillez indiquer ses sources de données :

zmprov gds galsync@example.com

Recherchez des valeurs telles que :

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

Le nom exact de la source de données peut varier. InternalGALest un nom courant pour une source de données interne ; une source de données externe peut être nommée ExternalGAL, ADGAL, ou tout autre nom choisi par l’administrateur.

La documentation du centre technique de Zimbra indique que l'intervalle d'interrogation de la source de données détermine la fréquence des importations automatisées. Le guide de l'administrateur v10 précise également que cet intervalle peut être exprimé en jours, heures, minutes ou secondes et qu'il est défini pour chaque source de données.

Référence : Centre technique Zimbra : Compte de synchronisation GAL .

Définir un intervalle d'interrogation GAL pratique

Pour modifier une source de données existante afin qu'elle se synchronise une fois par heure :

zmprov mds galsync@example.com InternalGAL   zimbraDataSourcePollingInterval 1h

D'autres exemples incluent 30m, 12h, ou 1d. La documentation de schéma publiée de Zimbra utilise des unités de durée telles que h, m, s, et d.

Un intervalle plus court n'est pas forcément préférable. Pour un petit annuaire interne, une heure peut suffire. En revanche, pour un grand annuaire LDAP externe ou un Active Directory connecté à un réseau étendu (WAN), une interrogation trop fréquente peut engendrer une charge inutile sur l'annuaire et le serveur de messagerie. Action : choisissez un intervalle en fonction de la rapidité avec laquelle les modifications d'annuaire doivent apparaître et du coût d'une synchronisation complète ou incrémentale dans votre environnement.

Erreur fréquente : forceSync cette fonction ne configure pas la synchronisation automatique. Elle lance une synchronisation immédiate. La planification récurrente provient de [nom du fichier/programme] zimbraDataSourcePollingInterval. Action : définissez d’abord l’intervalle, puis utilisez une synchronisation forcée uniquement pour valider immédiatement la configuration.

Forcez une synchronisation pour vérifier la configuration.

Après avoir défini l'intervalle, déclenchez une synchronisation immédiate :

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

Utilisez le nom exact de la source de données renvoyé par zmprov gds. La documentation officielle du centre technique de Zimbra utilise cette commande pour les sources de données GAL internes et externes.

Ensuite, examinez à nouveau la source de données :

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

Un résultat de vérification utile ne se limite pas à « la commande renvoyée sans erreur apparente ». Il doit comporter un horodatage de synchronisation réussie récent, une source de données activée, l'intervalle d'interrogation attendu et l'absence d'un horodatage d'échec de synchronisation plus récent indiquant que l'opération échoue de manière répétée.

Comment configurer la synchronisation automatique du GAL depuis la console d'administration

Pour un domaine nouveau ou reconfiguré, le chemin graphique pris en charge dans Zimbra v10 passe par la configuration GAL du domaine :

1. Ouvrez la console d'administration Zimbra.
2. Allez dans Configurer → Domaines .
3. Sélectionnez le domaine requis.
4. Ouvrez la section Configurer GAL depuis les actions du domaine.
5. Sélectionnez Interne , Externe ou Les deux selon le cas.
6. Veuillez confirmer le nom du compte de synchronisation GAL et de la source de données.
7. Définir l'intervalle d'interrogation GAL.
8. Terminez l'assistant, puis utilisez-le zmgsautil forceSyncsi vous avez besoin d'un test immédiat.

Le guide de l'administrateur v10 précise que lorsque le mode GAL est défini sur « Les deux » , un carnet d'adresses est créé pour chaque source de données LDAP. Il avertit également les administrateurs de ne pas modifier directement ces carnets d'adresses synchronisés, car la synchronisation peut écraser les modifications manuelles. Action : effectuez les modifications d'annuaire auprès de la source LDAP faisant autorité, et non dans le carnet d'adresses généré par le compte de synchronisation GAL.

Que se passe-t-il si le compte de synchronisation GAL n'existe pas ?

Pour les nouveaux déploiements, utilisez la console d'administration lorsque cela est possible, car elle permet de conserver la cohérence entre le domaine, le compte GAL et la source de données.

Le centre technique de Zimbra documente également la création d'interfaces de ligne de commande (CLI) zmgsautil createAccount. Voici un exemple documenté de GAL interne :

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

L' -soption mailbox-server est documentée pour ZCS 8 et versions ultérieures dans l'article du Centre technique. Le comportement exact de la ligne de commande pouvant varier selon la version et le packaging, consultez zmgsautill'aide du serveur installé avant de créer un nouveau compte plutôt que de copier une ancienne commande sans discernement.

Erreur fréquente : supprimer un compte GAL corrompu avec une commande de suppression de compte générique n’équivaut pas à le supprimer avec l’utilitaire GAL. Le centre technique de Zimbra avertit qu’une suppression incorrecte d’un compte GAL peut entraîner la zimbraGalAccountIdredirection du domaine vers un compte invalide. Action : si vous devez réellement supprimer et recréer un compte GAL, suivez la zmgsautil deleteAccountprocédure documentée au lieu de le traiter comme un compte de messagerie classique.

Référence : Centre technique Zimbra : supprimer, créer et forcer la synchronisation d'un compte GAL .

LDAP externe ou Active Directory : quels changements ?

Avec un GAL externe, le mécanisme planifié reste l'intervalle d'interrogation de la source de données GAL, mais la réussite de la synchronisation dépend également de la configuration LDAP externe : URL du serveur, DN de liaison, mot de passe de liaison, base de recherche et filtre.

Zimbra indique que la première source de données externe peut hériter de la configuration GAL du domaine. Les sources de données supplémentaires peuvent être configurées avec leurs propres paramètres de connexion LDAP. En cas d'échec de la synchronisation externe, la réduction de l'intervalle d'interrogation ne résoudra pas les problèmes liés à un mot de passe de liaison incorrect, un serveur LDAP inaccessible, une base de recherche erronée, un problème TLS ou un filtre excluant les utilisateurs attendus.

Action : en cas forceSyncd’échec, vérifiez la connexion au répertoire externe et le filtre avant de réduire davantage l’intervalle.

Comment savoir si la synchronisation automatique fonctionne réellement ?

Utilisez cette courte liste de vérification de validation après la configuration :

N’utilisez pas la saisie semi-automatique comme unique critère de vérification. Étant donné que Zimbra peut recourir à la recherche GAL basée sur LDAP lorsque le compte de synchronisation est indisponible, les utilisateurs peuvent toujours trouver des noms même si la synchronisation planifiée du carnet d’adresses GAL est obsolète.

Dépannage lorsque la planification semble correcte mais que les données restent obsolètes

Vérifiez l'horodatage de synchronisation en cas d'échec.

Si zimbraGalLastFailedSyncTimestampla date est plus récente que la dernière synchronisation réussie, le planificateur fonctionne peut-être correctement, mais la source de données est défaillante. Cela est différent d'une synchronisation automatique désactivée. Action : dépannez la source de données au lieu de modifier sans cesse l'intervalle d'interrogation.

Vérifiez les journaux de la boîte aux lettres autour de la tentative de synchronisation.

Les documents Zimbra /opt/zimbra/log/mailbox.logconstituent le journal d'activité principal de mailboxd. Utilisez-les pour corréler les erreurs survenues au moment d'une opération GAL forcée ou planifiée :

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

Pour un système de production, évitez d'activer la journalisation de débogage étendue, sauf si cela est nécessaire et que vous comprenez le volume supplémentaire de journaux.

Vérifiez les sources de données qui se chevauchent si vous voyez des contacts en double

Zimbra signale que plusieurs sources de données GAL avec des périmètres de recherche qui se chevauchent peuvent importer des entrées en double ; le système ne réconcilie pas automatiquement ces doublons. Action : restreignez la base de recherche LDAP ou filtrez-la afin que chaque source de données ait un périmètre clair, puis exécutez une nouvelle synchronisation.

Ne renommez pas un compte de synchronisation GAL existant

Le guide d'administration de Zimbra v10 indique que modifier le nom après la création peut interrompre la synchronisation. Pour modifier le nom, supprimez puis recréez la configuration GAL en suivant la procédure prévue à cet effet. Recommandation : ne modifiez pas le nom d'un compte de synchronisation GAL fonctionnel, sauf raison opérationnelle impérieuse justifiant sa reconstruction.

Modèle de configuration recommandé

Pour un déploiement classique sur un seul domaine, une approche fiable consiste à :

• Conservez le mode GAL approprié à l'architecture du répertoire.
• Utilisez un compte de synchronisation GAL dédié, créé via le flux de travail de configuration GAL de Zimbra.
• Gardez chaque source de données activée.
• Définissez un intervalle d'interrogation correspondant au délai acceptable de changement de répertoire.
• À utiliser zmgsautil forceSyncuniquement pour une validation immédiate ou un dépannage.
• Confirmez la réussite à l'aide des horodatages de la source de données, et pas seulement grâce à la saisie semi-automatique de l'utilisateur.
• Pour les annuaires LDAP externes, traitez la connectivité, la liaison des informations d'identification, la base de recherche et les filtres comme des dépendances distinctes.

Si ces vérifications sont concluantes, Zimbra devrait mettre à jour son carnet d'adresses GAL synchronisé selon la planification configurée. Si les horodatages cessent d'évoluer ou si la synchronisation forcée échoue, l'étape suivante ne consiste pas à réduire l'intervalle ; il s'agit d'identifier l'erreur de la source de données ou du serveur LDAP qui empêche l'exécution de la tâche planifiée.