Come configurare la sincronizzazione automatica della libreria globale di Zimbra e verificarne il corretto funzionamento.

Cosa fa effettivamente la sincronizzazione automatica GAL in Zimbra

Se gli utenti riescono a cercare nella rubrica globale (GAL) ma i contatti appena creati o modificati non vengono visualizzati immediatamente, il problema non è quasi mai dovuto al fatto che "la GAL è disabilitata". Più spesso, l'account di sincronizzazione della GAL esiste, ma l'intervallo di polling dell'origine dati è troppo lungo, l'origine dati è disabilitata oppure l'ultima sincronizzazione pianificata non è riuscita.

La Guida di amministrazione di Zimbra Daffodil (v10) descrive la rubrica globale (GAL) come una funzionalità per dominio con tre modalità: Interna, Esterna ed Entrambe. Un account di sincronizzazione GAL memorizza i contatti GAL sincronizzati in una rubrica, consentendo ai client di ottenere un completamento automatico e una navigazione più rapidi. Zimbra precisa inoltre che, qualora un account di sincronizzazione GAL non fosse disponibile, il sistema può ripiegare sulla tradizionale ricerca basata su LDAP. Questa distinzione è importante: una ricerca riuscita non garantisce che la sincronizzazione GAL programmata funzioni correttamente.

Riferimento: Guida per l'amministratore di Zimbra Daffodil v10 .

Prima di apportare qualsiasi modifica, identifica la modalità GAL corrente e sincronizza l'account

Eseguire i comandi amministrativi come zimbrautente del sistema operativo:

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

Sostituire example.comcon il dominio Zimbra reale. Il primo risultato utile è la modalità GAL:

• Interno : i dati GAL provengono dalla directory LDAP di Zimbra.
• Esterno : la ricerca e la sincronizzazione della GAL utilizzano una directory LDAP esterna, come Active Directory.
• Entrambi : Zimbra combina fonti GAL interne ed esterne.

Errore comune: la modalità GAL e la sincronizzazione GAL non sono la stessa cosa. La modalità GAL indica a Zimbra da dove provengono le informazioni della directory. La sincronizzazione automatica è controllata dall'origine dati GAL e dal suo intervallo di polling. Soluzione: verificare prima la modalità di dominio, quindi esaminare l'origine dati anziché modificare impostazioni di completamento automatico non correlate.

Prima di modificare la pianificazione, esaminare l'origine dati di sincronizzazione GAL.

Se il dominio dispone già di un account di sincronizzazione GAL, elencarne le origini dati:

zmprov gds galsync@example.com

Cerca valori come:

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

Il nome esatto dell'origine dati potrebbe essere diverso. InternalGALè un nome comune per un'origine dati interna; un'origine dati esterna potrebbe essere denominata ExternalGAL, ADGAL, o con un nome scelto dall'amministratore.

La documentazione del Centro assistenza tecnica di Zimbra mostra che l'intervallo di polling dell'origine dati determina la frequenza con cui vengono eseguite le importazioni automatiche. Anche la Guida per l'amministratore della versione 10 indica che l'intervallo può essere espresso in giorni, ore, minuti o secondi e viene impostato per ciascuna origine dati.

Riferimento: Centro assistenza tecnica Zimbra: Account di sincronizzazione GAL .

Imposta un intervallo di polling GAL pratico

Per modificare un'origine dati esistente in modo che si sincronizzi una volta all'ora:

zmprov mds galsync@example.com InternalGAL   zimbraDataSourcePollingInterval 1h

Altri esempi includono 30m, 12h, o 1d. La documentazione dello schema pubblicata da Zimbra utilizza unità di durata come h, m, s, e d.

Un intervallo più breve non è automaticamente migliore. Per una piccola directory interna, un'ora può essere ragionevole. Per una directory LDAP esterna di grandi dimensioni o per un Active Directory connesso tramite WAN, un polling troppo frequente può generare un carico eccessivo sulla directory e sul server delle cassette postali. Azione: scegliete un intervallo in base alla rapidità con cui devono essere visualizzate le modifiche alla directory e al costo di una sincronizzazione completa o incrementale nel vostro ambiente.

