'\"macro stdmacro
.\"
.\" Copyright (c) 2018 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 PMDAPODMAN 1 "PCP" "Performance Co-Pilot"
.SH "نام (NAME)"
pmdapodman \- ایجنت دامنه سنجه‌های عملکردی (PMDA) برای کانتینرهای پادمن
.SH "خلاصه دستور (SYNOPSIS)"
\f3$PCP_PMDAS_DIR/podman/pmdapodman\f1
[\f3\-D\f1 \f2debug\f1]
[\f3\-d\f1 \f2domain\f1]
[\f3\-l\f1 \f2logfile\f1]
.SH "توضیحات (DESCRIPTION)"
دستور
.BR podman (1)
ابزاری برای مدیریت پادها، کانتینرها و ایمیج‌های کانتینری است که از مفهوم پادِ کانتینر (که توسط کوبرنتیز محبوب شد) پیروی می‌کند.
.B pmdapodman
یک ایجنت دامنه سنجه‌های عملکردی (PMDA) است که سنجه‌های عملکردی نشان‌دهنده وضعیت کانتینرها و پادهای مدیریت‌شده توسط پادمن را استخراج می‌کند.
.PP
ایجنت
.B podman
(PMDA) سنجه‌هایی را صادر می‌کند که اطلاعات مربوط به کانتینرهای منفرد و گروه‌هایی از کانتینرها (موسوم به پاد) را اندازه‌گیری می‌کنند.
.PP
شرح مختصری از گزینه‌های خط فرمان
.B pmdapodman
در ادامه آمده است:
.TP 5
.B \-d
بسیار حیاتی است که شماره
.I domain
(دامنه) سنجه‌های عملکردی مشخص‌شده در اینجا، یکتا و یکپارچه باشد.
بدین معنا که
.I domain
باید برای هر PMDA در یک میزبان متفاوت باشد، و همان شماره
.I domain
باید برای همان PMDA در تمام میزبان‌ها استفاده شود.
.TP
.B \-l
محل فایل لاگ (گزارش رویدادها). به‌طور پیش‌فرض، هنگامی که
.B pmdapodman
راه‌اندازی می‌شود، یک فایل لاگ به نام
.I podman.log
در دایرکتوری جاری
.BR pmcd (1)
(یعنی
.BR $PCP_LOG_DIR/pmcd )
نوشته می‌شود. اگر فایل لاگ قابل ایجاد نباشد یا دسترسی نوشتن نداشته باشد، خروجی به جای آن در خطای استاندارد (stderr) نوشته می‌شود.
.SH "نصب (INSTALLATION)"
ایجنت
.B podman
(PMDA) به‌طور پیش‌فرض در لینوکس نصب شده و در دسترس است.
اگر می‌خواهید نصب آن را لغو و حذف کنید، دستورات زیر را به عنوان کاربر ریشه (root) اجرا کنید:
.PP
.ft CR
.nf
.in +0.5i
# cd $PCP_PMDAS_DIR/podman
# ./Remove
.in
.fi
.ft 1
.PP
اگر پس از حذف، می‌خواهید مجدداً دسترسی به نام‌ها، متن راهنما و مقادیر سنجه‌های عملکرد پادمن را برقرار کنید، دستورات زیر را به عنوان کاربر ریشه (root) اجرا کنید:
.PP
.ft CR
.nf
.in +0.5i
# cd $PCP_PMDAS_DIR/podman
# ./Install
.in
.fi
.ft 1
.PP
برنامه
.B pmdapodman
توسط
.BR pmcd (1)
راه‌اندازی می‌شود و هرگز نباید مستقیماً اجرا شود.
اسکریپت‌های Install و Remove به
.BR pmcd (1)
هنگام نصب یا حذف ایجنت اطلاع می‌دهند.
.SH "فایل‌ها (FILES)"
.PD 0
.TP 10
.B $PCP_PMCDCONF_PATH
گزینه‌های خط فرمان استفاده‌شده برای اجرای
.B pmdapodman
.TP 10
.B $PCP_PMDAS_DIR/podman/help
فایل متنی راهنمای پیش‌فرض برای سنجه‌های پادمن
.TP 10
.B $PCP_PMDAS_DIR/podman/Install
اسکریپت نصب برای ایجنت
.B pmdapodman
.TP 10
.B $PCP_PMDAS_DIR/podman/Remove
اسکریپت لغو نصب برای ایجنت
.B pmdapodman
.TP 10
.B $PCP_LOG_DIR/pmcd/podman.log
فایل لاگ پیش‌فرض برای پیام‌های خطا و سایر اطلاعات از
.B pmdapodman
.PD
.SH "محیط PCP (PCP ENVIRONMENT)"
متغیرهای محیطی با پیشوند
.B PCP_
برای پارامتریک کردن نام فایل‌ها و دایرکتوری‌های مورد استفاده توسط PCP استفاده می‌شوند.
در هر نصب، فایل
.I /etc/pcp.conf
حاوی مقادیر محلی برای این متغیرها است.
از متغیر
.B $PCP_CONF
می‌توان برای مشخص کردن یک فایل پیکربندی جایگزین استفاده کرد، همان‌طور که در
.BR pcp.conf (5)
شرح داده شده است.
.SH "گزینه‌های اشکال‌زدایی (DEBUGGING OPTIONS)"
گزینه
.B \-D
یا
.B \-\-debug
خروجی عیب‌یابی تکمیلی را روی
.I stderr
فعال می‌کند تا به تفکیک و رفع مشکلات کمک کند، هرچند این اطلاعات گاهی پیچیده است و اساساً برای راهنمایی توسعه‌دهندگان در نظر گرفته شده است تا کاربران نهایی.
.I debug
فهرستی از گزینه‌های اشکال‌زدایی جداشده با کاما است؛ از
.BR pmdbg (1)
همراه با گزینه
.B \-l
برای به‌دست آوردن فهرستی از گزینه‌های اشکال‌زدایی موجود و معانی آن‌ها استفاده کنید.
.SH "همچنین ببینید (SEE ALSO)"
.BR PCPIntro (1),
.BR pmcd (1),
.BR podman (1),
.BR pcp.conf (5)
و
.BR pcp.env (5).

.\" control lines for scripts/man-spell
.\" +ok+ pmdapodman podman