User Manual

Rev 2.2-1.0.1
Mellanox Technologies
265
Additional Options
-s schedule-file A file defining the communication pattern. The format described
in the below section SCHEDULE FILE.
-a Automatically generate an all-to-all schedule
-j min-shift -k max-shift Automatically generate a range of shifts
-z roots-file A file holding names of switches which are the roots of the
topology. This is mandatory if the -F flag is provided to report
HSD while estimating flow fractions.
SCHEDULE FILE
The schedule file describes a communication sequence. There are 2 types of lines:
• Stage line separates different stages of the schedule:
^STAGE(\s+[0-9]+)?
• SRC DST line describes traffic in pairs. Optionally the destination may be given a spe-
cific 'path-bits' that specifies the exact DLID from a range of DLIDs a destination may
have.
Another option is the flow may be given a relative BW of the SRC node.
• From the first rank to the second rank:
^\s*[0-9]+\s+[0-9]+(:([0-9]+))?(\s+(0\.[0-9]+))?\s*
• From a port name to a port name:
^\s*(\S+)/P([0-9]+)\s+*(\S+)/P([0-9]+)(:([0-9]+))?(\s+(0\.[0-9]+))?\s*
For example:
A flow from node H-1 port 1 to H-100 port 1 that 50% of the BW of H-1
H-1/U1/P1 H-100/U1/P1:1 0.5
ORDER FILE
The order file provides mapping between the rank (which is the line number) and a host in the
topology. The following are the type of lines supported:
-O order-file Runa a simulated annealing and write out the result into the given
file.
-o order-file A file holding host name in each line, defining their ordering.
Description of the order file is in section ORDER_FILE. Default order
is by host name sort H-<N> by the N.
-m Ignores missing CA-to-CA paths
-R rep-hsd-file Report each stage over subscription into the given file name
-Q rep-bw-file Reports each stage each flow BW (in csb format) into the given file
name
-v lvl: verbose mode Prepares for being flooded... lvl is:
1 -
2 - order optimization
3 - congestion analysis
4 - fat tree routing
5 - fat tree recognition
-h This message