'\"macro stdmacro
.\"
.\" Copyright (c) 2017 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 PMDABIND2 1 "PCP" "Performance Co-Pilot"
.SH "نام (NAME)"
\f3pmdabind2\f1 \- عامل دامنه معیارهای عملکرد BIND (PMDA)
.SH "توضیحات (DESCRIPTION)"
این \s-1PMDA\s0 داده‌های عملکرد را از BIND (دامنه نام اینترنتی برکلی یا Berkeley Internet Name Domain) استخراج می‌کند.
این عامل امکان جمع‌آوری بیشتر معیارهای آماری را از کارساز Bind نسخه ۹ یا بالاتر فراهم می‌آورد، که شامل موارد زیر است:
.IP \[bu] 2
آمار کلی حافظه
.IP \[bu]
آمار کلی به ازای هر پرس‌وجو (پرس‌وجوهای عمومی، پاسخ‌های EDNS/کوتاه‌شده، پیام‌های Update/Notify/AXFR/IXFR)
.IP \[bu]
آمار کلی خطاها (Rejected، SERVFAIL، خطاهای Update/XFR و...)
.IP \[bu]
آمار کلی به ازای پروتکل انتقال، EDNS و نسخه پروتکل IP
.IP \[bu]
آمار تحلیل‌گر نام (resolver) (موفقیت‌ها، خطاها، زمان‌های رفت‌وبرگشت در چندین بازه)
.IP \[bu]
آمار تفصیلی به ازای هر سوکت با توجه به پروتکل انتقال و نسخه IP به همراه خطاها
.IP \[bu]
آمار تفصیلی به ازای هر توصیف‌کننده فایل شامل خطاها
.PP
این PMDA جمع‌آوری ثانیه‌ای کل مجموعه داده‌ها (۱۴۸ معیار در محیط آزمایشی) را با نیازمندی‌های سخت‌افزاری اندک (۲٪ مصرف پردازنده در Intel i7-4700MQ @2.4 GHz، حدود ۳۰ مگابایت RAM) انجام می‌دهد.
.P
اگر بیش از ۱ درخواست در ثانیه انجام شود، مقدارهای ذخیره‌شده در حافظه موقت (memoized) مورد استفاده قرار می‌گیرند تا رابط آماری کارساز Bind با بار اضافی مواجه نشود.
.SH "نصب (INSTALLATION)"
کارساز BIND را پیکربندی کنید تا آمار XML را از طریق رابط REST خود برون‌ریزی کند.
این کار نیازمند پیکربندی BIND برای فعال‌سازی برون‌ریزی آمار (دست‌کم) به صورت محلی است.
.sp 1
.RS +4
.ft B
.nf
statistics-channels {
\    inet 127.0.0.1 port 8080 allow { 127.0.0.1; };
}
options { zone-statistics yes; }
# ./Install
.fi
.ft P
.RE
.sp 1
نام میزبان (localhost)، درگاه (8080 در بالا) و سایر اطلاعات پیکربندی باید هم در فایل پیکربندی BIND و هم در فایل
\&\f(CR$PCP_PMDAS_DIR\fR/bind2/bind2.conf
مشخص شوند.
.sp 1
.RS +4
.ft B
.nf
# cd $PCP_PMDAS_DIR/bind2
# [ edit bind2.conf ]
\  host=localhost.localdomain:8080
.fi
.ft P
.RE
.sp 1
پس از راه‌اندازی، می‌توانید با انجام مراحل زیر با دسترسی ریشه (root)، به نام‌ها و مقدارهای معیارهای عملکرد bind2 دسترسی پیدا کنید:
.sp 1
.RS +4
.ft B
.nf
# cd $PCP_PMDAS_DIR/bind2
# ./Install
.fi
.ft P
.RE
.sp 1
برای لغو نصب، مراحل زیر باید با دسترسی ریشه (root) انجام شود:
.sp 1
.RS +4
.ft B
.nf
# cd $PCP_PMDAS_DIR/bind2
# ./Remove
.fi
.ft P
.RE
.sp 1
\fBpmdabind2\fR توسط \fIpmcd\fR(1) راه‌اندازی می‌شود و هرگز نباید مستقیماً اجرا گردد. اسکریپت‌های Install و Remove هنگامی که عامل نصب یا حذف می‌شود، به \fIpmcd\fR(1) اطلاع می‌دهند.
.SH "فایل‌ها (FILES)"
.IP "\fB$PCP_PMDAS_DIR/bind2/bind2.conf\fR" 4
فایل پیکربندی الزامی که نمونه‌های bind2 تحت نظارت را فهرست می‌کند
.IP "\fB$PCP_PMDAS_DIR/bind2/Install\fR" 4
اسکریپت نصب برای عامل \fBpmdabind2\fR
.IP "\fB$PCP_PMDAS_DIR/bind2/Remove\fR" 4
اسکریپت لغو نصب برای عامل \fBpmdabind2\fR
.IP "\fB$PCP_LOG_DIR/pmcd/bind2.log\fR" 4
فایل گزارش پیش‌فرض برای پیام‌های خطای \fBpmdabind2\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 pmdanamed (1),
.BR named.conf (5)
و
.BR named (8).

.\" control lines for scripts/man-spell
.\" +ok+ localdomain pmdanamed SERVFAIL memoized pmdabind EDNS AXFR
.\" +ok+ IXFR inet XFR cca MQ