'\"macro stdmacro
.\"
.\" Copyright (c) 2014,2017 Red Hat.
.\" Copyright (c) 2012-2013 Chandana De Silva.
.\" Copyright (c) 2008 Aconex.  All Rights Reserved.
.\"
.\" 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 PMDAMYSQL 1 "PCP" "Performance Co-Pilot"
.SH "نام (NAME)"
pmdamysql \- واسط PMDA برای پایگاه‌های داده MySQL و MariaDB
.SH "توضیحات (DESCRIPTION)"
\f3pmdamysql\f1 یک \s-1PMDA\s0 در Performance Co-Pilot است که
داده‌های زنده کارایی را از یک پایگاه داده در حال اجرای MySQL یا MariaDB استخراج می‌کند.
.SH "نصب (INSTALLATION)"
\f3pmdamysql\f1 از یک فایل پیکربندی (به این ترتیب اولویت) استفاده می‌کند:
.IP "\(bu" 4
/etc/pcpdbi.conf
.IP "\(bu" 4
\&\f(CR$PCP_PMDAS_DIR\fR/mysql/mysql.conf
.PP
این فایل می‌تواند حاوی مقادیر بازنویسی‌شده (کد Perl) برای تنظیمات
فهرست‌شده در ابتدای pmdamysql.pl باشد، از جمله:
.IP "\(bu" 4
نام پایگاه داده (برای جزئیات به \s-1\fIDBI\s0\fR\|(3) مراجعه کنید، پیش‌فرض "DBI:mysql:mysql" است)
.IP "\(bu" 4
نام کاربری پایگاه داده (پیش‌فرض "dbmonitor" است)
.IP "\(bu" 4
رمز عبور پایگاه داده (پیش‌فرض "dbmonitor" است)
.IP "\(bu" 4
حساب کاربری ورود (پیش‌فرض "pcp" است)
.PP
در برخی نگارش‌های MariaDB (+10) طرح‌واره کارایی (performance schema) به صورت پیش‌فرض غیرفعال است
و برای عملکرد PMDA باید فعال گردد.
این امر با افزودن رشته "performance_schema" به
بخش "[mysqld]" فایل پیکربندی MariaDB (یا
.I my.cnf
یا
.IR my.ini )
حاصل می‌شود. عبارت SQL با عنوان "SHOW ENGINES" پشتیبانی از طرح‌واره کارایی را نمایش می‌دهد.
.PP
پس از تکمیل این اقدامات اولیه راه‌اندازی، می‌توانید با انجام اقدامات زیر با دسترسی کاربر ریشه (root)،
به نام‌ها و مقادیر معیارهای کارایی mysql دسترسی پیدا کنید:
.sp 1
.RS +4
.ft B
.nf
# cd $PCP_PMDAS_DIR/mysql
# ./Install
.fi
.ft P
.RE
.sp 1
برای حذف نصب، اقدامات زیر باید با دسترسی کاربر ریشه (root) انجام شود:
.sp 1
.RS +4
.ft B
.nf
# cd $PCP_PMDAS_DIR/mysql
# ./Remove
.fi
.ft P
.RE
.sp 1
دستور \fBpmdamysql\fR توسط \fIpmcd\fR(1) راه‌اندازی می‌شود و هرگز نباید به صورت
مستقیم اجرا گردد. اسکریپت‌های Install و Remove هنگام نصب یا حذف
عامل، به \fIpmcd\fR(1) اطلاع می‌دهند.
.SH "مقادیر وضعیت دودویی در متن (Binary Status values in text)"
برخی از مقادیر وضعیت به صورت \s-1YES/NO\s0 یا \s-1ON/OFF\s0 هستند.
.PP
از آنجا که این مقادیر توسط ابزارهایی مانند
.BR pmie (1)
قابل تفسیر نیستند، با یک پسوند _num و
مقادیر 1 (\s-1YES/ON\s0) یا 0 (\s-1NO/OFF\s0) تکرار شده‌اند.
.SS "مثال (Eg:)"
.IX Subsection "Eg:"
.IP "\(bu" 4
mysql.slave_status.slave_io_running
.IP "\(bu" 4
mysql.slave_status.slave_io_running_num
.SH "فایل‌ها (FILES)"
.IP "\fB/etc/pcpdbi.conf\fR" 4
فایل پیکربندی برای تمامی ناظرهای پایگاه داده \s-1PCP\s0
.ie n .IP "\fB$PCP_PMDAS_DIR/mysql/mysql.conf\f1" 4
.el .IP "\f(CR$PCP_PMDAS_DIR\fR/mysql/mysql.conf\f1" 4
فایل پیکربندی برای \fBpmdamysql\fR
.IP "\fB$PCP_PMDAS_DIR/mysql/Install\fR" 4
اسکریپت نصب برای عامل \fBpmdamysql\fR
.IP "\fB$PCP_PMDAS_DIR/mysql/Remove\fR" 4
اسکریپت حذف نصب برای عامل \fBpmdamysql\fR
.IP "\fB$PCP_LOG_DIR/pmcd/mysql.log\fR" 4
فایل گزارش پیش‌فرض برای پیام‌های خطای \fBpmdamysql\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 pmdadbping (1)،
.BR pmie (1)
و
.BR DBI (3).

.\" control lines for scripts/man-spell
.\" +ok+ slave_io_running_num performance_schema slave_io_running slave_status
.\" +ok+ pmdadbping dbmonitor pmdamysql pcpdbi mysqld mysql DBI
.\" +ok+ _num {from a _num extension}
.\" +ok+ cnf {from my.cnf}
.\" +ok+ Eg {from .SS "Eg:"} pl {from pmdamysql.pl}