doveadm-sync - Online în cloud

PROGRAM:

NUME

doveadm-sync - utilitarul Dovecot de sincronizare a cutiei poștale bidirecționale
doveadm-backup - utilitarul Dovecot de sincronizare a cutiei poștale unidirecționale

REZUMAT

doveadm [-Dv] sincronizaţi [-u utilizator|-A|-F fişier] [-S cale_socket] [-1fPRU] [-l secunde] [-r
rawlog_path] [-m cutie poștală] [-g mailbox_guid] [-n Spațiu de nume|-N] [-x exclude] [-s de stat] [-T
secunde] -d|destinație

doveadm [-Dv] de rezervă [-u utilizator|-A|-F fişier] [-S cale_socket] [-fPRU] [-l secunde] [-r
rawlog_path] [-m cutie poștală] [-g mailbox_guid] [-n Spațiu de nume|-N] [-x exclude] [-s de stat] [-T
secunde] -d|destinație

DESCRIERE

dsync este utilitarul de sincronizare a cutiei poștale de la Dovecot. Poate fi folosit pentru mai multe
cazuri de utilizare: sincronizare bidirecțională a cutiilor poștale, crearea de copii de rezervă ale e-mailurilor și conversie
cutii poștale de la/la diferite formate de cutie poștală. Toate acestea pot fi folosite în același
server sau între diferite servere (prin ssh(1) sau conexiuni tcp). Cutiile poștale de la distanță pot
poate fi accesat și prin protocolul IMAP, care permite utilizarea dsync pentru migrarea cutiei poștale
scopuri.

Puteți rula dsync în unul dintre cele trei moduri:

· doveadm de rezervă efectuează sincronizarea unidirecțională. Dacă există modificări
în destinație vor fi șterse, deci destinația va arăta
exact ca sursa.

· doveadm sincronizaţi efectuează sincronizarea în două sensuri. Îmbină toate modificările
fără a pierde nimic. Ambele cutii poștale vor ajunge să arate identice
după terminarea sincronizării.

· doveadm sincronizaţi -1 efectuează sincronizarea unidirecțională, dar îmbină modificările
in destinatie fara a sterge nimic. Acest lucru nu funcționează în prezent
perfect, astfel încât utilizarea sa ar trebui să fie limitată. Scopul său principal este ca în timpul
migrarea căsuței poștale pe care o puteți rula doveadm de rezervă de mai multe ori, apoi comută
e-mailuri care urmează să fie livrate în noua căsuță poștală și rulați doveadm sincronizaţi -1 inca o data
pentru a transfera ultimele e-mailuri noi din vechea căsuță poștală.

Există, de asemenea, trei algoritmi diferiți de sincronizare:

· Sincronizarea completă (parametrul -f) scanează toate mesajele în totalitate
cutiile poştale. Acest lucru garantează că totul va fi sincronizat, dar
este inutil de lent pentru sincronizarea incrementală.

· Sincronizarea rapidă (implicit) încearcă mai întâi să găsească cutiile poștale care au
schimbate și sincronizați numai acelea. Acest lucru se face prin verificarea
metadatele cutiilor poștale (NEXTUID și HIGHESTMODSEQ). De obicei, asta funcționează bine,
mai ales cu sincronizarea unidirecțională, dar dacă ambele părți fac exact
același număr de modificări, metadatele pot ajunge să conțină aceleași valori
chiar dacă schimbările au fost diferite.

· Sincronizarea cu stat (parametrul -s) este cea mai eficientă modalitate de a
sincroniza cutiile poștale. Se bazează pe starea anterioară a rulării dsync
salvat undeva și trecut la următoarea rulare de sincronizare. Pe baza acestei stări
dsync poate trimite numai modificările care au avut loc după rularea anterioară a dsync.
Atâta timp cât starea sau cutiile poștale nu sunt corupte, acest algoritm ar trebui
functioneaza perfect. Procesul de replicare folosește acest lucru intern pentru a realiza cele mai multe
a sincronizării.

Sincronizarea se face cât se poate de perfect: un client IMAP sau POP3 nu ar trebui să poată
pentru a observa orice diferențe între cele două cutii poștale. Sincronizarea bidirecțională înseamnă că este sigură
pentru a face orice fel de modificări în ambele părți, iar dsync va îmbina modificările fără
pierzând orice modificări făcute de ambele părți. Acest lucru este posibil deoarece dsync poate accesa
Jurnalele de index ale Dovecot care țin evidența modificărilor. Desigur, este posibil să aibă
conflictele în timpul comasării, acestea sunt rezolvate în siguranță. Vezi sincronizare proiecta document
pentru mai multe informatii.

