PMDASIMPLE(1) General Commands Manual PMDASIMPLE(1)

pmdasimple - کارگزار سادهٔ دامنه معیارهای کارایی (PMDA)

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

برنامهٔ pmdasimple یک کارگزار دامنه معیارهای کارایی (PMDA) ساده است که تعداد اندکی از معیارهای کارایی ساختگی را صادر می‌کند.

کارگزار PMDA ساده به‌صورت کد منبع عرضه می‌شود و برای کمک به توسعه‌دهندگان PMDA طراحی شده است. از نظر حجم کد و قابلیت‌ها، از trivial PMDA پیچیده‌تر، تقریباً هم‌اندازهٔ txmon PMDA و ساده‌تر از sample PMDA است. کد منبع PMDA ساده یک الگوی مناسب است که می‌توان از روی آن PMDAهای سفارشی و آماده برای محیط عملیاتی را توسعه داد.

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

بسیار حیاتی است که شمارهٔ domain معیارهای کارایی که در اینجا مشخص می‌شود، یکتا و سازگار باشد. بدین معنا که domain باید برای هر PMDA روی یک میزبان متفاوت باشد، و از شمارهٔ domain یکسانی برای همان PMDA در تمامی میزبان‌ها استفاده شود.
انتظار دارد که PMCD به pmdasimple روی درگاه TCP/IP مشخص‌شده متصل شود. port می‌تواند یک شماره درگاه یا نام درگاه باشد.
مکان فایل گزارش (log). به‌طور پیش‌فرض، هنگامی که pmdasimple آغاز به کار می‌کند، فایل گزارشی به نام simple.log در دایرکتوری جاری pmcd(1) نوشته می‌شود؛ یعنی $PCP_LOG_DIR/pmcd. اگر فایل گزارش نتواند ایجاد شود یا قابل نوشتن نباشد، خروجی به‌جای آن در خروجی خطای استاندارد نوشته می‌شود.
انتظار دارد PMCD یک لوله (pipe) ایجاد کند و اتصال به pmdasimple از طریق ورودی استاندارد و خروجی استاندارد برقرار شود. این حالت، حالت اتصال پیش‌فرض است.
انتظار دارد PMCD به pmdasimple روی سوکت دامنه یونیکس به نام socket متصل شود.
حساب کاربری‌ای که کارگزار تحت آن اجرا می‌شود. در نسخه‌های کنونی PCP، پیش‌فرض حساب کاربری بی‌استفاده از امتیازات “pcp” است، اما در نسخه‌های قدیمی‌تر به‌طور پیش‌فرض از حساب کاربری مدیر سیستم (“root”) استفاده می‌شد.

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

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

# cd $PCP_PMDAS_DIR/simple
# ./Install

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

# cd $PCP_PMDAS_DIR/simple
# ./Remove

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

$PCP_PMCDCONF_PATH
گزینه‌های خط فرمان مورد استفاده برای راه‌اندازی pmdasimple
$PCP_PMDAS_DIR/simple/help
فایل متن راهنمای پیش‌فرض برای معیارهای simple
$PCP_PMDAS_DIR/simple/Install
اسکریپت نصب برای کارگزار pmdasimple
$PCP_PMDAS_DIR/simple/Remove
اسکریپت لغو نصب برای کارگزار pmdasimple
$PCP_PMDAS_DIR/simple/simple.conf
فایل پیکربندی برای دامنه نمونهٔ پویایی که زیربنای معیار کارایی simple.now است. برای توضیحات، به فایل متن راهنما مراجعه کنید، یا دستور زیر را اجرا نمایید:

$ pminfo -T simple.now

$PCP_PMDAS_DIR/simple/*.pmda_simple.so
نسخهٔ DSO کارگزار PMDA. از همان کد منبع برای ساخت هر دو نسخهٔ DSO و دیمن (daemon) از simple PMDA استفاده می‌شود، و یکی از این دو می‌تواند در جریان گفتگوی تعاملی در اسکریپت Install نصب شود.
$PCP_LOG_DIR/pmcd/simple.log
فایل گزارش پیش‌فرض برای پیام‌های خطا و سایر اطلاعات از pmdasimple

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

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

PCPIntro(1)، pmcd(1)، pmdasample(1)، pmdatrivial(1)، pmdatxmon(1)، PMDA(3)، pcp.conf(5) و pcp.env(5).

PCP Performance Co-Pilot