نام (NAME)

mpathpersist - مدیریت رزروهای پایدار SCSI روی دستگاه‌های چندمسیره dm.

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

mpathpersist [OPTIONS] device

توضیحات (DESCRIPTION)

این ابزار برای مدیریت رزروهای پایدار SCSI روی دستگاه‌های چندمسیره نگاشت‌گر دستگاه (Device Mapper Multipath) استفاده می‌شود. برای اینکه بتوانید از این قابلیت استفاده کنید، ویژگی reservation_key باید در فایل /etc/multipath.conf تعریف شده باشد. در غیر این صورت، دیمن multipathd وضعیت رزرو پایدار را برای مسیرهای تازه کشف‌شده یا مسیرهای بازگردانده‌شده بررسی نخواهد کرد.

دستور mpathpersist از همان گزینه‌های خط فرمانی ابزار sg_persist پشتیبانی می‌کند. برای بررسی دقیق و عمیق گزینه‌های مختلف، به صفحه راهنمای sg_persist (8) مراجعه کنید.

گزینه‌ها (OPTIONS)

-verbose|-v level

سطح پرگویی (Verbosity):

--device=DEVICE|-d DEVICE

پرس‌وجو یا تغییر DEVICE.

--batch-file=DEVICE|-f FILE

خواندن دستورات از FILE. بخش "فایل‌های دسته‌ای (BATCH FILES)" در زیر را ببینید. این گزینه حداکثر یک بار می‌تواند مشخص شود.

--help|-h

نمایش این پیام راهنما.

--hex|-H

نمایش پاسخ در قالب هگزادسیمال (hex).

--in|-i

درخواست دستور PR In.

--out|-o

درخواست دستور PR Out.

--param-alltgpt|-Y

پارامتر PR Out با مقدار 'ALL_TG_PT'.

--param-aptpl|-Z

پارامتر PR Out با مقدار 'APTPL'.

--read-keys|-k

دستور PR In: خواندن کلیدها (Read Keys).

--param-rk=RK|-K RK

پارامتر کلید رزرو PR Out (مقدار RK در مبنای ۱۶ و حداکثر ۸ بایت است).

--param-sark=SARK|-S SARK

پارامتر کلید رزرو کنش سرویس PR Out (مقدار SARK در مبنای ۱۶ است).

--preempt|-P

دستور PR Out: سلب حق تقدم (Preempt).

--clear|-C

دستور PR Out: پاک‌سازی ثبت‌نام‌ها (Clear registrations).

--preempt-abort|-A

دستور PR Out: سلب حق تقدم و لغو (Preempt and Abort).

--prout-type=TYPE|-T TYPE

نوع دستور PR Out.

--read-full-status|-s

دستور PR In: خواندن وضعیت کامل (Read Full Status).

--read-keys|-k

دستور PR In: خواندن کلیدها (Read Keys).

--read-reservation|-r

دستور PR In: خواندن رزرو (Read Reservation).

--register|-G

دستور PR Out: ثبت‌نام (Register).

--register-ignore|-I

دستور PR Out: ثبت‌نام و نادیده‌گیری (Register and Ignore).

--release|-L

دستور PR Out: آزادسازی (Release).

--report-capabilities|-c

دستور PR In: گزارش قابلیت‌ها (Report Capabilities).

--reserve|-R

دستور PR Out: رزرو (Reserve).

--transport-id=TIDS|-X TIDS

شناسه‌های TransportID می‌توانند به چندین شکل مختلف ذکر شوند.

--alloc-length=LEN|-l LEN

دستور PR In: حداکثر طول تخصیص. LEN یک عدد در مبنای ۱۰ بین 0 تا 8192 است.

مثال (EXAMPLE)

ثبت کلید "123abc" برای دستگاه /dev/mapper/mpath9:

خواندن کلیدهای رزرو ثبت‌شده برای دستگاه /dev/mapper/mpath9:

ایجاد یک رزرو برای دستگاه /dev/mapper/mpath9 با کلید رزرو داده‌شده:

خواندن وضعیت رزرو دستگاه /dev/mapper/mpath9:

