نام (NAME)

multipath.conf - فایل پیکربندی دیمن چندمسیری (multipathd)

توضیحات (DESCRIPTION)

/etc/multipath.conf فایل پیکربندی دیمن چندمسیری است. این فایل برای بازنویسی جدول پیکربندی توکار multipathd به کار می‌رود. هر خطی که نخستین نویسه غیرفاصله‌ای آن '#' باشد، یک خط توضیح (کامنت) در نظر گرفته می‌شود. خطوط خالی نادیده گرفته می‌شوند.

پیکربندی فعلی مورد استفاده multipathd را می‌توان با دستور multipath -t یا multipathd show config مشاهده کرد.

پیکربندی‌های تکمیلی را می‌توان در فایل‌های قطره‌ای (drop-in) زیر مسیر /etc/multipath/conf.d/ انجام داد. فایل‌هایی که در این پوشه نام آن‌ها به .conf ختم می‌شود، پس از خواندن /etc/multipath.conf به ترتیب الفبایی خوانده می‌شوند. آن‌ها از همان سینتکس /etc/multipath.conf استفاده می‌کنند و از تمام بخش‌ها و کلیدواژه‌ها پشتیبانی می‌نمایند. اگر کلیدواژه‌ای در یک بخش یکسان در چندین فایل تکرار شود، آخرین مورد بر تمام موارد پیشین اولویت خواهد داشت.

سینتکس (SYNTAX)

فایل پیکربندی شامل ورودی‌هایی به شکل زیر است:

<section> {

<attribute> <value>
...
<subsection> {

<attribute> <value>
...

}

}

هر بخش (section) شامل یک یا چند صفت (attribute) یا زیربخش (subsection) است. کلیدواژه‌های شناخته‌شده برای صفت‌ها یا زیربخش‌ها بستگی به بخشی دارد که در آن قرار گرفته‌اند.

<attribute> و <value> باید در یک خط منفرد قرار گیرند. <attribute> یکی از کلیدواژه‌های فهرست‌شده در این صفحه راهنما است. <value> یا یک کلمه ساده است (فاقد فضای خالی و بدون هیچ‌یک از نویسه‌های '"'، '#' و '!') یا یک رشته محصور در نقل‌قول دوتایی ("..."). در خارج از رشته نقل‌قول‌شده، متنی که با '#' یا '!' شروع شود به عنوان کامنت در نظر گرفته شده و تا انتهای خط نادیده گرفته می‌شود. در داخل یک رشته نقل‌قول‌شده، نویسه‌های '#' و '!' معمولی هستند و فاصله‌ها حفظ می‌شوند. برای نمایش نویسه نقل‌قول دوتایی در داخل یک رشته نقل‌قول‌شده، از دو نقل‌قول دوتایی متوالی ('""') استفاده کنید. بنابراین '2.5" SSD' را می‌توان به صورت "2.5"" SSD" نوشت.

کروشه باز ('{') باید در همان خط پس از نام بخش یا زیربخش بیاید. کروشه بسته ('}') که انتهای بخش یا زیربخش را مشخص می‌کند باید تنها نویسه غیرفاصله‌ای در آن خط باشد. فاصله‌های خالی به جز در داخل نقل‌قول دوتایی نادیده گرفته می‌شوند، بنابراین فاصله‌گذاری و دندانه‌گذاری نشان‌داده‌شده در مثال بالا برای خوانندگان انسانی مفید است اما الزامی نیست.

نکته‌ای در مورد عبارات باقاعده (Regular Expressions): سینتکس /etc/multipath.conf اجازه می‌دهد مقادیر بسیاری از صفت‌ها به صورت عبارات باقاعده گسترش‌یافته پوزیکس (POSIX Extended Regular Expressions، به regex(7) مراجعه کنید) مشخص شوند. این عبارات باقاعده به بزرگی و کوچکی حروف حساس هستند و مهارنشده (unanchored) می‌باشند؛ بنابراین عبارت "bar" با "barbie"، "rhabarber" و "wunderbar" مطابقت دارد، اما با "Barbie" مطابقت ندارد. برای جلوگیری از تطبیق‌های ناخواسته زیررشته‌ها، می‌توان از سینتکس استاندارد عبارات باقاعده با استفاده از نویسه‌های ویژه "^" و "$" استفاده کرد.

کلیدواژه‌های بخش (section) زیر شناخته شده‌اند:

defaults

این بخش مقادیر پیش‌فرض را برای صفت‌هایی تعریف می‌کند که هرگاه هیچ مقداری در بخش‌های مناسب device یا multipath داده نشده باشد، استفاده می‌شوند.

blacklist

این بخش مشخص می‌کند کدام دستگاه‌ها باید از کشف توپولوژی چندمسیری مستثنی شوند.

blacklist_exceptions

این بخش مشخص می‌کند کدام دستگاه‌ها با وجود قرار داشتن در بخش blacklist، باید در کشف توپولوژی چندمسیری گنجانده شوند.

multipaths

این بخش توپولوژی‌های چندمسیری را تعریف می‌کند. این توپولوژی‌ها توسط یک شناسه جهانی (WWID) نمایه‌سازی می‌شوند. برای جزئیات در مورد تولید WWID به بخش تولید WWID (WWID generation) در ادامه مراجعه کنید. صفت‌های تنظیم‌شده در این بخش بر تمام موارد دیگر اولویت دارند.

devices

این بخش تنظیمات خاص هر دستگاه را تعریف می‌کند. دستگاه‌ها بر اساس سازنده (vendor)، محصول (product) و نسخه بازنگری (revision) شناسایی می‌شوند.

overrides

این بخش مقادیری را برای صفت‌هایی تعریف می‌کند که باید تنظیمات خاص دستگاه را برای تمام دستگاه‌ها بازنویسی (override) کنند.

بخش defaults (defaults section)

بخش defaults کلیدواژه‌های زیر را می‌شناسد:

verbosity

میزان پرگویی پیش‌فرض. مقادیر بالاتر سطح پرگویی را افزایش می‌دهند. سطوح معتبر بین 0 و 6 هستند.

polling_interval

فاصله زمانی بین دو بررسی مسیر بر حسب ثانیه. برای مسیرهایی که به درستی کار می‌کنند، فاصله زمانی بین بررسی‌ها به تدریج تا max_polling_interval افزایش می‌یابد. در صورت استفاده از systemd، این مقدار توسط تنظیم WatchdogSec در تعریف multipathd.service بازنویسی خواهد شد.

max_polling_interval

حداکثر فاصله زمانی بین دو بررسی مسیر بر حسب ثانیه.

reassign_maps

فعال‌سازی تخصیص مجدد نگاشت‌های device-mapper. با این گزینه، multipathd نگاشت‌های موجود device-mapper را مجدداً نگاشت می‌کند تا همیشه به دستگاه چندمسیری اشاره کنند، نه دستگاه‌های بلوکی زیرین. مقادیر ممکن عبارتند از yes و no.

multipath_dir

(منسوخ‌شده) این گزینه دیگر پشتیبانی نمی‌شود و نادیده گرفته خواهد شد.

path_selector

الگوریتم پیش‌فرض انتخاب مسیر برای استفاده؛ این الگوریتم‌ها توسط تارگت چندمسیری هسته ارائه می‌شوند:

path_grouping_policy

(وابسته به سخت‌افزار) خط‌مشی پیش‌فرض گروه‌بندی مسیر برای اعمال روی چندمسیری‌های نامشخص. مقادیر ممکن عبارتند از:

detect_pgpolicy

اگر روی yes تنظیم شود و تمام دستگاه‌های مسیر با یکی از اولویت‌بندی‌کننده‌های alua یا sysfs پیکربندی شده باشند، دستگاه چندمسیری به طور خودکار از خط‌مشی گروه‌بندی مسیر group_by_prio استفاده خواهد کرد. اگر روی no تنظیم شود، خط‌مشی path_grouping_policy طبق روال عادی انتخاب می‌شود.

detect_pgpolicy_use_tpg

