نام (NAME)

pmdacisco - عامل دامنه معیارهای کارایی مسیریاب سیسکو (PMDA)

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

$PCP_PMDAS_DIR/cisco/pmdacisco [-D debug] [-d domain] [-l logfile] [-U username] [-P password] [-r refresh] [-s prompt] [-M username] [-x port] host:interface-spec [...]
$PCP_PMDAS_DIR/cisco/parse [گزینه‌ها] host:interface-spec [...]
$PCP_PMDAS_DIR/cisco/probe [-D debug] [-P password] [-s prompt] [-U username] [-x port] host

توضیحات (DESCRIPTION)

pmdacisco یک عامل دامنه معیارهای کارایی (PMDA) است که معیارهای کارایی را از یک یا چند مسیریاب Cisco استخراج می‌کند.

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

-d: بسیار حیاتی است که شماره دامنه ( domain ) معیارهای کارایی که در اینجا مشخص می‌شود، یکتا و سازگار باشد. بدین معنا که domain باید برای هر PMDA روی یک میزبان معین، متفاوت باشد و همان شماره domain باید برای همان PMDA در تمام میزبان‌ها استفاده شود.
-l: محل فایل گزارش. به‌طور پیش‌فرض، فایلی با نام cisco.log هنگام آغاز به کار pmdacisco در دایرکتوری جاری pmcd(1) یعنی $PCP_LOG_DIR/pmcd نوشته می‌شود. اگر فایل گزارش نتواند ایجاد شود یا قابل نوشتن نباشد، خروجی به‌جای آن در خطای استاندارد نوشته می‌شود.
-P: به‌طور پیش‌فرض، فرض می‌شود برای دسترسی به درگاه telnet سیسکو نیازی به گذرواژه در سطح کاربر نیست. اگر گذرواژه‌های سطح کاربر روی دستگاه‌های Cisco فعال شده باشند، باید آن گذرواژه‌ها به pmdacisco ارائه شوند. در صورت تعیین با گزینه -P، مقدار password به‌عنوان گذرواژه پیش‌فرض سطح کاربر برای تمام دستگاه‌های Cisco استفاده خواهد شد. همچنین بخش INTERFACE IDENTIFICATION در ادامه را ببینید.
-r: pmdacisco با برقراری ارتباط با هر مسیریاب Cisco در هر refresh ثانیه، مقادیر جاری را برای تمام معیارهای کارایی بازنشانی خواهد کرد. مقدار پیش‌فرض refresh برابر با ۱۲۰ ثانیه است.
-s: اعلان خط فرمان Cisco به رشته prompt ختم می‌شود. مقدار پیش‌فرض ``>'' است. تنها راهی که pmdacisco می‌تواند ارسال دستورها و تحلیل خروجی را همگام کند، شناسایی prompt به‌عنوان یک رشته منحصربه‌فرد است که در پایان تمام خروجی‌ها می‌آید، یعنی به‌عنوان اعلان خط فرمان هنگام انتظار برای دستور بعدی.
-U: به‌طور پیش‌فرض، فرض می‌شود برای دسترسی به درگاه telnet سیسکو به هیچ نام کاربری نیازی نیست. اگر ورود با نام کاربری روی دستگاه‌های Cisco فعال شده باشد، باید نام‌های کاربری مربوطه به pmdacisco ارائه شوند. در صورت تعیین با گزینه -U، مقدار username به‌عنوان نام کاربری پیش‌فرض برای تمام دستگاه‌های Cisco استفاده خواهد شد. همچنین بخش INTERFACE IDENTIFICATION در ادامه را ببینید.
-M: حساب کاربری که عامل تحت آن اجرا می‌شود. پیش‌فرض در نسخه‌های فعلی PCP حساب غیرممتاز "pcp" است، اما در نسخه‌های قدیمی‌تر از حساب کاربر ریشه ("root") به‌طور پیش‌فرض استفاده می‌شد.
-x: اتصال به Cisco از طریق شماره درگاه TCP port به‌جای درگاه پیش‌فرض ۲۳ برای اتصال telnet.

برای هر رابط، به‌محض برقراری اتصال telnet، pmdacisco حداکثر تا ۵ ثانیه منتظر می‌ماند تا Cisco یک تصویر لحظه‌ای (snapshot) جدید از اطلاعات درخواستی ارائه دهد. اگر این اتفاق نیفتد، اتصال telnet قطع شده و هیچ مقداری بازگردانده نمی‌شود. این کار مانع از آن می‌شود که pmdacisco در زمانی که پاسخ از سمت مسیریاب مطابق انتظار نیست (برای مثال اگر قالب خروجی ``show int'' تغییر کرده باشد یا دستور به‌دلیل پیکربندی نبودن رابط روی مسیریاب با خطا مواجه شود)، با انتظار نامحدود درگاه‌های telnet دستگاه Cisco را بیهوده مسدود نگه دارد..SH "شناسایی رابط (INTERFACE IDENTIFICATION)" از آنجا که هر روتر Cisco می‌تواند از چندین رابط شبکه و/یا چندین پروتکل ارتباطی پشتیبانی کند، ضروری است که به pmdacisco اعلام شود کدام رابط‌ها باید پایش شوند.

