نام (NAME)

pmdashping - عامل دامنه معیارهای کارایی «shell-ping»

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

$PCP_PMDAS_DIR/shping/pmdashping [-C] [-D debug] [-d domain] [-l logfile] [-I interval] [-t timeout] [-U username] configfile

توضیحات (DESCRIPTION)

دستور pmdashping یک «عامل دامنه معیارهای کارایی» (PMDA) است که اندازه‌گیری‌های مربوط به کیفیت سرویس و زمان پاسخ‌دهی را برای دستورهای دلخواهی که ممکن است از طریق پوسته‌ای مانند sh(1) اجرا شوند، صادر می‌کند.

این اندازه‌گیری‌ها به منظور تعیین کمّی کیفیت و در دسترس بودن سرویس‌هایی طراحی شده‌اند که یا دارای اهمیت حیاتی هستند و یا به عنوان شاخص‌های زودهنگام افت کارایی سیستم عمل می‌کنند.

پیکربندی نمونه، این موارد را نظارت می‌کند: دستورهای ساده پوسته (exit و date(1))، یک وظیفه محاسباتی سنگین و کوتاه با استفاده از sum(1)، یک کامپایل کوتاه C، پرس‌وجوی DNS از طریق nslookup(1)، پرس‌وجوی YP از طریق ypcat(1)، سرویس bind/portmapper با استفاده از rpcbind(1)، سرویس SMTP از طریق اتصال به پورت 25 تلنت و ارسال درخواست «expn root»، و سرویس NNTP از طریق اتصال به پورت 119 تلنت و اجرای دستور «listgroup».

انتظار می‌رود سایر دستورها از نمونه‌های موجود در فایل پیکربندی نمونه الگوبرداری کنند و بیشتر پیاده‌سازی‌های PMDA برنامه pmdashping از یک فایل پیکربندی سفارشی استفاده نمایند.

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

-C

تجزیه و اعتبارسنجی configfile، گزارش هرگونه خطا و خروج با وضعیتی غیرصفر در صورت وجود خطاهای نحوی در فایل.

-d

بسیار حیاتی است که شماره domain (دامنه) معیارهای کارایی مشخص‌شده در اینجا یکتا و سازگار باشد. به این معنی که domain باید برای هر PMDA روی یک میزبان متفاوت باشد، و همان شماره domain باید برای همان PMDA روی تمام میزبان‌ها به کار رود.

-l

محل فایل لاگ. به طور پیش‌فرض، زمانی که pmdashping آغاز به کار می‌کند، فایلی به نام shping.log در دایرکتوری جاری pmcd(1) (یعنی $PCP_LOG_DIR/pmcd) نوشته می‌شود. اگر فایل لاگ قابل ایجاد نباشد یا امکان نوشتن در آن وجود نداشته باشد، خروجی به جای آن در خطای استاندارد نوشته می‌شود.

-I

میزان زمان (به ثانیه) بین اجراهای متوالی فهرست دستورهای ارائه‌شده از طریق فایل پیکربندی configfile. مقدار پیش‌فرض ۲ دقیقه است.

-t

میزان زمان (به ثانیه) برای انتظار پیش از سرآمدن زمان (timeout) هنگام دریافت پاسخ برای یک دستور از configfile. مقدار پیش‌فرض ۲۰ ثانیه است.

-U

حساب کاربری که عامل و تمامی دستورها تحت آن اجرا می‌شوند. پیش‌فرض در نسخه‌های فعلی PCP حساب غیرممتاز "pcp" است، اما در نسخه‌های قدیمی‌تر حساب کاربری ریشه ("root") به طور پیش‌فرض استفاده می‌شد.

فایل الزامی configfile جفت‌های «tag» (برچسب) و «command» (دستور) را مشخص می‌کند که هر کدام در یک خط جداگانه قرار دارند. تمام دستورها یکی پس از دیگری اجرا می‌شوند و کل مجموعه مجدداً برنامه‌ریزی می‌شود تا یک بار در هر interval اجرا گردد. به ازای هر دستوری که اجرا می‌شود، pmdashping اطلاعات مربوط به موفقیت (یا timeout)، وضعیت خروج، زمان سپری‌شده و زمان CPU (سیستمی و کاربری) را ثبت می‌کند و این اطلاعات توسط PMDA صادر می‌شود. برچسب‌ها برای شناسایی دستورهای منفرد در میان مقادیر صادرشده توسط PMDA استفاده می‌شوند و شناسه‌های دامنه نمونه خارجی را برای معیارهای pmdashping که به هر دستور مربوط می‌شوند، تشکیل می‌دهند.

نصب (INSTALLATION)

برای اینکه یک میزبان بتواند نام‌ها، متن راهنما و مقادیر معیارهای کارایی shping را صادر کند، دستورهای زیر را با دسترسی root انجام دهید:

# cd $PCP_PMDAS_DIR/shping
# ./Install

مجموعه جفت‌های «tag» و «command» را می‌توان از یک فایل پیکربندی پیش‌فرض (نمونه)، یک فایل سفارشی مشخص کرد یا به‌صورت تعاملی به عنوان بخشی از اسکریپت Install وارد نمود.

اگر می‌خواهید نصب را لغو کنید، دستورهای زیر را با دسترسی root انجام دهید:

# cd $PCP_PMDAS_DIR/shping
# ./Remove

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

فایل‌ها (FILES)

$PCP_PMCDCONF_PATH

گزینه‌های خط فرمان استفاده‌شده برای راه‌اندازی pmdashping

$PCP_PMDAS_DIR/shping/help

فایل متن راهنمای پیش‌فرض برای معیارهای shping

$PCP_PMDAS_DIR/shping/sample.conf

فایل پیکربندی نمونه شامل تعدادی از دستورهای رایج

$PCP_PMDAS_DIR/shping/Install

اسکریپت نصب برای عامل pmdashping

$PCP_PMDAS_DIR/shping/Remove

اسکریپت لغو نصب برای pmdashping

$PCP_LOG_DIR/pmcd/shping.log

فایل لاگ پیش‌فرض برای پیام‌های خطا و سایر اطلاعات از pmdashping

محیط PCP (PCP ENVIRONMENT)

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

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

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

گزینه‌های اشکال‌زدایی مخصوص pmdashping به شرح زیر است:

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

PCPIntro(1)، pmcd(1) و pcp-shping(1).