'\"macro stdmacro
.\"
.\" Copyright (c) 2013 Red Hat.
.\" Copyright (c) 2013 Ryan Doyle.
.\"
.\" 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 PMDANGINX 1 "PCP" "Performance Co-Pilot"
.SH "نام (NAME)"
pmdanginx \- عامل دامنه معیارهای عملکرد Nginx برای PCP
.SH "توضیحات (DESCRIPTION)"
برنامه
\f3pmdanginx\f1
یک عامل دامنه معیارهای عملکرد (\s-1PMDA\s0) است که معیارهای عملکرد را از
.BR nginx (8)
\- یک سرور HTTP و پراکسی معکوس، یک سرور پراکسی ایمیل و یک سرور پراکسی عمومی TCP \- صادر می‌کند.
.SH "نصب (INSTALLATION)"
این \s-1PMDA\s0 نیازمند آن است که ماژول
.B stub_status
در
.B nginx
فعال بوده و در نشانی
.BR http://localhost/nginx_status
در دسترس باشد.
.PP
به منظور فعال‌سازی این ماژول، بخش «server» در فایل پیکربندی
.I nginx.conf
باید شامل موارد زیر باشد:
.de CS
.in +0.5i
.ft CR
.nf
..
.de CE
.fi
.ft 1
.in
..
.PP
.CS
location /nginx_status {
    stub_status on;
    access_log off;
    allow 127.0.0.1;
    allow ::1;
    deny all;
}
.CE
.PP
در دسترس بودن ابزار سنجش را می‌توان با استفاده از این دستورات (بررسی زمان کامپایل و سپس زمان اجرا) اعتبارسنجی کرد:
.sp 1
.RS +4
.ft B
.nf
# nginx -V 2>&1 | grep -o with-http_stub_status_module
# curl http://localhost/nginx_status
.fi
.ft P
.RE
.sp 1
برای نصب \s-1PMDA\s0 مربوط به nginx، اسکریپت Install را با دسترسی ریشه (root) اجرا کنید:
.sp 1
.RS +4
.ft B
.nf
# cd $PCP_PMDAS_DIR/nginx
# ./Install
.fi
.ft P
.RE
.sp 1
برای حذف نصب، دستورات زیر باید با دسترسی ریشه (root) انجام شوند:
.sp 1
.RS +4
.ft B
.nf
# cd $PCP_PMDAS_DIR/nginx
# ./Remove
.fi
.ft P
.RE
.sp 1
عامل
\fBpmdanginx\fR
توسط
\fIpmcd\fR(1)
راه‌اندازی می‌شود و هرگز نباید به صورت مستقیم اجرا گردد. اسکریپت‌های Install و Remove هنگامی که عامل نصب یا حذف می‌شود، به
\fIpmcd\fR(1)
اطلاع‌رسانی می‌کنند.
.SH "فایل‌ها (FILES)"
.IP "\fB$PCP_PMDAS_DIR/nginx/nginx.conf\fR" 4
فایل پیکربندی اختیاری برای \fBpmdanginx\fR
.IP "\fB$PCP_PMDAS_DIR/nginx/Install\fR" 4
اسکریپت نصب برای عامل \fBpmdanginx\fR
.IP "\fB$PCP_PMDAS_DIR/nginx/Remove\fR" 4
اسکریپت لغو نصب برای عامل \fBpmdanginx\fR
.IP "\fB$PCP_LOG_DIR/pmcd/nginx.log\fR" 4
فایل لاگ پیش‌فرض برای پیام‌های خطای \fBpmdanginx\fR
.SH "محیط PCP (PCP ENVIRONMENT)"
متغیرهای محیطی با پیشوند
\fBPCP_\fR
برای پارامتریک‌سازی نام فایل‌ها و دایرکتوری‌های مورد استفاده توسط
\fBPCP\fR
به کار می‌روند. در هر نصب، فایل
\fB/etc/pcp.conf\fR
حاوی مقادیر محلی برای این متغیرها است. از متغیر
\fB$PCP_CONF\fR
می‌توان برای مشخص کردن یک فایل پیکربندی جایگزین استفاده کرد، همان‌طور که در
\fIpcp.conf\fR(5)
توضیح داده شده است.
.SH "همچنین ببینید (SEE ALSO)"
.BR PCPIntro (1),
.BR pmcd (1)
و
.BR nginx (8).

.\" control lines for scripts/man-spell
.\" +ok+ nginx_status stub_status access_log pmdanginx nginx