Errore comune: forceSync non configura la sincronizzazione automatica. Avvia una sincronizzazione immediata. La pianificazione ricorrente proviene da zimbraDataSourcePollingInterval. Azione: impostare prima l'intervallo, quindi utilizzare una sincronizzazione forzata solo per convalidare immediatamente la configurazione.

Forza una sincronizzazione per verificare la configurazione

Dopo aver impostato l'intervallo, avvia una sincronizzazione immediata:

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

Utilizzare il nome esatto dell'origine dati restituito da zmprov gds. La documentazione ufficiale del Centro assistenza tecnica di Zimbra utilizza questo comando sia per le origini dati GAL interne che esterne.

Quindi, esamina nuovamente l'origine dati:

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

Un risultato di verifica utile non si limita a "il comando è stato restituito senza errori evidenti". È necessario visualizzare un timestamp di sincronizzazione riuscita recente, un'origine dati abilitata, l'intervallo di polling previsto e nessun timestamp di sincronizzazione fallita più recente che indichi che l'operazione fallisce ripetutamente.

Come configurare la sincronizzazione automatica della rubrica globale (GAL) dalla console di amministrazione.

Per un dominio nuovo o riconfigurato, il percorso grafico supportato in Zimbra v10 passa attraverso la configurazione della GAL del dominio:

1. Apri la console di amministrazione di Zimbra.
2. Vai su Configura → Domini .
3. Selezionare il dominio desiderato.
4. Apri Configura GAL dalle azioni del dominio.
5. Selezionare Interno , Esterno o Entrambi , a seconda dei casi.
6. Confermare i nomi dell'account di sincronizzazione GAL e dell'origine dati.
7. Imposta l'intervallo di polling della GAL.
8. Completa la procedura guidata, quindi utilizzala zmgsautil forceSyncse hai bisogno di un test immediato.

La Guida dell'amministratore v10 specifica che, quando la modalità GAL è impostata su Entrambi , viene creata una rubrica per ogni origine dati LDAP. Avverte inoltre gli amministratori di non modificare direttamente queste rubriche sincronizzate, poiché la sincronizzazione può sovrascrivere le modifiche manuali. Azione consigliata: apportare le modifiche alla directory nell'origine LDAP autorevole, non nella rubrica generata dall'account di sincronizzazione GAL.

Cosa succede se l'account di sincronizzazione GAL non esiste?

Per le nuove implementazioni, quando possibile, utilizzare la Console di amministrazione, in quanto mantiene coerenti il ​​dominio, l'account GAL e la relazione con l'origine dati.

Il Centro assistenza tecnica di Zimbra documenta anche la creazione di CLI con zmgsautil createAccount. Un esempio documentato di GAL interna è:

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

L' -sopzione mailbox-server è documentata per ZCS 8 e versioni successive nell'articolo del Tech Center. Poiché il comportamento esatto della riga di comando può variare a seconda della versione e del pacchetto, si consiglia di consultare zmgsautilla guida del server installato prima di creare un nuovo account, anziché copiare ciecamente un vecchio comando.

Errore comune: eliminare un account GAL danneggiato con un comando generico di eliminazione account non è equivalente a rimuoverlo tramite l'utilità GAL. Il Centro assistenza tecnica di Zimbra avverte che l'eliminazione errata di un account GAL può lasciare che il dominio zimbraGalAccountIdpunti a un account non valido. Soluzione: se è effettivamente necessario rimuovere e ricreare un account GAL, seguire la zmgsautil deleteAccountprocedura documentata anziché trattarlo come un normale account di posta elettronica.

Riferimento: Zimbra Tech Center: rimuovere, creare e sincronizzare forzatamente un account GAL .

LDAP esterno o Active Directory: quali cambiamenti?

Con una GAL esterna, il meccanismo di pianificazione rimane l'intervallo di polling dell'origine dati GAL, ma la corretta sincronizzazione dipende anche dalla configurazione LDAP esterna: URL del server, DN di associazione, password di associazione, base di ricerca e filtro.

