'\" t
.\"
.\" Copyright (c) 2012 Red Hat.
.\" Copyright (c) 2000-2002 Silicon Graphics, Inc.  All Rights Reserved.
.\"
.\" This program is free software; you can redistribute it and/or modify it
.\" under the terms of the GNU General Public License as published by the
.\" Free Software Foundation; either version 2 of the License, or (at your
.\" option) any later version.
.\"
.\" This program is distributed in the hope that it will be useful, but
.\" WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY
.\" or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License
.\" for more details.
.\"
.\"
.TH PMDACISCO 1 "PCP" "Performance Co-Pilot"
.SH "نام (NAME)"
\f3pmdacisco\f1 \- عامل دامنه معیارهای کارایی مسیریاب سیسکو (PMDA)
.SH "خلاصه دستور (SYNOPSIS)"
\f3$PCP_PMDAS_DIR/cisco/pmdacisco\f1
[\f3\-D\f1 \f2debug\f1]
[\f3\-d\f1 \f2domain\f1]
[\f3\-l\f1 \f2logfile\f1]
[\f3\-U\f1 \f2username\f1]
[\f3\-P\f1 \f2password\f1]
[\f3\-r\f1 \f2refresh\f1]
[\f3\-s\f1 \f2prompt\f1]
[\f3\-M\f1 \f2username\f1]
[\f3\-x\f1 \f2port\f1]
\f2host:interface-spec\f1 [...]
.br
\f3$PCP_PMDAS_DIR/cisco/parse\f1
[گزینه‌ها]
\f2host:interface-spec\f1 [...]
.br
\f3$PCP_PMDAS_DIR/cisco/probe\f1
[\f3\-D\f1 \f2debug\f1]
[\f3\-P\f1 \f2password\f1]
[\f3\-s\f1 \f2prompt\f1]
[\f3\-U\f1 \f2username\f1]
[\f3\-x\f1 \f2port\f1]
\f2host\f1
.SH "توضیحات (DESCRIPTION)"
.B pmdacisco
یک عامل دامنه معیارهای کارایی (PMDA) است که معیارهای کارایی را از یک یا چند مسیریاب Cisco استخراج می‌کند.
.PP
شرح مختصری از گزینه‌های خط فرمان
.B pmdacisco
در ادامه آمده است:
.TP 5
.B \-d
بسیار حیاتی است که شماره دامنه (
.IR domain
) معیارهای کارایی که در اینجا مشخص می‌شود، یکتا و سازگار باشد.
بدین معنا که
.I domain
باید برای هر PMDA روی یک میزبان معین، متفاوت باشد و همان شماره
.I domain
باید برای همان PMDA در تمام میزبان‌ها استفاده شود.
.TP 5
.B \-l
محل فایل گزارش. به‌طور پیش‌فرض، فایلی با نام
.I cisco.log
هنگام آغاز به کار
.B pmdacisco
در دایرکتوری جاری
.BR pmcd (1)
یعنی
.IR $PCP_LOG_DIR/pmcd
نوشته می‌شود. اگر فایل گزارش نتواند ایجاد شود یا قابل نوشتن نباشد، خروجی به‌جای آن در خطای استاندارد نوشته می‌شود.
.TP 5
.B \-P
به‌طور پیش‌فرض، فرض می‌شود برای دسترسی به درگاه telnet سیسکو نیازی به گذرواژه در سطح کاربر نیست. اگر گذرواژه‌های سطح کاربر روی دستگاه‌های Cisco فعال شده باشند، باید آن گذرواژه‌ها به
.B pmdacisco
ارائه شوند. در صورت تعیین با گزینه
.BR \-P ،
مقدار
.I password
به‌عنوان گذرواژه پیش‌فرض سطح کاربر برای تمام دستگاه‌های Cisco استفاده خواهد شد. همچنین بخش INTERFACE IDENTIFICATION در ادامه را ببینید.
.TP 5
.B \-r
.B pmdacisco
با برقراری ارتباط با هر مسیریاب Cisco در هر
.I refresh
ثانیه، مقادیر جاری را برای تمام معیارهای کارایی بازنشانی خواهد کرد.
مقدار پیش‌فرض
.I refresh
برابر با ۱۲۰ ثانیه است.
.TP 5
.B \-s
اعلان خط فرمان Cisco به رشته
.I prompt
ختم می‌شود. مقدار پیش‌فرض ``>'' است.
تنها راهی که
.B pmdacisco
می‌تواند ارسال دستورها و تحلیل خروجی را همگام کند، شناسایی
.I prompt
به‌عنوان یک رشته منحصربه‌فرد است که در پایان تمام خروجی‌ها می‌آید، یعنی به‌عنوان اعلان خط فرمان هنگام انتظار برای دستور بعدی.
.TP 5
.B \-U
به‌طور پیش‌فرض، فرض می‌شود برای دسترسی به درگاه telnet سیسکو به هیچ نام کاربری نیازی نیست. اگر ورود با نام کاربری روی دستگاه‌های Cisco فعال شده باشد، باید نام‌های کاربری مربوطه به
.B pmdacisco
ارائه شوند. در صورت تعیین با گزینه
.BR \-U ،
مقدار
.I username
به‌عنوان نام کاربری پیش‌فرض برای تمام دستگاه‌های Cisco استفاده خواهد شد. همچنین بخش INTERFACE IDENTIFICATION در ادامه را ببینید.
.TP 5
.B \-M
حساب کاربری که عامل تحت آن اجرا می‌شود.
پیش‌فرض در نسخه‌های فعلی PCP حساب غیرممتاز "pcp" است، اما در نسخه‌های قدیمی‌تر از حساب کاربر ریشه ("root") به‌طور پیش‌فرض استفاده می‌شد.
.TP 5
.B \-x
اتصال به Cisco از طریق شماره درگاه TCP
.I port
به‌جای درگاه پیش‌فرض ۲۳ برای اتصال telnet.
.PP
برای هر رابط، به‌محض برقراری اتصال telnet،
.B pmdacisco
حداکثر تا ۵ ثانیه منتظر می‌ماند تا Cisco یک تصویر لحظه‌ای (snapshot) جدید از اطلاعات درخواستی ارائه دهد. اگر این اتفاق نیفتد، اتصال telnet قطع شده و هیچ مقداری بازگردانده نمی‌شود. این کار مانع از آن می‌شود که
.B pmdacisco
در زمانی که پاسخ از سمت مسیریاب مطابق انتظار نیست (برای مثال اگر قالب خروجی ``show int'' تغییر کرده باشد یا دستور به‌دلیل پیکربندی نبودن رابط روی مسیریاب با خطا مواجه شود)، با انتظار نامحدود درگاه‌های telnet دستگاه Cisco را بیهوده مسدود نگه دارد..SH "شناسایی رابط (INTERFACE IDENTIFICATION)"
از آنجا که هر روتر Cisco می‌تواند از چندین رابط شبکه و/یا چندین پروتکل ارتباطی پشتیبانی کند، ضروری است که به
.B pmdacisco
اعلام شود کدام رابط‌ها باید پایش شوند.
.PP
آرگومان‌های
.I host:interface-spec
در خط فرمان یک رابط مشخص را روی یک روتر Cisco خاص تعریف می‌کنند.
.I host
باید یک نام میزبان یا یک نشانی IP با ساختار نقطه‌دار (``dot-notation'') باشد که درگاه telnet یک روتر Cisco خاص را مشخص می‌کند.
اجزای
.I interface-spec
به شرح زیر است:
.TP
protocol
یکی از اختصارات
.BR a ،
.BR B ،
.BR E ،
.BR e ،
.BR f ،
.BR G ،
.BR h ،
.B s
یا
.B Vl
به ترتیب برای ATM، BRI (ISDN)، FastEthernet، Ethernet، FDDI، GigabitEthernet، HSSI، serial یا Vlan.
.TP
interface
بسته به مدل دستگاه Cisco، این مقدار یا یک عدد صحیح خواهد بود، مانند\&
.BR s0 ،
یا یک عدد صحیح و به دنبال آن یک ممیز (``/'') و سپس شناسه زیررابط در یکی از انواع ساختارهای نحوی، مانند\&
.BR e1/0 ،
.B G0/0/1
یا
.BR s4/2.1 .
.RS
.P
برای یافتن رابط‌های معتبر روی یک Cisco خاص، به درگاه telnet (با استفاده از
.BR telnet (1))
متصل شوید و دستور "show int" را وارد کنید و به دنبال شناسه‌های رابط پس از کلیدواژه‌های ``Ethernet''، ``Fddi''، ``Serial'' و غیره بگردید.
.P
همچنین می‌توانید دستور
.B probe
را اجرا کنید.
.RE
.TP
username
اگر ورود به سیستم نیاز به نام کاربری داشته باشد و با مقدار پیش‌فرض متفاوت باشد (گزینه
.B \-U
در بالا را ببینید)، می‌توان آن را به‌طور اختیاری با افزودن
\&``@'' و نام کاربری به انتهای
.IR interface-spec
مشخص کرد.
.TP
password
اگر گذرواژه‌ای در سطح کاربر وجود داشته باشد و با مقدار پیش‌فرض متفاوت باشد (گزینه
.B \-P
در بالا را ببینید)، می‌توان آن را به‌طور اختیاری با افزودن علامت سوال (``?'') و گذرواژه به انتهای
.IR interface-spec
مشخص کرد.
.TP
prompt
اگر اعلان دستور (prompt) سیسکو با مقدار پیش‌فرض متفاوت باشد (گزینه
.B \-s
در بالا را ببینید)، می‌توان آن را به‌طور اختیاری با افزودن علامت تعجب (``!'') و اعلان به انتهای
.IR interface-spec
مشخص کرد.
.PP
موارد زیر نمونه‌هایی از آرگومان‌های معتبر
.I interface-spec
هستند:
.in +1i
.nf
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
.fi
.in
.SH "ابزارهای کمکی (HELPER UTILITIES)"
دستور
.B probe
می‌تواند برای یافتن نام تمام رابط‌های یک روتر Cisco خاص که با
.IR host
مشخص شده است، استفاده شود.
آرگومان
.B \-P
مشابه همان مورد برای
.B pmdacisco
است.
.PP
دستور
.B parse
دقیقاً همان آرگومان‌های
.B pmdacisco
را می‌پذیرد، اما خارج از کنترل هرگونه
.BR pmcd (1)
اجرا می‌شود و بنابراین می‌تواند برای عیب‌یابی مشکلات مربوط به مدیریت یک روتر Cisco خاص و/یا یکی از رابط‌های آن استفاده شود.
.PP
اطلاعات تشخیصی با جزئیات بیشتر را می‌توان با استفاده از گزینه خط فرمان
.B "\-D appl0,appl1,appl2"
تولید کرد.
.B appl0
رویدادهای اتصال و قطع اتصال، روند ورود، جریان کنترل سطح‌بالا و آمارهای استخراج‌شده را ثبت می‌کند.
.B appl1
تمام دستورهای ارسال‌شده به دستگاه Cisco را ردگیری می‌کند.
.B appl2
توکن‌سازی و تجزیه خروجی دریافتی از دستگاه Cisco را ثبت می‌کند.
اطلاعات تشخیصی با واکشی و تجزیه هر نمونه، روی خطای استاندارد (standard error) تولید می‌شوند..SH "نصب (INSTALLATION)"
اگر می‌خواهید به نام‌ها، متن راهنما و مقادیر معیارهای کارایی Cisco دسترسی داشته باشید، مراحل زیر را با کاربر ریشه (root) انجام دهید:
.PP
.ft CR
.nf
.in +0.5i
# cd $PCP_PMDAS_DIR/cisco
# ./Install
.in
.fi
.ft 1
.PP
اگر می‌خواهید نصب را لغو کنید، کارهای زیر را با کاربر ریشه (root) انجام دهید:
.PP
.ft CR
.nf
.in +0.5i
# cd $PCP_PMDAS_DIR/cisco
# ./Remove
.in
.fi
.ft 1
.PP
.B pmdacisco
توسط
.BR pmcd (1)
راه‌اندازی می‌شود و هرگز نباید به‌صورت مستقیم اجرا شود.
اسکریپت‌های Install و Remove هنگامی که عامل نصب یا حذف می‌شود، به
.BR pmcd (1)
اطلاع‌رسانی می‌کنند.
.SH "فایل‌ها (FILES)"
.PD 0
.TP 10
.B $PCP_PMCDCONF_PATH
گزینه‌های خط فرمان مورد استفاده برای راه‌اندازی
.B pmdacisco
.TP 10
.B $PCP_PMDAS_DIR/cisco/help
فایل متنی پیش‌فرض راهنما برای معیارهای Cisco
.TP 10
.B $PCP_PMDAS_DIR/cisco/Install
اسکریپت نصب برای عامل
.B pmdacisco
.TP 10
.B $PCP_PMDAS_DIR/cisco/Remove
اسکریپت لغو نصب برای عامل
.B pmdacisco
.TP 10
.B $PCP_LOG_DIR/pmcd/cisco.log
فایل گزارش پیش‌فرض برای پیام‌های خطا و اطلاعات دیگر از
.B pmdacisco
.PD
.SH "محیط PCP (PCP ENVIRONMENT)"
متغیرهای محیطی با پیشوند
.B PCP_
برای پارامتریک‌سازی نام فایل‌ها و دایرکتوری‌های مورد استفاده توسط PCP به کار می‌روند.
در هر نصب، فایل
.I /etc/pcp.conf
حاوی مقادیر محلی برای این متغیرها است.
متغیر
.B $PCP_CONF
ممکن است برای تعیین یک فایل پیکربندی جایگزین، همان‌طور که در
.BR pcp.conf (5)
توصیف شده است، استفاده شود.
.SH "گزینه‌های اشکال‌زدایی (DEBUGGING OPTIONS)"
گزینهٔ
.B \-D
یا
.B \-\-debug
خروجی خطایابی تکمیلی را روی
.I stderr
فعال می‌کند تا به عیب‌یابی مشکلات کمک کند، اگرچه این اطلاعات گاهی مبهم هستند و در وهله اول برای راهنمایی توسعه‌دهندگان در نظر گرفته شده‌اند تا کاربران نهایی.
.I debug
یک فهرست جداشده با کاما از گزینه‌های اشکال‌زدایی است؛ از
.BR pmdbg (1)
همراه با گزینهٔ
.B \-l
استفاده کنید تا فهرستی از گزینه‌های اشکال‌زدایی موجود و معانی آن‌ها را به دست آورید.
.PP
گزینه‌های اشکال‌زدایی مختص به
.B pmdacisco
به شرح زیر هستند:
.TS
box;
lf(B) | lf(B)
lf(B) | lxf(R) .
گزینه	توضیحات
_
appl0	T{
.ad l
مقداردهی اولیه، جزئیات پردازهٔ کارگر (worker)، تازه‌سازی داده‌ها، مهلت‌های زمانی (timeouts)
T}
_
appl1	T{
.ad l
درخواست‌های ارسال‌شده به دستگاه Cisco
T}
_
appl2	T{
.ad l
پویشگر واژگانی و تجزیه‌کننده برای خروجی از دستگاه Cisco
T}
.TE
.SH "همچنین ببینید (SEE ALSO)"
.BR pmcd (1)،
.BR pcp.conf (5)
و
.BR pcp.env (5).

.\" control lines for scripts/man-spell
.\" +ok+ BRI Ciscos FDDI FastEthernet Fddi GigabitEthernet HSSI ISDN
.\" +ok+ Vl {from protocol Vl}
.\" +ok+ Vlan appl cisco mycisco mylogin mypassword myprompt somecisco
.\" +ok+ subinterface trust_me wancisco yourcisco yourlogin
.\" +ok+ yourpassword