اگر هم این گزینه و هم detect_pgpolicy روی yes تنظیم شوند و تمام دستگاه‌های مسیر با اولویت‌بندی‌کننده alua یا sysfs پیکربندی شده باشند، دستگاه چندمسیری به طور خودکار از خط‌مشی گروه‌بندی مسیر group_by_tpg استفاده خواهد کرد. اگر روی no تنظیم شود، خط‌مشی path_grouping_policy بر اساس روش شرح داده‌شده برای detect_pgpolicy در بالا انتخاب خواهد شد.

pg_timeout

(منسوخ‌شده) این گزینه دیگر پشتیبانی نمی‌شود و نادیده گرفته خواهد شد.

uid_attrs

تنظیم این گزینه ادغام رخدادهای uevent را بر اساس WWID فعال می‌کند که ممکن است کارایی پردازش uevent را بهبود بخشد. علاوه بر این، روشی جایگزین برای پیکربندی ویژگی‌های udev جهت استفاده در تعیین شناسه‌های یکتای مسیر (WWIDها) است.

uid_attribute

صفت udev که شناسه یکتای مسیر (WWID) را ارائه می‌دهد. اگر uid_attribute روی یک رشته خالی تنظیم شود، تعیین WWID با استفاده از روش sysfs به جای استفاده از udev انجام می‌شود (در محیط عملیاتی توصیه نمی‌شود؛ بخش تولید WWID (WWID generation) در ادامه را ببینید).

getuid_callout

(منسوخ‌شده) این گزینه دیگر پشتیبانی نمی‌شود و نادیده گرفته خواهد شد.

prio

نام روال اولویت مسیر. روال مشخص‌شده باید یک مقدار عددی بازگرداند که اولویت نسبی این مسیر را مشخص کند. اعداد بزرگتر اولویت بالاتری دارند. "none" یک مقدار معتبر است. در حال حاضر روال‌های اولویت مسیر زیر پیاده‌سازی شده‌اند:

prio_args

آرگومان‌هایی که به تابع prio ارسال می‌شوند. این گزینه فقط برای اولویت‌بندی‌کننده‌های خاصی کاربرد دارد:

features

ویژگی‌های device-mapper مورد استفاده را مشخص می‌کند. سینتکس آن به صورت num list است که در آن num تعداد ویژگی‌ها (بین 0 تا 8) در list می‌باشد. مقادیر ممکن برای فهرست ویژگی‌ها عبارتند از:

path_checker

روش پیش‌فرض مورد استفاده برای تعیین وضعیت مسیر. از نسخه 0.15.0 ابزارهای multipath-tools، تمامی بررسی‌کننده‌های مسیر به طور پیش‌فرض در حالت غیرهمگام (asynchronous) اجرا می‌شوند تا دستگاه‌های پاسخ‌نادهنده موجب توقف multipathd نشوند. از پارامتر force_sync برای اجبار به بررسی همگام استفاده کنید. مقادیر ممکن عبارتند از:

alias_prefix

پیشوند برای user_friendly_names.

failback

نحوه مدیریت بازگشت به مسیر اولیه (failback) گروه مسیر را به multipathd مشخص می‌کند. برای انتخاب immediate یا یک مقدار عددی، الزامی است که دستگاه از یک اولویت‌بندی‌کننده فعال پشتیبانی کند.

rr_min_io

(منسوخ‌شده از هسته 4.6) این گزینه دیگر پشتیبانی نمی‌شود و نادیده گرفته خواهد شد.

rr_min_io_rq

(منسوخ‌شده از هسته 4.6) این گزینه دیگر پشتیبانی نمی‌شود و نادیده گرفته خواهد شد.

max_fds

حداکثر تعداد توصیف‌کننده‌های فایل را که می‌توانند توسط multipath و multipathd باز شوند مشخص می‌کند. این معادل با ulimit -n است. مقدار max این گزینه را روی حد مجاز سیستم از /proc/sys/fs/nr_open تنظیم می‌کند. در صورت عدم تنظیم، حداکثر تعداد توصیف‌کننده‌های فایل باز از فرایند فراخواننده گرفته می‌شود که معمولاً 1024 است. برای ایمنی، اگر تعداد کل مسیرها به علاوه 32 بیشتر از 1024 باشد، این مقدار باید روی آن تنظیم شود.

rr_weight

(منسوخ‌شده از هسته 4.6) این گزینه دیگر پشتیبانی نمی‌شود و نادیده گرفته خواهد شد.

no_path_retry

مشخص می‌کند هنگامی که تمام مسیرها قطع هستند چه اقدامی انجام شود. مقادیر ممکن عبارتند از:

queue_without_daemon

اگر روی no تنظیم شود، هنگامی که multipathd متوقف می‌شود، صف‌بندی برای تمام دستگاه‌ها خاموش خواهد شد. این گزینه برای دستگاه‌هایی که no_path_retry را تنظیم کرده‌اند مفید است. اگر ماشینی خاموش شود در حالی که تمام مسیرهای یک دستگاه قطع هستند، این احتمال وجود دارد که سیستم پس از متوقف شدن multipathd در انتظار بازگشت I/O از دستگاه قفل کند. بدون اجرای multipathd، دسترسی به مسیرها بازیابی نمی‌شود و به هسته نیز نمی‌توان دستور داد صف‌بندی I/O را متوقف کند. تنظیم queue_without_daemon روی no از این مشکل جلوگیری می‌نماید.

checker_timeout

مهلت زمانی مورد استفاده برای بررسی‌کننده‌های مسیر و اولویت‌بندی‌کننده‌ها بر حسب ثانیه. تنها اولویت‌بندی‌کننده‌هایی که دستورات scsi صادر می‌کنند از checker_timeout استفاده می‌نمایند. اگر یک مسیر پس از گذشت checker_timeout ثانیه به دستور بررسی پاسخ ندهد، قطع (down) در نظر گرفته می‌شود.

allow_usb_devices

اگر روی no تنظیم شود، تمام دستگاه‌های USB در طول فرآیند کشف مسیر نادیده گرفته می‌شوند. اگر قصد دارید از چندمسیری روی دستگاه‌های متصل به USB استفاده کنید، این گزینه را روی yes تنظیم کنید.

flush_on_last_del

اگر روی always تنظیم شود، multipathd هنگام حذف آخرین مسیر به یک دستگاه، صف‌بندی را غیرفعال خواهد کرد. اگر روی never تنظیم شود، multipathd هنگام حذف آخرین مسیر به یک دستگاه، صف‌بندی را غیرفعال نمی‌کند. از آنجا که multipath نمی‌تواند با خیال راحت دستگاهی را که صف‌بندی آن فعال است حذف کند، تنظیم این گزینه روی never به این معنی است که اگر دستگاهی در حال حاضر روی queue_if_no_path تنظیم شده باشد، multipathd دستگاه چندمسیری استفاده‌نشده‌ای را که تمام مسیرهایش حذف شده‌اند به طور خودکار حذف نخواهد کرد. اگر روی unused تنظیم شود، multipathd تنها زمانی صف‌بندی را در هنگام حذف آخرین مسیر غیرفعال می‌کند که در حال حاضر هیچ فرایندی دستگاه چندمسیری یا هیچ‌یک از دستگاه‌های پارتیشن kpartx روی آن را باز نکرده باشد.

user_friendly_names

اگر روی yes تنظیم شود، از فایل پیوندها /etc/multipath/bindings برای اختصاص یک نام مستعار پایدار و یکتا به دستگاه چندمسیری به شکل prefix<n> (که در آن prefix توسط alias_prefix تعریف می‌شود؛ پیش‌فرض mpath) استفاده خواهد شد. اگر روی no تنظیم شود، از WWID به عنوان نام مستعار استفاده می‌شود. در هر دو صورت، این مورد توسط هر نام مستعار مشخصی که در بخش multipaths تعریف شده باشد بازنویسی خواهد شد.

fast_io_fail_tmo

تعداد ثانیه‌هایی را مشخص می‌کند که لایه SCSI پس از تشخیص بروز مشکل در یک پورت ریموت FC، قبل از اعلام شکست در درخواست‌های ورودی/خروجی به دستگاه‌های روی آن پورت ریموت، منتظر می‌ماند. این مقدار باید کوچکتر از dev_loss_tmo باشد. تنظیم آن روی off مهلت زمانی را غیرفعال می‌کند.

dev_loss_tmo

