نام (NAME)

multipath - پیکربندی خودکار مقصدهای نگاشت‌کننده دستگاه (Device Mapper).

خلاصه دستور (SYNOPSIS)

multipath [-v level] [-B|-d|-i|-q|-r] [-b file] [-p policy] [device]

multipath [-v level] [-R retries] -f device

multipath [-v level] [-R retries] -F

multipath [-v level] [-l|-ll] [device]

multipath [-v level] [-a|-w] device

multipath [-v level] -W

multipath [-v level] [-i] [-c|-C] device

multipath [-v level] [-i] [-u|-U]

multipath [-h|-t|-T]

توضیحات (DESCRIPTION)

دستور multipath برای شناسایی و ادغام چندین مسیر به سمت دستگاه‌ها، به منظور جایگزینی در صورت خرابی (fail-over) یا بهبود کارایی استفاده می‌شود.

آرگومان‌ها (ARGUMENTS)

آرگومان device عملکرد multipath را فقط به دستگاه‌هایی که با عبارت داده‌شده مطابقت دارند محدود می‌کند. این آرگومان می‌تواند به یک نگاشت چندمسیره یا به اجزای آن ("مسیرها") اشاره داشته باشد. این عبارت می‌تواند در یکی از قالب‌های زیر باشد:

گره دستگاه (device node): نام فایل یک گره دستگاه، به عنوان مثال /dev/dm-10 یا /dev/sda. اگر این گره به یک دستگاه نگاشت‌کننده دستگاه موجود که نماینده یک نگاشت چندمسیره است اشاره کند، بسته به حالت عملکرد، این نگاشت یا مسیرهای آن انتخاب می‌شوند. در غیر این صورت، یک دستگاه مسیر انتخاب خواهد شد.
شناسه دستگاه (device ID): شماره دستگاه در هسته که با شماره‌های major:minor مشخص می‌شود، مانند 65:16. این قالب فقط برای دستگاه‌های مسیر قابل استفاده است.
شناسه سراسری (WWID): یک شناسه سراسری (World Wide Identifier) که با یک نگاشت چندمسیره یا مسیرهای آن مطابقت دارد. برای فهرست کردن WWID دستگاه‌های موجود در سیستم، می‌توانید برای نمونه از دستور multipath -d -v3 2>/dev/null استفاده کنید.

حالت‌های عملکرد (OPERATION MODES)

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

-f: تخلیه (حذف) یک نگاشت دستگاه چندمسیره مشخص‌شده به عنوان پارامتر، در صورتی که استفاده نشود. این عملیات در صورت در حال اجرا بودن دیمن multipathd به آن واگذار می‌شود.
-F: تخلیه (حذف) تمام نگاشت‌های استفاده‌نشده دستگاه‌های چندمسیره. این عملیات در صورت در حال اجرا بودن دیمن multipathd به آن واگذار می‌شود.
-l: نمایش ("فهرست کردن") توپولوژی فعلی چندمسیره با استفاده از اطلاعات دریافت شده از sysfs و نگاشت‌کننده دستگاه (device-mapper).
-ll: نمایش ("فهرست کردن") توپولوژی فعلی چندمسیره از روی تمامی اطلاعات موجود (sysfs، نگاشت‌کننده دستگاه، بررسی‌کننده‌های مسیر و...).
-a: افزودن WWID مربوط به دستگاه مشخص‌شده به فایل WWIDها.
-w: حذف WWID مربوط به دستگاه مشخص‌شده از فایل WWIDها.
-W: بازنشانی فایل WWIDها به طوری که فقط شامل دستگاه‌های چندمسیره فعلی باشد.
-c: بررسی اینکه آیا یک دستگاه بلوکی باید به عنوان مسیری در یک دستگاه چندمسیره باشد یا خیر.
-C: بررسی اینکه آیا یک دستگاه چندمسیره دارای مسیرهای قابل استفاده است یا خیر. این مورد می‌تواند برای آزمایش اینکه آیا ورودی/خروجی (I/O) روی این دستگاه محتملاً موفق خواهد بود یا خیر استفاده شود. خود دستور تلاشی برای انجام I/O روی دستگاه انجام نمی‌دهد.
-u: بررسی اینکه آیا دستگاه مشخص‌شده در متغیرهای محیطی برنامه باید مسیری در یک دستگاه چندمسیره باشد یا خیر.
-U: بررسی اینکه آیا دستگاه مشخص‌شده در متغیرهای محیطی برنامه یک دستگاه چندمسیره با مسیرهای قابل استفاده است یا خیر. گزینه -C را ببینید.
-h: چاپ متن راهنمای استفاده از دستور.
-t: نمایش پیکربندی فعلی مورد استفاده توسط multipathd.
-T: نمایش پیکربندی فعلی مورد استفاده توسط multipathd، با محدود کردن خروجی فقط به دستگاه‌هایی که واقعاً در سیستم حضور دارند. این خروجی می‌تواند به عنوان الگویی برای ایجاد /etc/multipath.conf استفاده شود.

