doveadm-sync - Online di Cloud

PROGRAM:

NAMA

doveadm-sync - utilitas sinkronisasi kotak surat dua arah Dovecot
doveadm-backup - utilitas sinkronisasi kotak surat satu arah Dovecot

RINGKASAN

doveadm [-Dv] sinkronisasi [-u pemakai|-A|-F fillet] [-S soket_jalur] [-1fPRU] [-l detik] [-r
rawlog_path] [-m kotak surat] [-g kotak_panduan] [-n namespace|-N] [-x mengecualikan] [-s negara] [-T
detik] -d|tujuan

doveadm [-Dv] backup [-u pemakai|-A|-F fillet] [-S soket_jalur] [-fPRU] [-l detik] [-r
rawlog_path] [-m kotak surat] [-g kotak_panduan] [-n namespace|-N] [-x mengecualikan] [-s negara] [-T
detik] -d|tujuan

DESKRIPSI

dsync adalah utilitas sinkronisasi kotak surat Dovecot. Hal ini dapat digunakan untuk beberapa yang berbeda
kasus penggunaan: Sinkronisasi kotak surat dua arah, membuat cadangan surat, dan mengonversi
kotak surat dari/ke format kotak surat yang berbeda. Semua ini dapat digunakan dalam waktu yang sama
server atau antara server yang berbeda (melalui ssh(1) atau koneksi tcp). Kotak surat jarak jauh dapat
dapat diakses juga melalui protokol IMAP, yang memungkinkan penggunaan dsync untuk migrasi kotak surat
tujuan.

Anda dapat menjalankan dsync dalam salah satu dari tiga mode:

· doveadm backup melakukan sinkronisasi satu arah. Jika ada perubahan
di tujuan mereka akan dihapus, sehingga tujuan akan terlihat
persis seperti sumbernya.

· doveadm sinkronisasi melakukan sinkronisasi dua arah. Ini menggabungkan semua perubahan
tanpa kehilangan apapun. Kedua kotak surat akan terlihat identik
setelah sinkronisasi selesai.

· doveadm sinkronisasi -1 melakukan sinkronisasi satu arah, tetapi menggabungkan perubahan
di tujuan tanpa menghapus apa pun. Saat ini tidak berfungsi
sempurna, sehingga penggunaannya harus dibatasi. Tujuan utamanya adalah selama
migrasi kotak surat yang dapat Anda jalankan doveadm backup beberapa kali, lalu beralih
surat yang akan dikirim ke kotak surat baru dan jalankan doveadm sinkronisasi -1 sekali lagi
untuk mentransfer surat baru terakhir dari kotak surat lama.

Ada juga tiga algoritma sinkronisasi yang berbeda:

· Sinkronisasi penuh (parameter -f) memindai semua pesan di semua
kotak surat. Ini menjamin bahwa semuanya akan disinkronkan, tapi
itu tidak perlu lambat untuk sinkronisasi tambahan.

· Sinkronisasi cepat (default) upaya pertama untuk menemukan kotak surat yang memiliki
diubah, dan hanya menyinkronkan itu. Hal ini dilakukan dengan memeriksa
metadata kotak surat (NEXTUID dan HIGHESTMODSEQ). Biasanya ini bekerja dengan baik,
terutama dengan sinkronisasi satu arah, tetapi jika kedua belah pihak melakukan hal yang sama
jumlah perubahan yang sama, metadata mungkin berisi nilai yang sama
walaupun perubahannya berbeda.

· Sinkronisasi stateful (parameter -s) adalah cara paling efisien untuk
menyinkronkan kotak surat. Itu bergantung pada status dsync run sebelumnya
disimpan di suatu tempat dan diteruskan ke dsync run berikutnya. Berdasarkan keadaan ini
dsync hanya dapat mengirim perubahan yang terjadi setelah dsync dijalankan sebelumnya.
Selama status atau kotak surat tidak rusak, algoritma ini seharusnya
bekerja dengan sempurna. Proses replikator menggunakan ini secara internal untuk melakukan sebagian besar
dari sinkronisasi.

Sinkronisasi dilakukan sesempurna mungkin: klien IMAP atau POP3 seharusnya tidak dapat
untuk melihat perbedaan antara dua kotak surat. Sinkronisasi dua arah berarti aman
untuk melakukan segala jenis modifikasi di kedua sisi, dan dsync akan menggabungkan perubahan tanpa
kehilangan perubahan yang dilakukan di kedua sisi. Ini dimungkinkan karena dsync dapat mengakses
Log indeks Dovecot yang melacak perubahan. Tentu saja mungkin untuk memiliki
konflik selama penggabungan, ini diselesaikan dengan cara yang aman. Lihat sinkronkan disain dokumen
for more information.

