.\" ----------------------------------------------------------------------------
.\" Update the date below if you make any significant change.
.\" ----------------------------------------------------------------------------
.
.TH MPATHPERSIST 8 2021-11-12 Linux
.
.
.\" ----------------------------------------------------------------------------
.SH "نام (NAME)"
.\" ----------------------------------------------------------------------------
.
mpathpersist \- مدیریت رزروهای پایدار SCSI روی دستگاه‌های چندمسیره dm.
.
.
.\" ----------------------------------------------------------------------------
.SH "خلاصه دستور (SYNOPSIS)"
.\" ----------------------------------------------------------------------------
.
.B mpathpersist
.RB [\| OPTIONS \|]
.I device
.
.
.\" ----------------------------------------------------------------------------
.SH "توضیحات (DESCRIPTION)"
.\" ----------------------------------------------------------------------------
.
این ابزار برای مدیریت رزروهای پایدار SCSI روی دستگاه‌های چندمسیره نگاشت‌گر دستگاه (Device Mapper Multipath) استفاده می‌شود. برای اینکه بتوانید از این قابلیت استفاده کنید، ویژگی \fIreservation_key\fR باید در فایل \fI/etc/multipath.conf\fR تعریف شده باشد. در غیر این صورت، دیمن \fBmultipathd\fR وضعیت رزرو پایدار را برای مسیرهای تازه کشف‌شده یا مسیرهای بازگردانده‌شده بررسی نخواهد کرد.
.
.LP
دستور \fBmpathpersist\fR از همان گزینه‌های خط فرمانی ابزار \fBsg_persist\fR پشتیبانی می‌کند.
.
برای بررسی دقیق و عمیق گزینه‌های مختلف، به صفحه راهنمای \fBsg_persist (8)\fR مراجعه کنید.
.
.\" ----------------------------------------------------------------------------
.SH "گزینه‌ها (OPTIONS)"
.\" ----------------------------------------------------------------------------
.
.TP
.BI \-verbose|\-v " level"
سطح پرگویی (Verbosity):
.RS
.TP
.I 0
پیام‌های بحرانی (Critical).
.TP
.I 1
پیام‌های خطا (Error).
.TP
.I 2
پیام‌های هشدار (Warning).
.TP
.I 3
پیام‌های اطلاعاتی (Informational).
.TP
.I 4
پیام‌های اطلاعاتی با ردیابی (trace) فعال.
.RE
.
.TP
.BI \--device=\fIDEVICE\fB|\-d " DEVICE"
پرس‌وجو یا تغییر DEVICE.
.
.TP
.BI \--batch-file=\fIDEVICE\fB|\-f " FILE"
خواندن دستورات از \fIFILE\fR. بخش \(dqفایل‌های دسته‌ای (BATCH FILES)\(dq در زیر را ببینید. این گزینه حداکثر یک بار می‌تواند مشخص شود.
.
.TP
.B \--help|\-h
نمایش این پیام راهنما.
.
.TP
.B \--hex|\-H
نمایش پاسخ در قالب هگزادسیمال (hex).
.
.TP
.B \--in|\-i
درخواست دستور PR In.
.
.TP
.B \--out|\-o
درخواست دستور PR Out.
.
.TP
.B \--param-alltgpt|\-Y
پارامتر PR Out با مقدار 'ALL_TG_PT'.
.
.TP
.B \--param-aptpl|\-Z
پارامتر PR Out با مقدار 'APTPL'.
.
.TP
.B \--read-keys|\-k
دستور PR In: خواندن کلیدها (Read Keys).
.
.TP
.BI \--param-rk=\fIRK\fB|\-K " RK"
پارامتر کلید رزرو PR Out (مقدار RK در مبنای ۱۶ و حداکثر ۸ بایت است).
.
.TP
.BI \--param-sark=\fISARK\fB|\-S " SARK"
پارامتر کلید رزرو کنش سرویس PR Out (مقدار SARK در مبنای ۱۶ است).
.
.TP
.B \--preempt|\-P
دستور PR Out: سلب حق تقدم (Preempt).
.
.TP
.B \--clear|\-C
دستور PR Out: پاک‌سازی ثبت‌نام‌ها (Clear registrations).
.
.TP
.B \--preempt-abort|\-A
دستور PR Out: سلب حق تقدم و لغو (Preempt and Abort).
.
.TP
.BI \--prout-type=\fITYPE\fB|\-T " TYPE"
نوع دستور PR Out.
.
.TP
.B \--read-full-status|\-s
دستور PR In: خواندن وضعیت کامل (Read Full Status).
.
.TP
.B \--read-keys|\-k
دستور PR In: خواندن کلیدها (Read Keys).
.
.TP
.B \--read-reservation|\-r
دستور PR In: خواندن رزرو (Read Reservation).
.
.TP
.B \--register|\-G
دستور PR Out: ثبت‌نام (Register).
.
.TP
.B \--register-ignore|\-I
دستور PR Out: ثبت‌نام و نادیده‌گیری (Register and Ignore).
.
.TP
.B \--release|\-L
دستور PR Out: آزادسازی (Release).
.
.TP
.B \--report-capabilities|\-c
دستور PR In: گزارش قابلیت‌ها (Report Capabilities).
.
.TP
.B \--reserve|\-R
دستور PR Out: رزرو (Reserve).
.
.TP
.BI \--transport-id=\fITIDS\fB|\-X " TIDS"
شناسه‌های TransportID می‌توانند به چندین شکل مختلف ذکر شوند.
.
.TP
.BI \--alloc-length=\fILEN\fB|\-l " LEN"
دستور PR In: حداکثر طول تخصیص. LEN یک عدد در مبنای ۱۰ بین 0 تا 8192 است.
.
.
.\" ----------------------------------------------------------------------------
.SH "مثال (EXAMPLE)"
.\" ----------------------------------------------------------------------------
.
ثبت کلید \(dq123abc\(dq برای دستگاه /dev/mapper/mpath9:
.RS
\fBmpathpersist --out --register --param-sark=\fI123abc /dev/mapper/mpath9\fR
.RE
.PP
خواندن کلیدهای رزرو ثبت‌شده برای دستگاه /dev/mapper/mpath9:
.RS
\fBmpathpersist -i -k \fI/dev/mapper/mpath9\fR
.RE
.PP
ایجاد یک رزرو برای دستگاه /dev/mapper/mpath9 با کلید رزرو داده‌شده:
.RS
\fBmpathpersist --out --reserve --param-rk=\fI123abc \fB--prout-type=\fI8 \fB-d \fI/dev/mapper/mpath9\fR
.RE
.PP
خواندن وضعیت رزرو دستگاه /dev/mapper/mpath9:
.RS
\fBmpathpersist -i -s -d \fI/dev/mapper/mpath9\fR
.RE
.PP
آزادسازی رزرو از پیش ایجادشده (توجه داشته باشید که prout-type باید همانند بالا باشد):
.RS
\fBmpathpersist --out --release --param-rk=\fI123abc \fB--prout-type=\fI8 \fB-d \fI/dev/mapper/mpath9\fR
.RE
.PP
حذف کلید فعلی ثبت‌شده برای این میزبان (یعنی بازنشانی آن به 0):
.RS
\fBmpathpersist --out --register-ignore -K \fI123abc\fB -S \fI0\fB \fI/dev/mapper/mpath9\fR
.RE
.PP
حذف رزرو فعلی و لغو ثبت تمامی کلیدهای ثبت‌شده از تمام پیوندهای I_T (اتصالات I_T nexus):
.RS
\fBmpathpersist -oCK \fI123abc \fI/dev/mapper/mpath9\fR
.RE
.
.
.\" ----------------------------------------------------------------------------
.SH "فایل‌های دسته‌ای (BATCH FILES)"
.\" ----------------------------------------------------------------------------
.
گزینه \fI--batch-file\fR (\fI-f\fR) یک فایل ورودی را برای پردازش توسط \fBmpathpersist\fR مشخص می‌کند. گروه‌بندی دستورات در فایل‌های دسته‌ای می‌تواند بهبود سرعت به‌ویژه در استقرارهای بزرگ فراهم کند، زیرا \fBmpathpersist\fR تنها یک بار در هنگام راه‌اندازی نیاز به پویش مسیرها و نگاشت‌های موجود دارد.
.
.PP
فایل ورودی یک فایل متنی است که خط به خط تجزیه می‌شود. هر خط از فایل به عنوان یک خط فرمان (یعنی فهرستی از گزینه‌ها و پارامترها) برای \fBmpathpersist\fR تفسیر می‌شود. گزینه‌ها و پارامترها با یک یا چند نویسه فاصله خالی (فاصله یا TAB) از یکدیگر جدا می‌شوند. خطوط می‌توانند با کلمه \(dqmpathpersist\(dq شروع شوند، اما اجباری در آن نیست. نویسه \(dq#\(dq، چه در ابتدای خط و چه پس از مقداری فاصله خالی، نشان‌دهنده شروع یک توضیح است که تا انتهای خط ادامه می‌یابد. خطوط خالی مجاز هستند. ادامه دادن دستورات mpathpersist در چندین خط پشتیبانی نمی‌شود.
.
.PP
تمام گزینه‌های فهرست‌شده در این صفحه راهنما، به جز \fI-f\fR و \fI-v\fR، در فایل‌های دسته‌ای مجاز هستند. هر دو قالب گزینه‌های کوتاه و بلند را می‌توان استفاده کرد. استفاده از گزینه \fI-f\fR در داخل فایل دسته‌ای یک خطا است. گزینه \fI-v\fR در فایل‌های دسته‌ای نادیده گرفته می‌شود.
.
.PP
نگاشت چندمسیره‌ای (multipath map) که عملیات روی آن انجام می‌شود باید در هر خط ورودی مشخص گردد، مثلاً با استفاده از گزینه \fI-d\fR. دستوراتی که روی نگاشت‌های چندمسیره مختلف عمل می‌کنند می‌توانند در یک فایل دسته‌ای ترکیب شوند، و چندین دستور می‌توانند روی یک نگاشت چندمسیره یکسان عمل کنند. دستورات یکی پس از دیگری اجرا می‌شوند، به‌طوری‌که دستورات پایین‌تر در فایل تغییرات وضعیت ناشی از دستورات قبلی را می‌بینند. اگر \fBmpathpersist\fR هنگام پردازش یک خط در فایل دسته‌ای با خطایی مواجه شود، پردازش فایل دسته‌ای متوقف \fBنمی‌شود\fR؛ دستورات بعدی با وجود این اجرا خواهند شد. وضعیت خروج \fBmpathpersist\fR برابر با وضعیت اولین دستور ناموفق خواهد بود، یا اگر همه دستورات با موفقیت انجام شوند برابر 0 است.
.
.PP
اگر گزینه‌ها و پارامترهای دیگری همراه با \fI-f\fR در خط فرمان \fBmpathpersist\fR استفاده شوند، ابتدا خط فرمان اجرا می‌شود و به دنبال آن دستورات فایل دسته‌ای اجرا خواهند شد.
.
.PP
در زیر نمونه‌ای از یک فایل ورودی دسته‌ای معتبر آورده شده است.
.
.PP
.RS
.EX
# 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
.EE
.RE
.
.
.\" ----------------------------------------------------------------------------
.SH "همچنین ببینید (SEE ALSO)"
.\" ----------------------------------------------------------------------------
.
.BR multipath (8),
.BR multipathd (8),
.BR sg_persist (8).
.
.
.\" ----------------------------------------------------------------------------
.SH "نویسندگان (AUTHORS)"
.\" ----------------------------------------------------------------------------
.
\fImultipath-tools\fR توسط Christophe Varoqui <christophe.varoqui@opensvc.com> و دیگران توسعه یافته است.
.\" EOF