doveadm-sync - Dalam talian dalam Awan

JADUAL:

NAMA

doveadm-sync - Utiliti penyegerakan peti mel dua hala Dovecot
doveadm-backup - utiliti penyegerakan peti mel sehala Dovecot

SINOPSIS

doveadm [-Dv] menyegerakkan [-u pengguna|-A|-F fail] [-S socket_path] [-1fPRU] [-l secs] [-r
rawlog_path] [-m peti mel] [-g panduan_peti mel] [-n ruang nama|-N] [-x tidak termasuk] [-s adalah] [-T
secs] -d|destinasi

doveadm [-Dv] sandaran [-u pengguna|-A|-F fail] [-S socket_path] [-fPRU] [-l secs] [-r
rawlog_path] [-m peti mel] [-g panduan_peti mel] [-n ruang nama|-N] [-x tidak termasuk] [-s adalah] [-T
secs] -d|destinasi

DESCRIPTION

dsync ialah utiliti penyegerakan peti mel Dovecot. Ia boleh digunakan untuk beberapa yang berbeza
kes penggunaan: Penyegerakan dua hala peti mel, mencipta sandaran mel dan menukar
peti mel dari/ke format peti mel yang berbeza. Semua ini boleh digunakan dalam masa yang sama
pelayan atau antara pelayan yang berbeza (melalui ssh(1) atau sambungan tcp). Peti surat jauh boleh
boleh diakses juga melalui protokol IMAP, yang membenarkan penggunaan dsync untuk pemindahan peti mel
tujuan.

Anda boleh menjalankan dsync dalam salah satu daripada tiga mod:

· doveadm sandaran melakukan penyegerakan sehala. Jika terdapat sebarang perubahan
di destinasi mereka akan dipadamkan, jadi destinasi akan kelihatan
betul-betul seperti sumbernya.

· doveadm menyegerakkan melakukan penyegerakan dua hala. Ia menggabungkan semua perubahan
tanpa kehilangan apa-apa. Kedua-dua peti mel akan kelihatan sama
selepas penyegerakan selesai.

· doveadm menyegerakkan -1 melakukan penyegerakan sehala, tetapi ia menggabungkan perubahan
dalam destinasi tanpa memadam apa-apa. Ini tidak berfungsi pada masa ini
dengan sempurna, jadi penggunaannya harus dihadkan. Tujuan utamanya ialah semasa
migrasi peti mel anda boleh jalankan doveadm sandaran beberapa kali, kemudian tukar
mel untuk dihantar ke peti mel baharu dan dijalankan doveadm menyegerakkan -1 sekali lagi
untuk memindahkan sebarang mel baharu yang terakhir dari peti mel lama.

Terdapat juga tiga algoritma penyegerakan yang berbeza:

· Penyegerakan penuh (parameter-f) mengimbas semua mesej dalam semua
peti mel. Ini menjamin bahawa segala-galanya akan disegerakkan, tetapi
ia tidak semestinya perlahan untuk penyegerakan tambahan.

· Penyegerakan pantas (lalai) percubaan pertama untuk mencari peti mel yang mempunyai
berubah, dan menyegerakkan hanya mereka. Ini dilakukan dengan menyemak
metadata peti mel (NEXTUID dan HIGHESTMODSEQ). Biasanya ini berfungsi dengan baik,
terutamanya dengan penyegerakan sehala, tetapi jika kedua-dua pihak melakukan betul-betul
bilangan perubahan yang sama, metadata mungkin mengandungi nilai yang sama
walaupun perubahannya berbeza.

· Penyegerakan stateful (-s parameter) ialah cara yang paling berkesan untuk
menyegerakkan peti mel. Ia bergantung pada keadaan dsync run yang lebih awal
disimpan di suatu tempat dan dihantar ke larian dsync seterusnya. Berdasarkan negeri ini
dsync hanya boleh menghantar perubahan yang berlaku selepas dsync dijalankan sebelumnya.
Selagi keadaan atau peti mel tidak rosak, algoritma ini sepatutnya
bekerja dengan sempurna. Proses replikator menggunakan ini secara dalaman untuk melaksanakan kebanyakannya
daripada penyegerakan.

Penyegerakan dilakukan sebaik mungkin: pelanggan IMAP atau POP3 tidak sepatutnya dapat melakukannya
untuk melihat sebarang perbezaan antara kedua-dua peti mel. Penyegerakan dua hala bermakna ia selamat
untuk melakukan apa-apa jenis pengubahsuaian dalam kedua-dua belah pihak, dan dsync akan menggabungkan perubahan tanpa
kehilangan sebarang perubahan yang dilakukan di kedua-dua belah pihak. Ini mungkin kerana dsync boleh mengakses
Log indeks Dovecot yang menjejaki perubahan. Sudah tentu boleh dimiliki
konflik semasa penggabungan, ini diselesaikan dengan cara yang selamat. Lihat dsync reka bentuk dokumen
untuk maklumat lanjut.