تعداد ثانیه‌هایی را مشخص می‌کند که لایه SCSI پس از تشخیص قطع ارتباط در یک پورت ریموت، قبل از حذف آن از سیستم منتظر می‌ماند. این مقدار را می‌توان روی "infinity" تنظیم کرد که عملاً به معنای 136 سال (2^32-1 ثانیه) است. این پارامتر فقط برای دستگاه‌های Fibre Channel و SAS اعمال می‌شود.

eh_deadline

حداکثر مدت زمانی (بر حسب ثانیه) را که لایه SCSI هنگام خرابی دستگاه‌های scsi صرف رسیدگی به خطا می‌کند، مشخص می‌نماید. پس از پایان این مهلت، لایه scsi یک بازنشانی کامل HBA انجام می‌دهد. تنظیم این گزینه ممکن است در مواردی ضروری باشد که پورت ریموت هرگز قطع نمی‌شود، بنابراین fast_io_fail_tmo و dev_loss_tmo هرگز فعال نخواهند شد، اما دستورات scsi (معمولاً به دلیل بار کاری بالا) همچنان قفل می‌کنند. توجه: هنگامی که گرداننده خطای scsi عمل بازنشانی HBA را انجام می‌دهد، تمام مسیرهای هدف روی آن HBA تحت تاثیر قرار خواهند گرفت. eh_deadline تنها باید در مواردی تنظیم شود که تمام اهداف روی HBAهای مربوطه چندمسیری شده باشند.

max_retries

حداکثر دفعاتی را که لایه SCSI دستورات ورودی/خروجی را برای برخی از انواع خطاهای SCSI پیش از اعلام شکست مجدداً تلاش می‌کند، مشخص می‌نماید. تنظیم این گزینه برای مواردی که دستورات ورودی/خروجی قفل کرده و دچار انقضای زمان می‌شوند مفید است. به طور پیش‌فرض، لایه SCSI تلاش مجدد را 5 بار انجام می‌دهد. کاهش این مقدار به multipath اجازه می‌دهد درخواست ورودی/خروجی را سریع‌تر از طریق مسیر دیگری مجدداً تلاش کند. مقادیر معتبر از 0 تا 5 هستند.

bindings_file

(منسوخ‌شده) این گزینه دیگر پشتیبانی نمی‌شود و نادیده گرفته خواهد شد.

wwids_file

(منسوخ‌شده) این گزینه دیگر پشتیبانی نمی‌شود و نادیده گرفته خواهد شد.

prkeys_file

(منسوخ‌شده) این گزینه دیگر پشتیبانی نمی‌شود و نادیده گرفته خواهد شد.

log_checker_err

اگر روی once تنظیم شود، multipathd نخستین خطای بررسی‌کننده مسیر را در سطح لاگ‌گیری 2 ثبت می‌کند. خطاهای بعدی تا زمان بازیابی دستگاه در سطح 3 ثبت می‌شوند. اگر روی always تنظیم شود، multipathd خطای بررسی‌کننده مسیر را همواره در سطح لاگ‌گیری 2 ثبت خواهد کرد.

reservation_key

این کلید رزرو کنش سرویس است که توسط mpathpersist استفاده می‌شود. این گزینه باید برای تمام دستگاه‌های چندمسیری که از رزروهای پایدار استفاده می‌کنند تنظیم شود، و باید با فیلد RESERVATION KEY در فهرست پارامترهای PERSISTENT RESERVE OUT یکسان باشد که حاوی یک مقدار 8 بایتی ارائه‌شده توسط کلاینت برنامه به سرور دستگاه برای شناسایی nexus I_T است. اگر هنگام ثبت کلید با mpathpersist از گزینه --param-aptpl استفاده شده باشد، باید :aptpl به انتهای کلید رزرو پیوست شود.

all_tg_pt

پرچم «تمام پورت‌های هدف» (all targets ports) را هنگام ثبت کلیدها با mpathpersist تنظیم می‌کند. برخی از آرایه‌ها به جای ثبت به ازای هر پورت هدف به ازای هر هاست، به طور خودکار کلیدهای ثبت‌نام را روی تمام پورت‌های هدف از یک هاست تنظیم و پاک می‌کنند. پرچم ALL_TG_PT باید تنظیم شود تا بتوان با موفقیت از mpathpersist روی این آرایه‌ها استفاده کرد. تنظیم این گزینه همانند فراخوانی mpathpersist با --param-alltgpt است.

retain_attached_hw_handler

(منسوخ‌شده برای هسته‌های >= 4.3) اگر روی yes تنظیم شود و لایه SCSI از قبل یک hardware_handler را به دستگاه متصل کرده باشد، multipath دستگاه را مجبور به استفاده از hardware_handler مشخص‌شده در /etc/multipath.conf نخواهد کرد. اگر لایه SCSI گرداننده سخت‌افزاری متصل نکرده باشد، multipath به استفاده از گرداننده سخت‌افزاری پیکربندی‌شده خود ادامه می‌دهد.

detect_prio

اگر روی yes تنظیم شود، multipath تلاش خواهد کرد تشخیص دهد که آیا دستگاه از SCSI-3 ALUA پشتیبانی می‌کند یا خیر. در این صورت، اگر صفت‌های sysfs مورد نیاز یعنی access_state و preferred_path پشتیبانی شوند، دستگاه به طور خودکار از اولویت‌بندی‌کننده sysfs استفاده می‌کند، و در غیر این صورت از اولویت‌بندی‌کننده alua استفاده خواهد کرد. اگر روی no تنظیم شود، اولویت‌بندی‌کننده طبق معمول انتخاب خواهد شد.

detect_checker

اگر روی yes تنظیم شود، multipath تلاش خواهد کرد تشخیص دهد که آیا دستگاه از SCSI-3 ALUA پشتیبانی می‌کند یا خیر. در این صورت، دستگاه به طور خودکار از بررسی‌کننده tur استفاده خواهد کرد. اگر روی no تنظیم شود، بررسی‌کننده طبق روال عادی انتخاب خواهد شد.

force_sync

اگر روی yes تنظیم شود، multipathd بررسی‌کننده‌های مسیر را تنها در حالت همگام فراخوانی می‌کند. این بدان معنی است که در هر زمان تنها یک بررسی‌کننده اجرا می‌شود و ممکن است multipathd هنگام انتظار برای پاسخ دستگاه، عملیات خود را متوقف کند. این گزینه در حالتی مفید است که اجرای موازی بررسی‌کننده‌های زیاد multipathd فشار قابل توجهی روی CPU وارد می‌کند.

strict_timing

اگر روی yes تنظیم شود، multipathd یک حلقه بررسی مسیر جدید را دقیقاً پس از گذشت یک ثانیه آغاز می‌کند، به طوری که هر بررسی مسیر دقیقاً در فواصل polling_interval ثانیه رخ دهد. در سیستم‌های شلوغ ممکن است بررسی مسیرها بیش از یک ثانیه طول بکشد؛ در اینجا تیک‌های از دست‌رفته در دور بعدی به حساب خواهند آمد. اگر بررسی‌های مسیر بیشتر از polling_interval ثانیه طول بکشد، یک هشدار چاپ خواهد شد.

deferred_remove

اگر روی yes تنظیم شود، multipathd هنگام حذف آخرین دستگاه مسیر، به جای حذف عادی یک حذف به تعویق افتاده انجام می‌دهد. این بدان معنی است که اگر دستگاه چندمسیری هنوز در حال استفاده باشد، زمانی که آخرین کاربر آن را ببندد آزاد خواهد شد. اگر پیش از بسته شدن آن توسط آخرین کاربر مسیری به دستگاه چندمسیری اضافه شود، حذف به تعویق افتاده لغو خواهد شد.

partition_delimiter

