doveadm-sync - Trực tuyến trên Đám mây

CHƯƠNG TRÌNH:

TÊN

doveadm-sync - Tiện ích đồng bộ hóa hộp thư hai chiều của Dovecot
doveadm-backup - Tiện ích đồng bộ hóa hộp thư một chiều của Dovecot

SYNOPSIS

chim bồ câu [-đv] đồng bộ [-u người sử dụng|-A|-F hồ sơ] [-S đường dẫn ổ cắm] [-1fPRU] [-l giây] [-r
rawlog_path] [-m hộp thư] [-g hộp thư_guide] [-n không gian tên|-N] [-x loại trừ] [-s nhà nước] [-T
giây] -d|điểm đến

chim bồ câu [-đv] sao lưu [-u người sử dụng|-A|-F hồ sơ] [-S đường dẫn ổ cắm] [-fPRU] [-l giây] [-r
rawlog_path] [-m hộp thư] [-g hộp thư_guide] [-n không gian tên|-N] [-x loại trừ] [-s nhà nước] [-T
giây] -d|điểm đến

MÔ TẢ

dsync là tiện ích đồng bộ hóa hộp thư của Dovecot. Nó có thể được sử dụng cho một số
các trường hợp sử dụng: Đồng bộ hóa hai chiều của hộp thư, tạo bản sao lưu của thư và chuyển đổi
hộp thư từ / đến các định dạng hộp thư khác nhau. Tất cả những thứ này đều có thể được sử dụng trong cùng một
máy chủ hoặc giữa các máy chủ khác nhau (thông qua ssh(1) hoặc kết nối tcp). Hộp thư từ xa có thể
cũng được truy cập thông qua giao thức IMAP, cho phép sử dụng dsync để di chuyển hộp thư
mục đích.

Bạn có thể chạy dsync ở một trong ba chế độ:

· chim bồ câu sao lưu thực hiện đồng bộ một chiều. Nếu có bất kỳ thay đổi nào
ở điểm đến, chúng sẽ bị xóa, vì vậy điểm đến sẽ trông
chính xác như nguồn.

· chim bồ câu đồng bộ thực hiện đồng bộ hai chiều. Nó kết hợp tất cả các thay đổi
mà không mất gì. Cả hai hộp thư sẽ trông giống hệt nhau
sau khi quá trình đồng bộ hóa kết thúc.

· chim bồ câu đồng bộ -1 thực hiện đồng bộ hóa một chiều, nhưng nó kết hợp các thay đổi
trong điểm đến mà không xóa bất kỳ thứ gì. Điều này hiện không hoạt động
hoàn hảo, vì vậy việc sử dụng nó nên được hạn chế. Mục đích chính của nó là trong
di chuyển hộp thư bạn có thể chạy chim bồ câu sao lưu nhiều lần, sau đó chuyển đổi
thư được gửi đến hộp thư mới và chạy chim bồ câu đồng bộ -1 hơn Tháng Mười Hai oz
để chuyển bất kỳ thư mới cuối cùng nào từ hộp thư cũ.

Ngoài ra còn có ba thuật toán đồng bộ hóa khác nhau:

· Đồng bộ hóa đầy đủ (tham số -f) quét qua tất cả các thư trong tất cả
hộp thư. Điều này đảm bảo rằng mọi thứ sẽ được đồng bộ hóa, nhưng
nó chậm một cách không cần thiết đối với quá trình đồng bộ hóa gia tăng.

· Đồng bộ hóa nhanh (mặc định) lần đầu tiên cố gắng tìm các hộp thư có
đã thay đổi và chỉ đồng bộ hóa những. Điều này được thực hiện bằng cách kiểm tra
siêu dữ liệu của hộp thư (NEXTUID và HIGHESTMODSEQ). Thông thường điều này hoạt động tốt,
đặc biệt là với đồng bộ hóa một chiều, nhưng nếu cả hai bên đều thực hiện chính xác
cùng một số lượng thay đổi, siêu dữ liệu có thể chứa các giá trị giống nhau
ngay cả khi những thay đổi là khác nhau.

