doveadm-sync - Online sa Cloud

PROGRAMA:

NAME

doveadm-sync - Dovecot's two-way mailbox synchronization utility
doveadm-backup - Ang one-way na mailbox synchronization utility ng Dovecot

SINOPSIS

doveadm [-Dv] i-sync [-u gumagamit|-A|-F file] [-S socket_path] [-1fPRU] [-l tuyo] [-r
rawlog_path] [-m mailbox] [-g mailbox_guid] [-n namespace|-N] [-x huwag isama] [-s ay] [-T
tuyo] -d|patutunguhan

doveadm [-Dv] backup [-u gumagamit|-A|-F file] [-S socket_path] [-fPRU] [-l tuyo] [-r
rawlog_path] [-m mailbox] [-g mailbox_guid] [-n namespace|-N] [-x huwag isama] [-s ay] [-T
tuyo] -d|patutunguhan

DESCRIPTION

Ang dsync ay ang mailbox synchronization utility ng Dovecot. Maaari itong magamit para sa maraming iba't ibang
mga kaso ng paggamit: Two-way na pag-synchronize ng mga mailbox, paggawa ng mga backup ng mga mail, at pag-convert
mga mailbox mula/sa iba't ibang mga format ng mailbox. Ang lahat ng ito ay maaaring gamitin sa loob ng pareho
server o sa pagitan ng iba't ibang mga server (sa pamamagitan ng SSH(1) o tcp na mga koneksyon). Maaari ang mga remote mailbox
ma-access din sa pamamagitan ng IMAP protocol, na nagbibigay-daan sa paggamit ng dsync para sa paglipat ng mailbox
mga layunin.

Maaari mong patakbuhin ang dsync sa isa sa tatlong mga mode:

· doveadm backup gumaganap ng one-way na pag-synchronize. Kung may mga pagbabago
sa patutunguhan sila ay tatanggalin, kaya ang patutunguhan ay titingnan
eksakto tulad ng pinagmulan.

· doveadm i-sync gumaganap ng two-way synchronization. Pinagsasama nito ang lahat ng pagbabago
nang walang nawawala. Ang parehong mga mailbox ay magiging magkapareho
pagkatapos ng synchronization ay tapos na.

· doveadm i-sync -1 nagsasagawa ng one-way na pag-synchronize, ngunit pinagsasama nito ang mga pagbabago
sa patutunguhan nang hindi tinatanggal ang anuman. Ito ay kasalukuyang hindi gumagana
perpekto, kaya dapat na limitado ang paggamit nito. Ang pangunahing layunin nito ay sa panahon
mailbox migration na maaari mong patakbuhin doveadm backup maraming beses, pagkatapos ay lumipat
mail na ihahatid sa bagong mailbox at patakbuhin doveadm i-sync -1 isa pa
upang ilipat ang anumang huling bagong mail mula sa lumang mailbox.

Mayroon ding tatlong magkakaibang algorithm ng pag-synchronize:

· Ang buong synchronization (-f parameter) ay nag-scan sa lahat ng mga mensahe sa lahat
ang mga mailbox. Ginagarantiyahan nito na ang lahat ay mai-synchronize, ngunit
ito ay hindi kinakailangang mabagal para sa incremental na pag-synchronize.

· Mabilis na pag-synchronize (default) unang sumusubok na maghanap ng mga mailbox na mayroon
binago, at i-synchronize lamang ang mga iyon. Ginagawa ito sa pamamagitan ng pagsuri sa
metadata ng mga mailbox (NEXTUID at HIGHESTMODSEQ). Kadalasan ito ay gumagana nang maayos,
lalo na sa one-way na pag-synchronize, ngunit kung eksaktong gagawin ng magkabilang panig ang
parehong bilang ng mga pagbabago, ang metadata ay maaaring maglaman ng parehong mga halaga
kahit na iba ang mga pagbabago.

