'\"macro stdmacro
.\"
.\" Copyright (c) 2014 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 PMDAJBD2 1 "PCP" "Performance Co-Pilot"
.SH "نام (NAME)"
\f3pmdajbd2\f1 \- عامل دامنه معیارهای کارایی (PMDA) برای دستگاه بلوکی ژورنال (JBD)
.SH "خلاصه دستور (SYNOPSIS)"
\f3$PCP_PMDAS_DIR/jbd2/pmdajbd2\f1
[\f3\-D\f1 \f2debug\f1]
[\f3\-d\f1 \f2domain\f1]
[\f3\-l\f1 \f2logfile\f1]
[\f3\-j\f1 \f2path\f1]
[\f3\-U\f1 \f2username\f1]
.SH "توضیحات (DESCRIPTION)"
دستور
.B pmdajbd2
یک عامل دامنه معیارهای کارایی (PMDA) است که معیارهای کارایی را از زیرسیستم Journal Block Device (نسخه ۲) در هسته لینوکس استخراج می‌کند.
این معیارها توسط هسته در فایل‌های procfs، یک فایل به ازای هر دستگاه بلوکی، صادر می‌شوند.
زیرسیستم JBD2 توسط چندین سیستم‌فایل از جمله ext3، ext4 و ocfs2 استفاده می‌شود.
.PP
عامل
.B jbd2
معیارهایی را صادر می‌کند که اطلاعات دقیق تراکنش‌های ژورنال را اندازه‌گیری می‌کنند، از قبیل زمان صرف‌شده در انتظار و قفل‌بودن، نرخ درخواست‌ها، بلوک‌های استفاده‌شده و موارد دیگر.
.PP
در ادامه شرح کوتاهی از گزینه‌های خط فرمان
.B pmdajbd2
آمده است (این گزینه‌ها تنها زمانی کاربرد دارند که PMDA به عنوان یک دیمن اجرا شود، نه به عنوان یک کتابخانه مشترک):
.TP 5
.B \-d
بسیار حیاتی است که شماره
.I domain
(دامنه) معیارهای کارایی مشخص‌شده در اینجا یکتا و سازگار باشد.
بدین معنا که
.I domain
باید برای هر PMDA روی یک میزبان متفاوت باشد، و همان شماره
.I domain
باید برای همان PMDA روی تمام میزبان‌ها به کار رود.
.TP
.B \-l
مکان فایل گزارش (log). به طور پیش‌فرض، هنگام اجرا به صورت دیمن، یک فایل گزارش با نام
.I jbd2.log
در دایرکتوری جاری در زمان آغاز به کار
.B pmdajbd2
نوشته می‌شود، یعنی
.BR $PCP_LOG_DIR/pmcd .
اگر فایل گزارش قابل ایجاد نباشد یا امکان نوشتن روی آن وجود نداشته باشد، خروجی به جای آن در خطای استاندارد (stderr) نوشته خواهد شد.
هنگام اجرا در حالت کتابخانه مشترک، اطلاعات عیب‌یابی در فایل گزارش
.B pmcd
یعنی
.BR $PCP_LOG_DIR/pmcd/pmcd.log
نوشته می‌شود.
.TP
.B \-j
امکان تعیین یک مسیر جایگزین برای فایل‌های آماری jbd2 را فراهم می‌کند.
مسیر پیش‌فرض
.IR /proc/fs/jbd2
است.
.TP
.B \-U
حساب کاربری که عامل تحت آن اجرا می‌شود.
پیش‌فرض در نسخه‌های فعلی PCP، حساب غیرممتاز "pcp" است، اما در نسخه‌های قدیمی‌تر به صورت پیش‌فرض از حساب مدیر سیستم ("root") استفاده می‌شد.
.SH "نصب (INSTALLATION)"
این PMDA به طور پیش‌فرض و در حالت کتابخانه مشترک (به جای دیمن جداگانه برای
.BR pmcd (1))
نصب می‌شود.
بنابراین، نام‌ها، متن راهنما و مقادیر معیارهای کارایی jbd2 باید همیشه در دسترس باشند.
.PP
اگر از این معیارها استفاده نمی‌کنید، می‌توانید این PMDA را حذف کنید؛ برای این کار دستورهای زیر را با دسترسی root انجام دهید:
.PP
.ft CR
.nf
.in +0.5i
# cd $PCP_PMDAS_DIR/jbd2
# ./Remove
.in
.fi
.ft 1
.PP
اگر می‌خواهید مجدداً آن را فعال و نصب کنید، دستورهای زیر را به عنوان کاربر root انجام دهید:
.PP
.ft CR
.nf
.in +0.5i
# cd $PCP_PMDAS_DIR/jbd2
# ./Install
.in
.fi
.ft 1
.PP
دستور
.B pmdajbd2
توسط
.BR pmcd (1)
راه‌اندازی می‌شود و هرگز نباید به طور مستقیم اجرا شود.
اسکریپت‌های Install و Remove در زمان نصب یا حذف عامل، این موضوع را به
.BR pmcd (1)
اطلاع می‌دهند.
.SH "فایل‌ها (FILES)"
.PD 0
.TP 10
.B $PCP_PMCDCONF_PATH
گزینه‌های خط فرمان مورد استفاده برای راه‌اندازی
.B pmdajbd2
.TP 10
.B $PCP_PMDAS_DIR/jbd2/help
فایل متن راهنمای پیش‌فرض برای معیارهای jbd2
.TP 10
.B $PCP_PMDAS_DIR/jbd2/Install
اسکریپت نصب برای عامل
.B pmdajbd2
.TP 10
.B $PCP_PMDAS_DIR/jbd2/Remove
اسکریپت لغو نصب برای عامل
.B pmdajbd2
.TP 10
.B $PCP_LOG_DIR/pmcd/jbd2.log
فایل گزارش پیش‌فرض برای پیام‌های خطا و سایر اطلاعات از سوی
.B pmdajbd2
.PD
.SH "محیط PCP (PCP ENVIRONMENT)"
متغیرهای محیطی با پیشوند
.B PCP_
برای پارامتریک‌سازی نام فایل‌ها و پوشه‌های مورد استفاده در PCP به کار می‌روند.
در هر بار نصب، فایل
.I /etc/pcp.conf
حاوی مقادیر محلی برای این متغیرها است.
متغیر
.B $PCP_CONF
ممکن است برای تعیین یک فایل پیکربندی جایگزین استفاده شود، همان‌طور که در
.BR pcp.conf (5)
توضیح داده شده است.
.SH "گزینه‌های اشکال‌زدایی (DEBUGGING OPTIONS)"
گزینه
.B \-D
یا
.B \-\-debug
خروجی پیام‌های عیب‌یابی بیشتر را روی
.I stderr
فعال می‌سازد تا به ریشه‌یابی مشکلات کمک کند، گرچه این اطلاعات گاهی پیچیده بوده و اساساً به جای کاربران نهایی برای راهنمایی توسعه‌دهندگان طراحی شده‌اند.
آرگومان
.I debug
یک فهرست جداشده با کاما از گزینه‌های اشکال‌زدایی است؛ از
.BR pmdbg (1)
همراه با گزینه
.B \-l
برای به‌دست آوردن فهرستی از گزینه‌های اشکال‌زدایی موجود و معانی آن‌ها استفاده کنید.
.SH "همچنین ببینید (SEE ALSO)"
.BR PCPIntro (1)،
.BR pmcd (1)،
.BR pcp.conf (5)
و
.BR pcp.env (5).

.\" control lines for scripts/man-spell
.\" +ok+ pmdajbd procfs jbd fs {from /proc/fs/jbd2}
.\" +ok+ JBD ext ocfs {all from JBD filesystems ext2, ... ocfs2}