· Đồng bộ hóa trạng thái (tham số -s) là cách hiệu quả nhất để
đồng bộ hóa các hộp thư. Nó dựa vào việc có trạng thái chạy dsync sớm hơn
được lưu ở đâu đó và được chuyển sang lần chạy dsync tiếp theo. Dựa trên trạng thái này
dsync chỉ có thể gửi những thay đổi đã xảy ra sau lần chạy dsync trước đó.
Miễn là trạng thái hoặc các hộp thư không bị hỏng, thuật toán này sẽ
hoạt động hoàn hảo. Quá trình sao chép sử dụng nội bộ này để thực hiện hầu hết
của sự đồng bộ hóa.

Quá trình đồng bộ hóa được thực hiện một cách hoàn hảo nhất có thể: một ứng dụng khách IMAP hoặc POP3 sẽ không thể
để nhận thấy bất kỳ sự khác biệt nào giữa hai hộp thư. Đồng bộ hóa hai chiều có nghĩa là nó an toàn
để thực hiện bất kỳ loại sửa đổi nào ở cả hai bên và dsync sẽ hợp nhất các thay đổi mà không
mất bất kỳ thay đổi nào được thực hiện ở cả hai bên. Điều này có thể thực hiện được vì dsync có thể truy cập
Các bản ghi chỉ mục của Dovecot theo dõi các thay đổi. Tất nhiên là có thể có
những xung đột trong quá trình hợp nhất, những xung đột này được giải quyết một cách an toàn. Xem dsync thiết kế tài liệu
để biết thêm thông tin chi tiết.

dsync sử dụng các tệp cấu hình tương tự như phần còn lại của Dovecot (thông qua chim bồ câu(1) nhị phân).
Toàn bộ cấu hình có thể được thay đổi bằng cách đưa tham số -c cho một cấu hình khác
hoặc sử dụng tham số -o để ghi đè các cài đặt cụ thể. Khi thực thi dsync từ xa
chương trình nó hoạt động theo cùng một cách: nó sử dụng cấu hình cục bộ của chính nó.

dsync có thể chạy hoàn toàn độc lập. Nó không yêu cầu bất kỳ quy trình máy chủ Dovecot nào
đang chạy, ngoại trừ khi sử dụng tham số -u để thực hiện userdb tra cứu từ quy trình xác thực.

dsync có thể đồng bộ một hoặc nhiều người dùng bằng cách sử dụng tham số -u hoặc -A. Liên tục
sao chép, bạn có thể sử dụng quy trình sao chép Dovecot, quy trình này sẽ tự động chạy dsync
bất cứ khi nào tin nhắn đã thay đổi.

LỰA CHỌN

Toàn cầu chim bồ câu(1) lựa chọn:

-D Cho phép thông báo chi tiết và gỡ lỗi.

-o thiết lập=giá trị
Ghi đè cấu hình thiết lập từ /etc/dovecot/dovecot.conf và từ
userdb với giá trị. Để ghi đè nhiều cài đặt, -o tùy chọn
có thể được chỉ định nhiều lần.

-v Bật tính chi tiết, bao gồm cả bộ đếm tiến trình.

Lệnh cụ thể lựa chọn:

-1 Thực hiện đồng bộ hóa một chiều thay vì đồng bộ hóa hai chiều.

-A Nếu -A tùy chọn hiện tại, lệnh sẽ được thực hiện cho tất cả người dùng. Sử dụng
tùy chọn này kết hợp với người dùng hệ thống từ userdb { trình điều khiển = passwd } không phải là
được khuyến nghị, vì nó cũng chứa những người dùng có UID thấp hơn
được cấu hình với first_valid_uid thiết lập.

Khi mô-đun userdb SQL được sử dụng, hãy đảm bảo rằng lặp_query thiết lập trong
/etc/dovecot/dovecot-sql.conf.ext phù hợp với bố cục cơ sở dữ liệu của bạn. Khi sử dụng
Mô-đun userdb LDAP, hãy đảm bảo rằng iterate_attrs và iterate_filter cài đặt trong
/etc/dovecot/dovecot-ldap.conf.ext khớp với giản đồ LDAP của bạn. Nếu không thì chim bồ câu(1)
sẽ không thể lặp lại trên tất cả người dùng.