· Ang stateful synchronization (-s parameter) ay ang pinakamabisang paraan upang
i-synchronize ang mga mailbox. Ito ay umaasa sa pagkakaroon ng naunang dsync run's state
nai-save sa isang lugar at ipinapasa sa susunod na dsync run. Batay sa estadong ito
Maaari lamang ipadala ng dsync ang mga pagbabagong nangyari pagkatapos ng nakaraang pagtakbo ng dsync.
Hangga't ang estado o ang mga mailbox ay hindi nasira ang algorithm na ito
gumana nang perpekto. Ginagamit ito ng proseso ng replicator sa loob upang maisagawa ang karamihan
ng synchronization.

Ginagawa ang pag-sync hangga't maaari: hindi dapat magawa ng IMAP o POP3 client
upang mapansin ang anumang pagkakaiba sa pagitan ng dalawang mailbox. Ang ibig sabihin ng two-way na pag-sync ay ligtas ito
upang gumawa ng anumang uri ng mga pagbabago sa magkabilang panig, at pagsasamahin ng dsync ang mga pagbabago nang wala
pagkawala ng anumang mga pagbabagong ginawa sa magkabilang panig. Posible ito dahil makaka-access ang dsync
Ang mga index log ng Dovecot na sumusubaybay sa mga pagbabago. Syempre posibleng magkaroon
mga salungatan sa panahon ng pagsasanib, ang mga ito ay nareresolba sa ligtas na paraan. Tingnan ang dsync disenyo dokumento
para sa karagdagang impormasyon.

dsync ay gumagamit ng parehong mga file ng pagsasaayos tulad ng iba pang bahagi ng Dovecot (sa pamamagitan ng doveconf(1) binary).
Ang buong configuration ay maaaring baguhin sa pamamagitan ng pagbibigay -c parameter sa isa pang configuration
file, o paggamit ng -o parameter para i-override ang mga partikular na setting. Kapag nagsasagawa ng remote dsync
program na ito ay gumagana sa parehong paraan: gumagamit ito ng sarili nitong lokal na pagsasaayos.

Ang dsync ay maaaring ganap na patakbuhin nang nakapag-iisa. Hindi ito nangangailangan ng anumang mga proseso ng Dovecot server
na tumatakbo, maliban kapag gumagamit ng -u parameter upang gawin a userdb paghahanap mula sa proseso ng auth.

Maaaring i-sync ng dsync ang alinman sa isa o maraming user gamit ang -u o -A na mga parameter. Para tuloy-tuloy
replikasyon maaari mong gamitin ang proseso ng Dovecot replicator, na awtomatikong nagpapatakbo ng dsync
sa tuwing nagbabago ang mga mensahe.

Opsyon

Global doveadm(1) pagpipilian:

-D Pinapagana ang verbosity at debug na mga mensahe.

-o pagtatakda ng=halaga
Ino-override ang configuration pagtatakda ng mula /etc/dovecot/dovecot.conf at mula sa
userdb kasama ang ibinigay halaga. Upang ma-override ang maramihang mga setting, ang -o opsyon
maaaring tukuyin ng maraming beses.

-v Pinapagana ang verbosity, kabilang ang progress counter.

Tukoy sa utos pagpipilian:

-1 Gawin ang one-way na pag-synchronize sa halip na ang two-way na pag-synchronize.

-A Kung ang -A naroroon ang opsyon, ang utos isasagawa para sa lahat ng mga gumagamit. Gamit
ang opsyong ito kasama ng mga user ng system mula sa userdb { drayber = passwd } Hindi
inirerekomenda, dahil naglalaman din ito ng mga user na may mas mababang UID kaysa sa isa
naka-configure sa first_valid_uid setting na ito.

Kapag ginamit ang SQL userdb module siguraduhin na ang iterate_query setting sa
/etc/dovecot/dovecot-sql.conf.ext tumutugma sa iyong layout ng database. Kapag ginagamit ang
LDAP userdb module, siguraduhin na ang iterate_attrs at iterate_filter setting sa
/etc/dovecot/dovecot-ldap.conf.ext tumugma sa iyong LDAP schema. Kung hindi doveadm(1)
ay hindi makakaulit sa lahat ng mga user.

