'\"macro stdmacro
.\"
.\" Copyright (C) 2016,2024 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 PMDALIBVIRT 1 "PCP" "Performance Co-Pilot"
.SH "نام (NAME)"
\f3pmdalibvirt\f1 \- عامل PMDA برای libvirt
.SH "توضیحات (DESCRIPTION)"
برنامه \fBpmdalibvirt\fP یک عامل دامنه معیارهای کارایی (PMDA) است که
داده‌های زنده کارایی را از هایپروایزر libvirt و دامنه‌ها (ماشین‌های مجازی) استخراج می‌کند.
.PP
برای توضیحات دقیق درباره هر معیار، مستندات libvirt را ببینید.
.SH "نصب (INSTALLATION)"
برنامه \fBpmdalibvirt\fP یک فایل پیکربندی اختیاری با ساختار ini را می‌خواند:
.IP
.PD 0
.RS +4
.IP \(bu 2
.I \f(CR$PCP_PMDAS_DIR\fP/libvirt/libvirt.conf
.RE
.PD
.PP
این فایل در بخش \fB[pmda]\fP خود می‌تواند شامل مقادیر جایگزین
برای گزینه‌های PMDA زیر باشد:
.IP
.PD 0
.RS +4
.IP \(bu 2
user
.IP \(bu
uri
.IP \(bu
backing
.RE
.PD
.PP
به‌طور پیش‌فرض، به ترتیب مقادیر \fBroot\fP، \fBqemu:///system\fP و \fBFalse\fP
به عنوان مقادیر این گزینه‌ها استفاده می‌شوند.
.PP
تنظیم backing می‌تواند برای بسط اطلاعات دستگاه‌های بلوکی جهت
پوشش زنجیره‌های پشتیبان (backing chains) در نسخه‌های جدید libvirt استفاده شود.
.PP
تنظیم old API می‌تواند در محیط‌هایی که امکانات جدید API مربوط به libvirt در دسترس نیستند
(مانند RHEL 6 / libvirt-0.10.2) به کار رود تا
برخی از معیارهای موجود در API جدیدتر را فراهم سازد.
صرف‌نظر از نسخه API، برای معیارهای کارایی به هیچ عامل مهمانی (guest agent) نیاز نیست.
.PP
توجه داشته باشید که استفاده از کاربری غیر از root معمولاً نیازمند
پیکربندی در سمت libvirt نیز می‌باشد؛ لطفاً برای جزئیات بیشتر در این زمینه به مستندات libvirt مراجعه کنید.
.PP
هنگامی که راه‌اندازی‌های لازم آماده شد، می‌توانید اتصال را آزمایش کرده و
PMDA را نصب کنید تا دسترسی به نام‌ها و مقادیر معیارهای کارایی libvirt فعال شود.
برای نصب، دستورات زیر را به عنوان کاربر ریشه (root) اجرا کنید:
.sp 1
.RS +4
.ft B
.nf
# cd $PCP_PMDAS_DIR/libvirt
# ./connect
# ./Install
.fi
.ft P
.RE
.sp 1
برای حذف نصب، دستورات زیر را به عنوان کاربر ریشه (root) اجرا کنید:
.sp 1
.RS +4
.ft B
.nf
# cd $PCP_PMDAS_DIR/libvirt
# ./Remove
.fi
.ft P
.RE
.sp 1
برنامه \fBpmdalibvirt\fP توسط \fBpmcd\fP(1) اجرا می‌شود و هرگز
نباید مستقیماً اجرا گردد.
اسکریپت‌های Install و Remove هنگامی که عامل نصب یا حذف می‌شود،
به \fBpmcd\fP(1) اطلاع می‌دهند.
.SH "فایل‌ها (FILES)"
.TP
.I \f(CR$PCP_PMDAS_DIR\fP/libvirt/libvirt.conf
فایل پیکربندی برای عامل \fBpmdalibvirt\fP
.TP
.I \f(CR$PCP_PMDAS_DIR\fP/libvirt/connect
ابزار کمکی آزمایش اتصال با استفاده از پیکربندی عامل \fBpmdalibvirt\fP
.TP
.I \f(CR$PCP_PMDAS_DIR\fP/libvirt/Install
اسکریپت نصب برای عامل \fBpmdalibvirt\fP
.TP
.I \f(CR$PCP_PMDAS_DIR\fP/libvirt/Remove
اسکریپت حذف نصب برای عامل \fBpmdalibvirt\fP
.TP
.I \f(CR$PCP_LOG_DIR\fP/pmcd/libvirt.log
فایل لاگ پیش‌فرض برای پیام‌های ارسال‌شده از عامل \fBpmdalibvirt\fP
.SH "محیط PCP (PCP ENVIRONMENT)"
متغیرهای محیطی با پیشوند \fBPCP_\fP برای پارامتریک‌سازی نام فایل‌ها و دایرکتوری‌های
مورد استفاده توسط PCP به کار می‌روند.
در هر نصب، فایل \fB/etc/pcp.conf\fP حاوی مقادیر محلی برای این متغیرها است.
متغیر \fB$PCP_CONF\fP ممکن است برای تعیین یک فایل پیکربندی جایگزین،
همان‌طور که در \fBpcp.conf\fP(5) شرح داده شده است، استفاده شود.
.SH "همچنین ببینید (SEE ALSO)"
.BR PCPIntro (1),
.BR pmcd (1),
.BR virsh (1)
و
.BR libvirtd (8).

.\" control lines for scripts/man-spell
.\" +ok+ pmdalibvirt libvirtd libvirt virsh RHEL qemu VMs uri