'\" t
.\"
.\" Copyright (c) 2013 Red Hat.
.\"
.\" This program is free software; you can redistribute it and/or modify it
.\" under the terms of the GNU General Public License as published by the
.\" Free Software Foundation; either version 2 of the License, or (at your
.\" option) any later version.
.\"
.\" This program is distributed in the hope that it will be useful, but
.\" WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY
.\" or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License
.\" for more details.
.\"
.\"
.TH PMDAGFS2 1 "PCP" "Performance Co-Pilot"
.SH "نام (NAME)"
\f3pmdagfs2\f1 \- عامل PMDA برای سامانه فایل سرتاسری نسخه ۲ (GFS2)
.SH "خلاصه دستور (SYNOPSIS)"
\f3$PCP_PMDAS_DIR/gfs2/pmdagfs2\f1
[\f3\-D\f1 \f2debug\f1]
.SH "توضیحات (DESCRIPTION)"
.B pmdagfs2
یک عامل دامنه معیارهای کارایی (PMDA) است که مقادیر معیارها را درباره سامانه‌های فایل GFS2 سوارشده از سامانه فایل debugfs استخراج کرده و ارائه می‌دهد.
این PMDA برای ارائه داده‌های معیار، نیازمند سوار شدن debugfs به همراه حداقل یک سامانه فایل GFS2 سوارشده است.
.PP
این PMDA هم با سامانه‌های فایل GFS2 که به صورت محلی سوار شده‌اند و هم با سامانه‌های فایلی که به عنوان فضای ذخیره‌سازی مشترک درون یک محیط خوشه‌ای سوار شده‌اند قابل استفاده است. با این حال، معیارهایی وجود دارند که برای ارائه داده‌های معیار به طور مشخص نیاز به راه‌اندازی GFS2 در یک محیط خوشه‌ای دارند. دلیل این امر آن است که آن‌ها برای تولید خروجی خود انتظار دارند پیام‌های قفل‌گذاری از طریق مدیر توزیع‌شده قفل (DLM) میان گره‌های یک خوشه مبادله شوند.
.PP
این معیارهای مختص محیط خوشه‌ای را می‌توان با وجود معیارهای کنترلی متناظرشان تفکیک کرد تا بتوان در سیستم‌هایی که نیازی به نظارت بر آن‌ها نیست یا پشتیبانی نمی‌شوند، آن‌ها را به صورت اختیاری فعال یا غیرفعال کرد.
.PP
می‌توان از
.BR pmstore (3)
برای مقداردهی به این معیارهای کنترلی جهت فعال‌سازی (1) یا غیرفعال‌سازی (0) آن‌ها استفاده کرد.
این سازوکار همچنین در توزیع‌هایی که در حال حاضر پشتیبانی کاملی از نقاط ردیابی (trace-points) مربوط به GFS2 ندارند یا نسخه‌های قدیمی‌تری از گرداننده GFS2 را ارائه می‌دهند، مفید است.
.SH "نصب (INSTALLATION)"
عامل GFS2 PMDA را با استفاده از اسکریپت Install به عنوان کاربر ریشه (root) نصب کنید:
.sp 1
.RS +4
.ft B
.nf
# cd $PCP_PMDAS_DIR/gfs2
# ./Install
.fi
.ft P
.RE
.sp 1
.PP
برای حذف نصب، اقدامات زیر را به عنوان کاربر ریشه انجام دهید:
.sp 1
.RS +4
.ft B
.nf
# cd $PCP_PMDAS_DIR/gfs2
# ./Remove
.fi
.ft P
.RE
.sp 1
.PP
.B pmdagfs2
توسط
.BR pmcd (1)
راه‌اندازی می‌شود و هرگز نباید به طور مستقیم اجرا گردد.
اسکریپت‌های Install و Remove به محض نصب یا حذف عامل، به
.B pmcd
اطلاع‌رسانی می‌کنند.
.SH "فایل‌ها (FILES)"
.IP "\fB$PCP_PMDAS_DIR/gfs2/help\fR" 4
فایل متنی راهنمای پیش‌فرض برای معیارهای GFS2
.IP "\fB$PCP_PMDAS_DIR/gfs2/Install\fR" 4
اسکریپت نصب برای عامل \fBpmdagfs2\fR
.IP "\fB$PCP_PMDAS_DIR/gfs2/Remove\fR" 4
اسکریپت لغو نصب برای عامل \fBpmdagfs2\fR
.IP "\fB$PCP_LOG_DIR/pmcd/gfs2.log\fR" 4
فایل لاگ پیش‌فرض برای پیام‌های خطای \fBpmdagfs2\fR
.SH "محیط PCP (PCP ENVIRONMENT)"
متغیرهای محیطی با پیشوند \fBPCP_\fR برای پارامتریک‌سازی نام فایل‌ها و دایرکتوری‌های مورد استفاده توسط \fBPCP\fR به کار می‌روند. در هر نصب، فایل \fB/etc/pcp.conf\fR حاوی مقادیر محلی برای این متغیرها است. متغیر \fB$PCP_CONF\fR ممکن است برای مشخص کردن یک فایل پیکربندی جایگزین استفاده شود، همان‌طور که در \fIpcp.conf\fR(5) شرح داده شده است.
[\f3\-D\f1 \f2debug\f1]
.SH "گزینه‌های اشکال‌زدایی (DEBUGGING OPTIONS)"
گزینه
.B \-D
یا
.B \-\-debug
خروجی عیب‌یابی‌های تکمیلی را در
.I stderr
برای کمک به تفکیک و ریشه‌یابی مشکلات فعال می‌کند، اگرچه این اطلاعات گاهی پیچیده است و اساساً به منظور ارائه راهنمایی برای توسعه‌دهندگان در نظر گرفته شده تا کاربران نهایی.
.I debug
یک فهرست جداشده با کاما از گزینه‌های اشکال‌زدایی است؛ از
.BR pmdbg (1)
با گزینه
.B \-l
برای دریافت فهرستی از گزینه‌های اشکال‌زدایی موجود و مفهوم آن‌ها استفاده کنید.
.PP
گزینه‌های اشکال‌زدایی مختص به
.B pmdagfs2
به شرح زیر است:
.TS
box;
lf(B) | lf(B)
lf(B) | lxf(R) .
گزینه	توضیحات
_
appl0	T{
.ad l
جزئیات واکشی و تازه‌سازی sbstats و worst_glock
T}
.TE
.SH "همچنین ببینید (SEE ALSO)"
.BR PCPIntro (1)،
.BR pmcd (1)،
.BR pmstore (1)
و
.BR gfs2 (5).

.\" control lines for scripts/man-spell
.\" +ok+ debugfs pmdagfs GFS DLM gfs sbstats worst_glock