-F file
Isagawa ang utos para sa lahat ng mga gumagamit sa file. Ito ay katulad ng -A
opsyon, ngunit sa halip na makuha ang listahan ng mga user mula sa userdb, binabasa sila
mula sa ibinigay file. ang file naglalaman ng isang username bawat linya.

-N I-synchronize ang lahat ng available na namespaces. Bilang default, ang mga namespace lang na hindi
may malinaw na setting ng lokasyon ay naka-synchronize.

-P Patakbuhin ang isang doveadm-purge(1) para sa destinasyon (remote) na imbakan pagkatapos ng pag-synchronize.

-R Gumawa ng reverse sync. Karaniwan, ang mga mensahe ay itutulak mula sa lokal na sistema patungo sa
destinasyon (remote). Binabaliktad ng opsyong ito ang daloy, at sa halip ay kukuha ng mga mensahe
mula sa remote hanggang sa lokal na imbakan.

-S socket_path
Ang argumento ng opsyon ay alinman sa isang ganap na landas sa isang lokal na UNIX domain socket, o
isang hostname at port (hostname:port), upang ikonekta ang isang malayuang host sa pamamagitan ng isang TCP
saksakan.

Nagbibigay-daan ito sa isang administrator na magsagawa doveadm(1) mail command sa pamamagitan ng ibinigay
saksakan.

-T tuyo
Tukuyin ang oras sa mga segundo, gaano katagal doveadm(1) dapat maghintay para sa natigil na I/O
mga operasyon. Ang default na timeout ay 600 segundo.

-U Ito ay ginagamit sa loob ng replicator upang ipaalam ito sa dsync kapag ang
tapos na ang synchronization.

-d Gamitin ang default na destinasyon, na hinahanap mula sa mail_replica userdb dagdag
na patlang.

-g mailbox_guid
Pareho sa -m, ngunit hanapin ang mailbox na i-synchronize ng GUID nito sa halip na sa pamamagitan ng pangalan.

-l tuyo
I-lock ang dsync para sa user na ito. Maghintay para sa maximum tuyo bago sumuko. Ito
dapat gamitin ang parameter upang maiwasan ang sirang pag-synchronize kung posible iyon
Ang dsync ay sabay na pinapatakbo para sa parehong user.

-m mailbox
I-synchronize lamang ang pangalan ng mailbox na ito.

-n namespace
I-synchronize lamang ang tinukoy na namespace. Ang parameter na ito ay maaaring gamitin nang maramihan
beses.

-r rawlog_path
Pagpapatakbo ng dsync nang malayuan, isulat ang remote na input/output na trapiko sa tinukoy na log
file.

-s nakaraang_estado
Gumamit ng stateful synchronization. Kung hindi alam ang dating estado, gumamit ng walang laman
string. Ang bagong estado ay palaging naka-print sa karaniwang output.

-u gumagamit/maskara
Patakbuhin ang utos para lang sa binigay gumagamit. Posible ring gamitin ang '*'At'?'
mga wildcard (hal -u *@example.org).
Kapag hindi ang -A opsyon, o ang -F file opsyon, o ang -u gumagamit ay tinukoy,
ang utos ay isasagawa kasama ang kapaligiran ng kasalukuyang naka-log in na gumagamit.

-x mailbox_mask
Ibukod ang tinukoy na pangalan/mask ng mailbox. Ang maskara ay maaaring naglalaman ng "?"At"*"
mga wildcard. Maaaring gamitin ang parameter na ito nang maraming beses.

MGA PANGANGATWIRANG

patutunguhan
Tinutukoy ng argumentong ito ang naka-synchronize na destinasyon. Maaari itong isa sa:

lugar
Katulad ng mail_location setting, hal maildir:~/Maildir

remote:login@host
Gumagamit dsync_remote_cmd setting upang kumonekta sa remote host (karaniwan ay sa pamamagitan ng
ssh)

remoteprefix:login@host
Ito ay kapareho ng remote, maliban sa "user@domain\n" ay ipinadala bago ang dsync
magsisimula ang protocol. Nagbibigay-daan ito sa pagpapatupad ng pinagkakatiwalaang script ng wrapper na iyon
nagpapatakbo ng doveadm dsync-server sa pamamagitan ng pagbabasa ng username mula sa unang linya.