گزینه‌ها (OPTIONS)

-v level: میزان جزئیات (Verbosity) اطلاعات چاپ‌شده در خروجی استاندارد (stdout) در حالت‌های عملکرد پیش‌فرض و "فهرست کردن" (list). مقدار پیش‌فرض -v 2 است.

0: هیچ پیامی چاپ نمی‌شود.
1: در حالت پیش‌فرض، نام‌ها/WWIDهای نگاشت‌های چندمسیره ایجادشده یا تغییریافته چاپ می‌شوند. در حالت فهرست، WWIDهای تمامی نگاشت‌های چندمسیره چاپ می‌شوند.
2: در حالت پیش‌فرض، توپولوژی نگاشت‌های چندمسیره ایجادشده یا تغییریافته چاپ می‌شود. در حالت فهرست، توپولوژی تمامی نگاشت‌های چندمسیره چاپ می‌شود.
3: تمام مسیرهای شناسایی‌شده و توپولوژی تمامی نگاشت‌های چندمسیره چاپ می‌شوند.

سطح پرگویی همچنین سطح پیام‌های گزارش (log) و اشکال‌زدایی چاپ‌شده در خروجی خطای استاندارد (stderr) را کنترل می‌کند. سطح پیش‌فرض متناظر با LOG_NOTICE است (پیام‌های مهمی که در عملکرد عادی نباید نادیده گرفته شوند).

-d: اجرای آزمایشی (Dry run)؛ نگاشت‌های دستگاه (devmaps) را ایجاد یا به‌روزرسانی نمی‌کند.
-e: فعال‌سازی تمامی کتابخانه‌های خارجی (foreign). این گزینه مقدار enable_foreign در multipath.conf(5) را بازنویسی می‌کند.
-i: نادیده گرفتن فایل WWIDها هنگام پردازش دستگاه‌ها. اگر find_multipaths strict یا find_multipaths no در فایل /etc/multipath.conf تنظیم شده باشد، multipath تنها دستگاه‌هایی را در نظر می‌گیرد که در فایل WWIDها فهرست شده باشند. این گزینه آن رفتار را بازنویسی می‌کند. برای سایر مقادیر find_multipaths، این گزینه هیچ تأثیری ندارد. توضیحات find_multipaths را در /etc/multipath.conf(5) ببینید. این گزینه فقط باید در شرایط نادر استفاده شود.
-B: تلقی کردن فایل نگاشت‌ها (bindings file) به صورت فقط‌خواندنی.
-b file: (منسوخ‌شده، استفاده نکنید) تعیین مکان فایل نگاشت‌های user_friendly_names. مقدار پیش‌فرض /etc/multipath/bindings است.
-q: ویژگی queue_if_no_path نگاشت‌کننده دستگاه را برای نگاشت‌های چندمسیره غیرفعال (unset) نکنید. در حالت عادی، اگر multipathd در حال اجرا نباشد، multipath این ویژگی را غیرفعال می‌کند؛ زیرا تنها یک دیمن چندمسیره در حال اجرا تضمین می‌کند که مسیرهای غیرقابل استفاده پس از در دسترس قرار گرفتن مجدد بازیابی شوند.
-p policy: وادار کردن نگاشت‌های جدید به استفاده از خط‌مشی (policy) مشخص‌شده، که پیکربندی موجود در multipath.conf(5) را بازنویسی می‌کند. مقادیر مجاز برای policy همانند مقادیر path_grouping_policy در multipath.conf(5) هستند. نگاشت‌های موجود تغییر نمی‌کنند.
-r: بارگذاری مجدد اجباری تمام نگاشت‌های چندمسیره موجود. این دستور در صورت در حال اجرا بودن دیمن multipathd به آن واگذار می‌شود. در این حالت، سایر سوییچ‌های خط فرمان دستور multipath هیچ تأثیری نخواهند داشت.
-R retries: تعداد دفعات تلاش مجدد برای پاکسازی (flush) دستگاه‌های چندمسیره‌ای که در حال استفاده هستند. مقدار پیش‌فرض 0 است.

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

multipathd(8), multipath.conf(5), kpartx(8), udev(8), dmsetup(8), hotplug(8).

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

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