Cum se configurează sincronizarea automată GAL pentru Zimbra și se verifică dacă funcționează

Ce face de fapt sincronizarea automată GAL în Zimbra

Dacă utilizatorii pot căuta în Lista globală de adrese (GAL), dar contactele nou create sau modificate nu apar decât mult mai târziu, problema obișnuită nu este „GAL este dezactivat”. Cel mai adesea, contul de sincronizare GAL există, dar intervalul de interogare a sursei de date este prea lung, sursa de date este dezactivată sau ultima sincronizare programată a eșuat.

Ghidul actual de administrare Daffodil (v10) al Zimbra descrie GAL ca o funcție per domeniu cu trei moduri: Intern, Extern și Ambele. Un cont de sincronizare GAL stochează contactele GAL sincronizate într-o agendă, astfel încât clienții să poată beneficia de completare automată și navigare mai rapide. Zimbra menționează, de asemenea, că, dacă un cont de sincronizare GAL nu este disponibil, sistemul poate reveni la căutarea tradițională bazată pe LDAP. Această distincție contează: o căutare reușită nu dovedește că sincronizarea GAL programată este sănătoasă.

Referință: Ghidul administratorului Zimbra Daffodil v10 .

Înainte de a schimba ceva, identificați modul GAL curent și sincronizați contul.

Executați comenzi administrative ca zimbrautilizator al sistemului de operare:

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

Înlocuiți example.comcu domeniul Zimbra real. Primul rezultat util este modul GAL:

• Intern : Datele GAL provin din directorul LDAP Zimbra.
• Extern : Căutarea și sincronizarea GAL utilizează un director LDAP extern, cum ar fi Active Directory.
• Ambele : Zimbra combină surse GAL interne și externe.

Neînțelegere frecventă: Modul GAL și sincronizarea GAL nu sunt aceeași setare. Modul GAL îi spune lui Zimbra de unde provin informațiile din director. Sincronizarea automată este controlată de sursa de date GAL și de intervalul său de interogare. Acțiune: confirmați mai întâi modul de domeniu, apoi inspectați sursa de date în loc să modificați setările de completare automată fără legătură.

Verificați sursa de date de sincronizare GAL înainte de a edita programarea

Dacă domeniul are deja un cont de sincronizare GAL, enumerați sursele sale de date:

zmprov gds galsync@example.com

Căutați valori precum:

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

Numele exact al sursei de date poate diferi. InternalGALeste un nume comun pentru o sursă de date internă; o sursă de date externă poate fi denumită ExternalGAL, ADGAL, sau ceva ales de administrator.

Documentația Centrului Tehnic Zimbra arată că intervalul de interogare a sursei de date determină cât de des au loc importurile automate. Ghidul administratorului v10 actual precizează, de asemenea, că intervalul poate fi exprimat în zile, ore, minute sau secunde și este setat pentru fiecare sursă de date.

Referință: Centrul tehnic Zimbra: Cont de sincronizare GAL .

Setați un interval practic de interogare GAL

Pentru a modifica o sursă de date existentă pentru a se sincroniza o dată pe oră:

zmprov mds galsync@example.com InternalGAL   zimbraDataSourcePollingInterval 1h

Alte exemple includ 30m, 12h, sau 1d. Documentația schemei publicată de Zimbra folosește unități de durată precum h, m, s, și d.

Un interval mai scurt nu este automat mai bun. Pentru un director intern mic, o oră poate fi rezonabilă. Pentru un director LDAP extern mare sau un Active Directory conectat la WAN, interogarea agresivă poate crea o încărcare inutilă a directorului și a serverului de cutii poștale. Acțiune: alegeți un interval în funcție de cât de repede trebuie să apară modificările directorului și de cât de costisitoare este o sincronizare completă sau incrementală în mediul dvs.