dsync menggunakan fail konfigurasi yang sama seperti Dovecot yang lain (melalui doveconf(1) binari).
Keseluruhan konfigurasi boleh diubah dengan memberikan parameter -c kepada konfigurasi lain
fail, atau menggunakan parameter -o untuk mengatasi tetapan tertentu. Apabila melaksanakan dsync jauh
program ia berfungsi dengan cara yang sama: ia menggunakan konfigurasi setempatnya sendiri.

dsync boleh dijalankan sepenuhnya kendiri. Ia tidak memerlukan sebarang proses pelayan Dovecot
untuk dijalankan, kecuali apabila menggunakan parameter -u untuk melakukan a userdb carian daripada proses pengesahan.

dsync boleh menyegerakkan sama ada satu atau berbilang pengguna menggunakan parameter -u atau -A. Untuk berterusan
replikasi anda boleh menggunakan proses replikator Dovecot, yang secara automatik menjalankan dsync
setiap kali mesej telah berubah.

PILIHAN

Global doveadm(1) pilihan:

-D Mendayakan mesej verbositi dan nyahpepijat.

-o menetapkan=nilai
Mengatasi konfigurasi menetapkan dari /etc/dovecot/dovecot.conf dan daripada
userdb dengan yang diberikan nilai. Untuk mengatasi berbilang tetapan, -o pilihan
boleh dinyatakan beberapa kali.

-v Mendayakan verbositi, termasuk pembilang kemajuan.

Perintah khusus pilihan:

-1 Lakukan penyegerakan sehala dan bukannya penyegerakan dua hala.

-A Jika -A pilihan ada, iaitu arahan akan dilakukan untuk semua pengguna. menggunakan
pilihan ini dalam kombinasi dengan pengguna sistem dari userdb { pemandu = passwd } tidak
disyorkan, kerana ia juga mengandungi pengguna dengan UID yang lebih rendah daripada yang satu
dikonfigurasikan dengan first_valid_uid penetapan.

Apabila modul userdb SQL digunakan pastikan bahawa iterate_query masuk ke dalam
/etc/dovecot/dovecot-sql.conf.ext sepadan dengan susun atur pangkalan data anda. Apabila menggunakan
Modul userdb LDAP, pastikan bahawa iterate_attrs and iterate_filter tetapan di
/etc/dovecot/dovecot-ldap.conf.ext sepadan dengan skema LDAP anda. Jika tidak doveadm(1)
tidak akan dapat mengulangi semua pengguna.

-F fail
Laksanakan arahan untuk semua pengguna dalam fail. Ini serupa dengan -A
pilihan, tetapi bukannya mendapatkan senarai pengguna daripada userdb, mereka dibaca
daripada yang diberikan fail. Yang fail mengandungi satu nama pengguna setiap baris.

-N Segerakkan semua ruang nama yang tersedia. Secara lalai hanya ruang nama yang tidak
mempunyai tetapan lokasi yang jelas disegerakkan.

-P Jalankan a doveadm-purge(1) untuk storan destinasi (jauh) selepas penyegerakan.

-R Lakukan penyegerakan terbalik. Biasanya, mesej akan ditolak dari sistem tempatan ke
destinasi (jauh). Pilihan ini membalikkan aliran dan sebaliknya akan menarik mesej
daripada alat kawalan jauh ke storan tempatan.

-S socket_path
Hujah pilihan adalah sama ada laluan mutlak ke soket domain UNIX tempatan, atau
nama hos dan port (nama hos:pelabuhan), untuk menyambungkan hos jauh melalui TCP
soket.

Ini membolehkan pentadbir untuk melaksanakan doveadm(1) mel arahan melalui yang diberikan
soket.

-T secs
Nyatakan masa dalam saat, berapa lama doveadm(1) harus menunggu I/O yang terhenti
operasi. Tamat masa lalai ialah 600 saat.

-U Ini digunakan secara dalaman oleh replikator supaya dsync memberitahunya apabila
penyegerakan selesai.

-d Gunakan destinasi lalai, yang dilihat dari mail_replica userdb tambahan
lapangan.

-g panduan_peti mel
Sama seperti -m, tetapi cari peti mel untuk disegerakkan oleh GUIDnya dan bukannya dengan nama.

-l secs
Kunci dsync untuk pengguna ini. Tunggu maksimum secs sebelum berputus asa. ini
parameter harus digunakan untuk mengelakkan penyegerakan rosak jika mungkin
dsync sedang dijalankan serentak untuk pengguna yang sama.

-m peti mel
Segerakkan hanya nama peti mel ini.

-n ruang nama
Segerakkan hanya ruang nama yang ditentukan. Parameter ini boleh digunakan berbilang
kali.

-r rawlog_path
Menjalankan dsync dari jauh, tulis trafik input/output jauh ke log yang ditentukan
fail.

-s negeri_sebelumnya
Gunakan penyegerakan stateful. Jika keadaan sebelumnya tidak diketahui, gunakan kosong
tali. Keadaan baharu sentiasa dicetak kepada keluaran standard.