این پارامتر نحوه انتخاب نام دستگاه‌های پارتیشن نگاشت‌های چندمسیری را در صورت تغییر نام نگاشت چندمسیری (مثلاً در صورت اضافه یا تغییر نام مستعار نگاشت) کنترل می‌کند. اگر این پارامتر روی رشته‌ای غیر از "/UNSET/" تنظیم شود (حتی رشته خالی)، multipath آن رشته را بین نام دستگاه و شماره پارتیشن درج می‌کند تا نام دستگاه پارتیشن را بسازد. در غیر این صورت (یعنی اگر این پارامتر تنظیم نشده باشد یا مقدار "/UNSET/" داشته باشد)، رفتار به نام نگاشت بستگی دارد: اگر نام به یک رقم ختم شود، یک "p" بین نام و شماره پارتیشن درج می‌شود؛ در غیر این صورت، شماره پارتیشن به سادگی به انتهای آن اضافه خواهد شد. توزیع‌ها ممکن است از یک مقدار پیش‌فرض غیرتهی برای این گزینه استفاده کنند؛ در این صورت، کاربر باید آن را روی "/UNSET/" قرار دهد تا رفتار اصلی <تنظیم‌نشده> را به دست آورد. برای بررسی تنظیمات فعلی از multipath -T استفاده کنید.

config_dir

(منسوخ‌شده) این گزینه دیگر پشتیبانی نمی‌شود و نادیده گرفته خواهد شد.

san_path_err_threshold

اگر روی مقداری بزرگتر از 0 تنظیم شود، multipathd مسیرها را زیر نظر گرفته و تعداد دفعات شکست یک مسیر به دلیل خطا را بررسی می‌کند. اگر تعداد خرابی‌ها در یک مسیر خاص بیشتر از san_path_err_threshold باشد، آن مسیر تا پایان زمان san_path_err_recovery_time به مدار بازگردانده نخواهد شد. این خرابی‌های مسیر باید در طول بازه بررسی‌های san_path_err_forget_rate رخ دهند، در غیر این صورت مسیر به اندازه کافی خوب تلقی شده و مجدداً برقرار می‌گردد. بخش "تشخیص مسیرهای ناپایدار (Shaky paths detection)" در ادامه را ببینید.

san_path_err_forget_rate

اگر روی مقداری بزرگتر از 0 تنظیم شود، multipathd بررسی می‌کند که آیا خرابی‌های مسیر در طول این تعداد بررسی (یعنی san_path_err_forget_rate) از حد san_path_err_threshold فراتر رفته است یا خیر. اگر چنین باشد، مسیر تا پایان زمان san_path_err_recovery_time احیا نخواهد شد. بخش "تشخیص مسیرهای ناپایدار (Shaky paths detection)" در ادامه را ببینید.

san_path_err_recovery_time

اگر روی مقداری بزرگتر از 0 تنظیم شود، multipathd اطمینان حاصل می‌کند که هرگاه خرابی‌های مسیر در طول san_path_err_forget_rate از حد san_path_err_threshold فراتر رفت، مسیر به مدت زمان san_path_err_recovery_time در وضعیت شکست‌خورده قرار گیرد. پس از پایان مهلت san_path_err_recovery_time، مسیر شکست‌خورده دوباره به کار گرفته می‌شود. مقدار san_path_err_recovery_time باید بر حسب ثانیه باشد. بخش "تشخیص مسیرهای ناپایدار (Shaky paths detection)" در ادامه را ببینید.

marginal_path_double_failed_time

یکی از چهار پارامتر پشتیبانی از بررسی مسیر بر اساس شمارش خطای I/O مانند خطاهای متناوب. هنگامی که یک رخداد خرابی مسیر دو بار در طول marginal_path_double_failed_time ثانیه به دلیل خطای I/O رخ دهد و هر سه پارامتر دیگر تنظیم شده باشند، multipathd مسیر را شکست‌خورده اعلام کرده و آن را در صفی قرار می‌دهد که اعضای آن چندین درخواست خواندن مستقیم غیرهمگام با نرخ نمونه‌برداری ثابت 10 هرتز دریافت می‌کنند تا فرآیند شمارش خطای I/O آغاز شود. بخش "تشخیص مسیرهای ناپایدار (Shaky paths detection)" در ادامه را ببینید.

marginal_path_err_sample_time

یکی از چهار پارامتر پشتیبانی از بررسی مسیر بر پایه شمارش خطای I/O مانند خطاهای متناوب. اگر روی مقداری کمتر از 120 تنظیم نشده باشد، هنگامی که یک رخداد شکست مسیر دو بار در طول marginal_path_double_failed_time ثانیه به دلیل خطای I/O رخ دهد، multipathd مسیر را شکست‌خورده اعلام کرده و آن را در صفی قرار می‌دهد که اعضای آن چندین درخواست مستقیم ناهمگام با نرخ نمونه‌برداری ثابت 10 هرتز دریافت می‌کنند تا فرآیند ارزیابی خطای I/O آغاز شود که به مدت marginal_path_err_sample_time ادامه خواهد داشت. اگر نرخ خطای I/O در یک مسیر خاص بیشتر از marginal_path_err_rate_threshold باشد، آن‌گاه مسیر به مدت marginal_path_err_recheck_gap_time ثانیه به مدار بازگردانده نخواهد شد مگر اینکه تنها یک مسیر فعال وجود داشته باشد. پس از انقضای marginal_path_err_recheck_gap_time، مسیر برای بررسی مجدد در صف قرار می‌گیرد. اگر نتیجه بررسی به اندازه کافی خوب باشد، مسیر احیا خواهد شد. بخش "تشخیص مسیرهای ناپایدار (Shaky paths detection)" در ادامه را ببینید.

marginal_path_err_rate_threshold

آستانه نرخ خطا به صورت در هزار (پرمیل یا 1/1000). یکی از چهار پارامتر پشتیبانی از بررسی مسیر بر پایه شمارش خطای I/O مانند خطاهای متناوب. به marginal_path_err_sample_time مراجعه کنید. اگر نرخ خطاهای I/O در یک مسیر خاص بیشتر از این پارامتر باشد، مسیر به مدت marginal_path_err_recheck_gap_time ثانیه احیا نخواهد شد مگر اینکه تنها یک مسیر فعال وجود داشته باشد. بخش "تشخیص مسیرهای ناپایدار (Shaky paths detection)" در ادامه را ببینید.

marginal_path_err_recheck_gap_time

یکی از چهار پارامتر پشتیبانی از بررسی مسیر بر پایه شمارش خطای I/O مانند خطاهای متناوب. به marginal_path_err_sample_time مراجعه کنید. اگر این پارامتر روی یک مقدار مثبت تنظیم شود، مسیر شکست‌خورده‌ای که نرخ خطای I/O آن بزرگتر از marginal_path_err_rate_threshold باشد، به مدت marginal_path_err_recheck_gap_time ثانیه در وضعیت شکست‌خورده نگه داشته می‌شود. هنگامی که marginal_path_err_recheck_gap_time ثانیه سپری شد، مسیر مجدداً برای بررسی در صف قرار می‌گیرد. اگر نتیجه بررسی به اندازه کافی خوب باشد، مسیر احیا خواهد شد وگرنه در وضعیت شکست‌خورده باقی می‌ماند. بخش "تشخیص مسیرهای ناپایدار (Shaky paths detection)" در ادامه را ببینید.

delay_watch_checks

(منسوخ‌شده) این گزینه منسوخ شده و به san_path_err_forget_rate نگاشت می‌شود. اگر این گزینه روی مقداری بزرگتر از 0 تنظیم شود و هیچ گزینه‌ای از گزینه‌های san_path_err تنظیم نشده باشد، san_path_err_forget_rate روی مقدار delay_watch_checks تنظیم خواهد شد و san_path_err_threshold روی 1 قرار می‌گیرد. برای اطلاعات بیشتر، گزینه‌های san_path_err_forget_rate و san_path_err_threshold و بخش "تشخیص مسیرهای ناپایدار (Shaky paths detection)" در ادامه را ببینید.

delay_wait_checks

(منسوخ‌شده) این گزینه منسوخ شده و به san_path_err_recovery_time نگاشت می‌شود. اگر این گزینه روی مقداری بزرگتر از 0 تنظیم شود و هیچ گزینه‌ای از گزینه‌های san_path_err تنظیم نشده باشد، san_path_err_recovery_time روی حاصل‌ضرب مقدار delay_wait_checks در max_polling_interval تنظیم خواهد شد. این کار تقریباً همان مدت زمان انتظاری را فراهم می‌کند که پیش‌تر delay_wait_checks ایجاد می‌کرد. همچنین، san_path_err_threshold روی 1 تنظیم می‌شود. برای اطلاعات بیشتر گزینه‌های san_path_err_recovery_time و san_path_err_threshold و بخش "تشخیص مسیرهای ناپایدار (Shaky paths detection)" در ادامه را ببینید.

