doveadm-sync - クラウドでオンライン

プログラム：

NAME

doveadm-sync - Dovecot の双方向メールボックス同期ユーティリティ
doveadm-backup - Dovecot の一方向メールボックス同期ユーティリティ

SYNOPSIS

doveadm [-Dv] sync [-u user|-A|-F file] [-S ソケットパス] [-1fPRU] [-l ドライ] [-r
rawlog_path] [-m メールボックス] [-g mailbox_guid] [-n 名前空間|-N] [-x 除外する] [-s 状態] [-T
ドライ] -d|デスティネーション

doveadm [-Dv] バックアップ [-u user|-A|-F file] [-S ソケットパス] [-fPRU] [-l ドライ] [-r
rawlog_path] [-m メールボックス] [-g mailbox_guid] [-n 名前空間|-N] [-x 除外する] [-s 状態] [-T
ドライ] -d|デスティネーション

DESCRIPTION

dsync は Dovecot のメールボックス同期ユーティリティです。 いくつかの異なる用途に使用できます
使用例: メールボックスの双方向同期、メールのバックアップの作成、および変換
異なるメールボックス形式間のメールボックス。 これらはすべて同じ内で使用できます
サーバー間、または異なるサーバー間 (経由) ssh(1) または tcp 接続)。 リモートメールボックスは、
IMAP プロトコル経由でもアクセスできるため、メールボックスの移行に dsync を使用できます。
目的。

dsync は、次の XNUMX つのモードのいずれかで実行できます。

· doveadm バックアップ 一方向の同期を実行します。 変更があった場合
宛先では削除されるため、宛先は次のようになります。
ソースとまったく同じです。

· doveadm sync 双方向の同期を実行します。 すべての変更をマージします
何も失うことなく。 両方のメールボックスは最終的に同じように見えます
同期が完了した後。

· doveadm sync -1 一方向の同期を実行しますが、変更はマージされます
何も削除せずに宛先に移動します。 これは現在機能しません
完全に機能するため、その使用は制限されるべきです。 その主な目的は、
実行できるメールボックスの移行 doveadm バックアップ 何度か繰り返してから切り替える
新しいメールボックスに配信されて実行されるメール doveadm sync -1 もう一度
古いメールボックスから最後の新しいメールを転送します。

次の XNUMX つの異なる同期アルゴリズムもあります。

· 完全同期 (-f パラメータ) は、すべてのメッセージをスキャンします。
メールボックス。 これにより、すべてが同期されることが保証されますが、
増分同期では不必要に時間がかかります。

· 高速同期 (既定) では、まず、次のようなメールボックスの検索が試行されます。
変更され、それらのみを同期します。 これは、
メールボックスのメタデータ (NEXTUID および HIGHESTMODSEQ)。 通常はこれで問題なく動作しますが、
特に一方向の同期では、両側が正確に同期を行う場合、
同じ数の変更を行うと、メタデータに同じ値が含まれる可能性があります。
たとえ変化が異なっていたとしても。

· ステートフル同期 (-s パラメータ) は、最も効率的な方法です。
メールボックスを同期します。 以前の dsync 実行の状態に依存します。
どこかに保存され、次の dsync 実行に渡されます。 この状態を踏まえて
dsync は、前回の dsync 実行後に発生した変更のみを送信できます。
状態またはメールボックスが破損していない限り、このアルゴリズムは
完璧に機能します。 レプリケータ プロセスはこれを内部的に使用して、ほとんどの処理を実行します。
同期の。

同期は可能な限り完全に行われます。IMAP または POP3 クライアントでは同期できません。
XNUMX つのメールボックス間の違いを確認します。 双方向同期は安全であることを意味します
両側であらゆる種類の変更を行うと、dsync は変更をマージせずに変更をマージします。
どちらかの側で行われた変更は失われます。 dsync がアクセスできるため、これが可能です。
変更を追跡する Dovecot のインデックス ログ。 もちろん持つことも可能です
マージ中に競合が発生した場合、これらは安全な方法で解決されます。 を参照してください。 dsync デザイン ドキュメント
。

dsync は Dovecot の残りの部分と同じ構成ファイルを使用します ( doveconf(1) バイナリ)。
別の構成に -c パラメータを指定することで、構成全体を変更できます
ファイルを使用するか、-o パラメーターを使用して特定の設定をオーバーライドします。 リモート dsync を実行する場合
プログラムでも同じように動作し、独自のローカル設定を使用します。