-u pengguna/topeng
Jalankan arahan hanya untuk yang diberi pengguna. Ia juga mungkin untuk menggunakan '*'Dan'?'
kad bebas (cth -u *@example.org).
Apabila kedua-duanya tidak -A pilihan, mahupun -F fail pilihan, mahupun -u pengguna telah dinyatakan,
yang arahan akan dilaksanakan dengan persekitaran pengguna yang sedang log masuk.

-x peti surat_topeng
Kecualikan nama peti mel/topeng yang ditentukan. Topeng itu mungkin mengandungi "?"Dan"*"
kad bebas. Parameter ini boleh digunakan beberapa kali.

HUJAH

destinasi
Argumen ini menentukan destinasi yang disegerakkan. Ia boleh menjadi salah satu daripada:

lokasi
Sama seperti lokasi_mel tetapan, cth maildir:~/Maildir

jauh:log masuk@hos
kegunaan dsync_remote_cmd tetapan untuk menyambung ke hos jauh (biasanya melalui
ssh)

remoteprefix:login@host
Ini adalah sama seperti jauh, kecuali "pengguna@domain\n" dihantar sebelum dsync
protokol bermula. Ini membolehkan melaksanakan skrip pembalut yang dipercayai itu
menjalankan doveadm dsync-server dengan membaca nama pengguna dari baris pertama.

tcp:hos[:port]
Menyambung ke pelayan doveadm jauh melalui TCP. Port lalai ditentukan oleh
doveadm_port penetapan.

tcps:hos[:port]
Ini sama seperti tcp, tetapi dengan SSL.

EXIT STATUS

dsync akan keluar dengan salah satu daripada nilai berikut:

0 Penyegerakan telah dilakukan dengan sempurna.

2 Penyegerakan telah dilakukan tanpa ralat, tetapi beberapa perubahan tidak dapat dilakukan, jadi
peti mel tidak disegerakkan dengan sempurna. Menjalankan dsync sekali lagi biasanya membetulkannya.
Biasanya ini berlaku untuk urutan pengubahsuaian mesej dengan peti mel yang baru dibuat.
Ia juga boleh berlaku jika salah satu peti mel berubah semasa penyegerakan.

1, >2
Penyegerakan gagal.

CONTOH

SINKRONISASI
Segerakkan peti mel dengan pelayan jauh. Sebarang ralat ditulis kepada stderr.

doveadm menyegerakkan -u [e-mel dilindungi] remote:server-replica.example.com

Jika anda memerlukan parameter yang lebih kompleks untuk ssh, anda boleh menggunakan contohnya:

doveadm menyegerakkan -u [e-mel dilindungi] ssh -i id_dsa.dovecot \
[e-mel dilindungi] doveadm dsync-server -u [e-mel dilindungi]

MENUKAR
Dengan andaian bahawa lokasi_mel masuk ke dalam /etc/dovecot/conf.d/10-mail.conf ditetapkan kepada:
lokasi_mel = mdbox:~/mdbox, pengguna sistem yang log masuk boleh menukar melnya daripadanya
Maildir dalam direktori rumahnya ke format peti mel mdbox. Pengguna perlu melaksanakan
perintahnya:

doveadm menyegerakkan maildir:~/Maildir

Jika anda ingin melakukan ini tanpa sebarang masa henti, anda boleh melakukan penukaran satu pengguna pada satu masa.
Pada mulanya:

· Penggunaan konfigurasi lokasi_mel = maildir:~/Maildir

· Sediakan kemungkinan untuk menggunakan lokasi mel setiap pengguna userdb medan tambahan.

Kemudian untuk setiap pengguna:

1. Run doveadm menyegerakkan sekali untuk melakukan penukaran awal.

2. Run doveadm menyegerakkan sekali lagi, kerana penukaran awal mungkin mengambil sedikit masa
dan perubahan baru mungkin berlaku semasanya. Kali kedua ini hanya terpakai
berubah, jadi ia sepatutnya pantas.

3. Kemas kini medan tambahan mel dalam userdb ke mdbox:~/mdbox. Jika anda menggunakan cache auth,
anda perlu menyiramnya, cth doveadm auth cache flush.

4. Tunggu beberapa saat dan kemudian bunuh (doveadm kick) semua imap sedia ada pengguna
dan sesi pop3 (yang masih menggunakan maildir).

5. Run doveadm menyegerakkan sekali lagi untuk menggunakan perubahan terakhir yang mungkin dilakukan. Selepas
ini sepatutnya tiada perubahan pada Maildir, kerana lokasi mel pengguna mempunyai
telah diubah dan semua proses sedia ada yang menggunakannya telah dimatikan.

Setelah semua pengguna telah ditukar, anda boleh menetapkan lalai lokasi_mel ke mdbox dan
alih keluar lokasi mel setiap pengguna daripada userdb.

PELAPORAN BUANG

Laporkan pepijat, termasuk doveconf -n output, ke Senarai Mel Dovecot
<[e-mel dilindungi]>. Maklumat tentang pepijat pelaporan tersedia di:
http://dovecot.org/bugreport.html

Gunakan doveadm-sync dalam talian menggunakan perkhidmatan onworks.net