'\"macro stdmacro
.\"
.\" Copyright (c) 2010 Josef 'Jeff' Sipek <jeffpc@josefsipek.net>
.\"
.\" 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 MRTG2PCP 1 "PCP" "Performance Co-Pilot"
.SH "نام (NAME)"
\f3mrtg2pcp\f1 \- وارد کردن داده‌های MRTG و ایجاد بایگانی PCP
.SH "خلاصه دستور (SYNOPSIS)"
\&\fBmrtg2pcp\fR \fIhostname\fR \fIdevname\fR \fItimezone\fR \fIinfile\fR \fIoutfile\fR
.SH "توضیحات (DESCRIPTION)"
\&\fBmrtg2pcp\fR برای خواندن یک فایل لاگ \s-1MRTG\s0 ایجادشده توسط \fBmrtg\fR(1) و تبدیل آن به یک بایگانی Performance Co-Pilot (\s-1PCP\s0) با نام پایهٔ \fIoutfile\fR در نظر گرفته شده است.
آرگومان‌های \fIhostname\fR، \fIdevname\fR و \fItimezone\fR اطلاعات مربوط به سیستمی را مشخص می‌کنند که آمارها برای آن جمع‌آوری شده‌اند.
.PP
بایگانی \s-1PCP\s0 حاصل می‌تواند با تمام ابزارهای کلاینت \s-1PCP\s0 برای رسم نمودار زیرمجموعه‌هایی از داده‌ها با استفاده از \fBpmchart\fR(1)، انجام کاهش داده‌ها و گزارش‌گیری، فیلتر کردن با موتور استنتاج \s-1PCP\s0 یعنی \fBpmie\fR(1) و غیره استفاده شود.
.PP
مجموعه‌ای از فایل‌های فیزیکی با پیشوند \fIoutfile\fR ایجاد خواهند شد.
این فایل‌ها عبارتند از \fIoutfile\fR\fB.0\fR (داده‌های کارایی)،
\&\fIoutfile\fR\fB.meta\fR (فراداده‌ای که داده‌های کارایی را توصیف می‌کند) و
\&\fIoutfile\fR\fB.index\fR (یک نمایهٔ زمانی برای بهبود کارایی عملیات بازپخش برای بایگانی).
اگر هر یک از این فایل‌ها از قبل وجود داشته باشد،
آن‌گاه \fBmrtg2pcp\fR روی آن‌ها بازنویسی \fBنخواهد\fR کرد و با پیام خطایی به این شکل خارج خواهد شد:
.PP
\&__pmLogNewFile: ``blah.0'' already exists, not over-written
.PP
دستور \&\fBmrtg2pcp\fR یک اسکریپت Perl است که از پوشش پرل PCP::LogImport پیرامون کتابخانهٔ \fIlibpcp_import\fR متعلق به \s-1PCP\s0 استفاده می‌کند و به همین ترتیب می‌تواند به عنوان نمونه‌ای برای توسعهٔ ابزارهای جدید جهت وارد کردن انواع دیگر داده‌های کارایی و ایجاد بایگانی‌های \s-1PCP\s0 مورد استفاده قرار گیرد.
.SH "محیط PCP (PCP ENVIRONMENT)"
متغیرهای محیطی با پیشوند \fBPCP_\fP برای مقداردهی پارامترهای نام فایل‌ها و دایرکتوری‌های مورد استفاده توسط PCP به کار می‌روند.
در هر نصب، فایل \fI/etc/pcp.conf\fP حاوی مقادیر محلی برای این متغیرها است.
متغیر \fB$PCP_CONF\fP می‌تواند برای مشخص کردن یک فایل پیکربندی جایگزین استفاده شود، همان‌طور که در \fBpcp.conf\fP(5) شرح داده شده است.
.SH "همچنین ببینید (SEE ALSO)"
.BR mrtg (1),
.BR pmchart (1),
.BR pmie (1),
.BR pmlogger (1),
.BR LOGIMPORT (3)
و
.BR PCP::LogImport (3).

.\" control lines for scripts/man-spell
.\" +ok+ MRTG {from MRTG2PCP}