'\" t
.\"
.\" 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 PMDAAPACHE 1 "PCP" "Performance Co-Pilot"
.SH "نام (NAME)"
\f3pmdaapache\f1 \- کارگزار دامنه معیارهای کارایی (PMDA) برای وب‌سرور Apache2
.SH "خلاصه دستور (SYNOPSIS)"
\f3$PCP_PMDAS_DIR/apache/pmdaapache\f1
[\f3\-D\f1 \f2debug\f1]
[\f3\-d\f1 \f2domain\f1]
[\f3\-l\f1 \f2logfile\f1]
[\f3\-U\f1 \f2username\f1]
[\f3\-S\f1 \f2server\f1]
[\f3\-P\f1 \f2port\f1]
[\f3\-L\f1 \f2location\f1]
.SH "توضیحات (DESCRIPTION)"
.B pmdaapache
یک کارگزار دامنه معیارهای کارایی (PMDA) است که معیارهای کارایی توصیف‌کننده وضعیت وب‌سرور Apache را استخراج می‌کند.
.PP
کارگزار
.B apache
معیارهایی را صادر می‌کند که نرخ درخواست‌ها، اندازه تجمعی درخواست‌ها، مدت‌زمان بالا بودن سرور (uptime) و وضعیت‌های مختلف اتصال را برای کلاینت‌های فعال اندازه‌گیری می‌کنند.
.PP
این اطلاعات با ارسال یک درخواست HTTP به آدرس اینترنتی (URL) وضعیت سرور به دست می‌آید که باید در فایل پیکربندی
.I httpd.conf
فعال شده باشد.
.P
.ft CR
.nf
.in +0.5i
ExtendedStatus on
<Location /server-status>
SetHandler server-status
Order deny,allow
Deny from all
Allow from localhost
</Location>
.in
.fi
.ft 1
.PP
شرح کوتاهی از گزینه‌های خط فرمان
.B pmdaapache
در ادامه آمده است:
.TP 5
.B \-d
بسیار حیاتی است که شماره
.I domain
(دامنه) معیارهای کارایی که در اینجا مشخص می‌شود، یکتا و سازگار باشد؛ بدین معنا که
.I domain
باید برای هر PMDA در یک میزبان متفاوت باشد، و همان شماره
.I domain
باید برای همان PMDA در تمام میزبان‌ها استفاده شود.
.TP
.B \-l
مکان فایل ثبت وقایع (لاگ). به‌طور پیش‌فرض، هنگام راه‌اندازی
.BR pmdaapache ،
فایل لاگی به نام
.I apache.log
در دایرکتوری جاری
.BR pmcd (1)
نوشته می‌شود، یعنی
.BR $PCP_LOG_DIR/pmcd .
اگر فایل لاگ ایجاد نشود یا قابل نوشتن نباشد، خروجی در خطای استاندارد نوشته خواهد شد.
.TP
.B \-S
پرس‌وجوی اطلاعات وضعیت Apache از
.I server
نام‌برده به‌جای میزبان محلی.
.TP
.B \-P
پرس‌وجوی اطلاعات وضعیت Apache از
.I port
مشخص‌شده به‌جای درگاه پیش‌فرض (80).
.TP
.B \-L
مشخص کردن یک
.I location
(مکان) جایگزین برای یافتن صفحه server-status.
.TP
.B \-U
حساب کاربری که کارگزار تحت آن اجرا می‌شود.
پیش‌فرض در نگارش‌های فعلی PCP، حساب غیرممتاز "pcp" است، اما در نگارش‌های قدیمی‌تر حساب کاربر ریشه ("root") به‌طور پیش‌فرض استفاده می‌شد.
.SH "نصب (INSTALLATION)"
اگر می‌خواهید به نام‌ها، متن راهنما و مقادیر معیارهای کارایی apache دسترسی داشته باشید، دستورهای زیر را با کاربر ریشه (root) انجام دهید:
.PP
.ft CR
.nf
.in +0.5i
# cd $PCP_PMDAS_DIR/apache
# ./Install
.in
.fi
.ft 1
.PP
اگر می‌خواهید نصب را لغو کنید، دستورهای زیر را با کاربر ریشه (root) انجام دهید:
.PP
.ft CR
.nf
.in +0.5i
# cd $PCP_PMDAS_DIR/apache
# ./Remove
.in
.fi
.ft 1
.PP
.B pmdaapache
توسط
.BR pmcd (1)
راه‌اندازی می‌شود و هرگز نباید به‌طور مستقیم اجرا گردد.
اسکریپت‌های Install و Remove به
.BR pmcd (1)
هنگام نصب یا حذف کارگزار اطلاع می‌دهند.
.SH "فایل‌ها (FILES)"
.PD 0
.TP 10
.B $PCP_PMCDCONF_PATH
گزینه‌های خط فرمان مورد استفاده برای راه‌اندازی
.B pmdaapache
.TP 10
.B $PCP_PMDAS_DIR/apache/help
فایل متن راهنمای پیش‌فرض برای معیارهای apache
.TP 10
.B $PCP_PMDAS_DIR/apache/Install
اسکریپت نصب برای کارگزار
.B pmdaapache
.TP 10
.B $PCP_PMDAS_DIR/apache/Remove
اسکریپت لغو نصب برای کارگزار
.B pmdaapache
.TP 10
.B $PCP_LOG_DIR/pmcd/apache.log
فایل لاگ پیش‌فرض برای پیام‌های خطا و سایر اطلاعات از
.B pmdaapache
.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
برای به‌دست آوردن فهرستی از گزینه‌های اشکال‌زدایی موجود و معانی آن‌ها استفاده کنید.
.PP
گزینه‌های اشکال‌زدایی مختص به
.B pmdaapache
به شرح زیر است:
.TS
box;
lf(B) | lf(B)
lf(B) | lf(R) .
گزینه	توضیحات
_
appl0	ردیابی هر فراخوانی refreshData()
_
appl1	گزارش اشکالات شناسایی‌شده در refreshData()
_
appl2	تخلیه داده‌های داخلی پس از هر فراخوانی refreshData()
.TE
.SH "همچنین ببینید (SEE ALSO)"
.BR PCPIntro (1)،
.BR httpd (8)،
.BR pmcd (1)،
.BR pcp.conf (5)
و
.BR pcp.env (5).

.\" control lines for scripts/man-spell
.\" +ok+ ExtendedStatus SetHandler refreshData