marginal_pathgroups

اگر روی off تنظیم شود، گزینه‌های delay_*_checks، marginal_path_* و san_path_err_* از بازگرداندن مسیرهای لب‌مرزی یا "ناپایدار (shaky)" به مدار جلوگیری می‌کنند تا زمانی که برای مدتی پایش شوند. این امر می‌تواند وضعیتی ایجاد کند که در آن تمام مسیرهای غیرلب‌مرزی قطع شوند و هیچ مسیری تا زمانی که multipathd متوجه نشده و یک مسیر لب‌مرزی را احیا نکند قابل استفاده نباشد. اگر دستگاه چندمسیری به گونه‌ای پیکربندی نشده باشد که در این حالت I/O را صف‌بندی کند، با وجود در دسترس بودن مسیرهای لب‌مرزی می‌تواند باعث بروز خطاهای I/O شود. با این حال، اگر این گزینه روی on تنظیم شود، هرگاه یکی از روش‌های تشخیص مسیر لب‌مرزی تعیین کند که یک مسیر لب‌مرزی است، آن مسیر احیا شده و در یک گروه مسیر مجزا قرار می‌گیرد که تنها پس از امتحان تمام گروه‌های مسیر غیرلب‌مرزی استفاده خواهد شد. این کار از احتمال وقوع خطاهای I/O در زمانی که مسیرهای لب‌مرزی همچنان قابل استفاده هستند جلوگیری می‌کند. پس از پایش مسیر به مدت زمان پیکربندی‌شده و اعلام سلامت آن، مسیر به گروه مسیر عادی خود بازگردانده می‌شود. اگر این گزینه روی fpin تنظیم شود، multipathd اعلان‌های fpin را دریافت کرده، وضعیت مسیرها را بر همان اساس روی "marginal" تنظیم می‌کند و مسیرها را مطابق آنچه برای on شرح داده شد بازگروه‌بندی می‌نماید. این گزینه را نمی‌توان در ترکیب با سایر گزینه‌های "تشخیص مسیرهای ناپایدار" (در ادامه) استفاده کرد. نکته: اگر این گزینه روی fpin تنظیم شود، گزینه‌های marginal_path_* و san_path_err_* به طور ضمنی روی no قرار می‌گیرند. همچنین، این گزینه در بازپیکربندی دیمن multipathd نمی‌تواند به یا از fpin تغییر یابد؛ برای اعمال این تغییر باید multipathd را مجدداً راه‌اندازی کرد. برای اطلاعات بیشتر بخش "تشخیص مسیرهای ناپایدار (Shaky paths detection)" در ادامه را ببینید.

find_multipaths

این گزینه کنترل می‌کند که آیا multipath و multipathd تلاش کنند روی دستگاه‌های غیر مسدود که با آن‌ها مواجه می‌شوند نگاشت‌های چندمسیری ایجاد کنند یا خیر. این موضوع در دو حالت اهمیت دارد: الف) هنگامی که در طول پردازش قواعد udev، یک دستگاه توسط multipath -u شناسایی می‌شود (تنها و تنها در صورتی از پردازش بیشتر دستگاه توسط لایه‌های بالاتر - مانند LVM - جلوگیری می‌شود که به عنوان یک مسیر معتبر دستگاه چندمسیری تلقی گردد)، و ب) هنگامی که multipathd دستگاه جدیدی را شناسایی می‌کند. مقادیر ممکن عبارتند از:

find_multipaths_timeout

مهلت زمانی بر حسب ثانیه برای انتظار جهت کشف مسیرهای اضافی پس از شناسایی نخستین مسیر، در صورتی که گزینه find_multipaths "smart" (بالا را ببینید) تنظیم شده باشد. اگر مقدار مثبت باشد، این مهلت برای تمام دستگاه‌های ناشناخته و غیرمسدود مشاهده‌شده استفاده می‌شود. اگر مقدار منفی باشد (توصیه می‌شود)، تنها برای دستگاه‌های "شناخته‌شده" که دارای یک ورودی در جدول سخت‌افزاری multipath هستند (خواه در جدول توکار یا در یک بخش device) اعمال می‌شود؛ سایر دستگاه‌ها ("ناشناخته") برای جلوگیری از تاخیر در بوت تنها از مهلت زمانی 1 ثانیه استفاده خواهند کرد. مقدار 0 به معنای "استفاده از پیش‌فرض توکار" است. اگر find_multipaths مقداری غیر از smart داشته باشد، این گزینه هیچ تاثیری ندارد.

uxsock_timeout

مهلت زمانی دریافت CLI بر حسب میلی‌ثانیه. برای سیستم‌های بزرگتر، دستورات CLI ممکن است پیش از آزاد شدن قفل multipathd و امکان پردازش دستور CLI، دچار انقضای زمان شوند. این امر منجر به بازگرداندن خطاهایی مانند "timeout receiving packet" از دستورات CLI می‌شود. در این موارد توصیه می‌شود مهلت زمانی CLI افزایش یابد تا از بروز این مشکلات جلوگیری شود.

retrigger_tries

تعداد دفعاتی را تعیین می‌کند که multipathd برای به دست آوردن WWID تلاش می‌کند یک uevent را مجدداً ارسال کند.

retrigger_delay

مدت زمان انتظار بر حسب ثانیه بین تلاش‌های مجدد را تعیین می‌کند.

missing_uev_wait_timeout

کنترل می‌کند که multipathd پس از ایجاد یک دستگاه چندمسیری جدید، چند ثانیه برای دریافت رخداد تغییر از udev برای آن دستگاه منتظر بماند، پیش از آنکه بارگذاری‌های مجدد دستگاه را به طور خودکار فعال کند. معمولاً multipathd بارگذاری‌های مجدد روی یک دستگاه را به تعویق می‌اندازد تا زمانی که یک change uevent از بارگذاری جدول اولیه دریافت نماید.

skip_kpartx

اگر روی yes تنظیم شود، kpartx به طور خودکار روی دستگاه پارتیشن ایجاد نخواهد کرد.

purge_disconnected

اگر روی yes تنظیم شود، multipathd دستگاه‌هایی را که در وضعیت قطع‌شده هستند به طور خودکار حذف می‌کند. یک مسیر زمانی قطع‌شده تلقی می‌شود که بررسی‌کننده مسیر TUR (تست آمادگی واحد) کد حسگری اسکازی "LOGICAL UNIT NOT SUPPORTED" (کلید حسگر 0x5، ASC/ASCQ 0x25/0x00) را دریافت کند. این حالت معمولاً نشان می‌دهد که LUN از نگاشت خارج شده یا دیگر توسط آرایه ذخیره‌سازی ارائه نمی‌شود. این گزینه به پاکسازی ورودی‌های کهنه دستگاه که در غیر این صورت در سیستم باقی می‌مانند کمک می‌کند.

disable_changed_wwids

(منسوخ‌شده) این گزینه دیگر پشتیبانی نمی‌شود و نادیده گرفته خواهد شد.

remove_retries

تعداد دفعاتی را تعیین می‌کند که multipath تلاش می‌کند دستگاهی را که در حال استفاده است حذف کند. بین هر تلاش، multipath به مدت 1 ثانیه به خواب می‌رود.

max_sectors_kb

پارامتر دستگاه max_sectors_kb را روی برخی از دستگاه‌های مسیر و دستگاه چندمسیری به مقدار مشخص‌شده تنظیم می‌کند. max_sectors_kb بزرگترین اندازه ورودی/خروجی، بر حسب واحدهای 1024 بایتی است که هسته برای یک درخواست ورودی/خروجی مجاز می‌داند. برای دستگاه‌های سخت‌افزاری مانند دیسک‌های SCSI، این مقدار توسط قابلیت‌های سخت‌افزار محدود می‌شود. بسیار حیاتی است که مقدار یک نگاشت چندمسیری هرگز بیشتر از حداقل مقدار تمام دستگاه‌های مسیر آن نباشد. این موضوع در زمان بارگذاری نگاشت چندمسیری توسط هسته تضمین می‌شود، اما دستکاری مقادیر یک نگاشت یا هر یک از مسیرهای آن در حالی که نگاشت فعال است می‌تواند باعث بروز شرایط رقابتی و خطاهای ورودی/خروجی شود. بنابراین این مقدار تنها زمانی توسط multipathd اعمال می‌شود که یک نگاشت چندمسیری برای نخستین بار ایجاد شود، یا زمانی که یک دستگاه مسیر به یک نگاشت اضافه گردد. در هر دو حالت، هسته از بروز شرایط رقابتی جلوگیری می‌کند.

