.\" Copyright (c) 2013-2018 Dovecot authors, see the included COPYING file .TH DOVEADM\-DIRECTOR 1 "2014-08-30" "Dovecot v2.3" "Dovecot" .SH "نام (NAME)" doveadm\-director \- مدیریت دایرکتورهای Dovecot .\"------------------------------------------------------------------------ .SH "خلاصه دستور (SYNOPSIS)" .BR doveadm " [" \-Dv ] [\fB\-f\fP \fIformatter\fP] .BI director \ command .RI [ OPTIONS ]\ [ ARGUMENTS ] .\"------------------------------------------------------------------------ .SH "توضیحات (DESCRIPTION)" دستور .B doveadm director می‌تواند برای مدیریت و استعلام وضعیت فهرست سرورهای ایمیل backend که پروکسی Dovecot اتصالات را به آن‌ها هدایت می‌کند، استفاده شود. .\"------------------------------------------------------------------------ .SH "گزینه‌ها (OPTIONS)" گزینه‌های عمومی .BR doveadm (1): .TP .B \-D پیام‌های اشکال‌زدایی (debug) و پرگویی را فعال می‌کند. .TP .BI \-f\ formatter قالب‌بند (\fIformatter\fP) را برای قالب‌بندی خروجی مشخص می‌کند. قالب‌بندهای پشتیبانی‌شده عبارتند از: .RS .TP .B flow هر سطر را با جفت‌های .IB key = value چاپ می‌کند. .TP .B pager هر جفت .IR key :\ value را در یک سطر جداگانه چاپ کرده و رکوردها را با نویسهٔ فرم‌فید .RB ( ^L ) از هم جدا می‌کند. .TP .B tab یک سربرگ جدول و به دنبال آن سطرهای حاوی مقادیر جداشده با تب (tab) را چاپ می‌کند. .TP .B table یک سربرگ جدول و به دنبال آن سطرهایی با مقادیر تراز‌شده چاپ می‌کند. .RE .TP .BI \-o\ setting = value تنظیم پیکربندی .I setting را از .I /etc/dovecot/dovecot.conf و از userdb با مقدار داده‌شدهٔ .IR value بازنویسی می‌کند. جهت بازنویسی چندین تنظیم، می‌توان گزینهٔ .B \-o را چندین بار مشخص کرد. .TP .B \-v پرگویی، شامل شمارندهٔ پیشرفت را فعال می‌کند. .\" --- command specific options --- "/. .PP گزینه‌های ویژهٔ این دستور: .\"------------------------------------- .TP .BI \-a\ director_socket_path این گزینه برای مشخص کردن یک سوکت جایگزین استفاده می‌شود. آرگومان این گزینه یا یک مسیر مطلق به یک سوکت محلی دامنه یونیکس است، یا یک نام میزبان و درگاه .RI ( hostname : port )، جهت اتصال به یک میزبان دوردست از طریق سوکت TCP. .sp به‌طور پیش‌فرض .BR doveadm (1) از سوکت .IR /run/dovecot/director\-admin استفاده می‌کند. چنانچه تنظیم پیش‌فرض .I base_dir در .IR /etc/dovecot/dovecot.conf بازنویسی شده باشد، ممکن است سوکت در پوشهٔ دیگری قرار داشته باشد. .\"------------------------------------------------------------------------ .SH "آرگومان‌ها (ARGUMENTS)" .TP .I host نام میزبان یا نشانی IP یک سرور ایمیل. .\"------------------------------------- .TP .I ip نشانی IP یک دایرکتور (director). .\"------------------------------------- .TP .I port درگاه TCP که سرور دایرکتور برای اتصالات روی آن شنود می‌کند. درگاه پیش‌فرض همان درگاهی است که دایرکتور محلی روی آن شنود می‌کند. .\"------------------------------------- .TP .I user نام ورود کاربر (\fIuser\fP). بسته به پیکربندی، نام ورود می‌تواند به عنوان مثال .BR jane " یا " john@example.com باشد. .\"------------------------------------- .TP .I vhost_count تعداد «میزبان‌های مجازی» (virtual hosts) اختصاص‌یافته به این سرور. هرچه این عدد نسبت به سایر سرورها بیشتر باشد، اتصالات بیشتری دریافت می‌کند. مقدار پیش‌فرض ۱۰۰ است. .\"------------------------------------------------------------------------ .SH "دستورها (COMMANDS)" .SS director add .B doveadm director add [\fB\-a\fP \fIdirector_socket_path\fP] .I host .RI [ vhost_count ] .PP وظایف این دستور عبارتند از: .TP 4 * اختصاص دادن یک سرور ایمیل جدید به دایرکتور. .TP * افزایش یا کاهش .I vhost_count یک سرور که پیش‌تر اختصاص داده شده است. .PP .\"------------------------------------- .SS director dump .B doveadm director dump [\fB\-a\fP \fIdirector_socket_path\fP] .PP پیکربندی فعلی میزبان را به صورت دستورات doveadm تخلیه (dump) می‌کند. پس از راه‌اندازی مجدد کامل خوشهٔ دایرکتور، می‌توان این دستورات را به سادگی اجرا کرد تا به وضعیت ذخیره‌شده بازگشت. .\"------------------------------------- .SS director flush .B doveadm director flush [\fB\-a\fP \fIdirector_socket_path\fP] [\fB\-F\fP] [\fB\-\-\max\-parallel\fP \fIn\fP] \fIhost\fP|\fBall\fP .PP دستور .B doveadm director flush تمام انتساب‌های کاربر را از میزبان (\fIhost\fP) داده‌شده یا از همهٔ میزبان‌ها (\fBall\fP) حذف می‌کند. تمام اتصالات موجود بیرون انداخته (kick) خواهند شد. اگر .B director_flush_socket مشخص شده باشد، یک اسکریپت پاکسازی (flush) نیز به‌طور خودکار اجرا می‌شود. .PP از آنجا که اخراج و انتقال کاربران به سرورهای پشتیبان جدید باعث افزایش ناگهانی بار (load spike) موقت می‌شود، همه کاربران به یک‌باره منتقل نمی‌شوند. پارامتر .B \-\-\max\-parallel مشخص می‌کند که چه تعداد کاربر می‌توانند به‌طور همزمان منتقل شوند. مقدار پیش‌فرض ۱۰۰ است. .PP اگر از پارامتر .B \-F استفاده شود، انتساب‌های کاربران صرفاً رها (drop) می‌شوند. اتصالات موجود بیرون انداخته نخواهند شد و اسکریپت‌های پاکسازی نیز اجرا نمی‌شوند. .\"------------------------------------- .SS director kick .B doveadm director kick [\fB\-a\fP \fIdirector_socket_path\fP] .I user .PP کاربر (\fIuser\fP) مشخص‌شده را از کل خوشهٔ Dovecot بیرون می‌اندازد (kick). این دستور مشابه .B doveadm proxy kick است، اما این دستور فقط یک بار باید اجرا شود به‌جای اینکه روی تک‌تک سرورهای دایرکتور اجرا گردد. .\"------------------------------------- .SS director map .B doveadm director map [\fB\-a\fP \fIdirector_socket_path\fP] [\fB\-f\fP \fIusers_file\fP] [\fB\-h\fP|\fB\-u\fP] .RI [ host ] .PP دستور .B doveadm director map برای فهرست کردن نگاشت‌های فعلیِ .IR user "\ \(->\ " host استفاده می‌شود. توجه داشته باشید که دایرکتور با استفاده از هش‌های ۳۲ بیتی کار می‌کند که احتمال برخورد (collision) در آن‌ها زیاد است، بنابراین این دستور نمی‌تواند به طور دقیق و قابل اطمینان فهرست کند که چه کاربرانی به تازگی وارد سیستم شده‌اند. .PP .TP .BI \-f\ users_file مسیر فایلی شامل تمام نام‌های کاربری (یک نام در هر سطر). در صورت ارائه، هیچ جستجویی در .I userdb انجام نخواهد شد. این گزینه می‌تواند یک راهکار مفید جایگزین باشد هنگامی که به عنوان مثال اتصال شبکه به سرور LDAP یا SQL کند است. .\"----------------- .TP .B \-h تمام نام‌های کاربری منطبق با هش داده‌شده را خروجی می‌دهد. .\"----------------- .TP .B \-u هش مربوط به نام کاربری داده‌شده را خروجی می‌دهد. .\"----------------- .TP .I host نشانی IP یا نام میزبان یک سرور را مشخص می‌کند تا فقط نگاشت‌های مربوط به .I host داده‌شده فهرست شوند. .\"------------------------------------- .SS director move .B doveadm director move [\fB\-a\fP \fIdirector_socket_path\fP] .I user host .PP کاربر (\fIuser\fP) را به سرور پشتیبانِ (\fIhost\fP) مشخص‌شده منتقل می‌کند. اگر .I user هرگونه اتصال فعالی داشته باشد، آن اتصالات خاتمه داده می‌شوند (kill). .\"------------------------------------- .SS director remove .B doveadm director remove [\fB\-a\fP \fIdirector_socket_path\fP] .I host .PP از این دستور برای حذف .I host داده‌شده از دایرکتور استفاده کنید. .\"------------------------------------- .SS director ring add .B doveadm director ring add [\fB\-a\fP \fIdirector_socket_path\fP] .IR ip \ [ port ] .PP یک دایرکتور جدید را به حلقه (ring) اضافه می‌کند. .\"------------------------------------- .SS director ring remove .B doveadm director ring remove [\fB\-a\fP \fIdirector_socket_path\fP] .IR ip \ [ port ] .PP یک دایرکتور را از حلقه حذف می‌کند. .\"------------------------------------- .SS director ring status .B doveadm director ring status [\fB\-a\fP \fIdirector_socket_path\fP] .PP وضعیت تمام دایرکتورهای موجود در حلقه را نشان می‌دهد. .\"------------------------------------- .SS director status .B doveadm director status [\fB\-a\fP \fIdirector_socket_path\fP] .RI [ user ] .PP این دستور برای نمایش میزان استفادهٔ فعلی تمام سرورهای ایمیل اختصاص‌یافته استفاده می‌شود. .br هنگامی که یک نام کاربری ارائه شود، این دستور نشان می‌دهد که .I user در حال حاضر به کدام سرور اختصاص یافته است، پس از حذف انتساب ذخیره‌شدهٔ فعلی به کدام سرور اختصاص خواهد یافت، و اگر کل خوشهٔ پروکسی از ابتدا راه‌اندازی مجدد می‌شد، کاربر به کدام سرور اختصاص می‌یافت. .\"------------------------------------------------------------------------ .SH "فایل‌ها (FILES)" .TP .I /etc/dovecot/dovecot.conf فایل پیکربندی اصلی Dovecot. .TP .I /etc/dovecot/conf.d/10\-director.conf تنظیمات ویژهٔ دایرکتور (Director). .\"------------------------------------------------------------------------ .SH "مثال‌ها (EXAMPLES)" افزودن یک دایرکتور با تعداد vhost برابر با ۱۵۰ (یا تغییر vhost موجود به ۱۵۰): .PP .nf .B doveadm \-v director add x1357.imap.ha.example.net 150 2001:db8:543:6861:143::1357: OK .fi .\"------------------------------------- .PP حذف یک دایرکتور: .PP .nf .B doveadm director remove x1357.imap.ha.example.net .fi .\"------------------------------------- .PP استعلام وضعیت میزبان‌های ایمیل در یک دایرکتور: .PP .nf .B doveadm director status mail server ip vhosts users 192.168.10.1 100 125 192.168.10.2 100 144 192.168.10.3 100 115 .fi .\"------------------------------------- .PP استعلام وضعیت انتساب یک کاربر: .PP .nf .B doveadm director status user@example.com Current: 192.168.10.1 (expires 2010\-06\-18 20:17:04) Hashed: 192.168.10.2 Initial config: 192.168.10.3 .fi .PP این به این معناست که کاربر در حال حاضر به سرور ایمیل با نشانی IP برابر با 192.168.10.1 اختصاص یافته است. پس از خروج تمام اتصالات کاربر، این انتساب حذف خواهد شد (در حال حاضر به نظر می‌رسد در زمان 20:17:04، اما ممکن است افزایش یابد). پس از منقضی شدن انتساب، کاربر دفعه بعد به 192.168.10.2 هدایت خواهد شد (به فرض عدم تغییر تنظیمات دایرکتور). اگر کل خوشه پروکسی Dovecot مجدداً راه‌اندازی شود، به طوری که تمام پیکربندی دایرکتور به مقادیر اولیه بازگردد، کاربر به 192.168.10.3 هدایت خواهد شد. .\"------------------------------------------------------------------------ .SH "گزارش باگ‌ها (BUGS)" گزارش باگ‌ها، شامل خروجی .I doveconf \-n را به فهرست پستی Dovecot به نشانی ارسال کنید. اطلاعات درباره نحوه گزارش باگ‌ها در این نشانی در دسترس است: .\"------------------------------------------------------------------------ .SH "همچنین ببینید (SEE ALSO)" .BR doveadm (1)