-F hồ sơ
Thực hiện lệnh cho tất cả người dùng trong hồ sơ. Điều này tương tự như -A
nhưng thay vì lấy danh sách người dùng từ userdb, họ được đọc
từ cái đã cho hồ sơ. Các hồ sơ chứa một tên người dùng trên mỗi dòng.

-N Đồng bộ hóa tất cả các không gian tên có sẵn. Theo mặc định, chỉ những không gian tên không
có cài đặt vị trí rõ ràng được đồng bộ hóa.

-P Chạy một chim bồ câu-thanh trừng(1) cho bộ nhớ đích (từ xa) sau khi đồng bộ hóa.

-R Thực hiện đồng bộ hóa ngược lại. Thông thường, các thông báo sẽ được đẩy từ hệ thống cục bộ đến
điểm đến (từ xa). Tùy chọn này đảo ngược quy trình và thay vào đó sẽ kéo các thông báo
từ điều khiển từ xa đến bộ nhớ cục bộ.

-S đường dẫn ổ cắm
Đối số của tùy chọn là một đường dẫn tuyệt đối đến ổ cắm miền UNIX cục bộ hoặc
tên máy chủ và cổng (hostname:cổng), để kết nối máy chủ từ xa qua TCP
ổ cắm.

Điều này cho phép quản trị viên thực thi chim bồ câu(1) lệnh thư thông qua
ổ cắm.

-T giây
Chỉ định thời gian tính bằng giây, bao lâu chim bồ câu(1) nên đợi I / O bị đình trệ
các hoạt động. Thời gian chờ mặc định là 600 giây.

-U Điều này được sử dụng nội bộ bởi bản sao để yêu cầu dsync thông báo khi
đồng bộ hóa đã kết thúc.

-d Sử dụng đích mặc định, được tra cứu từ thư_bản sao userdb thêm
trường.

-g hộp thư_guide
Tương tự như -m, nhưng tìm hộp thư được đồng bộ hóa bằng GUID của nó thay vì theo tên.

-l giây
Khóa dsync cho người dùng này. Chờ tối đa giây trước khi bỏ cuộc. Cái này
tham số nên được sử dụng để tránh đồng bộ hóa bị hỏng nếu có thể
dsync đang được chạy đồng thời cho cùng một người dùng.

-m hộp thư
Chỉ đồng bộ hóa tên hộp thư này.

-n không gian tên
Chỉ đồng bộ hóa không gian tên được chỉ định. Tham số này có thể được sử dụng nhiều
lần.

-r rawlog_path
Chạy dsync từ xa, ghi lưu lượng đầu vào / đầu ra từ xa vào nhật ký được chỉ định
tập tin.

-s trước_state
Sử dụng đồng bộ hóa trạng thái. Nếu trạng thái trước đó là không xác định, hãy sử dụng
dây. Trạng thái mới luôn được in thành đầu ra tiêu chuẩn.

-u người dùng / mặt nạ
Chạy lệnh chỉ cho những gì đã cho người sử dụng. Nó cũng có thể sử dụng '*'Và'?'
ký tự đại diện (ví dụ: -u *@example.org).
Khi không -A tùy chọn, cũng không phải -F hồ sơ tùy chọn, cũng không phải -u người sử dụng đã được chỉ định,
các lệnh sẽ được thực thi với môi trường của người dùng đang đăng nhập.

-x hộp thư_mask
Loại trừ tên / mặt nạ hộp thư được chỉ định. Mặt nạ có thể chứa "?"Và"*"
ký tự đại diện. Tham số này có thể được sử dụng nhiều lần.

TRANH LUẬN

điểm đến
Đối số này chỉ định đích được đồng bộ hóa. Nó có thể là một trong số:

địa điểm thư viện nào
Giống như vị trí thư cài đặt, ví dụ: maildir:~ / Maildir

Xa xôi:login @ host
Sử dụng dsync_remote_cmd cài đặt để kết nối với máy chủ từ xa (thường thông qua
sss)

remoteprefix: login @ host
Điều này giống với điều khiển từ xa, ngoại trừ "user @ domain \ n" được gửi trước khi dsync
giao thức bắt đầu. Điều này cho phép triển khai một tập lệnh trình bao bọc đáng tin cậy
chạy doveadm dsync-server bằng cách đọc tên người dùng từ dòng đầu tiên.

