ibtracert(8) Open IB Diagnostics ibtracert(8)

ibtracert - ردگیری مسیر اینفینی‌باند

ibtracert [options] [<lid|guid> [<startlid> [<endlid>]]]

دستور ibtracert از بسته‌های SMP برای ردگیری مسیر از یک GID/LID مبدا به یک GID/LID مقصد استفاده می‌کند. هر گام (hop) در امتداد مسیر تا زمانی که به مقصد برسد یا پاسخی از یک گام دریافت نشود، نمایش داده می‌شود. با استفاده از گزینه -m، می‌توان ردگیری مسیر چندپخشی (multicast) را بین گره‌های مبدا و مقصد انجام داد.

قالب ساده؛ اطلاعات اضافی را نشان ندهد.
نمایش ردگیری چندپخشی مربوط به mlid مشخص‌شده.
مسیردهی اجباری به درگاه مقصد.

-G, --Guid آدرس مشخص‌شده یک Port GUID است

-L, --Lid آدرس مشخص‌شده یک LID است

-s, --sm_port <smlid> استفاده از 'smlid' به عنوان lid هدف برای پرس‌وجوهای SA.

--ports-file <ports-file> مشخص کردن یک فایل درگاه‌ها.

این فایل شامل چندین جفت lid یا guid مبدا و مقصد است. بخش «فایل‌ها (FILES)» را ببینید.

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

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

نمایه جدول P_Key (مقدار 0-65535، پیش‌فرض 0) مورد استفاده برای بسته‌های خروجی SA/GMP MAD. بسته‌های SMP (مسیر هدایت‌شده SMI یا هدایت‌شده با LID) همیشه از نمایه 0 جدول P_Key استفاده می‌کنند.

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

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

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

برای مثال:

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

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

-h, --help نمایش پیام راهنمای نحوه استفاده.

افزایش سطح جزئیات برنامه. می‌توان چندین بار استفاده کرد (-vv یا -v -v -v).

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

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

--node-name-map <node-name-map> یک نگاشت نام گره را مشخص می‌کند.

این فایل GUIDها را به نام‌های کاربرپسندتر نگاشت می‌کند. بخش «فایل‌ها (FILES)» را ببینید.
استفاده از M_key مشخص‌شده برای درخواست‌ها. اگر یک مقدار غیرعددی (مانند 'x') مشخص شود، مقدار از کاربر پرسیده خواهد شد.

--config, -z <config_file> مشخص کردن فایل پیکربندی جایگزین.

پیش‌فرض: /etc/infiniband-diags/ibdiag.conf

/etc/infiniband-diags/ibdiag.conf

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

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

این قابلیت توسط بسته opensm-libs ارائه می‌شود. برای آگاهی از مکان فایل در سیستم خود، به opensm(8) مراجعه کنید.

به طور کلی:

# comment
<guid> "<name>"

مثال:

# 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"

فایل درگاه‌ها می‌تواند برای مشخص کردن چندین جفت مبدا و مقصد استفاده شود. آن‌ها می‌توانند lid یا guid باشند. در صورت استفاده از guid، برای مشخص کردن آن از گزینه -G استفاده کنید.

به طور کلی:

# comment
<src> <dst>

مثال:

73 207
203 657
531 101
> یا <
0x0008f104003f125c 0x0008f104003f133d
0x0008f1040011ab07 0x0008f104004265c0
0x0008f104007c5510 0x0008f1040099bb08

مثال‌های تک‌پخشی (Unicast)

ibtracert 4 16                                  # نمایش مسیر بین lidهای 4 و 16
ibtracert -n 4 16                               # همان مورد، اما با استفاده از قالب خروجی ساده
ibtracert -G 0x8f1040396522d 0x002c9000100d051  # استفاده از نشانی‌های guid

مثال چندپخشی (Multicast)

ibtracert -m 0xc000 4 16    # نمایش مسیر چندپخشی mlid 0xc000 بین lidهای 4 و 16

ibroute(8)

<<hal.rosenstock@gmail.com>>
< <ira.weiny@intel.com> >
2018-04-02