'\"macro stdmacro
.\"
.\" Copyright (c) 2012-2013, 2019 Red Hat.
.\" Copyright (c) 2010 Ken McDonell.  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 SAR2PCP 1 "PCP" "Performance Co-Pilot"
.SH "نام (NAME)"
\f3sar2pcp\f1 \- وارد کردن داده‌های sar و ساخت یک بایگانی PCP
.SH "خلاصه دستور (SYNOPSIS)"
\f3sar2pcp\f1 \fIinfile\fR \fIoutfile\fR
.SH "توضیحات (DESCRIPTION)"
ابزار \&\fBsar2pcp\fR برای خواندن یک فایل داده باینری گزارش‌گیری فعالیت سامانه (sar) که توسط \fBsadc\fR(1) ایجاد شده است (\fIinfile\fR) و تبدیل آن به یک بایگانی Performance Co-Pilot (\s-1PCP\s0) با نام پایه \fIoutfile\fR طراحی شده است.
.PP
با این حال، اگر \fIinfile\fR دارای پسوند «‎.xml» باشد، در نظر گرفته می‌شود که از پیش در قالب \s-1XML\s0 است و \fBsar2pcp\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 (یک نمایه‌ زمانی برای بهبود کارایی عملیات بازپخش بایگانی). اگر هر یک از این فایل‌ها از قبل وجود داشته باشد، \fBsar2pcp\fR روی آن‌ها بازنویسی نخواهد کرد (\fBnot\fR overwrite) و با یک پیام خطا با قالبی مشابه زیر خارج می‌شود:
.PP
_&__pmLogNewFile: ``blah.0'' already exists, not over-written
.PP
ابزار \&\fBsar2pcp\fR یک اسکریپت Perl است که از پوشش Perl به نام PCP::LogImport در اطراف کتابخانه \s-1PCP\s0 \fIlibpcp_import\fR استفاده می‌کند، و به همین جهت می‌تواند به عنوان یک الگو برای توسعه ابزارهای جدید جهت وارد کردن انواع دیگر داده‌های کارایی و ایجاد بایگانی‌های \s-1PCP\s0 به کار رود. یک ماژول پوشش Python نیز در دسترس است.
.SH "نکات (NOTES)"
از نسخه 12.0.5 بسته \fBsysstat\fR، به \fBsadc\fR(1) قابلیتی برای نوشتن مستقیم فایل‌های بایگانی \s-1PCP\s0 افزوده شده است.
برای تولید فایل‌های بایگانی از sar، دستور زیر را اجرا کنید:
.sp
.nf
$ sadf -l -O pcparchive=ARCHIVE_NAME sar.dat -- -A
.fi
.sp
.SH "هشدارها (CAVEATS)"
در صورت عدم استفاده از گزینه ورودی \s-1XML\s0، دستور \fBsar2pcp\fR نیازمند این است که \fIinfile\fR توسط نسخه‌ای از \fBsadc\fR(1) برگرفته از
.B http://sebastien.godard.pagesperso\-orange.fr
ایجاد شده باشد که شامل ابزار \fBsadf\fR(1) برای تبدیل \fIinfile\fR به یک جریان \s-1XML\s0 است (هر نسخه‌ای از نسخه 6 به بعد)؛ \&\fBsar2pcp\fR به طور خودکار \fBsadf\fR(1) را اجرا کرده و \s-1XML\s0 حاصل را به یک بایگانی \s-1PCP\s0 تبدیل خواهد کرد.
.PP
هنگام استفاده از فایل‌های باینری \fBsadc\fR، بسیار مهم است اطمینان حاصل شود که \fBsadf\fR نصب‌شده با نسخه \fBsadc\fR که در ابتدا فایل‌های باینری را ایجاد کرده سازگار باشد. صرفاً با این فرض که نسخه جدیدترِ نصب‌شده کار خواهد کرد متأسفانه بیش از حد خوش‌بینانه است؛ و همچنین نباید فرض کرد که داده‌های باینری از سکوهای مختلف (مثلاً با ترتیب بایت یا endianness متفاوت) کار خواهند کرد \- این مسائل به دلیل محدودیت‌های موجود در \fBsadc\fR و \fBsadf\fR است، نه خود \fBsar2pcp\fR.
.PP
خوشبختانه، پیام \fBsadf\fR که نشان می‌دهد ناسازگاری تشخیص داده شده است، در بین تمام نسخه‌ها یکنواخت بوده و همواره دارای پیشوند زیر است:
.PP
Invalid system activity file
.PP
استفاده از یک \fIinfile\fR با قالب \s-1XML\s0 این مزیت را دارد که نسخه نصب‌شده \fBsadf\fR به طور کامل نادیده گرفته می‌شود. \fBsar2pcp\fR متعهد است که هر \s-1XML\s0 معتبر تولید شده توسط هر یک از نگارش‌های مختلف \fBsadf\fR را به یک بایگانی معتبر \s-1PCP\s0 تبدیل کند. هر نسخه‌ای از \s-1PCP\s0 قادر خواهد بود فایل‌های بایگانی تولید شده توسط هر نسخه‌ای از \fBsar2pcp\fR را تفسیر کند، و همچنین شما آزاد هستید بایگانی باینری \s-1PCP\s0 را بین سکوهای مختلف، سخت‌افزارهای مختلف و حتی سیستم‌عامل‌های گوناگون انتقال دهید \- و بدون هیچ مشکلی کار خواهد کرد (\s-1TM\s0 Just Works).
.SH "محیط پی‌سی‌پی (PCP ENVIRONMENT)"
متغیرهای محیطی با پیشوند \fBPCP_\fP برای مقداردهی و پارامتربندی نام فایل‌ها و دایرکتوری‌های مورد استفاده توسط PCP به کار می‌روند. در هر نصب، فایل \fI/etc/pcp.conf\fP حاوی مقادیر محلی برای این متغیرها است. متغیر \fB$PCP_CONF\fP می‌تواند برای تعیین یک فایل پیکربندی جایگزین استفاده شود، همان‌طور که در \fBpcp.conf\fP(5) شرح داده شده است.
.PP
برای متغیرهای محیطی مؤثر بر ابزارهای PCP، به \fBpmGetOptions\fP(3) مراجعه کنید.
.SH "همچنین ببینید (SEE ALSO)"
.BR pmie (1)،
.BR pmchart (1)،
.BR pmlogger (1)،
.BR pmlogextract (1)،
.BR pmlogsummary (1)،
.BR sadc (1)،
.BR sadf (1)،
.BR sar (1)،
.BR Date::Parse (3pm)،
.BR Date::Format (3pm)،
.BR PCP::LogImport (3pm)،
.BR XML::TokeParser (3pm)
و
.BR LOGIMPORT (3).

.\" control lines for scripts/man-spell
.\" +ok+ ARCHIVE_NAME TM TokeParser achive dat {from .dat suffix} endianness
.\" +ok+ godard pagesperso pcparchive sadc sebastien
.\" +ok+ fr {from http://sebastien.godard.pagesperso\-orange.fr}