IBDMCHK(1) IB DATA MODEL PACKAGE IBDMCHK(1)NAME
IBDM - Network Checker and Attributes Analyzer
SYNOPSYS
ibdmchk has two operation modes: design and verification.
DESIGN:
ibdmchk [-v][-h][-u][-a <roots file>] -t <topology file> -n <SM Node>
-p <SM Port> [-e] [-l <lmc>]
VERIFICATION:
ibdmchk [-v][-h][-r <roots file>] [-s <subnet file>] [-f <fdb file>]
[-l <lmc>]
DESIGN MODE DESCRIPTION
The Design mode is intended to be used before the cluster is built. It provides basic checks of the specified network as described by a
topology file. After simulating the SM LID assignment and routing algorithms it provides reports of the (H)CA to (H)CA paths depth his-
togram and credit deadlock potential in the resulting routing scheme.
ARGUMENTS :
-t|--topo <topo file>
The topology file specifying the network. See man ibdm-topology-file
-n|--node <SM Node>
The name of the Subnet Manager node (syntax: <Topo-File-System>/U1)
-p|--port <SM Port>
The port number by which the SM nodes is attached to the fabric.
OPTIONS
-v|--verbose
Verbsoe mode
-h|--help
Provides this help message
-l|--lmc <lmc>
LMC value > 0 means assigning 2^lmc lids to each port.
-e|--enh
Use enhanced routing algorithm when LMC > 0 and report the resulting paths correlation (using same system/node) histogram
-u|--updn
Use up/down routing algorithm instead of OpenSM min-hop.
-r|--roots <roots file> A file with all the roots node names (one on each line).
VERIFICATION MODE DESCRIPTION
After the cluster is built and OpenSM is run (using flag -D 0x43) it reports the subnet and FDB tables into the files osm-subnet.lst,
osm.fdbs and osm.fdbs in /var/log/ (or subnet.lst, osm.fdbs and osm.mcfdbs into /tmp in older OpenSM versions). Based on these files the
utility checks all CA to CA connectivity. Further analysis for credit deadlock potential is performed and reported. In case of an LMC > 0
it reports histograms for how many systems and nodes are common between the different paths for the same port pairs.
ARGUMENTS
-l|--lmc <lmc>
The LMC value used while running OpenSM. Mandatory if not the default 0.
OPTIONS
-v|--verbose
Verbsoe mode
-h|--help
Provides this help message
-s|--subnet <file>
OpenSM subnet.lst file (default is /var/log/osm-subnet.lst or /tmp/subnet.lst)
-f|--fdb <file>
OpenSM dump of Ucast LFDB. Use -D 0x41 to generate it (default is /var/log/osm.fdbs or /tmp/osm.fdbs).
-m|--mcfdb <file>
OpenSM dump of Multicast LFDB. Use -D 0x41 to generate it (default is /var/log/osm.mcfdbs or /tmp/osm.mcfdbs).
-r|--roots <roots file>
A file holding all root nodes guids (one per line).
AUTHOR
Eitan Zahavi, Mellanox Technologies LTD, eitan@mellanox.co.il
IBDM 1.0 2008-06-16 IBDMCHK(1)
Check Out this Related Man Page
OSMTEST(8) OpenIB Management OSMTEST(8)NAME
osmtest - InfiniBand subnet manager and administration (SM/SA) test program
SYNOPSIS
osmtest [-f(low) <c|a|v|s|e|f|m|q|t>] [-w(ait) <trap_wait_time>] [-d(ebug) <number>] [-m(ax_lid) <LID in hex>] [-g(uid)[=]<GUID in hex>]
[-p(ort)] [-i(nventory) <filename>] [-s(tress)] [-M(ulticast_Mode)] [-t(imeout) <milliseconds>] [-l | --log_file] [-v] [-vf <flags>]
[-h(elp)]
DESCRIPTION
osmtest is a test program to validate InfiniBand subnet manager and administration (SM/SA).
Default is to run all flows with the exception of the QoS flow.
osmtest provides a test suite for opensm.
osmtest has the following capabilities and testing flows:
It creates an inventory file of all available Nodes, Ports, and PathRecords, including all their fields. It verifies the existing inven-
tory, with all the object fields, and matches it to a pre-saved one. A Multicast Compliancy test. An Event Forwarding test. A Service
Record registration test. An RMPP stress test. A Small SA Queries stress test.
It is recommended that after installing opensm, the user should run "osmtest -f c" to generate the inventory file, and immediately after-
wards run "osmtest -f a" to test OpenSM.
Another recommendation for osmtest usage is to create the inventory when the IB fabric is stable, and occasionally run "osmtest -v" to ver-
ify that nothing has changed.
OPTIONS -f, --flow
This option directs osmtest to run a specific flow:
FLOW DESCRIPTION
c = create an inventory file with all nodes, ports and paths
a = run all validation tests (expecting an input inventory)
v = only validate the given inventory file
s = run service registration, deregistration, and lease test
e = run event forwarding test
f = flood the SA with queries according to the stress mode
m = multicast flow
q = QoS info: dump VLArb and SLtoVL tables
t = run trap 64/65 flow (this flow requires running of external tool)
(default is all flows except QoS)
-w, --wait
This option specifies the wait time for trap 64/65 in seconds It is used only when running -f t - the trap 64/65 flow (default to 10
sec)
-d, --debug
This option specifies a debug option. These options are not normally needed. The number following -d selects the debug option to
enable as follows:
OPT Description
--------------------
-d0 - Ignore other SM nodes
-d1 - Force single threaded dispatching
-d2 - Force log flushing after each log message
-d3 - Disable multicast support
-m, --max_lid
This option specifies the maximal LID number to be searched for during inventory file build (default to 100)
-g, --guid
This option specifies the local port GUID value with which OpenSM should bind. OpenSM may be bound to 1 port at a time. If GUID
given is 0, OpenSM displays a list of possible port GUIDs and waits for user input. Without -g, OpenSM trys to use the default
port.
-p, --port
This option displays a menu of possible local port GUID values with which osmtest could bind
-i, --inventory
This option specifies the name of the inventory file Normally, osmtest expects to find an inventory file, which osmtest uses to val-
idate real-time information received from the SA during testing If -i is not specified, osmtest defaults to the file 'osmtest.dat'
See -c option for related information
-s, --stress
This option runs the specified stress test instead of the normal test suite Stress test options are as follows:
OPT Description
--------------------
-s1 - Single-MAD response SA queries
-s2 - Multi-MAD (RMPP) response SA queries
-s3 - Multi-MAD (RMPP) Path Record SA queries
Without -s, stress testing is not performed
-M, --Multicast_Mode
This option specify length of Multicast test:
OPT Description
--------------------
-M1 - Short Multicast Flow (default) - single mode
-M2 - Short Multicast Flow - multiple mode
-M3 - Long Multicast Flow - single mode
-M4 - Long Multicast Flow - multiple mode
Single mode - Osmtest is tested alone, with no other apps that interact with OpenSM MC
Multiple mode - Could be run with other apps using MC with OpenSM. Without -M, default flow testing is performed
-t, --timeout
This option specifies the time in milliseconds used for transaction timeouts. Specifying -t 0 disables timeouts. Without -t,
OpenSM defaults to a timeout value of 200 milliseconds.
-l, --log_file
This option defines the log to be the given file. By default the log goes to stdout.
-v, --verbose
This option increases the log verbosity level. The -v option may be specified multiple times to further increase the verbosity
level. See the -vf option for more information about. log verbosity.
-V This option sets the maximum verbosity level and forces log flushing. The -V is equivalent to '-vf 0xFF -d 2'. See the -vf option
for more information about. log verbosity.
-vf This option sets the log verbosity level. A flags field must follow the -D option. A bit set/clear in the flags enables/disables a
specific log level as follows:
BIT LOG LEVEL ENABLED
---------------------
0x01 - ERROR (error messages)
0x02 - INFO (basic messages, low volume)
0x04 - VERBOSE (interesting stuff, moderate volume)
0x08 - DEBUG (diagnostic, high volume)
0x10 - FUNCS (function entry/exit, very high volume)
0x20 - FRAMES (dumps all SMP and GMP frames)
0x40 - ROUTING (dump FDB routing information)
0x80 - currently unused.
Without -vf, osmtest defaults to ERROR + INFO (0x3) Specifying -vf 0 disables all messages Specifying -vf 0xFF enables all messages
(see -V) High verbosity levels may require increasing the transaction timeout with the -t option
-h, --help
Display this usage info then exit.
AUTHORS
Hal Rosenstock
<hal@xsigo.com>
Eitan Zahavi
<eitan@mellanox.co.il>
OpenIB August 11, 2008 OSMTEST(8)