ghost_delay

تعداد ثانیه‌هایی را تعیین می‌کند که multipath پس از ایجاد دستگاهی که تنها دارای مسیرهای شبه (ghost) است، قبل از آماده علامت‌گذاری آن برای استفاده در systemd منتظر می‌ماند. این کار به مسیرهای فعال فرصت می‌دهد تا پیش از آنکه multipath گرداننده سخت‌افزاری را برای تغییر مسیرهای شبه به مسیرهای فعال اجرا کند، ظاهر شوند. تنظیم این گزینه روی 0 یا no باعث می‌شود multipath فوراً دستگاهی را که تنها مسیرهای شبه دارد به عنوان آماده علامت‌گذاری کند.

auto_resize

کنترل می‌کند چه زمانی multipathd به طور خودکار اندازه دستگاه چندمسیری را تغییر دهد. اگر روی never تنظیم شود، دستگاه‌های چندمسیری همیشه باید به صورت دستی با اجرای دستور multipathd resize map <name> تغییر اندازه داده شوند. اگر روی grow_only تنظیم شود، هنگامی که multipathd تشخیص دهد تمام مسیرهای یک دستگاه چندمسیری افزایش اندازه داشته‌اند، دستگاه چندمسیری را به طور خودکار به اندازه جدید گسترش می‌دهد. اگر روی grow_shrink تنظیم شود، multipathd همچنین پس از تشخیص کاهش اندازه تمامی مسیرهای آن، دستگاه را به طور خودکار کوچک خواهد کرد.

enable_foreign

کتابخانه‌های خارجی را فعال یا غیرفعال می‌کند (بخش پشتیبانی از چندمسیری خارجی (FOREIGN MULTIPATH SUPPORT) در ادامه را ببینید). مقدار آن یک عبارت باقاعده است؛ کتابخانه‌های خارجی در صورتی بارگذاری می‌شوند که نام آن‌ها (مثلاً "nvme") با عبارت مطابقت داشته باشد. به طور پیش‌فرض، هیچ کتابخانه خارجی فعالی وجود ندارد. این گزینه را روی "nvme" تنظیم کنید تا پشتیبانی از چندمسیری بومی NVMe فعال شود، یا ".*" برای فعال‌سازی تمامی کتابخانه‌های خارجی.

recheck_wwid

اگر روی yes تنظیم شود، هنگامی که یک مسیر شکست‌خورده بازیابی می‌شود، wwid آن دوباره بررسی خواهد شد. اگر wwid تغییر کرده باشد، مسیر از دستگاه چندمسیری فعلی حذف شده و به عنوان یک مسیر جدید اضافه می‌گردد. همچنین اگر یک مسیر به صورت دستی مجدداً اضافه شود، Multipathd شناسه wwid آن را دوباره بررسی خواهد کرد. این گزینه تنها برای دستگاه‌های SCSI کار می‌کند که برای استفاده از صفت پیش‌فرض uid_attribute یعنی ID_SERIAL، یا sysfs جهت دریافت wwid خود پیکربندی شده‌اند.

بخش‌های blacklist و blacklist_exceptions (blacklist and blacklist_exceptions sections)

بخش blacklist برای مستثنی کردن دستگاه‌های خاص از توپولوژی چندمسیری به کار می‌رود. این بخش عمدتاً برای جلوگیری از مدیریت دیسک‌های محلی یا دستگاه‌های غیردیسکی (مانند LUNهای کنترلر آرایه ذخیره‌سازی) توسط ابزارهای multipath-tools استفاده می‌شود.

در بخش‌های blacklist و blacklist_exceptions، شروع یک مقدار نقل‌قول‌شده با علامت تعجب "!" تطابق بقیه عبارت باقاعده را معکوس می‌کند. برای نمونه، "!^sd[a-z]" با تمام مقادیری که با "sd[a-z]" شروع نمی‌شوند تطبیق می‌یابد. علامت تعجب را می‌توان اسکیپ کرد ("\!") تا با یک علامت ! واقعی در ابتدای یک عبارت باقاعده مطابقت داده شود. توجه: علامت تعجب باید حتماً در داخل نقل‌قول‌ها باشد، در غیر این صورت به عنوان شروع کامنت تلقی خواهد شد.

بخش blacklist_exceptions برای برگرداندن اقدامات بخش blacklist به کار می‌رود. این کار امکان گنجاندن انتخابی ("لیست سفید") دستگاه‌هایی را فراهم می‌سازد که به طور معمول از طریق بخش blacklist مستثنی می‌شدند. یک کاربرد رایج، قرار دادن "همه‌چیز" در لیست سیاه با استفاده از یک عبارت باقاعده فراگیر و ایجاد ورودی‌های مشخص در blacklist_exceptions برای دستگاه‌هایی است که باید توسط multipath-tools مدیریت شوند.

کلیدواژه‌های زیر در هر دو بخش شناخته شده‌اند. پیش‌فرض‌ها خالی هستند مگر اینکه صراحتاً بیان شده باشد.

devnode

عبارت باقاعده منطبق بر گره‌های دستگاه جهت استثنا/گنجاندن.

wwid

عبارت باقاعده برای شناسه جهانی (WWID) دستگاه جهت استثنا/گنجاندن.

device

زیربخش برای توضیحات دستگاه. این زیربخش کلیدواژه‌های vendor و product را می‌شناسد. هر دو عبارت باقاعده هستند. برای توضیحات کامل این کلیدواژه‌ها لطفاً توضیحات بخش devices را ببینید.

property

عبارت باقاعده برای یک ویژگی udev. تمام دستگاه‌هایی که ویژگی‌های udev منطبق دارند مستثنی/گنجانده خواهند شد. نحوه مدیریت کلیدواژه property ویژه است، زیرا دستگاه‌ها باید دست‌کم یک ویژگی udev در لیست سفید داشته باشند؛ در غیر این صورت با آن‌ها به عنوان لیست سیاه رفتار شده و پیام "blacklisted, udev property missing" در گزارش‌ها نمایش داده می‌شود.

protocol

عبارت باقاعده برای پروتکل یک دستگاه جهت استثنا/گنجاندن.

برای هر دستگاه، این ۵ معیار لیست سیاه به ترتیب "property, devnode, device, protocol, wwid" ارزیابی می‌شوند. اگر دستگاهی با هر یک از معیارها در لیست سیاه قرار گیرد، از مدیریت توسط multipathd مستثنی شده و معیارهای بعدی دیگر ارزیابی نمی‌شوند. برای هر معیار، اگر دستگاهی با هر دو مطابقت داشته باشد، لیست سفید بر لیست سیاه اولویت دارد.

نکته: علاوه بر لیست سیاه و لیست سفید، سایر گزینه‌های پیکربندی مانند find_multipaths نیز بر این امر تاثیر می‌گذارند که آیا یک دستگاه معین توسط multipath-tools مدیریت شود یا خیر.

بخش multipaths (multipaths section)

بخش multipaths امکان تنظیم صفت‌های نگاشت‌های چندمسیری را فراهم می‌کند. صفت‌هایی که از طریق بخش multipaths تنظیم می‌شوند (فهرست زیر را ببینید) بر تمام تنظیمات پیکربندی دیگر، از جمله تنظیمات بخش overrides، اولویت دارند.

تنها صفت شناخته‌شده برای بخش multipaths، زیربخش multipath است. اگر چندین زیربخش multipath منطبق با یک WWID معین وجود داشته باشد، محتوای این بخش‌ها ادغام شده و تنظیمات ورودی‌های بعدی اولویت خواهند داشت.

زیربخش multipath صفت‌های زیر را می‌شناسد:

wwid