Neînțelegere frecventă: forceSync nu configurează sincronizarea automată. Pornește o sincronizare imediată. Programul recurent provine de la zimbraDataSourcePollingInterval. Acțiune: setați mai întâi intervalul, apoi utilizați o sincronizare forțată doar pentru a valida imediat configurația.

Forțați o sincronizare pentru a verifica configurația

După setarea intervalului, declanșați o sincronizare imediată:

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

Folosește numele exact al sursei de date returnat de zmprov gds. Documentația oficială a Centrului Tehnic Zimbra folosește această comandă atât pentru sursele de date GAL interne, cât și pentru cele externe.

Apoi inspectați din nou sursa de date:

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

Un rezultat util al verificării nu este doar „comanda returnată fără o eroare evidentă”. Doriți să vedeți un marcaj temporal recent pentru sincronizare reușită, o sursă de date activată, intervalul de interogare așteptat și niciun marcaj temporal mai nou pentru sincronizare eșuată care să indice că operațiunea eșuează în mod repetat.

Cum se configurează sincronizarea automată a listelor GAL din consola de administrare

Pentru un domeniu nou sau reconfigurat, calea grafică acceptată în Zimbra v10 este prin configurația GAL a domeniului:

1. Deschideți consola de administrare Zimbra.
2. Accesați Configurare → Domenii .
3. Selectați domeniul necesar.
4. Deschideți Configurare GAL din acțiunile domeniului.
5. Selectați Intern , Extern sau Ambele , după caz.
6. Confirmați contul de sincronizare GAL și numele sursei de date.
7. Setați intervalul de interogare GAL.
8. Termină expertul, apoi folosește-l zmgsautil forceSyncdacă ai nevoie de un test imediat.

Ghidul administratorului v10 menționează în mod specific că, atunci când modul GAL este Ambele , se creează o agendă pentru fiecare sursă de date LDAP. De asemenea, avertizează administratorii să nu editeze direct acele agende sincronizate, deoarece sincronizarea poate suprascrie modificările manuale. Acțiune: efectuați modificările directorului la sursa LDAP autorizată, nu în agenda generată de contul de sincronizare GAL.

Ce se întâmplă dacă contul de sincronizare GAL nu există?

Pentru implementările noi, utilizați Consola de administrare atunci când este posibil, deoarece aceasta menține consecvența relației dintre domeniu, contul GAL și sursa de date.

Centrul tehnic Zimbra documentează, de asemenea, crearea CLI cu zmgsautil createAccount. Un exemplu documentat de GAL intern este:

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

Opțiunea mailbox -s-server este documentată pentru ZCS 8 și versiunile ulterioare în articolul din Centrul Tehnic. Deoarece comportamentul exact al liniei de comandă poate varia în funcție de versiune și pachet, consultați zmgsautilajutorul de pe serverul instalat înainte de a crea un cont nou, în loc să copiați orbește o comandă veche.

Neînțelegere frecventă: ștergerea unui cont GAL defect cu o comandă generică de ștergere a contului nu este echivalentă cu eliminarea acestuia cu utilitarul GAL. Centrul tehnic Zimbra avertizează că ștergerea incorectă a unui cont GAL poate face ca domeniul să zimbraGalAccountIdindice către un cont nevalid. Acțiune: dacă trebuie cu adevărat să eliminați și să recreați un cont GAL, urmați zmgsautil deleteAccountprocedura documentată în loc să îl tratați ca pe un cont de cutie poștală normal.

Referință: Centrul tehnic Zimbra: eliminarea, crearea și sincronizarea forțată a unui cont GAL .

LDAP extern sau Active Directory: ce se schimbă?

Cu o listă GAL externă, mecanismul programat este în continuare intervalul de interogare a sursei de date GAL, dar sincronizarea cu succes depinde și de configurația LDAP externă: adresa URL a serverului, numele de utilizator (DN) de legare, parola de legare, baza de căutare și filtrul.

