User Manual

Rev 2.2-1.0.1
Mellanox Technologies
221
The following addressing modes can be used to define the IB ports:
• Using a Directed Route to the destination: (Tool option ‘-d’)
This option defines a directed route of output port numbers from the local port to the destina-
tion.
• Using port LIDs: (Tool option ‘-l’):
In this mode, the source and destination ports are defined by means of their LIDs. If the fabric
is configured to allow multiple LIDs per port, then using any of them is valid for defining a
port.
• Using port names defined in the topology file: (Tool option ‘-n’)
This option refers to the source and destination ports by the names defined in the topology file.
(Therefore, this option is relevant only if a topology file is specified to the tool.) In this mode,
the tool uses the names to extract the port LIDs from the matched topology
, then the tool oper-
ates as in the ‘-l’ option.
9.4 Diagnostic Utilities
The diagnostic utilities described in this chapter provide means for debugging the connectivity
and status of InfiniBand (IB) devices in a fabric.
9.4.1 ibdiagnet (of ibutils2) - IB Net Diagnostic
This version of ibdiagnet is included in the ibutils2 package, and it is run by default
after installing Mellanox OFED. To use this ibdiagnet version, run: ibdiagnet
Please see ibutils2_release_notes.txt for additional information and known issues.
ibdiagnet scans the fabric using directed route packets and extracts all the available information
regarding its connectivity and devices. It then produces the following files in the output directory
(which is defined by the -o option described below).
Synopsis
[-i|--device <dev-name>] [-p|--port <port-num>] [-g|--guid <GUID in hex>] [--vlr <file>]
[-r|--routing] [-u|--fat_tree] [-o|--output_path <directory>] [--skip <stage>]
[--skip_plugin <library name>] [--pc] [-P|--counter <<PM>=<value>>]
[--pm_pause_time <seconds>] [--ber_test] [--ber_use_data] [--ber_thresh <value>]
[--extended_speeds <dev-type>] [--pm_per_lane] [--ls <2.5|5|10|14|25|FDR10>]
[--lw <1x|4x|8x|12x>] [-w|--write_topo_file <file name>] [-t|--topo_file <file>]
[--out_ibnl_dir <directory>] [--screen_num_errs <num>] [--smp_window <num>]
[--gmp_window <num>] [--max_hops <max-hops>] [-V|--version] [-h|--help] [-H|--deep_help]
Options
-i|--device <dev-name> Specifies the name of the device of the port used to connect
to the IB fabric (in case of multiple devices on he local
system).
-p|--port <port-num> Specifies the local device's port number used to connect to
the IB fabric.