dsync menggunakan file konfigurasi yang sama dengan Dovecot lainnya (via merpaticonf(1) biner).
Seluruh konfigurasi dapat diubah dengan memberikan parameter -c ke konfigurasi lain
file, atau menggunakan parameter -o untuk mengganti pengaturan tertentu. Saat menjalankan dsync jarak jauh
program ini bekerja dengan cara yang sama: ia menggunakan konfigurasi lokalnya sendiri.

dsync dapat dijalankan sepenuhnya mandiri. Itu tidak memerlukan proses server Dovecot
untuk dijalankan, kecuali saat menggunakan parameter -u untuk melakukan a penggunadb pencarian dari proses auth.

dsync dapat menyinkronkan satu atau beberapa pengguna menggunakan parameter -u atau -A. Untuk terus menerus
replikasi Anda dapat menggunakan proses replikator Dovecot, yang secara otomatis menjalankan dsync
setiap kali pesan telah berubah.

PILIHAN

Aksi doveadm(1) Pilihan:

-D Mengaktifkan pesan verbositas dan debug.

-o pengaturan=nilai
Mengganti konfigurasi pengaturan dari /etc/dovecot/dovecot.conf dan dari
userdb dengan yang diberikan nilai. Untuk mengesampingkan beberapa pengaturan, tombol -o Option
dapat ditentukan beberapa kali.

-v Mengaktifkan verbositas, termasuk penghitung kemajuan.

Khusus perintah Pilihan:

-1 Lakukan sinkronisasi satu arah alih-alih sinkronisasi dua arah.

-A Jika -A pilihan hadir, the Command akan dilakukan untuk semua pengguna. Menggunakan
opsi ini dalam kombinasi dengan pengguna sistem dari penggunadb { pengemudi = passwd } tidak
direkomendasikan, karena berisi juga pengguna dengan UID lebih rendah dari yang sebelumnya
dikonfigurasi dengan first_valid_uid pengaturan.

Ketika modul SQL userdb digunakan, pastikan bahwa: ulangi_query pengaturan
/etc/dovecot/dovecot-sql.conf.ext cocok dengan tata letak basis data Anda. Saat menggunakan
modul LDAP userdb, pastikan bahwa: ulangi_attrs dan iterasi_filter pengaturan dalam
/etc/dovecot/dovecot-ldap.conf.ext cocok dengan skema LDAP Anda. Sebaliknya doveadm(1)
tidak akan dapat mengulangi semua pengguna.

-F fillet
Jalankan Command untuk semua pengguna di fillet. Ini mirip dengan -A
opsi, tetapi alih-alih mendapatkan daftar pengguna dari userdb, mereka dibaca
dari yang diberikan fillet. itu fillet berisi satu nama pengguna per baris.

-N Sinkronkan semua ruang nama yang tersedia. Secara default hanya ruang nama yang tidak
memiliki pengaturan lokasi eksplisit disinkronkan.

-P Jalankan a pembersihan-doveadm(1) untuk penyimpanan tujuan (jarak jauh) setelah sinkronisasi.

-R Lakukan sinkronisasi terbalik. Biasanya, pesan akan didorong dari sistem lokal ke
tujuan (jauh). Opsi ini membalikkan alur, dan sebagai gantinya akan menarik pesan
dari remote ke penyimpanan lokal.

-S soket_jalur
Argumen opsi adalah jalur absolut ke soket domain UNIX lokal, atau
nama host dan port (hostname:pelabuhan), untuk menghubungkan host jarak jauh melalui TCP
stopkontak.

Ini memungkinkan administrator untuk mengeksekusi doveadm(1) perintah surat melalui yang diberikan
stopkontak.

-T detik
Tentukan waktu dalam detik, berapa lama doveadm(1) harus menunggu I/O yang terhenti
operasi. Batas waktu default adalah 600 detik.

-U Ini digunakan secara internal oleh replikator agar dsync memberi tahu ketika
sinkronisasi selesai.

-d Gunakan tujuan default, yang dilihat dari surat_replika penggunadb tambahan
lapangan.

-g kotak_panduan
Sama seperti -m, tetapi temukan kotak surat yang akan disinkronkan dengan GUID-nya alih-alih berdasarkan nama.

-l detik
Kunci dsync untuk pengguna ini. Tunggu maksimal detik sebelum menyerah. Ini
parameter harus digunakan untuk menghindari sinkronisasi yang rusak jika memungkinkan
dsync sedang dijalankan secara bersamaan untuk pengguna yang sama.

-m kotak surat
Sinkronkan hanya nama kotak surat ini.

-n namespace
Sinkronkan hanya namespace yang ditentukan. Parameter ini dapat digunakan beberapa
kali.

-r rawlog_path
Menjalankan dsync dari jarak jauh, tulis lalu lintas input/output jarak jauh ke log yang ditentukan
file.

-s sebelumnya_status
Gunakan sinkronisasi stateful. Jika status sebelumnya tidak diketahui, gunakan yang kosong
rangkaian. Status baru selalu dicetak ke output standar.

