DOVEADM-REPLICATOR(1)               Dovecot              DOVEADM-REPLICATOR(1)

نام (NAME)
       doveadm-replicator - مدیریت همانندسازی ایمیل کاربران

خلاصه دستور (SYNOPSIS)
       doveadm [-Dv] [-f formatter] replicator command [OPTIONS] [ARGUMENTS]

توضیحات (DESCRIPTION)
       از COMMANDS مربوط به doveadm replicator می‌توان برای مدیریت همانندسازی
       خودکار ایمیل کاربران استفاده کرد.

گزینه‌ها (OPTIONS)
       گزینه‌های عمومی doveadm(1):

       -D     حالت پرگویی (verbosity) و پیام‌های اشکال‌زدایی را فعال می‌کند.

       -f formatter
              قالب‌بند (formatter) را برای قالب‌بندی خروجی مشخص می‌کند.
              قالب‌بندهای پشتیبانی‌شده عبارتند از:

              flow   هر سطر را به صورت جفت‌های key=value چاپ می‌کند.

              pager  هر جفت key: value را در سطر جداگانه‌ای چاپ کرده و رکوردها
                     را با نویسه برگه جدید (form feed) (^L) از یکدیگر جدا
                     می‌کند.

              tab    یک سربرگ جدول و در ادامه سطرهای مقادیر جداشده با تب را
                     چاپ می‌کند.

              table  یک سربرگ جدول و در ادامه سطرهای مقادیر تراز شده را چاپ
                     می‌کند.

       -o setting=value
              تنظیم پیکربندی setting را از /etc/dovecot/dovecot.conf و از
              userdb با value داده‌شده جایگزین می‌کند.  برای بازنویسی چندین
              تنظیم، گزینه -o می‌تواند چندین بار مشخص شود.

       -v     حالت پرگویی، شامل شمارنده پیشرفت را فعال می‌کند.

       این دستور به‌طور پیش‌فرض از قالب‌بند خروجی flow (بدون پیشوند key= )
       استفاده می‌کند.

       گزینه‌های مختص دستور:

       -a replicator_socket_path
              این گزینه برای تعیین یک مسیر مطلق به یک سوکت دامنه یونیکس (UNIX
              domain socket) جایگزین استفاده می‌شود.

              به‌طور پیش‌فرض doveadm(1) از سوکت /run/dovecot/replicator-doveadm
              استفاده خواهد کرد.  در صورتی که تنظیم پیش‌فرض base_dir در
              /etc/dovecot/dovecot.conf بازنویسی شده باشد، ممکن است سوکت در
              دایرکتوری دیگری قرار داشته باشد.

آرگومان‌ها (ARGUMENTS)
       user_mask
              مشخص می‌کند که دستور باید برای کدام کاربران اجرا شود.  در بیشتر
              موارد مایل خواهید بود از الگوهایی حاوی نویسه‌های عمومی (wildcard)
              استفاده کنید؛ مانند \*@example.net برای همه کاربران دامنه
              example.net، یا صرفاً \* برای تمام کاربران.

              هنگامی که ماژول SQL userdb استفاده می‌شود، مطمئن شوید که تنظیم
              iterate_query در /etc/dovecot/dovecot-sql.conf.ext با ساختار
              پایگاه‌داده شما مطابقت دارد.  هنگام استفاده از ماژول LDAP userdb،
              اطمینان حاصل کنید که تنظیمات iterate_attrs و iterate_filter در
              /etc/dovecot/dovecot-ldap.conf.ext با طرحواره (schema) مربوط به
              LDAP شما سازگار باشد.  در غیر این صورت، doveadm(1) قادر به
              پیمایش همه کاربران نخواهد بود.

دستورها (COMMANDS)
   replicator add
       doveadm replicator add [-a replicator_socket_path] user_mask

       کاربر(ان) مشخص‌شده را به replicator اضافه می‌کند.  اگر user_mask حاوی
       نویسه‌های عمومی "?" یا "*" باشد، فهرست نام‌های کاربری از userdb جستجو
       می‌شود.

   replicator dsync-status
       doveadm replicator dsync-status [-a replicator_socket_path]

       وضعیت فرایندهای dsync در حال اجرا را نمایش می‌دهد.

   replicator remove
       doveadm replicator remove [-a replicator_socket_path] username

       کاربر مشخص‌شده را از replicator حذف می‌کند.

   replicator replicate
       doveadm replicator replicate [-a replicator_socket_path] [-f] [-p
       priority] user_mask

       همانندسازی را برای کاربران مشخص‌شده بی‌درنگ آغاز می‌کند.  اگر پارامتر -f
       داده شود، همانندسازی کامل برای کاربر انجام خواهد شد.  همچنین می‌توانید
       اولویت را مشخص کنید که می‌تواند یکی از مقادیر high  یا  low باشد.  اگر
       ماسک کاربر شامل نویسه‌های عمومی "?" یا "*" باشد، فهرست نام‌های کاربری از
       میان کاربرانی که در حال حاضر در replicator وجود دارند (نه از userdb)
       جستجو می‌شود.

   replicator status
       doveadm replicator status [-a replicator_socket_path] user_mask

       وضعیت همانندسازی را برای کاربران نمایش می‌دهد.

گزارش باگ‌ها (BUGS)
       گزارش‌های باگ، از جمله خروجی doveconf -n را به فهرست پستی Dovecot به
       نشانی <dovecot@dovecot.org> ارسال کنید.  اطلاعات مربوط به گزارش باگ‌ها
       در نشانی زیر موجود است: http://dovecot.org/bugreport.html

همچنین ببینید (SEE ALSO)
       doveadm(1), doveadm-sync(1),

       منابع تکمیلی:

       Replication with dsync
              http://wiki2.dovecot.org/Replication

Dovecot v2.3                      2014-10-05             DOVEADM-REPLICATOR(1)