IBNETDISCOVER(8) Open IB Diagnostics IBNETDISCOVER(8)

ibnetdiscover - کشف همبندی (توپولوژی) شبکه اینفینی‌باند

ibnetdiscover [options] [<topology-file>]

دستور ibnetdiscover عملیات کشف زیرشبکه IB را انجام داده و یک فایل توپولوژی خوانا برای انسان خروجی می‌دهد. شناسه‌های GUID، انواع گره‌ها و شماره پورت‌ها به همراه LIDهای پورت و NodeDescriptionها نمایش داده می‌شوند. تمام گره‌ها (و پیوندها) نمایش داده می‌شوند (توپولوژی کامل). به صورت اختیاری، این ابزار می‌تواند برای فهرست کردن گره‌های متصل فعلی بر اساس نوع گره استفاده شود. خروجی در خروجی استاندارد چاپ می‌شود، مگر اینکه یک فایل توپولوژی مشخص شده باشد.

?B-l, -list?P فهرست گره‌های متصل

?B-g, -grouping?P نمایش گروه‌بندی. گروه‌بندی، گره‌های IB را بر اساس طرح‌های اختصاصی سازندگان مختلف مرتبط می‌کند. همچنین ممکن است تطابق پورت‌های خارجی سوییچ را نشان دهد.

?B-H, -Hca_list?P فهرست CAهای متصل

?B-S, -Switch_list?P فهرست سوییچ‌های متصل

?B-R, -Router_list?P فهرست مسیریاب‌های متصل

?B-s, -show?P نمایش اطلاعات پیشرفت در طول فرآیند کشف.

?B-f, -full?P نمایش اطلاعات کامل (سرعت و پهنای پورت‌ها، vlcap)

?B-p, -ports?P دریافت گزارش پورت‌ها که فهرستی از پورت‌های متصل به همراه اطلاعات مرتبط است (مانند LID، شماره پورت، GUID، پهنا، سرعت و NodeDescription).

?B-m, -max_hops?P گزارش حداکثر گام‌های (hops) کشف‌شده.

?B-outstanding_smps, -o <val>?P
تعیین تعداد SMPهای معلقی که باید در طول پویش ارسال شوند

پیش‌فرض: 2

?B-cache <filename>?P ذخیره داده‌های شبکه ibnetdiscover در فایل مشخص‌شده. این حافظه موقت می‌تواند توسط ابزارهای دیگر برای تحلیل بعدی استفاده شود.

?B-load-cache <filename>?P بارگیری و استفاده از داده‌های ذخیره‌شده ibnetdiscover در فایل مشخص‌شده. برای مشاهده و بررسی سایر ساختارهای شبکه یا وضعیت پیشین ساختار مفید است.

?B-diff <filename>?P بارگیری داده‌های ذخیره‌شده ibnetdiscover و انجام مقایسه تفاضلی با شبکه فعلی یا یک فایل حافظه موقت دیگر. یک خروجی تفاضلی ویژه برای ibnetdiscover نمایش داده خواهد شد که تفاوت‌های میان ساختار پیشین و فعلی را نشان می‌دهد. به طور پیش‌فرض، موارد زیر برای تفاوت‌ها مقایسه می‌شوند: سوییچ‌ها، آداپتورهای کانال، مسیریاب‌ها و اتصالات پورت‌ها.

?B-diffcheck <key(s)>?P مشخص کردن اینکه چه بررسی‌های تفاضلی باید در گزینه ?B-diff?P بالا انجام شود. چندین کلید بررسی را با کاما جدا کنید. بررسی‌های موجود عبارتند از: ?Bsw = سوییچ‌ها?P، ?Bca = آداپتورهای کانال?P، ?Brouter?P = مسیریاب‌ها، ?Bport?P = اتصالات پورت، ?Blid?P = شناسه‌های LID، ?Bnodedesc?P = توصیف‌های گره. توجه داشته باشید که ?Bport?P، ?Blid?P و ?Bnodedesc?P تنها برای انواع گره‌های مشخص‌شده (مانند ?Bsw?P، ?Bca?P، ?Brouter?P) بررسی می‌شوند. اگر ?Bport?P در کنار ?Blid?P یا ?Bnodedesc?P مشخص شود، LIDها و توصیف‌های پورت‌های دوردست نیز مقایسه خواهند شد.