dsync は完全にスタンドアロンで実行できます。 Dovecotサーバープロセスは必要ありません
-u パラメータを使用して実行する場合を除き、実行中である必要があります。 ユーザーデータベース 認証プロセスからの検索。

dsync は、-u または -A パラメータを使用して XNUMX 人または複数のユーザーを同期できます。 連続用
レプリケーションでは、dsync を自動的に実行する Dovecot レプリケーター プロセスを使用できます。
メッセージが変更されたときはいつでも。

OPTIONS

グローバル doveadm(1) オプション:

-D 詳細メッセージとデバッグメッセージを有効にします。

-o 設定=値
構成をオーバーライドします 設定 から /etc/dovecot/dovecot.conf とから
指定されたuserdb 値。 複数の設定を上書きするために、 -o オプション
複数回指定できます。

-v プログレスカウンターを含む詳細度を有効にします。

コマンド固有 オプション:

-1 双方向同期ではなく一方向同期を実行します。

-A Status -A オプションが存在する、 command すべてのユーザーに対して実行されます。 使用する
からのシステムユーザーと組み合わせたこのオプション ユーザーデータベース { ドライバー = passwd } ではありません
UIDがXNUMXつよりも低いユーザーも含まれているため推奨されます
で構成された first_valid_uid 設定。

SQL userdbモジュールを使用する場合は、 反復クエリ の設定
/etc/dovecot/dovecot-sql.conf.ext データベースのレイアウトと一致します。 使用する場合
LDAP userdbモジュール、次のことを確認してください iterate_attrs & iterate_filter の設定
/etc/dovecot/dovecot-ldap.conf.ext LDAPスキーマと一致します。 さもないと doveadm(1)
すべてのユーザーを反復処理することはできません。

-F file
実行する command のすべてのユーザーのために file。 これはに似ています -A
オプションですが、userdbからユーザーのリストを取得する代わりに、それらが読み取られます
与えられたから fileを選択します。 file XNUMX行にXNUMXつのユーザー名が含まれます。

-N 使用可能なすべての名前空間を同期します。 デフォルトでは、そうでない名前空間のみ
明示的な位置設定が同期されている。

-P 実行する doveadm-パージ(1) 同期後の宛先 (リモート) ストレージの場合。

-R 逆同期を実行します。 通常、メッセージはローカル システムから
宛先（リモート）。 このオプションはフローを逆にし、代わりにメッセージをプルします。
リモートからローカルストレージへ。

-S ソケットパス
オプションの引数は、ローカルUNIXドメインソケットへの絶対パス、または
ホスト名とポート（hostname:ポート）、TCP経由でリモートホストに接続するため
ソケット。

これにより、管理者は実行できます doveadm（1）指定されたメールコマンド
ソケット。

-T ドライ
時間を秒単位で指定します。 doveadm(1) ストールした I/O を待つ必要があります
オペレーション。 デフォルトのタイムアウトは 600 秒です。

-U これは、レプリケーターが内部的に使用して、dsync に通知させるために使用されます。
同期が完了しました。

-d デフォルトの宛先を使用します。 メールレプリカ ユーザーデータベース 余分な
フィールド。

-g mailbox_guid
-m と同じですが、同期するメールボックスを名前ではなく GUID で検索します。

-l ドライ
このユーザーの dsync をロックします。 最大まで待つ ドライ 諦める前に。 これ
可能性がある場合は、同期の中断を避けるためにパラメータを使用する必要があります。
dsync は同じユーザーに対して同時に実行されています。

-m メールボックス
このメールボックス名のみを同期します。

-n 名前空間
指定された名前空間のみを同期します。 このパラメータは複数使用できます
回。

-r rawlog_path
dsync をリモートで実行し、リモート入出力トラフィックを指定されたログに書き込みます。
ファイルにソフトウェアを指定する必要があります。

-s 以前の状態
ステートフル同期を使用します。 以前の状態が不明な場合は、空の状態を使用します。
弦。 新しい状態は常に標準出力に出力されます。

-u ユーザー/マスク
実行する command 与えられたものだけ user。 'を使用することも可能です*'と'?'
ワイルドカード（例：-u *@example.org）。
どちらも -A オプション、または -F file オプション、または -u user 指定された、
　 command 現在ログインしているユーザーの環境で実行されます。