tcp:host[:port]
Kumokonekta sa malayong doveadm server sa pamamagitan ng TCP. Ang default na port ay tinukoy ng
doveadm_port setting na ito.

tcps:host[:port]
Ito ay kapareho ng tcp, ngunit may SSL.

EXIT STATUS

dsync ay lalabas gamit ang isa sa mga sumusunod na halaga:

0 Perpektong nagawa ang pag-synchronize.

2 Ang pag-synchronize ay ginawa nang walang mga error, ngunit ang ilang mga pagbabago ay hindi magawa, kaya ang
hindi perpektong naka-synchronize ang mga mailbox. Karaniwang inaayos ito ng pagpapatakbo ng dsync muli.
Karaniwan itong nangyayari para sa mga sequence ng pagbabago ng mensahe na may mga bagong likhang mailbox.
Maaari rin itong mangyari kung magbabago ang isa sa mga mailbox habang nagsi-sync.

1, >2
Nabigo ang pag-synchronize.

Halimbawa

PAGHAHANAP
I-synchronize ang mga mailbox sa isang malayuang server. Ang anumang mga error ay isinulat sa stderr.

doveadm i-sync -u [protektado ng email] remote:server-replica.example.com

Kung kailangan mo ng mas kumplikadong mga parameter sa ssh, maaari mong gamitin ang hal:

doveadm i-sync -u [protektado ng email] SSH -i id_dsa.dovecot \
[protektado ng email] doveadm dsync-server -u [protektado ng email]

NAG-CONVERT
Ipagpalagay na ang mail_location setting sa /etc/dovecot/conf.d/10-mail.conf ay nakatakda sa:
mail_location = mdbox:~/mdbox, maaaring i-convert ng naka-log in na user ng system ang kanyang mga mail mula dito
Maildir sa kanyang home directory sa mdbox mailbox na format. Kailangang i-execute ng user
ang utos:

doveadm i-sync maildir:~/Maildir

Kung gusto mong gawin ito nang walang anumang downtime, maaari mong gawin ang conversion nang paisa-isa.
Sa una:

· Mga gamit ng configuration mail_location = maildir:~/Maildir

· I-set up ang posibilidad ng paggawa ng per-user na lokasyon ng mail gamit ang userdb dagdag na mga patlang.

Pagkatapos para sa bawat gumagamit:

1. Tumakbo doveadm i-sync isang beses upang gawin ang paunang conversion.

2. Tumakbo doveadm i-sync muli, dahil maaaring tumagal ang paunang conversion
at maaaring magkaroon ng mga bagong pagbabago sa panahon nito. Nalalapat lamang ang pangalawang pagkakataong ito
pagbabago, kaya dapat mabilis.

3. I-update ang karagdagang field ng mail sa userdb sa mdbox:~/mdbox. Kung gumagamit ka ng auth cache,
kailangan mong i-flush ito, hal doveadm auth cache Kapantay.

4. Maghintay ng ilang segundo at pagkatapos ay patayin (doveadm kick) ang lahat ng umiiral na imap ng user
at mga pop3 session (na gumagamit pa rin ng maildir).

5. Tumakbo doveadm i-sync muli upang ilapat ang mga huling pagbabago na posibleng nagawa. Pagkatapos
ito ay dapat na walang mga pagbabago sa Maildir, dahil mayroon ang lokasyon ng mail ng user
ay binago at lahat ng umiiral na proseso na gumagamit nito ay pinatay.

Kapag na-convert na ang lahat ng user, maaari mong itakda ang default mail_location sa mdbox at
alisin ang mga lokasyon ng per-user na mail mula sa userdb.

Pag-uulat TUMBOK

Mag-ulat ng mga bug, kabilang ang doveconf -n output, sa Dovecot Mailing List
<[protektado ng email]>. Ang impormasyon tungkol sa pag-uulat ng mga bug ay makukuha sa:
http://dovecot.org/bugreport.html

Gumamit ng doveadm-sync online gamit ang mga serbisyo ng onworks.net