PMDAIB(1) General Commands Manual PMDAIB(1)

pmdaib - عامل دامنه معیارهای کارایی Infiniband (PMDA)

$PCP_PMDAS_DIR/infiniband/pmdaib [-c configFile] [-D debug] [-d domain] [-l logfile] [-w]

دستور pmdaib یک «عامل دامنه معیارهای کارایی» (PMDA) است که اطلاعات و معیارهای عملکرد را در مورد HCAهای محلی Infiniband و GUIDهای محلی یا دوردست Infiniband صادر می‌کند.

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

محل فایل پیکربندی. به‌طور پیش‌فرض، فایل پیکربندی با نام $PCP_PMDAS_DIR/infiniband/config شناخته می‌شود. برای اطلاعات بیشتر فایل پیکربندی (CONFIG FILE) را ببینید.
مشخص کردن یک شماره domain (دامنه) جایگزین برای معیارهای کارایی. تقریباً هیچ‌گاه لازم نخواهد بود.
محل فایل وقایع (log). به‌طور پیش‌فرض، یک فایل وقایع با نام ib.log در $PCP_LOG_DIR/pmcd نوشته می‌شود. اگر ایجاد فایل وقایع مقدور نباشد یا قابل نوشتن نباشد، خروجی به‌جای آن به خطای استاندارد (stderr) ارسال می‌شود.
نوشتن فایل پیکربندی پیش‌فرض در $PCP_PMDAS_DIR/infiniband و خروج فوری. فایل پیکربندیِ ایجادشده حاوی درگاه‌های HCA محلی خواهد بود و فایل‌های موجود را بازنویسی نمی‌کند. از این آرگومان فقط باید برای ایجاد فایل پیکربندی الگو استفاده شود و هرگز نباید در pmcd.conf قرار گیرد. برای اطلاعات بیشتر درباره قالب فایل و پایش GUIDهای دوردست، فایل پیکربندی (CONFIG FILE) را ببینید.

به‌طور پیش‌فرض، PMDA بدون استفاده از فایل پیکربندی کار خواهد کرد. در این حالت عملیاتی، درگاه‌های HCA محلی پایش می‌شوند. توجه داشته باشید در صورتی که یک HCA جدید به سامانه اضافه شود، ممکن است نام‌گذاری دامنه نمونه (instance domain) تغییر کند؛ زیرا این نام‌گذاری همواره بر پایه نام‌گذاری هسته (kernel) خواهد بود.

در مواردی که این وضعیت مطلوب نباشد، یا در مواردی که پایش درگاه‌های Infiniband دوردست مورد نیاز باشد، باید یک فایل پیکربندی ایجاد شود. یک فایل «الگو» را می‌توان با اجرای دیمن pmdaib همراه با آرگومان -w ایجاد کرد. این کار فایل پیکربندی جدیدی شامل درگاه‌ها و GUIDهای محلی خواهد ساخت.

اگر فایل پیکربندی قابل اجرا (executable) باشد، اجرا خواهد شد و خروجی آن به عنوان محتوای پیکربندی مورد استفاده قرار می‌گیرد.

فایل پیکربندی از رکوردهای خط‌محور تشکیل شده است. خطوط خالی و تمام نویسه‌های پس از نویسه هش (#) نادیده گرفته می‌شوند. هر خط دارای ۶ فیلد است:

[instName] [portGUID] [portNum] via [localPortName]:[localPortNum]

فیلد نخست برای اختصاص یک نام نمونه‌ی ایستا به درگاه Infiniband دارای یک GUID معین به کار می‌رود. تمام فیلدهای دیگر باید برای پایش درگاه مربوطه به درستی مقداردهی شوند.

برای نمونه، جهت پایش درگاه شماره ۱ از HCA محلی موسوم به 'mthca0'، یک خطِ نمونه در فایل پیکربندی به صورت زیر خواهد بود:

myPort1 0xdeadbeef01234567 1 via mthca0:1

درگاه‌های دوردست را می‌توان به آسانی با مشخص کردن GUID مربوط به HCA یا سوئیچ و تعیین شماره درگاه دوردست پایش کرد. جفت‌فیلد localPortName:localPortNum مشخص می‌کند از کدام درگاه و HCA محلی به عنوان «گام نخست» (first hop) جهت ارتباط با GUID دوردست استفاده شود. به عنوان نمونه، برای پایش درگاه شماره ۱۳ از یک سوئیچ دوردست که روی درگاه اولِ HCA دوم به ساختار متصل است:

switch13 0xfeeffeefabcdabcd 13 via mthca1:1

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

PCPIntro(1)، pmcd(1)، PMAPI(3) و ibnetdiscover(8).

PCP Performance Co-Pilot