-x メールボックスマスク
指定されたメールボックス名/マスクを除外します。 マスクには「」が含まれる場合があります。?"と"*"
ワイルドカード。 このパラメータは複数回使用できます。

議論

デスティネーション
この引数は同期先を指定します。 次のいずれかになります。

場所
と同じ mail___cpLocation 設定、例: maildir:〜/ Maildir

リモート：ログイン@ホスト
あなたが使用します dsync_remote_cmd リモートホストに接続するための設定 (通常は
ssh)

リモートプレフィックス:login@host
これはリモートと同じですが、「user@domain\n」が dsync の前に送信される点が異なります。
プロトコルが開始されます。 これにより、信頼できるラッパー スクリプトを実装できるようになります。
最初の行からユーザー名を読み取ることで doveadm dsync-server を実行します。

TCP:host [：port]
TCP 経由でリモート doveadm サーバーに接続します。 デフォルトのポートは次のように指定されます。
doveadm_port 設定。

TCPS:host [：port]
これは tcp と同じですが、SSL を使用します。

EXIT ステータス

dsync 次のいずれかの値で終了します。

0 同期は完璧に行われました。

2 同期はエラーなく完了しましたが、一部の変更は実行できませんでした。
メールボックスは完全には同期されていません。 通常、dsync を再度実行すると、この問題は解決します。
通常、これは新しく作成されたメールボックスによるメッセージ変更シーケンスで発生します。
また、同期中にメールボックスの XNUMX つが変更された場合にも発生する可能性があります。

1, >2
同期に失敗しました。

実施例

同期
メールボックスをリモート サーバーと同期します。 エラーはすべて標準エラー出力に書き込まれます。

doveadm sync -u [メール保護] リモート:server-replica.example.com

ssh にさらに複雑なパラメータが必要な場合は、次のように使用できます。

doveadm sync -u [メール保護] ssh -i id_dsa.dovecot \
[メール保護] doveadm dsync サーバー -u [メール保護]

変換
コーヒーの粉の形状を球体と捉えたとき、１００ミクロン以下の粒子はどれくらい存在するでしょうか？ mail___cpLocation の設定 /etc/dovecot/conf.d/10-mail.conf に設定されています：
mail___cpLocation = MDボックス:~/mdbox、ログインしているシステム ユーザーは、自分のメールをそのサーバーから変換できます。
ホーム ディレクトリの Maildir を mdbox メールボックス形式に変換します。 ユーザーは実行する必要があります
コマンド：

doveadm sync メールディレクトリ:〜/ Maildir

ダウンタイムなしでこれを実行したい場合は、一度に XNUMX ユーザーずつ変換を実行できます。
最初は：

· 構成の用途 mail___cpLocation = メールディレクトリ:〜/ Maildir

· を使用してユーザーごとのメールの場所を特定できるようにセットアップします。 ユーザーデータベース 追加のフィールド。

次に、各ユーザーに対して次のようにします。

1。 実行 doveadm sync 最初の変換を行うために XNUMX 回。

2。 実行 doveadm sync 繰り返しになりますが、最初の変換には時間がかかる可能性があるため、
そしてその間に新たな変化が起こった可能性もあります。 XNUMX回目のみ適用
変化するので、高速である必要があります。

3. userdb のメール追加フィールドを次のように更新します。 MDボックス:~/mdbox。 認証キャッシュを使用している場合は、
それをフラッシュする必要があります。たとえば doveadm 認証 キャッシュ フラッシュ.

4. 数秒待ってから、ユーザーの既存のすべての imap を強制終了します (doveadm キック)。
および Pop3 セッション (まだ maildir を使用している)。

5。 実行 doveadm sync 実行された可能性のある最終的な変更をもう一度適用します。 後
ユーザーのメールの場所が変更されているため、Maildir は変更しないでください。
が変更され、それを使用している既存のプロセスがすべて強制終了されました。

すべてのユーザーが変換されたら、デフォルトを設定できます。 mail___cpLocation mdbox と
ユーザーごとのメールの場所をから削除する ユーザーデータベース.

報告 バグ

を含むバグを報告する doveconf -n Dovecotメーリングリストへの出力
<[メール保護]>。 バグの報告に関する情報は、次のURLで入手できます。
http://dovecot.org/bugreport.html

onworks.net サービスを使用してオンラインで doveadm-sync を使用する