(اجباری) شناسه جهانی (World Wide Identifier). نگاشت‌های چندمسیری شناسایی‌شده با این صفت تطبیق داده می‌شوند. توجه داشته باشید که برخلاف صفت wwid در بخش blacklist، این صفت یک عبارت باقاعده یا زیررشته نیست؛ شناسه‌های WWID در داخل بخش multipaths باید دقیقاً مطابقت داشته باشند.

alias

نام نمادین برای نگاشت چندمسیری. این گزینه بر ورودی مربوط به همان WWID در فایل /etc/multipath/bindings اولویت دارد.

صفت‌های زیر اختیاری هستند؛ در صورت عدم تنظیم، مقادیر پیش‌فرض از بخش‌های overrides، devices یا defaults گرفته می‌شوند:

بخش devices (devices section)

مهم:

جدول توکار دستگاه‌های سخت‌افزاری multipath-tools توسط اعضای جامعه لینوکس به این امید که مفید واقع شود ایجاد شده است. وجود یک ورودی برای یک محصول ذخیره‌سازی معین در جدول سخت‌افزاری به هیچ وجه به این معنی نیست که سازنده محصول، آن را به همراه multipath-tools به هر شکلی پشتیبانی کرده یا مورد آزمایش قرار داده است. همیشه برای اطلاعات مربوط به پشتیبانی به مستندات رسمی سازنده مراجعه کنید.

ابزارهای multipath-tools دارای یک جدول دستگاه‌های توکار با مقادیر پیش‌فرض معقول برای بیش از ۱۰۰ دستگاه ذخیره‌سازی شناخته‌شده با قابلیت چندمسیری هستند. بخش devices می‌تواند برای بازنویسی این تنظیمات استفاده شود. اگر چندین تطابق برای یک دستگاه معین وجود داشته باشد، صفت‌های تمام ورودی‌های منطبق روی آن اعمال می‌شوند. اگر یک صفت در چندین زیربخش دستگاه منطبق مشخص شده باشد، ورودی‌های بعدی اولویت خواهند داشت. بنابراین، ورودی‌های موجود در فایل‌های زیر پوشه /etc/multipath/conf.d/ (به ترتیب معکوس الفبایی) بالاترین اولویت را دارند و پس از آن ورودی‌های /etc/multipath.conf قرار می‌گیرند؛ جدول سخت‌افزاری توکار کمترین اولویت را دارد. در داخل یک فایل پیکربندی، ورودی‌های بعدی نسبت به ورودی‌های قبلی اولویت بالاتری دارند.

تنها صفت شناخته‌شده برای بخش devices، زیربخش device است. دستگاه‌های شناسایی‌شده در سیستم بر اساس فیلدهای vendor، product و revision که همگی عبارات باقاعده گسترش‌یافته پوزیکس هستند (به regex(7) مراجعه کنید) با ورودی‌های دستگاه تطبیق داده می‌شوند.

فیلدهای vendor، product و revision که multipath یا multipathd برای دستگاه‌های موجود در سیستم تشخیص می‌دهند به نوع دستگاه بستگی دارد. برای دستگاه‌های SCSI، این مقادیر متناظر با فیلدهای مربوطه در صفحه SCSI INQUIRY هستند. به طور کلی، دستور 'multipathd show paths format "%d %s"' می‌تواند برای مشاهده ویژگی‌های تشخیص‌داده‌شده تمام دستگاه‌ها در سیستم استفاده شود.

زیربخش device صفت‌های زیر را می‌شناسد:

vendor

(اجباری) عبارت باقاعده برای تطبیق نام سازنده.

product

(اجباری) عبارت باقاعده برای تطبیق نام محصول.

revision

عبارت باقاعده برای تطبیق نسخه بازنگری محصول. در صورت عدم تعیین، با هر نسخه بازنگری تطبیق می‌یابد.

product_blacklist

محصولات مربوط به vendor داده‌شده که با این رشته مطابقت دارند در لیست سیاه قرار می‌گیرند. این معادل یک ورودی device در بخش blacklist است که صفت vendor آن روی vendor این ورودی، و صفت product آن روی مقدار product_blacklist تنظیم شده باشد.

alias_prefix

پیشوند user_friendly_names برای استفاده در این نوع دستگاه، به جای مقدار پیش‌فرض "mpath".

vpd_vendor

اطلاعات صفحه vpd اختصاصی سازنده، با استفاده از نام اختصاری صفحه vpd. نام اختصاری صفحه vpd را می‌توان با اجرای sg_vpd -e پیدا کرد. دیمن multipathd از این اطلاعات برای جمع‌آوری اطلاعات خاص دستگاه استفاده می‌کند که می‌توان آن را با نویسه عام %g برای دستورات multipathd show maps format و multipathd show paths format نمایش داد. در حال حاضر تنها صفحه vpd مربوط به hp3par پشتیبانی می‌شود.

hardware_handler

گرداننده سخت‌افزاری مورد استفاده برای این نوع دستگاه. گرداننده‌های سخت‌افزاری زیر پیاده‌سازی شده‌اند:

صفت‌های زیر اختیاری هستند؛ در صورت عدم تنظیم، مقادیر پیش‌فرض از بخش defaults گرفته می‌شوند:

بخش overrides (overrides section)

بخش overrides صفت‌های اختیاری زیر را می‌شناسد؛ در صورت عدم تنظیم، مقادیر از بخش‌های devices یا defaults گرفته می‌شوند:

بخش overrides همچنین زیربخش اختیاری protocol را می‌شناسد و می‌تواند شامل چندین زیربخش protocol باشد. دستگاه‌های مسیر با استفاده از صفت اجباری type با زیربخش protocol تطبیق داده می‌شوند. صفت‌های موجود در یک زیربخش protocol منطبق، بر صفت‌های بقیه بخش overrides اولویت دارند. اگر چندین زیربخش protocol منطبق وجود داشته باشد، ورودی‌های بعدی اولویت خواهند داشت.

protocol subsection

زیربخش protocol صفت اجباری زیر را می‌شناسد:

تولید WWID (WWID generation)

ابزار Multipath از یک شناسه جهانی (WWID) برای تعیین اینکه کدام مسیرها به یک دستگاه یکسان تعلق دارند استفاده می‌کند. فرض بر این است که هر مسیری که WWID یکسانی ارائه می‌دهد، به دستگاه یکسانی اشاره دارد.

شناسه WWID با چهار روش تولید می‌شود (به ترتیب اولویت):

uid_attrs

شناسه WWID با تطبیق نام گره دستگاه از صفت‌های udev مشتق می‌شود؛ به uid_attrs در بالا مراجعه کنید.

uid_attribute

استفاده از مقدار صفت udev مشخص‌شده؛ به uid_attribute در بالا مراجعه کنید.

sysfs

تلاش برای تعیین WWID از روی صفت‌های sysfs. برای دستگاه‌های SCSI، این کار به معنی خواندن صفحه داده‌های حیاتی محصول (VPD) به نام "Device Identification" (0x83) است.

تنظیمات پیش‌فرض (استفاده از udev و uid_attribute پیکربندی‌شده از روی جدول سخت‌افزاری توکار) باید در بیشتر سناریوها به خوبی کار کند. کاربرانی که مایل به فعال‌سازی ادغام uevent هستند باید uid_attrs را تنظیم نمایند.

تشخیص مسیرهای ناپایدار (Shaky paths detection)