dsync folosește aceleași fișiere de configurare ca și restul Dovecot (prin doveconf(1) binar).
Întreaga configurație poate fi modificată dând parametrul -c unei alte configurații
fișier sau folosind parametrul -o pentru a înlocui anumite setări. Când executați o sincronizare la distanță
programul funcționează în același mod: folosește propria sa configurație locală.

dsync poate fi rulat complet independent. Nu necesită procese de server Dovecot
să ruleze, cu excepția cazului în care se utilizează parametrul -u pentru a face a userdb căutare din procesul de autentificare.

dsync poate sincroniza unul sau mai mulți utilizatori folosind parametrii -u sau -A. Pentru continuu
replicare puteți utiliza procesul de replicare Dovecot, care rulează automat dsync
ori de câte ori mesajele s-au schimbat.

OPŢIUNI

Caritate doveadm(1) Opțiuni:

-D Activează mesajele de verbozitate și depanare.

-o instalare=valoare
Ignoră configurația instalare din /etc/dovecot/dovecot.conf și de la
userdb cu data valoare. Pentru a anula mai multe setări, aplicația -o opțiune
poate fi specificat de mai multe ori.

-v Activează verbozitatea, inclusiv contorul de progres.

Comandă specifică Opțiuni:

-1 Efectuați sincronizarea într-un singur sens în loc de sincronizare în două sensuri.

-A În cazul în care -A opțiunea este prezentă, comandă va fi efectuată pentru toți utilizatorii. Folosind
această opțiune în combinație cu utilizatorii sistemului de la userdb { şofer = passwd } nu este
recomandat, deoarece conține și utilizatori cu un UID mai mic decât cel
configurat cu first_valid_uid setare.

Când este utilizat modulul userdb SQL, asigurați-vă că iterate_query instalarea
/etc/dovecot/dovecot-sql.conf.ext se potrivește cu aspectul bazei de date. Când utilizați
Modulul userdb LDAP, asigurați-vă că iterate_attrs și iterate_filter setări în
/etc/dovecot/dovecot-ldap.conf.ext potriviți schema dvs. LDAP. In caz contrar doveadm(1)
nu va putea repeta peste toți utilizatorii.

-F fişier
Executați comandă pentru toți utilizatorii din fişier. Aceasta este similară cu -A
opțiunea, dar în loc să obțină lista de utilizatori din userdb, aceștia sunt cititi
din dat fişier. fişier conține un nume de utilizator pe linie.

-N Sincronizați toate spațiile de nume disponibile. În mod implicit, numai spațiile de nume care nu
au setare explicită a locației sunt sincronizate.

-P Fugiți a doveadm-purge(1) pentru stocarea de destinație (la distanță) după sincronizare.

-R Faceți o sincronizare inversă. În mod normal, mesajele ar fi împinse din sistemul local către
destinație (la distanță). Această opțiune inversează fluxul și, în schimb, va extrage mesajele
de la distanță la stocarea locală.

-S cale_socket
Argumentul opțiunii este fie o cale absolută către un socket de domeniu UNIX local, fie
un nume de gazdă și un port (nume de gazdă:port), pentru a conecta o gazdă la distanță printr-un TCP
priză.

Acest lucru permite unui administrator să execute doveadm(1) comenzi prin e-mail prin date
priză.

-T secunde
Specificați timpul în secunde, cât timp doveadm(1) ar trebui să aștepte I/O blocat
operațiuni. Timpul de expirare implicit este de 600 de secunde.

-U Acesta este folosit intern de replicator pentru ca dsync să îl notifice atunci când
sincronizarea este terminată.

-d Utilizați destinația implicită, care este căutată din mail_replica userdb suplimentar
camp.

-g mailbox_guid
La fel ca -m, dar găsiți căsuța poștală să fie sincronizată prin GUID-ul său, nu după nume.

-l secunde
Blocați sincronizarea pentru acest utilizator. Așteptați maxim secunde înainte de a renunţa. Acest
parametrul ar trebui utilizat pentru a evita sincronizarea întreruptă, dacă este posibil
dsync rulează simultan pentru același utilizator.

-m cutie poștală
Sincronizați numai acest nume de cutie poștală.

-n Spațiu de nume
Sincronizați numai spațiul de nume specificat. Acest parametru poate fi utilizat de mai multe ori
ori.

-r rawlog_path
Rulând dsync de la distanță, scrieți traficul de intrare/ieșire de la distanță în jurnalul specificat
fișier.

-s stare_anterioara
Utilizați sincronizarea cu stare. Dacă starea anterioară este necunoscută, utilizați un gol
şir. Noua stare este întotdeauna tipărită la ieșirea standard.

