PMDATXMON(1)                General Commands Manual               PMDATXMON(1)

نام (NAME)
       pmdatxmon، txrecord، genload - عامل دامنه معیارهای کارایی txmon (معروف
       به PMDA)

خلاصه دستور (SYNOPSIS)
       $PCP_PMDAS_DIR/txmon/pmdatxmon [-D debug] [-d domain] [-l logfile] [-U
       username] tx_type ...
       $PCP_PMDAS_DIR/txmon/txrecord [-l]
       $PCP_PMDAS_DIR/txmon/txrecord tx_type servtime [tx_type servtime ... ]
       $PCP_PMDAS_DIR/txmon/genload

توضیحات (DESCRIPTION)
       برنامه pmdatxmon یک عامل دامنه معیارهای کارایی (PMDA) نمونه است که
       تعداد اندکی از معیارهای کارایی را از یک پایشگر تراکنش شبیه‌سازی‌شده
       استخراج کرده و ارائه می‌دهد.

       عامل txmon PMDA هم به‌صورت باینری و هم کد منبع عرضه می‌شود و با این هدف
       طراحی شده که کمکی برای توسعه‌دهندگان PMDA باشد؛ این PMDA نشان می‌دهد که
       داده‌های کارایی چگونه می‌توانند از یک برنامه کاربردی (در اینجا txrecord)
       از طریق یک قطعه حافظه اشتراکی به زیرساخت PCP صادر شوند. جهت آسودگی،
       pmdatxmon قطعه حافظه اشتراکی را ایجاد کرده (و هنگام خروج، آن را از بین
       می‌برد).

       آرگومان‌های tx_type برچسب‌های یکتا و دلخواهی هستند که برای شناسایی انواع
       گوناگون تراکنش استفاده می‌شوند.

       برنامه txrecord پردازش یک یا چند تراکنش شناسایی‌شده توسط tx_type و با
       زمان سرویس‌دهی مشاهده‌شدهٔ servtime را شبیه‌سازی می‌کند.

       با گزینهٔ -l، برنامه txrecord خلاصهٔ کنونی فعالیت‌های تراکنش را از قطعه
       حافظه اشتراکی نمایش می‌دهد.

       اسکریپت genload یک اسکریپت شل و awk(1) است که به عنوان رابطی برای
       txrecord عمل می‌کند تا باری ثابت از فعالیت‌های تراکنشی شبیه‌سازی‌شده ایجاد
       کند.

       شرح کوتاهی از گزینه‌های خط فرمان pmdatxmon در ادامه آمده است:

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

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

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

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

            # cd $PCP_PMDAS_DIR/txmon
            # ./Install

       برچسب‌های tx_type از شما پرسیده خواهد شد.

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

            # cd $PCP_PMDAS_DIR/txmon
            # ./Remove

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

فایل‌ها (FILES)
       $PCP_PMCDCONF_PATH
                 گزینه‌های خط فرمان استفاده‌شده برای راه‌اندازی pmdatxmon
       $PCP_PMDAS_DIR/txmon/help
                 فایل متن راهنمای پیش‌فرض برای معیارهای txmon
       $PCP_PMDAS_DIR/txmon/Install
                 اسکریپت نصب برای عامل pmdatxmon
       $PCP_PMDAS_DIR/txmon/Remove
                 اسکریپت حذف و بازگردانی برای عامل pmdatxmon
       $PCP_LOG_DIR/pmcd/txmon.log
                 فایل گزارش پیش‌فرض برای پیام‌های خطا و دیگر اطلاعات از
                 pmdatxmon

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

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

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

       ┌──────┬─────────────────────────┐
       │گزینه │ توضیحات                 │
       ├──────┼─────────────────────────┤
       │appl0 │ عملیات‌های حافظه اشتراکی │
       └──────┴─────────────────────────┘
همچنین ببینید (SEE ALSO)
       PCPIntro(1)، pmcd(1)، pmdasample(1)، pmdatrivial(1)، txmonvis(1) و
       PMDA(3).


Performance Co-Pilot                  PCP                         PMDATXMON(1)