User Manual

InfiniBand Fabric UtilitiesRev 2.2-1.0.1
Mellanox Technologies
264
Additional Options
-t|--topology <file> Topology file [ibdm.topo]. The format is defined in the IBDM user
manual.
-d|--discovered <file> [subnet.lst] file produced by OpenSM.
-e|--edge start processing from the edges using strict match.
-s|--start-node <name> The name of the start node [H-1/U1].
-p|--port-num <num> The number of the start port [1].
-g|--port-guid <guid> The guid of the start port [none].
9.4.28 ibcongest
Provides static congestion analysis. It calculates routing for a given topology (topo-mode) or uses
extracted lst/fdb files (lst-mode). Additionally, it analyzes congestion for a traffic schedule pro-
vided in a "schedule-file" or uses an automatically generated schedule of all-to-all-shift.
To display a help message which details the tool's options, please run "/opt/ibutils2/bin/ibcongest
-h".
Synopsis
TOPO
ibcongest [-hdABC][-v lvl] -t <topo-file> [-n <sm-node>][-p <sm-port>] [-r ftree|pgft|osm>]
[-z roots-file] [-R rep-hsd-file] [-Q rep-bw-file] [-O order-file] [-o order-file] {-a|-s
<schedule>}
LST
ibcongest [-hdABC][-v lvl] -l <lst> -f <fdbs> [-R rep-hsd-file] [-Q rep-bw-file]
[-O order-file] [-o order-file] {-a [-j <min-shift> -k <max-shift>]|-s <schedule>}
TOPO Mode Options
-t topo-file [Mandatory] Topology file to be used.
-r ftree/pgft/osm Defines the routing engine to be used (osm).
-n sm-node Defines the node name for the SM to run on (H-1/U1).
-p sm-port Defines the port number of the sm-node the SM run from (1).
LST Mode Options
-l lst-file [Mandatory] LST file obtained from OpenSM or ibdiagnet.
-f fdbs-file [Mandatory] FDBs file obtained from OpenSM or ibdiagnet.
Options
-A Checks all paths not just CA to CA
-B Calculates and reports actual bandwidth of each flow. Turned on also
if -Q is provided.
-C Assumes Congestion Control. I.e. flow fairness and no back-pressure.
-F Estimates flow fractions in HSD report. NOTE: this is inaccurate as
it does not take effects of HoL blocking or round-robin arbitration
into account