?B-C, -Ca <ca_name>?P استفاده از ca_name مشخص‌شده.

?B-P, -Port <ca_port>?P استفاده از ca_port مشخص‌شده.

?B-Y, -pkey-idx <idx>?P
شاخص جدول P_Key (از 0 تا 65535، پیش‌فرض 0) مورد استفاده برای MADهای خروجی SA/GMP. بسته‌های SMP MAD همیشه از شاخص P_Key برابر با 0 استفاده می‌کنند.

پشتیبانی از چند پورت/چند CA: هنگامی که هیچ دستگاه یا پورت IB مشخص نشده باشد، کتابخانه libibumad پورت مورد استفاده را بر اساس معیارهای زیر انتخاب می‌کند:

1.
نخستین پورتی که ACTIVE باشد.
2.
در صورت نیافتن، نخستین پورتی که UP باشد (پیوند فیزیکی برقرار باشد).

اگر پورت و/یا نام CA مشخص شده باشد، کتابخانه libibumad تلاش می‌کند درخواست کاربر را برآورده سازد و در صورت عدم امکان شکست خواهد خورد.

برای نمونه:

ibaddr                 # استفاده از نخستین پورت (معیار ۱ در بالا)
ibaddr -C mthca1       # انتخاب بهترین پورت تنها از "mthca1"
ibaddr -P 2            # استفاده از پورت دوم (فعال/بالا) از نخستین دستگاه IB موجود
ibaddr -C mthca0 -P 2  # تنها استفاده از پورت مشخص‌شده

?B-config, -z <config_file>?P تعیین فایل پیکربندی جایگزین.

پیش‌فرض: /etc/infiniband-diags/ibdiag.conf
?B-outstanding_smps, -o <val>?P
تعیین تعداد SMPهای معلقی که باید در طول پویش ارسال شوند

پیش‌فرض: 2

?B-node-name-map <node-name-map>?P تعیین فایل نگاشت نام گره.

این فایل GUIDها را به نام‌های کاربرپسندتر نگاشت می‌کند. بخش FILES را ببینید.

?B-t, -timeout <timeout_ms>?P بازتعریف مهلت زمانی پیش‌فرض برای MADهای درخواستی.

?B-y, -m_key <key>?P
استفاده از M_key مشخص‌شده برای درخواست‌ها. اگر مقدار غیرعددی (مانند 'x') مشخص شود، مقدار از کاربر پرسیده خواهد شد.

افزایش سطح اشکال‌زدایی IB. می‌تواند چندین بار استفاده شود (-ddd یا -d -d -d).
نمایش خطاهای ارسال و دریافت (اتمام مهلت زمانی و موارد دیگر)

?B-h, -help?P نمایش پیام راهنما

?B-v, -verbose?P
افزایش سطح پرگویی و جزئیات برنامه. می‌تواند چندین بار استفاده شود (-vv یا -v -v -v)

?B-V, -version?P نمایش اطلاعات نسخه.

/etc/infiniband-diags/ibdiag.conf

یک فایل پیکربندی سراسری برای تنظیم برخی گزینه‌های مشترک تمامی ابزارها ارائه شده است. برای جزئیات، فایل پیکربندی ارائه‌شده را ببینید.

نگاشت نام گره برای مشخص کردن نام‌های کاربرپسند برای گره‌ها در خروجی استفاده می‌شود. از GUIDها برای انجام جستجو استفاده می‌گردد.

این قابلیت توسط بسته opensm-libs ارائه می‌شود. برای مکان فایل در نصب خود به ?Bopensm(8)?P مراجعه کنید.

