'\"macro stdmacro
.\"
.\" Copyright (C) 2017-2018 Marko Myllynen <myllynen@redhat.com>
.\"
.\" 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 PMDAHAPROXY 1 "PCP" "Performance Co-Pilot"
.SH "نام (NAME)"
pmdahaproxy \- عامل دامنه معیارهای کارایی (PMDA) برای HAProxy
.SH "توضیحات (DESCRIPTION)"
دستور
.B pmdahaproxy
یک عامل دامنه معیارهای کارایی (PMDA) است که داده‌های زنده کارایی را از سوکت یا نشانی URL آمار HAProxy استخراج می‌کند.
.PP
به‌طور پیش‌فرض، سوکت آمار HAProxy برای بازیابی معیارها استفاده می‌شود، اما اگر گزینه اختیاری URL تنظیم شده باشد (پایین‌تر را ببینید)، به جای آن از نشانی URL مربوط به HAProxy استفاده می‌شود.
.PP
برای توضیحات دقیق درباره هر یک از معیارها، مستندات HAProxy را ببینید.
.SH "نصب (INSTALLATION)"
دستور
.B pmdahaproxy
یک فایل پیکربندی اختیاری با ساختار ini را می‌خواند:
.IP
.PD 0
.RS +4
.IP \(bu 2
.I \f(CR$PCP_PMDAS_DIR\fP/haproxy/haproxy.conf
.RE
.PD
.PP
این فایل می‌تواند در بخش
.B [pmda]
خود شامل مقادیر جایگزین برای گزینه‌های PMDA زیر باشد:
.IP
.PD 0
.RS +4
.IP \(bu 2
user
.IP \(bu
socket
.RE
.PD
.PP
به‌طور پیش‌فرض، به ترتیب
.B root
و
.B /var/lib/haproxy/stats
به‌عنوان مقادیر این گزینه‌ها استفاده می‌شوند.
.PP
این بخش همچنین می‌تواند شامل پارامترهای زیر باشد:
.IP
.PD 0
.RS +4
.IP \(bu 2
url
.IP \(bu
auth
.IP \(bu
pass
.RE
.PD
.PP
هنگامی که گزینه
.I url
تعریف شده باشد، اتصال URL به HAProxy استفاده می‌شود.
.B pmdahaproxy
انتظار دریافت داده‌های CSV را از نشانی URL مربوط به HAProxy دارد؛ نمونه‌ای از یک URL سازگار
.B http://127.0.0.1:9000/?stats;csv
است.
.PP
توجه داشته باشید که سوکت آمار و/یا نشانی URL مربوط به HAProxy باید به‌طور جداگانه در فایل پیکربندی HAProxy فعال شده باشند؛ لطفاً برای جزئیات به مستندات پیکربندی HAProxy مراجعه کنید. بسته به پیکربندی سیستم و HAProxy، استفاده از کاربر غیر ریشه (non-root) نیز ممکن است امکان‌پذیر باشد، به‌ویژه در اتصالات مبتنی بر URL.
.PP
پس از آماده‌سازی تنظیمات مورد نیاز، می‌توانید اتصال را آزمایش کرده و PMDA را نصب نمایید تا دسترسی به نام‌ها و مقادیر معیارهای کارایی HAProxy فعال گردد.
برای نصب، دستورات زیر را با دسترسی ریشه (root) اجرا کنید:
.sp 1
.RS +4
.ft B
.nf
# cd $PCP_PMDAS_DIR/haproxy
# ./connect
# ./Install
.fi
.ft P
.RE
.sp 1
برای لغو نصب، دستورات زیر را با دسترسی ریشه (root) اجرا کنید:
.sp 1
.RS +4
.ft B
.nf
# cd $PCP_PMDAS_DIR/haproxy
# ./Remove
.fi
.ft P
.RE
.sp 1
عامل
.B pmdahaproxy
توسط
.BR pmcd (1)
راه‌اندازی می‌شود و هرگز نباید به‌طور مستقیم اجرا گردد. اسکریپت‌های Install و Remove پس از نصب یا حذف شدن عامل، به
.BR pmcd (1)
اطلاع‌رسانی می‌کنند.
.SH "فایل‌ها (FILES)"
.TP
.I \f(CR$PCP_PMDAS_DIR\fP/haproxy/haproxy.conf
فایل پیکربندی برای عامل \fBpmdahaproxy\fR
.TP
.I \f(CR$PCP_PMDAS_DIR\fP/haproxy/connect
ابزار کمکی آزمایش اتصال با استفاده از پیکربندی عامل \fBpmdahaproxy\fR
.TP
.I \f(CR$PCP_PMDAS_DIR\fP/haproxy/Install
اسکریپت نصب برای عامل \fBpmdahaproxy\fR
.TP
.I \f(CR$PCP_PMDAS_DIR\fP/haproxy/Remove
اسکریپت لغو نصب برای عامل \fBpmdahaproxy\fR
.TP
.I \f(CR$PCP_LOG_DIR\fP/pmcd/haproxy.log
فایل گزارش وقایع (لاگ) پیش‌فرض برای پیام‌های دریافتی از عامل \fBpmdahaproxy\fR
.SH "محیط PCP (PCP ENVIRONMENT)"
متغیرهای محیطی با پیشوند
\fBPCP_\fR
برای پارامتریک‌سازی نام فایل‌ها و دایرکتوری‌های مورد استفاده توسط
\fBPCP\fR
به کار می‌روند. در هر نصب، فایل
\fI/etc/pcp.conf\fR
حاوی مقادیر محلی برای این متغیرها است. از متغیر
\fB$PCP_CONF\fR
می‌توان برای مشخص کردن یک فایل پیکربندی جایگزین استفاده کرد، همان‌طور که در
\fBpcp.conf\fR(5)
توضیح داده شده است.
.SH "همچنین ببینید (SEE ALSO)"
.BR PCPIntro (1)،
.BR haproxy (1)
و
.BR pmcd (1).

.\" control lines for scripts/man-spell
.\" +ok+ pmdahaproxy HAProxy haproxy auth url
.\" +ok+ csv {from http://127.0.0.1:9000/?stats;csv}