-u utilizator/mască
Pornește comandă numai pentru dat utilizator. De asemenea, este posibil să utilizați „*' și '?'
wildcards (de exemplu -u *@example.org).
Când nici cele -A opțiunea, nici cea -F fişier opțiunea, nici cea -u utilizator a fost specificat,
il comandă va fi executat cu mediul utilizatorului conectat în prezent.

-x mailbox_mask
Excludeți numele/mască de cutie poștală specificată. Masca poate conține „?"Şi"*"
wildcards. Acest parametru poate fi utilizat de mai multe ori.

ARGUMENTE

destinație
Acest argument specifică destinația sincronizată. Poate fi unul dintre:

locaţie
La fel ca locație_mail setare, de exemplu maildir:~/Maildir

la distanta:autentificare@gazdă
Utilizeaza dsync_remote_cmd setare pentru a se conecta la gazda de la distanță (de obicei prin
ssh)

remoteprefix:login@host
Este la fel ca la distanță, cu excepția faptului că „utilizator@domeniu\n” este trimis înainte de sincronizare
începe protocolul. Acest lucru permite implementarea unui script wrapper de încredere care
rulează doveadm dsync-server citind numele de utilizator din prima linie.

tcp:gazdă[:port]
Se conectează la serverul de la distanță doveadm prin TCP. Portul implicit este specificat de
doveadm_port setare.

tcps:gazdă[:port]
Este la fel ca tcp, dar cu SSL.

EXIT STAREA

sincronizare va ieși cu una dintre următoarele valori:

0 Sincronizarea s-a făcut perfect.

2 Sincronizarea s-a făcut fără erori, dar unele modificări nu au putut fi făcute, așa că
cutiile poștale nu sunt perfect sincronizate. Rularea dsync din nou rezolvă de obicei acest lucru.
De obicei, acest lucru se întâmplă pentru secvențele de modificare a mesajelor cu cutii poștale nou create.
Poate apărea și dacă una dintre cutiile poștale se schimbă în timpul sincronizării.

1, >2
Sincronizarea a eșuat.

EXEMPLU

SINCRONIZARE
Sincronizați cutiile poștale cu un server la distanță. Orice erori sunt scrise în stderr.

doveadm sincronizaţi -u [e-mail protejat] remote:server-replica.example.com

Dacă aveți nevoie de parametri mai complexi pentru ssh, puteți utiliza de exemplu:

doveadm sincronizaţi -u [e-mail protejat] ssh -i id_dsa.dovecot \
[e-mail protejat] doveadm dsync-server -u [e-mail protejat]

CONVERSIUNEA
Presupunând că locație_mail instalarea /etc/dovecot/conf.d/10-mail.conf este setat sa:
locație_mail = mdbox:~/mdbox, un utilizator de sistem conectat își poate converti e-mailurile din acesta
Maildir în directorul său principal în formatul de cutie poștală mdbox. Utilizatorul trebuie să execute
comanda:

doveadm sincronizaţi maildir:~/Maildir

Dacă doriți să faceți acest lucru fără timp de nefuncționare, puteți face conversia câte un utilizator.
Inițial:

· Utilizări de configurare locație_mail = maildir:~/Maildir

· Configurați posibilitatea de a face locație de e-mail per utilizator folosind userdb câmpuri suplimentare.

Apoi, pentru fiecare utilizator:

1. Alerga doveadm sincronizaţi o dată pentru a face conversia inițială.

2. Alerga doveadm sincronizaţi din nou, pentru că conversia inițială ar fi putut dura ceva timp
iar noi schimbări ar fi putut avea loc în timpul acesteia. Această a doua oară se aplică doar
modificări, așa că ar trebui să fie rapid.

3. Actualizați câmpul suplimentar pentru e-mail din userdb la mdbox:~/mdbox. Dacă utilizați cache de autentificare,
trebuie să-l spălați, de ex doveadm auth cache culoare.

4. Așteptați câteva secunde și apoi ucideți (doveadm kick) toate imap-urile existente ale utilizatorului
și sesiuni pop3 (care încă folosesc maildir).

5. Alerga doveadm sincronizaţi încă o dată pentru a aplica modificările finale care au fost posibile făcute. După
acest lucru nu ar trebui să existe modificări la Maildir, deoarece locația de e-mail a utilizatorului are
au fost schimbate și toate procesele existente care îl folosesc au fost oprite.

După ce toți utilizatorii au fost convertiți, puteți seta valoarea implicită locație_mail la mdbox și
eliminați locațiile de e-mail pentru fiecare utilizator din userdb.

RAPORTAREA GANDACI

Raportați erori, inclusiv doveconf -n ieșire, către Lista de corespondență Dovecot
<[e-mail protejat]>. Informații despre raportarea erorilor sunt disponibile la:
http://dovecot.org/bugreport.html

Utilizați doveadm-sync online folosind serviciile onworks.net