?Bبه طور عمومی:?P

# comment
<guid> "<name>"

?Bمثال:?P

# IB1
# Line cards
0x0008f104003f125c "IB1 (Rack 11 slot 1   ) ISR9288/ISR9096 Voltaire sLB-24D"
0x0008f104003f125d "IB1 (Rack 11 slot 1   ) ISR9288/ISR9096 Voltaire sLB-24D"
0x0008f104003f10d2 "IB1 (Rack 11 slot 2   ) ISR9288/ISR9096 Voltaire sLB-24D"
0x0008f104003f10d3 "IB1 (Rack 11 slot 2   ) ISR9288/ISR9096 Voltaire sLB-24D"
0x0008f104003f10bf "IB1 (Rack 11 slot 12  ) ISR9288/ISR9096 Voltaire sLB-24D"
# Spines
0x0008f10400400e2d "IB1 (Rack 11 spine 1   ) ISR9288 Voltaire sFB-12D"
0x0008f10400400e2e "IB1 (Rack 11 spine 1   ) ISR9288 Voltaire sFB-12D"
0x0008f10400400e2f "IB1 (Rack 11 spine 1   ) ISR9288 Voltaire sFB-12D"
0x0008f10400400e31 "IB1 (Rack 11 spine 2   ) ISR9288 Voltaire sFB-12D"
0x0008f10400400e32 "IB1 (Rack 11 spine 2   ) ISR9288 Voltaire sFB-12D"
# GUID   Node Name
0x0008f10400411a08 "SW1  (Rack  3) ISR9024 Voltaire 9024D"
0x0008f10400411a28 "SW2  (Rack  3) ISR9024 Voltaire 9024D"
0x0008f10400411a34 "SW3  (Rack  3) ISR9024 Voltaire 9024D"
0x0008f104004119d0 "SW4  (Rack  3) ISR9024 Voltaire 9024D"