Zimbra documentează faptul că prima sursă de date externă poate moșteni configurația GAL din domeniu. Sursele de date suplimentare pot fi configurate cu propriile setări de conexiune LDAP. Dacă sincronizarea externă eșuează, reducerea intervalului de interogare nu va remedia o parolă de legare greșită, o gazdă LDAP inaccesibilă, o bază de căutare incorectă, o problemă TLS sau un filtru care exclude utilizatorii așteptați.

Acțiune: dacă forceSynceșuează, verificați conexiunea la directorul extern și filtrați înainte de a reduce intervalul în continuare.

Cum să afli dacă sincronizarea automată funcționează cu adevărat

Folosește această scurtă listă de verificare pentru validare după configurare:

Nu utilizați doar completarea automată ca unică verificare a stării de funcționare. Deoarece Zimbra poate reveni la căutarea GAL bazată pe LDAP atunci când contul de sincronizare nu este disponibil, utilizatorii pot găsi în continuare nume chiar dacă sincronizarea planificată a agendei GAL este învechită.

Depanarea problemelor când programul pare corect, dar datele rămân învechite

Verificați dacă există o marcaj temporală de sincronizare eșuată

Dacă zimbraGalLastFailedSyncTimestampeste mai nou decât ultima marcaj temporal reușită, este posibil ca programatorul să ruleze corect, dar sursa de date să nu funcționeze. Aceasta este diferită de mesajul „sincronizarea automată este dezactivată”. Acțiune: depanați sursa de date în loc să modificați în mod repetat intervalul de interogare.

Verificați jurnalele cutiei poștale din jurul încercării de sincronizare

Documentele Zimbra sunt folosite /opt/zimbra/log/mailbox.logca jurnal principal de activitate pentru mailbox. Folosește-l pentru a corela erorile în jurul momentului unei operațiuni GAL forțate sau programate:

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

Pentru un sistem de producție, evitați activarea înregistrării extinse a depanării, cu excepția cazului în care aveți nevoie de ea și înțelegeți volumul suplimentar de jurnalizare.

Verificați sursele de date care se suprapun dacă observați contacte duplicate

Zimbra observă că mai multe surse de date GAL cu domenii de căutare care se suprapun pot importa intrări duplicate; sistemul nu reconciliază automat aceste duplicate. Acțiune: restrângeți baza de căutare LDAP sau filtrul astfel încât fiecare sursă de date să aibă un domeniu de căutare clar, apoi rulați o nouă sincronizare.

Nu redenumiți un cont de sincronizare GAL existent

Ghidul actual al administratorului Zimbra v10 precizează că schimbarea numelui după creare poate întrerupe sincronizarea. Pentru a schimba numele, eliminați și recreați configurația GAL utilizând procesul acceptat. Acțiune: lăsați neschimbat numele unui cont de sincronizare GAL funcțional, cu excepția cazului în care există un motiv operațional real pentru a-l reconstrui.

Model de configurare recomandat

Pentru o implementare tipică pe un singur domeniu, o abordare fiabilă este:

• Păstrați modul GAL corect pentru arhitectura directoarelor.
• Folosește un cont dedicat de sincronizare GAL, creat prin fluxul de lucru de configurare GAL din Zimbra.
• Mențineți fiecare sursă de date activată.
• Setați un interval de interogare care să corespundă cu întârzierea acceptabilă pentru schimbarea directorului.
• A se utiliza zmgsautil forceSyncdoar pentru validare imediată sau depanare.
• Confirmați succesul cu marcaje temporale ale sursei de date, nu doar cu completarea automată a utilizatorului.
• Pentru LDAP extern, tratați conectivitatea, acreditările de legare, baza de căutare și filtrele ca dependențe separate.

Dacă aceste verificări trec cu succes, Zimbra ar trebui să își actualizeze agenda de adrese de sincronizare GAL conform programării configurate. Dacă timestamp-urile nu mai avansează sau sincronizarea forțată eșuează, următorul pas nu este un interval mai scurt; este identificarea sursei de date sau a erorii LDAP care împiedică finalizarea jobului programat.