نام (NAME)

pmlogger_merge - اسکریپت کمکی برای ادغام بایگانی‌های Performance Co-Pilot

خلاصه دستور (SYNOPSIS)

$PCP_BINADM_DIR/pmlogger_merge [-fNVE?] [input-basename ... output-name]

توضیحات (DESCRIPTION)

pmlogger_merge یک اسکریپت کمکی است که توسط pmlogger_daily(1) هنگام ادغام تمام بایگانی‌های Performance Co-Pilot (PCP) مربوط به یک میزبان منفرد در یک روز مشخص، درون یک بایگانی ادغام‌شده PCP استفاده می‌شود.

pmlogger_merge یک اسکریپت پوششی برای pmlogextract(1) است که تمام بایگانی‌های منطبق با آرگومان‌های input-basename را ادغام کرده و با استفاده از output-name به‌عنوان نام پایه برای فایل‌های فیزیکی تشکیل‌دهنده بایگانی، یک بایگانی جدید ایجاد می‌کند. آرگومان‌های input-basename می‌توانند حاوی نویسه‌های عام به سبک sh(1) باشند.

اگر هر یک از فایل‌های تشکیل‌دهنده بایگانی‌های input-basename فشرده شده باشند، در صورت موفقیت، pmlogger_merge فایل‌های output-name را با استفاده از pmlogcompress(1) فشرده‌سازی خواهد کرد.

گزینه‌ها (OPTIONS)

گزینه‌های موجود خط فرمان عبارتند از:

-f, --force

این گزینه باعث می‌شود پس از ایجاد بایگانی خروجی، تمامی فایل‌های ورودی حذف شوند.

-N, --showme

اجرای pmlogger_merge در حالت «show me» یا «dry run» (اجرای آزمایشی) که در آن، وظایفی که قرار است انجام شوند گزارش می‌شوند اما هیچ تغییری اعمال نمی‌شود. این حالت معمولاً برای اشکال‌زدایی در ترکیب با یک گزینه -V (با جزئیات) یا دو گزینه -V (با جزئیات زیاد) استفاده می‌شود.

-V, --verbose

افزایش میزان جزئیات در گزارش پیشرفت خروجی.

-E, --expunge

هنگامی که تفاوت‌هایی در فراداده‌های سنجه‌ها بین بایگانی‌های مدنظر برای ادغام مشاهده شود، رفتار پیش‌فرض pmlogger_merge این است که با یک خطای مهلک متوقف شود و بایگانی output-name ایجاد نگردد. در عوض، پرچم -E یک هشدار صادر می‌کند و سنجه‌های متأثر را از بایگانی خروجی ادغام‌شده حذف می‌کند. این مورد برای چرخش خودکار روزانه بایگانی‌ها در نظر گرفته شده است، جایی که موفقیت‌آمیز بودن ادغام، بازنویسی و فشرده‌سازی بدون‌نظارت بایگانی‌های روزانه بسیار حائز اهمیت است. همچنین ببینید: pmlogger_daily(1) و پرچم -x در pmlogextract(1).

-?, --help

نمایش پیام راهنما و خروج.

محیط PCP (PCP ENVIRONMENT)

متغیرهای محیطی با پیشوند PCP_ برای پارامتربندی نام فایل‌ها و دایرکتوری‌های مورد استفاده PCP به کار می‌روند. در هر نصب، فایل /etc/pcp.conf حاوی مقادیر محلی برای این متغیرها است. متغیر $PCP_CONF می‌تواند برای تعیین یک فایل پیکربندی جایگزین استفاده شود، همان‌طور که در pcp.conf(5) شرح داده شده است.

همچنین ببینید (SEE ALSO)

PCPIntro(1), pmlogcompress(1), pmlogextract(1), pmlogger(1) و pmlogger_daily(1).