'\"macro stdmacro
.\"
.\" Copyright (c) 2013-2016,2020 Red Hat.
.\" Copyright (c) 2000 Silicon Graphics, Inc.  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 PMREPCONF 1 "PCP" "Performance Co-Pilot"
.SH "نام (NAME)"
pmrepconf \- ساخت یا ویرایش فایل پیکربندی pmrep
.SH "خلاصه دستور (SYNOPSIS)"
\f3pmrepconf\f1
[\f3\-crvV?\f1]
[\f3\-D\f1 \f2debug\f1]
[\f3\-d\f2 groupsdir\f1]
[\f3\-g\f2 grouptag\f1]
[\f3\-o\f2 option\f1]
[\f3\-h\f2 host\f1]
\f2configfile\f1
.SH "توضیحات (DESCRIPTION)"
.B pmrepconf
می‌تواند برای ساخت و تغییر یک فایل پیکربندی عمومی برای
.BR pmrep (1)
و ابزارهای مرتبط در قالب
.BR pmrep.conf (5)
به کار رود.
.PP
اگر
.I configfile
وجود نداشته باشد،
.B pmrepconf
یک فایل پیکربندی عمومی به همراه مجموعه‌ای از معیارهای شناسایی‌شده در بخش [metrics] ایجاد خواهد کرد.
.PP
پس از ایجاد،
.I configfile
می‌تواند با گزینهٔ
.B \-c
همراه با
.BR pmrep (1)
و ابزارهای مرتبط مانند
.BR pcp2elasticsearch (2)
و
.BR pcp2spark (2)
استفاده شود.
.PP
اگر
.I configfile
وجود داشته باشد،
.B pmrepconf
از کاربر درخواست ورودی می‌کند تا گروه‌هایی از معیارهای کارایی مرتبط را فعال یا غیرفعال سازد.
.PP
انتخاب گروه نیازمند یک پاسخ سادهٔ
.B y
(بله)
یا
.B n
(خیر)
به اعلان
.BR "Log this group?"
است.
.PP
پاسخ‌های دیگر در این مرحله می‌توانند برای انتخاب توابع کنترلی بیشتر به شرح زیر استفاده شوند:
.IP \fBm\fP 10n
گزارش نام معیارهای موجود در گروه جاری.
.IP \fBq\fP 10n
پایان دادن به انتخاب گروه (خروج) و اعمال نکردن تغییرات بیشتر روی این گروه یا هر یک از گروه‌های بعدی.
.IP \fB/\fIpattern\fP 10n
تغییری در این گروه ایجاد نکن، اما به دنبال گروهی بگرد که شامل
.I pattern
در توضیحات گروه یا نام معیارهای مرتبط با آن باشد.
.PP
هنگام اجرا از فرآیندهای راه‌اندازی خودکار، گزینهٔ
.B \-c
برای نشان دادن این که
.I pmrepconf
در حالت ایجاد خودکار قرار دارد و هیچ گفتگوی تعاملی صورت نمی‌گیرد استفاده می‌شود.
فایل خروجی
.I configfile
دارای یک پیام توضیحی اضافی و برچسب زمانی است که این موضوع را نشان می‌دهد، تا بتوان آن را شناسایی کرد و بعداً با استفادهٔ مجدد از
.B \-c
به‌روزرسانی نمود.
این گزینه برای استفادهٔ تعاملی از ابزار مناسب نیست.
.PP
خروجی با جزئیات بیشتر را می‌توان با گزینهٔ
.B \-v
فعال کرد.
.SH "فایل‌های گروه راه‌اندازی (SETUP GROUP FILES)"
هنگامی که یک
.I configfile
اولیه ایجاد می‌شود، مشخصات پیش‌فرض از مجموعه‌ای از فایل‌های گروه در زیر
.I groupsdir
مشخص‌شده با گزینهٔ
.B \-d
دریافت می‌شوند (مقدار پیش‌فرض
.I groupsdir
برابر با
.B $PCP_VAR_DIR/config/pmlogconf
است که در اکثر موارد درست است، بنابراین گزینهٔ
.B \-d
در عمل به ندرت استفاده می‌شود).
.PP
ساختار دایرکتوری و قالب فایل‌های زیر
.I groupsdir
با ابزار
.B pmlogconf (1)
مشترک است و با جزئیات کامل در آن صفحهٔ راهنما توضیح داده شده است.
هنگامی که توسط
.B pmrepconf
استفاده می‌شود، تمام تنظیمات بازه زمانی نادیده گرفته می‌شوند.
.SH "گزینه‌ها (OPTIONS)"
گزینه‌های موجود خط فرمان عبارتند از:
.TP 5
\fB\-c\fR
فعال‌سازی حالت غیرتعاملی و ایجاد خودکار.
.TP
\fB\-d\fR \fIgroupsdir\fR, \fB\-\-groups\fR=\fIgroupsdir\fR
مسیر دایرکتوری \fIgroupsdir\fP را مشخص می‌کند.
.TP
\fB\-g\fR \fIgrouptag\fR, \fB\-\-group\fR=\fIgrouptag\fR
وضعیت ثبت گزارش برای گروه خاصی با نام \fIgrouptag\fP را پرس‌وجو می‌کند.
.TP
\fB\-h\fR \fIhost\fR, \fB\-\-host\fR=\fIhost\fR
منبع معیارهای کارایی،
.BR pmcd (1)
روی
.IR host
است، به جای پیش‌فرض localhost.
.TP
\fB\-o\fR \fIoption\fR, \fB\-\-option\fR=\fIoption\fR
گزینه‌ای را برای اضافه شدن به بخش [option] از فایل تولیدشدهٔ
.BR pmrep.conf (5)
مشخص می‌کند.
این گزینه خط فرمان می‌تواند چندین بار مشخص شود تا چندین خط در بخش [option] اضافه گردد.
.TP
\fB\-r\fR, \fB\-\-reprobe\fR
بررسی مجدد تمام گروه‌ها برای گنجاندن در \fIconfigfile\fP.
.TP
\fB\-v\fR, \fB\-\-verbose\fR
فعال‌سازی حالت باجزئیات (verbose).
.TP
\fB\-V\fR, \fB\-\-version\fR
نمایش شماره نسخه و خروج.
.TP
\fB\-?\fR, \fB\-\-help\fR
نمایش پیام راهنما و خروج.
.SH "محیط PCP (PCP ENVIRONMENT)"
متغیرهای محیطی با پیشوند \fBPCP_\fP برای پارامتریک‌سازی نام فایل‌ها و دایرکتوری‌های مورد استفاده PCP به کار می‌روند.
در هر نصب، فایل \fI/etc/pcp.conf\fP حاوی مقادیر محلی برای این متغیرها است.
متغیر \fB$PCP_CONF\fP می‌تواند برای مشخص کردن یک فایل پیکربندی جایگزین استفاده شود، همان‌طور که در \fBpcp.conf\fP(5) شرح داده شده است.
.PP
.B pmrepconf
به دلایل کارایی، مقدار هرگونه متغیر محیطی
.B $PCP_DERIVED_CONFIG
را با یک رشتهٔ خالی بازنویسی (override) می‌کند.
.PP
.B pmrepconf
هنگام کاوش و ایجاد فایل‌های پیکربندی جدید
.B pmrep
متغیر محیطی
.B $PMCD_WAIT_TIMEOUT
را رعایت می‌کند.
در صورت عدم تنظیم این متغیر در محیط، از مقدار پیش‌فرض زمان انتظار ۱۰ ثانیه برای این کار استفاده می‌کند.
.SH "گزینه‌های اشکال‌زدایی (DEBUGGING OPTIONS)"
گزینهٔ
.B \-D
یا
.B \-\-debug
خروجی اطلاعات تشخیصی اضافی را روی
.I stderr
فعال می‌کند تا به عیب‌یابی مشکلات کمک نماید، اگرچه این اطلاعات گاهی پیچیده و مبهم است و در درجه اول برای راهنمایی توسعه‌دهندگان در نظر گرفته شده تا کاربران نهایی.
.I debug
یک فهرست جداشده با کاما از گزینه‌های اشکال‌زدایی است؛ از
.BR pmdbg (1)
همراه با گزینهٔ
.B \-l
استفاده کنید تا فهرستی از گزینه‌های اشکال‌زدایی موجود و معانی آن‌ها را دریافت نمایید.
.SH "همچنین ببینید (SEE ALSO)"
.BR pcp2elasticsearch (1),
.BR pcp2spark (1),
.BR pmcd (1),
.BR pmlogconf (1),
.BR pmrep (1),
.BR pcp.conf (5),
.BR pcp.env (5)
و
.BR pmrep.conf (5)

.\" control lines for scripts/man-spell
.\" +ok+ groupsdir grouptag