Zimbra documenta che la prima origine dati esterna può ereditare la configurazione della GAL dal dominio. Le origini dati aggiuntive possono essere configurate con le proprie impostazioni di connessione LDAP. Se la sincronizzazione esterna non riesce, la riduzione dell'intervallo di polling non risolverà un problema di password di bind errata, host LDAP irraggiungibile, base di ricerca errata, problema TLS o filtro che esclude gli utenti previsti.

Azione: se l' forceSyncoperazione fallisce, verificare la connessione alla directory esterna e il filtro prima di ridurre ulteriormente l'intervallo.

Come capire se la sincronizzazione automatica funziona davvero

Dopo la configurazione, utilizzare questa breve lista di controllo per la convalida:

Non utilizzare la funzione di completamento automatico come unico strumento di verifica. Poiché Zimbra può ricorrere alla ricerca nella rubrica globale (GAL) basata su LDAP quando l'account di sincronizzazione non è disponibile, gli utenti potrebbero comunque trovare i nomi anche se la sincronizzazione programmata della rubrica globale non è aggiornata.

Risoluzione dei problemi quando la pianificazione sembra corretta ma i dati rimangono obsoleti

Verifica la presenza di un timestamp di sincronizzazione non riuscita.

Se l'intervallo di polling zimbraGalLastFailedSyncTimestampè successivo all'ultimo timestamp di successo, lo scheduler potrebbe essere in esecuzione correttamente, ma l'origine dati potrebbe non funzionare. Questa situazione è diversa da "sincronizzazione automatica disabilitata". Azione: eseguire la risoluzione dei problemi dell'origine dati anziché modificare ripetutamente l'intervallo di polling.

Controlla i registri della casella di posta elettronica relativi al tentativo di sincronizzazione.

Zimbra documenta /opt/zimbra/log/mailbox.logcome registro principale delle attività di mailboxd. Utilizzalo per correlare gli errori in prossimità del momento in cui si verifica un'operazione GAL forzata o pianificata:

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

In un sistema di produzione, evitate di abilitare la registrazione di debug estesa a meno che non sia necessaria e non siate consapevoli del volume aggiuntivo di log che comporta.

Se vedi contatti duplicati, controlla le fonti di dati sovrapposte.

Zimbra segnala che più origini dati GAL con ambiti di ricerca sovrapposti possono importare voci duplicate; il sistema non risolve automaticamente tali duplicati. Soluzione: restringere la base di ricerca LDAP o applicare un filtro in modo che ogni origine dati abbia un ambito chiaro, quindi eseguire una nuova sincronizzazione.

Non rinominare un account di sincronizzazione GAL esistente

La Guida di amministrazione di Zimbra v10 attualmente in vigore afferma che la modifica del nome dopo la creazione può interrompere la sincronizzazione. Per modificare il nome, è necessario rimuovere e ricreare la configurazione della GAL utilizzando la procedura supportata. Azione consigliata: lasciare invariato il nome di un account di sincronizzazione GAL funzionante, a meno che non vi sia una reale ragione operativa per ricrearlo.

Schema di configurazione consigliato

Per una tipica implementazione a dominio singolo, un approccio affidabile è il seguente:

• Mantenere la modalità GAL corretta per l'architettura della directory.
• Utilizzare un account di sincronizzazione GAL dedicato, creato tramite il flusso di configurazione GAL di Zimbra.
• Mantieni attiva ciascuna origine dati.
• Imposta un intervallo di polling che corrisponda al ritardo accettabile per le modifiche alla directory.
• Da utilizzare zmgsautil forceSyncesclusivamente per la convalida immediata o la risoluzione dei problemi.
• Conferma il successo con i timestamp dell'origine dati, non solo con il completamento automatico dell'utente.
• Per LDAP esterno, considerare la connettività, le credenziali di associazione, la base di ricerca e i filtri come dipendenze separate.

Se questi controlli hanno esito positivo, Zimbra dovrebbe aggiornare la rubrica di sincronizzazione GAL secondo la pianificazione configurata. Se i timestamp smettono di avanzare o la sincronizzazione forzata fallisce, il passo successivo non è ridurre l'intervallo, bensì identificare l'errore dell'origine dati o LDAP che impedisce il completamento dell'attività pianificata.