آزادسازی رزرو از پیش ایجادشده (توجه داشته باشید که prout-type باید همانند بالا باشد):

حذف کلید فعلی ثبت‌شده برای این میزبان (یعنی بازنشانی آن به 0):

حذف رزرو فعلی و لغو ثبت تمامی کلیدهای ثبت‌شده از تمام پیوندهای I_T (اتصالات I_T nexus):

فایل‌های دسته‌ای (BATCH FILES)

گزینه --batch-file (-f) یک فایل ورودی را برای پردازش توسط mpathpersist مشخص می‌کند. گروه‌بندی دستورات در فایل‌های دسته‌ای می‌تواند بهبود سرعت به‌ویژه در استقرارهای بزرگ فراهم کند، زیرا mpathpersist تنها یک بار در هنگام راه‌اندازی نیاز به پویش مسیرها و نگاشت‌های موجود دارد.

فایل ورودی یک فایل متنی است که خط به خط تجزیه می‌شود. هر خط از فایل به عنوان یک خط فرمان (یعنی فهرستی از گزینه‌ها و پارامترها) برای mpathpersist تفسیر می‌شود. گزینه‌ها و پارامترها با یک یا چند نویسه فاصله خالی (فاصله یا TAB) از یکدیگر جدا می‌شوند. خطوط می‌توانند با کلمه "mpathpersist" شروع شوند، اما اجباری در آن نیست. نویسه "#"، چه در ابتدای خط و چه پس از مقداری فاصله خالی، نشان‌دهنده شروع یک توضیح است که تا انتهای خط ادامه می‌یابد. خطوط خالی مجاز هستند. ادامه دادن دستورات mpathpersist در چندین خط پشتیبانی نمی‌شود.

تمام گزینه‌های فهرست‌شده در این صفحه راهنما، به جز -f و -v، در فایل‌های دسته‌ای مجاز هستند. هر دو قالب گزینه‌های کوتاه و بلند را می‌توان استفاده کرد. استفاده از گزینه -f در داخل فایل دسته‌ای یک خطا است. گزینه -v در فایل‌های دسته‌ای نادیده گرفته می‌شود.

نگاشت چندمسیره‌ای (multipath map) که عملیات روی آن انجام می‌شود باید در هر خط ورودی مشخص گردد، مثلاً با استفاده از گزینه -d. دستوراتی که روی نگاشت‌های چندمسیره مختلف عمل می‌کنند می‌توانند در یک فایل دسته‌ای ترکیب شوند، و چندین دستور می‌توانند روی یک نگاشت چندمسیره یکسان عمل کنند. دستورات یکی پس از دیگری اجرا می‌شوند، به‌طوری‌که دستورات پایین‌تر در فایل تغییرات وضعیت ناشی از دستورات قبلی را می‌بینند. اگر mpathpersist هنگام پردازش یک خط در فایل دسته‌ای با خطایی مواجه شود، پردازش فایل دسته‌ای متوقف نمی‌شود؛ دستورات بعدی با وجود این اجرا خواهند شد. وضعیت خروج mpathpersist برابر با وضعیت اولین دستور ناموفق خواهد بود، یا اگر همه دستورات با موفقیت انجام شوند برابر 0 است.

اگر گزینه‌ها و پارامترهای دیگری همراه با -f در خط فرمان mpathpersist استفاده شوند، ابتدا خط فرمان اجرا می‌شود و به دنبال آن دستورات فایل دسته‌ای اجرا خواهند شد.

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

# This is an mpathpersist input file.
# Short and long forms of the same command
-i -k /dev/dm-1 # short form, this comment is ignored
mpathpersist --in --read-keys --device=/dev/dm-1
# Mixing of long and short options, variable white space
  --out  --register    -S  abcde     /dev/dm-1
# Mixing of commands for different maps
-ir /dev/dm-0
-ir /dev/dm-1
mpathpersist --out --param-rk abcde --reserve --prout-type 5 /dev/dm-1
# This should now show a reservation
-ir /dev/dm-1
-oCK abcde /dev/dm-1
--in --read-reservation /dev/dm-1

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

multipath(8), multipathd(8), sg_persist(8).

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

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