1IBDM-TOPO-FILE(1)            IB DATA MODEL PACKAGE           IBDM-TOPO-FILE(1)
2
3
4

NAME

6       IBDM Topology File
7
8       The topology file describes the IB connectivity and systems included in
9       the network.  It serves two purposes:
10
11       1. Support for arbitrary system names to be later used in every report
12       that IBDM generates.
13       2. Connectivity verification: The specified network topology is veri‐
14       fied against the discovered one. Mismatch errors resulting from missing
15       cables and/or wrong connections are reported by IBADM.
16
17       The topology file is composed "system" sections. Each such section
18       describes the connectivity of one system to other systems in the net‐
19       work. The first line of each section is a declaration of the system
20       composed of a system-type, its system-name section, and optional con‐
21       figuration details. The lines to follow until the next empty line
22       describe the connections between this system ports to the other sys‐
23       tems. The following is a formal definition of a system section syntax.
24
25       An example is listed afterwards.
26
27       SYSTEM-TYPE SYSTEM-NAME [CFG: <b1>=<modifier>, [<b2>=<modifier>]...]
28
29               LOCAL-PORT-PANEL-NAME -> REM-SYS-TYPE REM-SYS-NAME REM-PORT-PANEL-NAME
30
31               LOCAL-PORT-PANEL-NAME -> REM-SYS-TYPE REM-SYS-NAME REM-PORT-PANEL-NAME
32
33               LOCAL-PORT-PANEL-NAME -> REM-SYS-TYPE REM-SYS-NAME REM-PORT-PANEL-NAME
34
35               . . .
36
37       SYSTEM-TYPE SYSTEM-NAME [CFG: <b1>=<modifier>, [<b2>=<modifier>]...]
38
39               LOCAL-PORT-PANEL-NAME -> REM-SYS-TYPE REM-SYS-NAME REM-PORT-PANEL-NAME
40
41               LOCAL-PORT-PANEL-NAME -> REM-SYS-TYPE REM-SYS-NAME REM-PORT-PANEL-NAME
42
43               . . .
44
45       . . .
46
47       Where:
48
49       SYSTEM-TYPE and REM-SYS-TYPE
50           Any system that has a corresponding IBNL definition. See man
51           ibdm-ibnl-file
52
53       SYSTEM-NAME
54           The name of the system described in this topology file section.
55
56       LOCAL-PORT-PANEL-NAME
57           The name of the local system port. The numbers printed on the front
58           panel are used together with Ln for Leaf no. N or Sn for Spine no.
59           N.
60
61       REM-SYS-NAME
62           The name of the system connected to the local port.
63
64       REM-PORT-PANEL-NAME
65           A name of the remote system port. We use the numbers as printed on
66           the front panel and Ln for Leaf number N or Sn for Spine number N.
67

EXAMPLE

69       The following is a topology file for a simple cluster with one 24 port
70       switch and two HCAs. The firts HCA named H-1 and connect to the fabric
71       with its two ports. The second HCA named H-2. The switch is of type
72       MTS2400 and is named S-1
73
74       MTS2400 S-1
75          P1 -> MT23108 H-1 P1
76          P2 -> MT23108 H-1 P2
77          P24 -> MT23108 H-2 P1
78

OPTIONAL CFG SECTION

80       This section in the system declaration line describes the special cus‐
81       tomization of each board of the system.
82
83       That is the CFG string is a set of comma-separated sub-fields. Each
84       sub-field describes some special configuration of a corresponding sys‐
85       tem board. The actual semantics of the specific board modifiers is
86       defined by the IBNL of the specific system.
87

EXAMPLE

89       The following is an example of a definition-line in a topology file of
90       the MTS9600 switch system. This switch system can have up to eight
91       leafs and four spines. This example of the MTS9600 lacks (R) leafs
92       no.6,7 and 8, and lacks spines no. 3 and 4.
93
94       MTS9600 PartialGz1 CFG: leaf3=R,leaf5=R,leaf7=R,spine1=R
95

AUTHOR

97       Eitan Zahavi, Mellanox Technologies LTD, eitan@mellanox.co.il
98
99
100
101IBDM 1.0                          2008-06-16                 IBDM-TOPO-FILE(1)
Impressum