User Manual

Rev 2.1-1.0.6
Mellanox Technologies
165
8.5.7.6 Torus-2QoS Configuration File Syntax
[torus|mesh] x_radix[m|M|t|T] y_radix[m|M|t|T] z_radix[m|M|t|T]
xp_link sw0_GUID sw1_GUID
yp_link sw0_GUID sw1_GUID
zp_link sw0_GUID sw1_GUID
xm_link sw0_GUID sw1_GUID
ym_link sw0_GUID sw1_GUID
zm_link sw0_GUID sw1_GUID
The file torus-2QoS.conf contains configuration information that is specific to the OpenSM rout-
ing engine torus-2QoS. Blank lines and lines where the first non-whitespace character is "#" are
ignored. A token is any contiguous group of non-whitespace characters. Any tokens on a line fol-
lowing the recognized configuration tokens described below are ignored.
Either torus or mesh must be the first keyword in the configuration, and sets the topology that
torus-2QoS will try to construct.
A 2D topology can be configured by specifying one of x_radix,
y_radix, or z_radix as 1. An individual dimension can be configured as mesh (open) or torus
(looped) by suffixing its radix specification with one of m, M, t, or T. Thus, "mesh 3T 4 5" and
"torus 3 4M 5M" both specify the same topology.
Note that although torus-2QoS can route mesh fabrics, its ability to route around failed compo-
nents is severely compromised on such fabrics. A failed fabric componentis very likely to cause a
disjoint ring; see UNICAST ROUTING in torus-2QoS(8).
These keywords are used to seed the torus/mesh topology. For example, "xp_link 0x2000
0x2001" specifies that a link from the switch with node GUID 0x2000 to the switch with node
GUID 0x2001 would point in the positive x direction, while "xm_link 0x2000 0x2001" specifies
that a link from the switch with node GUID 0x2000 to the switch with node GUID 0x2001 would
point in the negative x direction.
All the link keywords for a given seed must specify the same
"from" switch.
In general, it is not necessary to configure both the positive and negative directions for a given
coordinate; either is sufficient. However, the algorithm used for topology discovery needs extra
information for torus dimensions of radix four (see TOPOLOGY DISCOVERY in torus-
2QoS(8)). For such cases both the positive and negative coordinate directions must be specified.
Based on the topology specified via the torus/mesh keyword, torus-2QoS will detect and log
when it has insufficient seed configuration.
In order for torus-2QoS to provide the guarantee that path SL values do not change under any
conditions for which it can still route the fabric, its idea of dateline position must not change rel-
ative to physical switch locations. The dateline keywords provide the means to configure such
behavior.
The dateline for a torus dimension is always between the switch with coordinate 0 and the switch
with coordinate radix-1 for that dimension. By default, the common switch in a torus seed is
taken as the origin of the coordinate system used to describe switch location. The position param-
x_dateline position
y_dateline position
z_dateline position