آرگومان‌های host:interface-spec در خط فرمان یک رابط مشخص را روی یک روتر Cisco خاص تعریف می‌کنند. host باید یک نام میزبان یا یک نشانی IP با ساختار نقطه‌دار (``dot-notation'') باشد که درگاه telnet یک روتر Cisco خاص را مشخص می‌کند. اجزای interface-spec به شرح زیر است:

protocol: یکی از اختصارات a، B، E، e، f، G، h، s یا Vl به ترتیب برای ATM، BRI (ISDN)، FastEthernet، Ethernet، FDDI، GigabitEthernet، HSSI، serial یا Vlan.
interface: بسته به مدل دستگاه Cisco، این مقدار یا یک عدد صحیح خواهد بود، مانند s0، یا یک عدد صحیح و به دنبال آن یک ممیز (``/'') و سپس شناسه زیررابط در یکی از انواع ساختارهای نحوی، مانند e1/0، G0/0/1 یا s4/2.1.

برای یافتن رابط‌های معتبر روی یک Cisco خاص، به درگاه telnet (با استفاده از telnet(1)) متصل شوید و دستور "show int" را وارد کنید و به دنبال شناسه‌های رابط پس از کلیدواژه‌های ``Ethernet''، ``Fddi''، ``Serial'' و غیره بگردید.

همچنین می‌توانید دستور probe را اجرا کنید.

username: اگر ورود به سیستم نیاز به نام کاربری داشته باشد و با مقدار پیش‌فرض متفاوت باشد (گزینه -U در بالا را ببینید)، می‌توان آن را به‌طور اختیاری با افزودن ``@'' و نام کاربری به انتهای interface-spec مشخص کرد.
password: اگر گذرواژه‌ای در سطح کاربر وجود داشته باشد و با مقدار پیش‌فرض متفاوت باشد (گزینه -P در بالا را ببینید)، می‌توان آن را به‌طور اختیاری با افزودن علامت سوال (``?'') و گذرواژه به انتهای interface-spec مشخص کرد.
prompt: اگر اعلان دستور (prompt) سیسکو با مقدار پیش‌فرض متفاوت باشد (گزینه -s در بالا را ببینید)، می‌توان آن را به‌طور اختیاری با افزودن علامت تعجب (``!'') و اعلان به انتهای interface-spec مشخص کرد.

موارد زیر نمونه‌هایی از آرگومان‌های معتبر interface-spec هستند:

my-router:e1/2
123.456.789.0:s0
wancisco:f2/3?trust_me
somecisco:G1/0!myprompt
cisco34.foo.bar.com:e2?way2cool
mycisco:s2/2.1@mylogin
yourcisco:E0/0@yourlogin?yourpassword
mycisco:E0/0@mylogin?mypassword!myprompt

ابزارهای کمکی (HELPER UTILITIES)

دستور probe می‌تواند برای یافتن نام تمام رابط‌های یک روتر Cisco خاص که با host مشخص شده است، استفاده شود. آرگومان -P مشابه همان مورد برای pmdacisco است.

دستور parse دقیقاً همان آرگومان‌های pmdacisco را می‌پذیرد، اما خارج از کنترل هرگونه pmcd(1) اجرا می‌شود و بنابراین می‌تواند برای عیب‌یابی مشکلات مربوط به مدیریت یک روتر Cisco خاص و/یا یکی از رابط‌های آن استفاده شود.

اطلاعات تشخیصی با جزئیات بیشتر را می‌توان با استفاده از گزینه خط فرمان -D appl0,appl1,appl2 تولید کرد. appl0 رویدادهای اتصال و قطع اتصال، روند ورود، جریان کنترل سطح‌بالا و آمارهای استخراج‌شده را ثبت می‌کند. appl1 تمام دستورهای ارسال‌شده به دستگاه Cisco را ردگیری می‌کند. appl2 توکن‌سازی و تجزیه خروجی دریافتی از دستگاه Cisco را ثبت می‌کند. اطلاعات تشخیصی با واکشی و تجزیه هر نمونه، روی خطای استاندارد (standard error) تولید می‌شوند..SH "نصب (INSTALLATION)" اگر می‌خواهید به نام‌ها، متن راهنما و مقادیر معیارهای کارایی Cisco دسترسی داشته باشید، مراحل زیر را با کاربر ریشه (root) انجام دهید:

# cd $PCP_PMDAS_DIR/cisco
# ./Install

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

# cd $PCP_PMDAS_DIR/cisco
# ./Remove

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

فایل‌ها (FILES)

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

محیط PCP (PCP ENVIRONMENT)

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

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

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

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

گزینه	توضیحات
appl0	مقداردهی اولیه، جزئیات پردازهٔ کارگر (worker)، تازه‌سازی داده‌ها، مهلت‌های زمانی (timeouts)
appl1	درخواست‌های ارسال‌شده به دستگاه Cisco
appl2	پویشگر واژگانی و تجزیه‌کننده برای خروجی از دستگاه Cisco

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

pmcd(1)، pcp.conf(5) و pcp.env(5).