نام (NAME)

pmdasample - عامل نمونه دامنه معیارهای کارایی (PMDA)

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

$PCP_PMDAS_DIR/pmdasample [-D debug] [-d domain] [-i port] [-l logfile] [-p] [-u socket] [-U username]

توضیحات (DESCRIPTION)

pmdasample یک عامل دامنه معیارهای کارایی (PMDA) نمونه است که مجموعه‌ای متنوع از معیارهای کارایی ساختگی را صادر می‌کند.

این PMDA به عنوان بخشی از آزمون‌های تضمین کیفیت برای محصول PCP توسعه یافته است، اما کاربردهای دیگری نیز دارد، به ویژه در توسعه کلاینت‌های جدید PCP.

معیارهای صادرشده توسط PMDA نمونه، طیف کاملی از انواع داده، معناشناسی داده‌ها، چندگانگی مقادیر، پایداری دامنه نمونه و شرایط خطای موجود در PMDAهای واقعی را پوشش می‌دهند.

شرح مختصری از گزینه‌های خط فرمان pmdasample در ادامه آمده است:

-d: بسیار حیاتی است که شماره domain معیارهای کارایی که در اینجا مشخص می‌شود یکتا و سازگار باشد. بدین معنا که domain باید برای هر PMDA روی یک میزبان متفاوت باشد، و همان شماره domain باید برای یک PMDA مشابه روی تمام میزبان‌ها استفاده شود.
-i: انتظار می‌رود PMCD به pmdasample روی درگاه TCP/IP مشخص‌شده متصل شود. port می‌تواند یک شماره درگاه یا نام درگاه باشد.
-l: محل فایل لاگ. به طور پیش‌فرض، هنگامی که pmdasample راه‌اندازی می‌شود، یک فایل لاگ به نام sample.log در دایرکتوری جاری pmcd(1) نوشته می‌شود، یعنی $PCP_LOG_DIR/pmcd. اگر فایل لاگ نتواند ایجاد شود یا قابل نوشتن نباشد، خروجی به جای آن در خطای استاندارد نوشته می‌شود.
-p: انتظار می‌رود PMCD یک لوله (pipe) ایجاد کند و اتصال به pmdasample از طریق ورودی استاندارد و خروجی استاندارد باشد. این حالت اتصال پیش‌فرض است.
-u: انتظار می‌رود PMCD به pmdasample روی سوکت دامنه یونیکس به نام socket متصل شود.
-U: حساب کاربری که عامل تحت آن اجرا می‌شود. پیش‌فرض در نسخه‌های کنونی PCP حساب کاربری بدون امتیاز “pcp” است، اما در نسخه‌های قدیمی‌تر از حساب کاربری مدیر سیستم (“root”) به طور پیش‌فرض استفاده می‌شد.

حداکثر یکی از گزینه‌های -i، -p و -u می‌تواند مشخص شود.

نصب (INSTALLATION)

اگر به نام‌ها، متن راهنما و مقادیر معیارهای کارایی نمونه نیاز دارید، دستورات زیر را با دسترسی ریشه (root) انجام دهید:

# cd $PCP_PMDAS_DIR/sample
# ./Install

توجه داشته باشید که اسکریپت نصب نسخه DSO از PMDA نمونه را نیز نصب می‌کند، بنابراین در عمل دو PMDA و دو مجموعه از معیارهای کارایی نصب می‌شوند، یعنی sample.* و sampledso.*.

اگر می‌خواهید نصب را لغو کنید (و هر دو PMDA را حذف نمایید)، دستورات زیر را با دسترسی ریشه (root) انجام دهید:

# cd $PCP_PMDAS_DIR/sample
# ./Remove

pmdasample توسط pmcd(1) راه‌اندازی می‌شود و هرگز نباید مستقیماً اجرا شود. اسکریپت‌های Install و Remove هنگامی که عامل نصب یا حذف می‌شود به pmcd(1) اطلاع‌رسانی می‌کنند.

فایل‌ها (FILES)

$PCP_PMCDCONF_PATH: گزینه‌های خط فرمان مورد استفاده برای راه‌اندازی pmdasample
$PCP_PMDAS_DIR/sample/help: فایل متن راهنمای پیش‌فرض برای معیارهای نمونه
$PCP_PMDAS_DIR/sample/Install: اسکریپت نصب برای عامل pmdasample
$PCP_PMDAS_DIR/sample/Remove: اسکریپت لغو نصب برای عامل pmdasample
$PCP_LOG_DIR/pmcd/sample.log: فایل لاگ پیش‌فرض برای پیام‌های خطا و سایر اطلاعات از pmdasample

محیط PCP (PCP ENVIRONMENT)

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

گزینه‌های اشکال‌زدایی (DEBUGGING OPTIONS)

گزینه -D یا --debug خروجی عیب‌یابی‌های اضافی را روی stderr فعال می‌کند تا به بررسی مشکلات کمک کند، اگرچه اطلاعات گاهی مبهم بوده و عمدتاً برای راهنمایی توسعه‌دهندگان در نظر گرفته شده است تا کاربران نهایی. debug فهرستی از گزینه‌های اشکال‌زدایی جداشده با کاما است؛ از pmdbg(1) همراه با گزینه -l برای دریافت فهرستی از گزینه‌های اشکال‌زدایی موجود و معانی آن‌ها استفاده کنید.

گزینه‌های اشکال‌زدایی ویژه pmdasample به شرح زیر است:

گزینه	توضیحات
appl0	پیام‌های تشخیصی با جزئیات کامل برای دامنه‌های نمونه پویا و نگاشت معیارها

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

PCPIntro(1)، pmcd(1)، pmdasimple(1)، pmdatrivial(1)، pmdatxmon(1)، pcp.conf(5) و pcp.env(5).