یک مشکل رایج در پیکربندی‌های SAN، وقوع خطاهای متناوب است: یک مسیر غیرقابل‌دسترس می‌شود، سپس برای مدت کوتاهی دوباره در دسترس قرار می‌گیرد، دوباره ناپدید می‌شود و به همین ترتیب. این اتفاق معمولاً در اتصالات ناپایدار رخ می‌دهد. در چنین رخدادهای متوالی و غیرقابل‌اطمینانی، سوئیچ کردن غیرضروری بین گروه‌های مسیر نامطلوب است. دیمن multipathd از سه روش مختلف برای تشخیص این وضعیت و مدیریت آن پشتیبانی می‌کند. همه این روش‌ها در یک شیوه عملیاتی پایه مشترک هستند: اگر مسیری "ناپایدار (shaky)" یا "در حال تغییر مداوم (flipping)" تشخیص داده شود، و به ظاهر در وضعیت سالم باشد، بلافاصله به مدار بازگردانده (احیا) نمی‌شود. در عوض، در وضعیت "با تاخیر (delayed)" قرار گرفته و برای مدتی تحت پایش قرار می‌گیرد و تنها زمانی احیا می‌شود که وضعیت سالم پایدار به نظر برسد. اگر گزینه marginal_pathgroups تنظیم شده باشد، مسیر بلافاصله احیا می‌شود اما در یک گروه مسیر ویژه برای مسیرهای لب‌مرزی (marginal) قرار می‌گیرد. گروه‌های مسیر لب‌مرزی تا زمانی که تمام گروه‌های مسیر دیگر امتحان نشده باشند، استفاده نخواهند شد. در زمانی که مسیر به طور عادی احیا می‌شد، به گروه مسیر عادی خود بازگردانده خواهد شد. منطق تعیین وضعیت "ناپایدار"، و همچنین منطق زمان احیا، در میان این سه روش متفاوت است.

ردیابی خرابی "delay_checks"

(منسوخ‌شده) این روش منسوخ شده و به روش "san_path_err" نگاشت شده است. برای اطلاعات بیشتر، گزینه‌های delay_watch_checks و delay_wait_checks در بالا را ببینید.

ردیابی خرابی "marginal_path"

اگر یک رخداد خرابی دوم (گذار از خوب به بد) در طول marginal_path_double_failed_time ثانیه پس از یک خرابی رخ دهد، پایش با فرکانس بالا برای مسیر آسیب‌دیده آغاز می‌شود: ورودی/خروجی با نرخ ۱۰ درخواست در ثانیه ارسال می‌گردد. این کار به مدت marginal_path_err_sample_time ثانیه انجام می‌شود. در طول این دوره، مسیر به مدار بازگردانده نمی‌شود. اگر در طول دوره پایش نرخ خطاها کمتر از marginal_path_err_rate_threshold باقی بماند، مسیر احیا خواهد شد. در غیر این صورت، برای مدت marginal_path_err_recheck_gap_time در وضعیت شکست‌خورده نگه داشته می‌شود و پس از آن، دوباره پایش خواهد شد. برای این روش، بازه‌های زمانی بر حسب ثانیه اندازه‌گیری می‌شوند.

ردیابی خرابی "san_path_err"

دیمن multipathd خرابی‌های مسیر را برای هر مسیر می‌شمارد. هنگامی که تعداد خرابی‌ها از مقدار ارائه‌شده توسط san_path_err_threshold فراتر رود، مسیر به مدت san_path_err_recovery_time ثانیه احیا نخواهد شد. در حین شمارش خرابی‌ها، multipathd به ازای هر "san_path_err_forget_rate" تیک، یک خرابی گذشته را "فراموش می‌کند"؛ بنابراین اگر خطاها بیشتر از یک بار در بازه نرخ فراموشی رخ ندهند، شمارش خرابی‌ها افزایش نمی‌یابد و آستانه هرگز برآورده نمی‌شود. تیک‌ها مدت زمان بین بررسی‌های مسیر توسط multipathd هستند که متغیر بوده و توسط پارامترهای polling_interval و max_polling_interval کنترل می‌شوند.

ردیابی خرابی "FPIN"

فابریک‌های فایبر چنل می‌توانند هاست‌ها را از مشکلات سطح فابریک مانند نقص‌های یکپارچگی یا ازدحام، با اعلان‌های موسوم به اعلان‌های تاثیر عملکرد فابریک (Fabric Performance Impact Notifications یا FPINs) مطلع سازند. با دریافت اعلان‌های fpin از طریق ELS، دیمن multipathd وضعیت مسیر و پورت مربوطه را به marginal تغییر خواهد داد.

برای جزئیات بیشتر به مستندات گزینه‌های مربوطه در بالا مراجعه کنید. استفاده از بیش از یکی از این روش‌ها برای هر نگاشت چندمسیری معین اکیداً توصیه نمی‌شود، زیرا دو روش همزمان ممکن است به روش‌های غیرقابل پیش‌بینی با یکدیگر تداخل داشته باشند. اگر روش "marginal_path" فعال باشد، پارامترهای "san_path_err" به طور ضمنی روی 0 تنظیم می‌شوند.

پشتیبانی از چندمسیری خارجی (FOREIGN MULTIPATH SUPPORT)

ابزارهای multipath و multipathd می‌توانند کتابخانه‌های "خارجی (foreign)" را برای افزودن پشتیبانی از سایر فناوری‌های چندمسیری به جز دیوایس‌مپر (device mapper) لینوکس بارگذاری کنند. در حال حاضر این پشتیبانی محدود به چاپ اطلاعات شناسایی‌شده درباره پیکربندی چندمسیری است. در خروجی توپولوژی، نام نگاشت‌های خارجی با نام کتابخانه خارجی در داخل براکت‌ها پیشوند می‌گیرد، مانند این مثال:

# multipath -ll
uuid.fedcba98-3579-4567-8765-123456789abc [nvme]:nvme4n9 NVME,Some NVMe controller,FFFFFFFF
size=167772160 features='n/a' hwhandler='ANA' wp=rw
|-+- policy='n/a' prio=50 status=optimized
| `- 4:38:1    nvme4c38n1 0:0     n/a   optimized    live
`-+- policy='n/a' prio=50 status=optimized
  `- 4:39:1    nvme4c39n1 0:0     n/a   optimized    live

کتابخانه خارجی "nvme" پشتیبانی از چندمسیری بومی NVMe در هسته را فراهم می‌کند. این کتابخانه بخشی از بسته استاندارد multipath است.

مشکلات شناخته‌شده (KNOWN ISSUES)

استفاده از گزینه queue_if_no_path می‌تواند در شرایطی که تمام مسیرهای یک LUN آفلاین می‌شوند، منجر به قفل شدن فرآیندها در وضعیت D state (خواب غیرقابل‌وقفه) و غیرقابل‌کشتن شدن آن‌ها گردد. توصیه می‌شود به جای آن از گزینه no_path_retry استفاده شود.

استفاده از queue_if_no_path یا no_path_retry ممکن است در صورتی که تنظیم dev_loss_tmo منجر به حذف دستگاه در حین صف‌بندی I/O شود، به بن‌بست (deadlock) ختم گردد. دیمن چندمسیری تنظیم dev_loss_tmo را بر این اساس به‌روزرسانی می‌کند تا از این بن‌بست جلوگیری نماید. از این رو اگر هر دو مقدار مشخص شوند، ترتیب اولویت عبارت است از: no_path_retry, queue_if_no_path, dev_loss_tmo.

فایل‌ها (FILES)

مسیرهای پیش‌فرض برای فایل‌ها و دایرکتوری‌های پیکربندی:

/etc/multipath.conf

فایل پیکربندی اصلی.

/etc/multipath/conf.d/

دایرکتوری فایل‌های قطره‌ای (drop-in) پیکربندی.

/etc/multipath/bindings

فایل پیوندها (bindings)؛ زمانی استفاده می‌شود که گزینه user_friendly_names روی yes تنظیم شده باشد تا به هر دستگاه چندمسیری یک نام مستعار پایدار و یکتا اختصاص دهد.

/etc/multipath/prkeys

فایل کلیدهای رزرو پایدار؛ توسط multipathd برای پیگیری کلید رزرو استفاده‌شده برای یک WWID خاص هنگامی که reservation_key روی file تنظیم شده است، استفاده می‌شود.

/etc/multipath/wwids

فایل شناسه‌های جهانی (WWIDs)؛ توسط multipath برای پیگیری شناسه‌های WWID مربوط به LUNهایی که در گذشته برای آن‌ها دستگاه‌های چندمسیری ایجاد شده است به کار می‌رود.

/run/multipathd.pid

فایل شناسه فرآیند (PID).

همچنین ببینید (SEE ALSO)

udev(8), dmsetup(8), multipath(8), multipathc(8), multipathd(8).

نویسندگان (AUTHORS)

مجموعه multipath-tools توسط کریستوف واروکی (Christophe Varoqui) <christophe.varoqui@opensvc.com> و دیگران توسعه یافته است.