قالب فایل توپولوژی برای انسان خوانا و تا حد زیادی شهودی است. اکثر شناسه‌ها دارای نام‌های متنی هستند مانند شناسه سازنده (vendid)، شناسه دستگاه (devid)، انواع GUIDها (مانند sysimgguid، caguid، switchguid و غیره). PortGUIDها در پرانتز () نمایش داده می‌شوند. برای سوییچ‌ها، این مورد در خط switchguid نشان داده می‌شود. برای پورت‌های CA و مسیریاب، در خطوط اتصال نشان داده می‌شود. گره IB مشخص شده و به دنبال آن تعداد پورت‌ها و GUID گره داخل نقل‌قول می‌آید. در سمت راست این خط یک کامنت (#) و به دنبال آن NodeDescription داخل نقل‌قول قرار دارد. اگر گره یک سوییچ باشد، این خط همچنین مشخص می‌کند که پورت ۰ سوییچ پایه است یا پیشرفته، و LID و LMC پورت ۰ را نشان می‌دهد. خطوط بعدی مربوط به این گره اتصالات را نشان می‌دهند. در سمت چپ شماره پورت گره فعلی قرار دارد. در سمت راست گره همتا (گره در سر دیگر پیوند) قرار دارد. این گره با نوع گره داخل نقل‌قول و به دنبال آن - و NodeGUID به همراه شماره پورت در قلاب [] مشخص می‌شود. در سمت راست‌تر یک کامنت (#) قرار دارد. آنچه پس از کامنت می‌آید بستگی به نوع گره دارد. اگر گره سوییچ باشد، NodeDescription داخل نقل‌قول و LID گره همتا می‌آید. اگر گره CA یا مسیریاب باشد، LID و LMC محلی و سپس NodeDescription داخل نقل‌قول و LID گره همتا می‌آید. پهنا و سرعت پیوند فعال نیز به انتهای این خط خروجی اضافه می‌شود.

نمونه‌ای از آن:

#
# Topology file: generated on Tue Jun  5 14:15:10 2007
#
# Max of 3 hops discovered
# Initiated from node 0008f10403960558 port 0008f10403960559
Non-Chassis Nodes
vendid=0x8f1
devid=0x5a06
sysimgguid=0x5442ba00003000
switchguid=0x5442ba00003080(5442ba00003080)
Switch  24 "S-005442ba00003080"         # "ISR9024 Voltaire" base port 0 lid 6 lmc 0
[22]    "H-0008f10403961354"[1](8f10403961355)         # "MT23108 InfiniHost Mellanox Technologies" lid 4 4xSDR
[10]    "S-0008f10400410015"[1]         # "SW-6IB4 Voltaire" lid 3 4xSDR
[8]     "H-0008f10403960558"[2](8f1040396055a)         # "MT23108 InfiniHost Mellanox Technologies" lid 14 4xSDR
[6]     "S-0008f10400410015"[3]         # "SW-6IB4 Voltaire" lid 3 4xSDR
[12]    "H-0008f10403960558"[1](8f10403960559)         # "MT23108 InfiniHost Mellanox Technologies" lid 10 4xSDR
vendid=0x8f1
devid=0x5a05
switchguid=0x8f10400410015(8f10400410015)
Switch  8 "S-0008f10400410015"          # "SW-6IB4 Voltaire" base port 0 lid 3 lmc 0
[6]     "H-0008f10403960984"[1](8f10403960985)         # "MT23108 InfiniHost Mellanox Technologies" lid 16 4xSDR
[4]     "H-005442b100004900"[1](5442b100004901)        # "MT23108 InfiniHost Mellanox Technologies" lid 12 4xSDR
[1]     "S-005442ba00003080"[10]                # "ISR9024 Voltaire" lid 6 1xSDR
[3]     "S-005442ba00003080"[6]         # "ISR9024 Voltaire" lid 6 4xSDR
vendid=0x2c9
devid=0x5a44
caguid=0x8f10403960984
Ca      2 "H-0008f10403960984"          # "MT23108 InfiniHost Mellanox Technologies"
[1](8f10403960985)     "S-0008f10400410015"[6]         # lid 16 lmc 1 "SW-6IB4 Voltaire" lid 3 4xSDR
vendid=0x2c9
devid=0x5a44
caguid=0x5442b100004900
Ca      2 "H-005442b100004900"          # "MT23108 InfiniHost Mellanox Technologies"
[1](5442b100004901)     "S-0008f10400410015"[4]         # lid 12 lmc 1 "SW-6IB4 Voltaire" lid 3 4xSDR
vendid=0x2c9
devid=0x5a44
caguid=0x8f10403961354
Ca      2 "H-0008f10403961354"          # "MT23108 InfiniHost Mellanox Technologies"
[1](8f10403961355)     "S-005442ba00003080"[22]                # lid 4 lmc 1 "ISR9024 Voltaire" lid 6 4xSDR
vendid=0x2c9
devid=0x5a44
caguid=0x8f10403960558
Ca      2 "H-0008f10403960558"          # "MT23108 InfiniHost Mellanox Technologies"
[2](8f1040396055a)     "S-005442ba00003080"[8]         # lid 14 lmc 1 "ISR9024 Voltaire" lid 6 4xSDR
[1](8f10403960559)     "S-005442ba00003080"[12]                # lid 10 lmc 1 "ISR9024 Voltaire" lid 6 1xSDR

هنگامی که از گروه‌بندی استفاده می‌شود، گره‌های IB در شاسی‌هایی سازماندهی می‌شوند که شماره‌گذاری شده‌اند. گره‌هایی که نتوان حضور آن‌ها را در یک شاسی تعیین کرد، با عنوان "Non-Chassis Nodes" نمایش داده می‌شوند. پورت‌های خارجی نیز روی خطوط اتصال نمایش داده می‌شوند.

< <halr@voltaire.com> >
< <ira.weiny@intel.com> >
2013-06-22