Login or Register to Ask a Question and Join Our Community

Linux and UNIX Man Pages

Linux & Unix Commands - Search Man Pages

ibdmchk(1) [debian man page]

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

RUNSIMTEST(1)						      IB MANAGEMENT SIMULATOR						     RUNSIMTEST(1)

NAME

       RunSimTest - Run a test over the IB management simulator

SYNOPSYS

       RunSimTest [-h] [-o osm-path][-f flow-file][-c checker-file]
	  -t topology [-n osm-node-name][-p osm-port-num][-s seed][-V verbosity-list]

       This command starts the simulator and runs the the given test flow on top of it. Then it runs the checker flow. The default test flow
       starts OpenSM and wait for Subnet-Up event. User given flow can make use of the provided facilities for starting OpenSM and tracking it
       events.

ARGUMENTS

       -t topology
	   A topology file describing the fabric (see ibdm-topo-file)

OPTIONS

       -f flow-file
	   A tcl file sourced by the sim after the fabric is setup. See following discussion about the provided API and global variables that are
	   available for the flow.

       -c checker-file
	   A tcl file defining when osm completed and what checks are requierd to validate it's outputs. The procedure named 'checker' is invoked
	   by the test flow to start the checking flow. The default flow waits for OpenSM to complete setup the fabric and run ibdmchk.

       -o osm-path
	   Full path to OpenSM (/usr/local/ofed/osm-sim/bin/opensm). NOTE OpenSM should be compiled with --with-osmv=sim to be able to connect to
	   the simulator.

       -n osm-node
	   Topology file node name the SM runs on (default H-1/U1)

       -p port-num
	   Port number the SM attaches to (default 1).

       -s seed
	   Random seed to be used.

       -V verbosity-list
	   Module verbosity list. The first should be the global verbosity. See IBMgtSim for full list of modules.  Examples:

	    -V 0xffff = Full verbosity on all modules
	    -V '"0x3 server 0x6f2 sma 0xffff"' = Only fatal and error
	       for all modules full verbosity for the SMA module and default
	       verbosity for the Server module.

       -h  This help message

AUTHOR

       Eitan Zahavi, Mellanox Technologies LTD, eitan@mellanox.co.il

IBMGTSIM 1.0							    2008-06-16							     RUNSIMTEST(1)
Man Page