-u pengguna/topeng
Jalankan Command hanya untuk yang diberikan pemakai. Bisa juga menggunakan '*'Dan'?'
wildcard (misalnya -u *@example.org).
Ketika keduanya tidak -A pilihan, atau -F fillet pilihan, atau -u pemakai ditentukan,
itu Command akan dieksekusi dengan lingkungan pengguna yang saat ini masuk.

-x kotak_mask
Kecualikan nama/masker kotak surat yang ditentukan. Masker mungkin mengandung "?"Dan"*"
wildcard. Parameter ini dapat digunakan beberapa kali.

ARGUMEN

tujuan
Argumen ini menentukan tujuan yang disinkronkan. Ini bisa menjadi salah satu dari:

tempat
Sama dengan lokasi_mail pengaturan, misalnya maildir:~/Maildir

terpencil:masuk@host
penggunaan dsync_remote_cmd pengaturan untuk terhubung ke host jarak jauh (biasanya melalui
sst)

remoteprefix: login@host
Ini sama dengan remote, kecuali "pengguna@domain\n" dikirim sebelum dsync
protokol dimulai. Ini memungkinkan penerapan skrip pembungkus tepercaya yang
menjalankan doveadm dsync-server dengan membaca nama pengguna dari baris pertama.

tcp:tuan rumah[:pelabuhan]
Terhubung ke server doveadm jarak jauh melalui TCP. Port default ditentukan oleh
doveadm_port pengaturan.

tcps:tuan rumah[:pelabuhan]
Ini sama dengan tcp, tetapi dengan SSL.

EXIT STATUS

sinkronkan akan keluar dengan salah satu nilai berikut:

0 Sinkronisasi dilakukan dengan sempurna.

2 Sinkronisasi dilakukan tanpa kesalahan, tetapi beberapa perubahan tidak dapat dilakukan, jadi
kotak surat tidak disinkronkan dengan sempurna. Menjalankan dsync lagi biasanya memperbaiki ini.
Biasanya ini terjadi untuk urutan modifikasi pesan dengan kotak surat yang baru dibuat.
Ini juga dapat terjadi jika salah satu kotak surat berubah selama sinkronisasi.

1, >2
Sinkronisasi gagal.

CONTOH

SINKRONISASI
Sinkronisasi kotak surat dengan server jauh. Setiap kesalahan ditulis ke stderr.

doveadm sinkronisasi -u [email dilindungi] jarak jauh: server-replica.example.com

Jika Anda membutuhkan parameter yang lebih kompleks untuk ssh, Anda dapat menggunakan mis:

doveadm sinkronisasi -u [email dilindungi] ssh -i id_dsa.dovecot \
[email dilindungi] doveadm server dsync -u [email dilindungi]

KONVERSI
Dengan asumsi bahwa lokasi_mail pengaturan /etc/dovecot/conf.d/10-mail.conf diatur ke:
lokasi_mail = kotak md:~/mdbox, pengguna sistem yang masuk dapat mengonversi emailnya dari
Maildir di direktori home-nya ke format kotak surat mdbox. Pengguna harus mengeksekusi
perintah:

doveadm sinkronisasi alamat surat:~/Maildir

Jika Anda ingin melakukan ini tanpa downtime, Anda dapat melakukan konversi satu pengguna pada satu waktu.
Mulanya:

· Penggunaan konfigurasi lokasi_mail = alamat surat:~/Maildir

· Atur kemungkinan melakukan lokasi email per pengguna menggunakan penggunadb bidang tambahan.

Kemudian untuk setiap pengguna:

1. Menjalankan doveadm sinkronisasi sekali untuk melakukan konversi awal.

2. Menjalankan doveadm sinkronisasi lagi, karena konversi awal bisa memakan waktu cukup lama
dan perubahan baru bisa terjadi selama itu. Kali kedua ini hanya berlaku
berubah, jadi harus cepat.

3. Perbarui bidang ekstra email di userdb ke kotak md:~/mdbox. Jika Anda menggunakan cache auth,
Anda perlu menyiramnya, mis doveadm auth Cache menyiram.

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

5. Menjalankan doveadm sinkronisasi sekali lagi untuk menerapkan perubahan akhir yang mungkin dilakukan. Setelah
ini seharusnya tidak ada perubahan pada Maildir, karena lokasi email pengguna memiliki
telah diubah dan semua proses yang ada yang menggunakannya telah dimatikan.

Setelah semua pengguna dikonversi, Anda dapat mengatur default lokasi_mail ke mdbox dan
hapus lokasi email per pengguna dari penggunadb.

PELAPORAN BUG

Laporkan bug, termasuk merpaticonf -n output, ke Milis Dovecot
<[email dilindungi]>. Informasi tentang pelaporan bug tersedia di:
http://dovecot.org/bugreport.html

Gunakan sinkronisasi doveadm online menggunakan layanan onworks.net