tcp:tổ cổng]
Kết nối với máy chủ doveadm từ xa qua TCP. Cổng mặc định được chỉ định bởi
doveadm_port thiết lập.

tcp:tổ cổng]
Điều này giống với tcp, nhưng với SSL.

EXIT TÌNH TRẠNG

dsync sẽ thoát với một trong các giá trị sau:

0 Đồng bộ hóa đã được thực hiện một cách hoàn hảo.

2 Quá trình đồng bộ hóa đã được thực hiện mà không có lỗi, nhưng không thể thực hiện được một số thay đổi, vì vậy
hộp thư không được đồng bộ hóa hoàn hảo. Chạy lại dsync thường khắc phục được điều này.
Thông thường, điều này xảy ra đối với trình tự sửa đổi thư với các hộp thư mới được tạo.
Nó cũng có thể xảy ra nếu một trong các hộp thư thay đổi trong quá trình đồng bộ hóa.

1, >2
Không đồng bộ hóa được.

THÍ DỤ

TỔNG HỢP
Đồng bộ hóa hộp thư với một máy chủ từ xa. Bất kỳ lỗi nào được ghi vào stderr.

chim bồ câu đồng bộ -u [email được bảo vệ] remote: server-replica.example.com

Nếu bạn cần các tham số phức tạp hơn cho ssh, bạn có thể sử dụng ví dụ:

chim bồ câu đồng bộ -u [email được bảo vệ] ssh -i id_dsa.dovecot \
[email được bảo vệ] chim bồ câu máy chủ dsync -u [email được bảo vệ]

CHUYỂN ĐỔI
Giả sử rằng vị trí thư thiết lập trong /etc/dovecot/conf.d/10-mail.conf được đặt thành:
vị trí thư = hộp md:~ / mdbox, một người dùng hệ thống đã đăng nhập có thể chuyển đổi các thư của cô ấy / anh ấy từ
Maildir trong thư mục chính của cô ấy / anh ấy sang định dạng hộp thư mdbox. Người dùng phải thực thi
lệnh:

chim bồ câu đồng bộ thư mục:~ / Maildir

Nếu bạn muốn làm điều này mà không có bất kỳ thời gian chết nào, bạn có thể thực hiện chuyển đổi từng người dùng một.
Ban đầu:

· Cấu hình sử dụng vị trí thư = thư mục:~ / Maildir

· Thiết lập khả năng thực hiện vị trí thư cho mỗi người dùng bằng cách sử dụng userdb các trường phụ.

Sau đó, đối với mỗi người dùng:

1. chạy chim bồ câu đồng bộ một lần để thực hiện chuyển đổi ban đầu.

2. chạy chim bồ câu đồng bộ một lần nữa, vì quá trình chuyển đổi ban đầu có thể mất một lúc
và những thay đổi mới có thể đã xảy ra trong thời gian đó. Lần thứ hai này chỉ áp dụng
thay đổi, vì vậy nó phải được nhanh chóng.

3. Cập nhật trường bổ sung thư trong userdb thành hộp md:~ / mdbox. Nếu bạn đang sử dụng bộ đệm xác thực,
bạn cần phải xả nó, ví dụ: chim bồ câu auth bộ nhớ cache tuôn ra.

4. Chờ một vài giây và sau đó giết (đá doveadm) tất cả imap hiện có của người dùng
và các phiên pop3 (vẫn đang sử dụng maildir).

5. chạy chim bồ câu đồng bộ một lần nữa để áp dụng những thay đổi cuối cùng có thể được thực hiện. Sau
điều này sẽ không có thay đổi đối với Maildir, vì vị trí thư của người dùng có
đã bị thay đổi và tất cả các quy trình hiện có sử dụng nó đã bị giết.

Khi tất cả người dùng đã được chuyển đổi, bạn có thể đặt giá trị mặc định vị trí thư đến mdbox và
xóa các vị trí thư cho mỗi người dùng khỏi userdb.

BÁO CÁO GIỎI

Báo cáo lỗi, bao gồm chim bồ câu -n đầu ra, vào Danh sách gửi thư Dovecot
<[email được bảo vệ]>. Thông tin về báo cáo lỗi có tại:
http://dovecot.org/bugreport.html

Sử dụng doveadm-sync trực tuyến bằng các dịch vụ onworks.net