director add

doveadm director add [-a director_socket_path] host [vhost_count]

وظایف این دستور عبارتند از:

*

اختصاص دادن یک سرور ایمیل جدید به دایرکتور.

*

افزایش یا کاهش vhost_count یک سرور که پیش‌تر اختصاص داده شده است.

director dump

doveadm director dump [-a director_socket_path]

پیکربندی فعلی میزبان را به صورت دستورات doveadm تخلیه (dump) می‌کند. پس از راه‌اندازی مجدد کامل خوشهٔ دایرکتور، می‌توان این دستورات را به سادگی اجرا کرد تا به وضعیت ذخیره‌شده بازگشت.

director flush

doveadm director flush [-a director_socket_path] [-F] [--x-parallel n] host|all

دستور doveadm director flush تمام انتساب‌های کاربر را از میزبان (host) داده‌شده یا از همهٔ میزبان‌ها (all) حذف می‌کند. تمام اتصالات موجود بیرون انداخته (kick) خواهند شد. اگر director_flush_socket مشخص شده باشد، یک اسکریپت پاکسازی (flush) نیز به‌طور خودکار اجرا می‌شود.

از آنجا که اخراج و انتقال کاربران به سرورهای پشتیبان جدید باعث افزایش ناگهانی بار (load spike) موقت می‌شود، همه کاربران به یک‌باره منتقل نمی‌شوند. پارامتر --x-parallel مشخص می‌کند که چه تعداد کاربر می‌توانند به‌طور همزمان منتقل شوند. مقدار پیش‌فرض ۱۰۰ است.

اگر از پارامتر -F استفاده شود، انتساب‌های کاربران صرفاً رها (drop) می‌شوند. اتصالات موجود بیرون انداخته نخواهند شد و اسکریپت‌های پاکسازی نیز اجرا نمی‌شوند.

director kick

doveadm director kick [-a director_socket_path] user

کاربر (user) مشخص‌شده را از کل خوشهٔ Dovecot بیرون می‌اندازد (kick). این دستور مشابه doveadm proxy kick است، اما این دستور فقط یک بار باید اجرا شود به‌جای اینکه روی تک‌تک سرورهای دایرکتور اجرا گردد.

director map

doveadm director map [-a director_socket_path] [-f users_file] [-h|-u] [host]

دستور doveadm director map برای فهرست کردن نگاشت‌های فعلیِ user → host استفاده می‌شود. توجه داشته باشید که دایرکتور با استفاده از هش‌های ۳۲ بیتی کار می‌کند که احتمال برخورد (collision) در آن‌ها زیاد است، بنابراین این دستور نمی‌تواند به طور دقیق و قابل اطمینان فهرست کند که چه کاربرانی به تازگی وارد سیستم شده‌اند.

-f users_file

مسیر فایلی شامل تمام نام‌های کاربری (یک نام در هر سطر). در صورت ارائه، هیچ جستجویی در userdb انجام نخواهد شد. این گزینه می‌تواند یک راهکار مفید جایگزین باشد هنگامی که به عنوان مثال اتصال شبکه به سرور LDAP یا SQL کند است.

-h

تمام نام‌های کاربری منطبق با هش داده‌شده را خروجی می‌دهد.

-u

هش مربوط به نام کاربری داده‌شده را خروجی می‌دهد.

host

نشانی IP یا نام میزبان یک سرور را مشخص می‌کند تا فقط نگاشت‌های مربوط به host داده‌شده فهرست شوند.

director move

doveadm director move [-a director_socket_path] user host

کاربر (user) را به سرور پشتیبانِ (host) مشخص‌شده منتقل می‌کند. اگر user هرگونه اتصال فعالی داشته باشد، آن اتصالات خاتمه داده می‌شوند (kill).

director remove

doveadm director remove [-a director_socket_path] host

از این دستور برای حذف host داده‌شده از دایرکتور استفاده کنید.

director ring add

doveadm director ring add [-a director_socket_path] ip [port]

یک دایرکتور جدید را به حلقه (ring) اضافه می‌کند.

director ring remove

doveadm director ring remove [-a director_socket_path] ip [port]

یک دایرکتور را از حلقه حذف می‌کند.

director ring status

doveadm director ring status [-a director_socket_path]

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

director status

doveadm director status [-a director_socket_path] [user]

این دستور برای نمایش میزان استفادهٔ فعلی تمام سرورهای ایمیل اختصاص‌یافته استفاده می‌شود.
هنگامی که یک نام کاربری ارائه شود، این دستور نشان می‌دهد که user در حال حاضر به کدام سرور اختصاص یافته است، پس از حذف انتساب ذخیره‌شدهٔ فعلی به کدام سرور اختصاص خواهد یافت، و اگر کل خوشهٔ پروکسی از ابتدا راه‌اندازی مجدد می‌شد، کاربر به کدام سرور اختصاص می‌یافت.