1
2opa2rm(8)              Master map: IFSFFCLIRG (Man Page)             opa2rm(8)
3
4
5

NAME

7       opa2rm
8
9
10
11       Permits  the  generation  of  configuration  files  for  FastFabric  or
12       resource managers from a topology xml file.
13
14       When using a topology spreadsheet and  opaxlattopology  to  design  and
15       prepare  for deployment verification of a fabric, opa2rm may be used to
16       generate  resource  manager  configuration  from  the  planned  cluster
17       design.  Using  this  approach  will  allow the resulting configuration
18       files to be complete, even if some nodes in the  fabric  have  not  yet
19       been  installed or made operational. Alternatively, opareport -o topol‐
20       ogy can be used to generate a topology XML file for input to opa2rm. In
21       this case, only the currently present nodes will be included.
22
23       When working with SLURM, the opa2rm -o slurm option should typically be
24       used. This option will generate a SLURM configuration file  that  lists
25       the  hosts  directly  connected  to each switch in a syntax that can be
26       used by SLURM's topology/tree plugin. It also generates a single "fake"
27       switch  shown  as  connecting  all  the  other  switches together. This
28       approach allows for SLURM job placement to be improved  while  avoiding
29       undo overhead in SLURM. This option also allows for topologies that are
30       not a pure fat-tree.
31
32       When the configuration is a pure fat tree or oversubscribed  fat  tree,
33       the  opa2rm  -o  slurmfull  option  may  be  used  to generate the full
34       description of the fabric, including all intermediate and core switches
35       in  the  fat tree topology. This option may permit better job placement
36       optimization than the output from the opa2rm -o slurm  option.  However
37       for larger fabrics, it may also increase the overhead within SLURM.
38

Syntax

40       opa2rm [-v] [-q] -o output[-g|-u|-t] [-F point] [-p prefix] [-s suffix]
41       topology_input
42

Options

44       --help    Produces full help text.
45
46
47       -v/--verbose
48                 Specifies verbose output.
49
50
51       -q/--quiet
52                 Disables progress reports.
53
54
55       -o/--output output
56                 Specifies the output type:
57
58
59
60
61                 slurm     SLURM tree nodes. Supports a variety of topologies.
62
63
64
65
66
67                 slurmful  SLURM fat tree nodes and ISLs. Only  supports  pure
68                           trees.
69
70
71
72
73
74                 hosts     FastFabric hosts file omitting this host
75
76
77
78       -g/--guid Specifies the output switch GUIDs instead of names.
79
80
81       -u/--underscore
82                 Changes spaces in switch names to underscores.
83
84
85       -t/--trunc
86                 Truncates switch names at first space.
87
88
89                 This  will  treat  large  Director  switches as a single, big
90                 switch.
91
92                 If -g, -u or -t are not specified, the switch name's  suffix,
93                 after  the  first  space,  will be placed at the start of the
94                 name. For example, 'core5 Leaf 101' becomes 'Leaf101_core5'.
95
96       -F/--focus point
97                 Specifies the focus area for output. Limits the scope of out‐
98                 put to links that match any of the given focus points.
99
100
101       -p/--prefix prefix
102                 Specifies the prefix to prepend to all FI hostnames.
103
104
105       -s/--suffix suffix
106                 Specifies the suffix to append to all FI hostnames.
107
108
109       topology_input
110                 Specifies  the topology_input file to use. '-' may be used to
111                 specify stdin.
112
113

Point Syntax

115       node:value
116                 value is node description (node name).
117
118
119       node:value1:port:value2
120                 value1 is node description (node name); value2 is  port  num‐
121                 ber.
122
123
124       nodepat:value
125                 value is glob pattern for node description (node name).
126
127
128       nodepat:value1:port:value2
129                 value1  is  glob  pattern  for  node description (node name);
130                 value2 is port number.
131
132
133       nodetype:value
134                 value is node type (SW, FI, or RT).
135
136
137       nodetype:value1:port:value2
138                 value1 is node type (SW, FI or RT); value2 is port number.
139
140
141       rate:value
142                 value is string for rate (25g, 50g, 75g, 100g).
143
144
145       mtucap:value
146                 value is MTU size (2048, 4096,  8192,  10240);  omits  switch
147                 mgmt port 0.
148
149
150       labelpat:value
151                 value is glob pattern for cable label.
152
153
154       lengthpat:value
155                 value is glob pattern for cable length.
156
157
158       cabledetpat:value
159                 value is glob pattern for cable details.
160
161
162       linkdetpat:value
163                 value is glob pattern for link details.
164
165
166       portdetpat:value
167                 value is glob pattern for port details to value.
168
169

Examples

171       opa2rm -o slurm topology.xml
172       opa2rm -o slurm -p 'opa-' topology.xml
173       opa2rm -o slurm -s '-opa' topology.xml
174       opa2rm -o slurm -F 'nodepat:compute*' -F 'nodepat:opacore1 *'
175       topology.xml
176       opa2rm -o nodes -F 'nodedetpat:compute*' topology.xml
177       opa2rm -o hosts topology.xml
178
179
180
181Copyright(C) 2015-2018         Intel Corporation                     opa2rm(8)