opaxlattopology(8) | Master map: IFSFFCLIRG (Man Page) | opaxlattopology(8) |
opaxlattopology
Generates a topology XML file of a cluster using your customized <topologyfile>.csv, linksum_swd06.csv, and linksum_swd24.csv as input. The output topology XML file can be used to bring up and verify the cluster.
NOTE: The <topologyfile>.csv input file must be present in the same directory from which the script operates, but the linksum CSV files are read from the /usr/share/opa/samples directory.
opaxlattopology [-d level] [-v level] [-i
level] [-K] [-s hfi_suffix]
[source [dest]]
1 Intel(R) Omni-Path Edge Switch 100 Series topology files.
2 Rack topology files.
4 Rack group topology files.
0 No output.
1 Progress output.
2 Reserved.
4 Time stamps.
8 Reserved.
brnodes Creates the <Node> section xml for the csv input.
links Creates the <LinkSummary> section xml for the csv input.
The opaxlattopology script reads your customized <topologyfile>.csv file from the local directory, and reads the other files from /usr/share/opa/samples/linksum_swd06.csv and /usr/share/opa/samples/linksum_swd24.csv. Two sample topology XLSX files, detailed_topology.xlsx and minimal_topology.xlsx, are located in the /usr/share/opa/samples/ directory. You must create your <topologyfile>.csv file by editing one of the sample spreadsheets and saving the Fabric Links tab as a CSV file. Inspect your <topologyfile>.csv file to ensure that each row contains the correct and same number of comma separators. Any extraneous entries in the spreadsheet can cause the CSV output to have extra fields.
The script outputs one or more topology files starting with topology.0:0.xml. Your <topologyfile>.csv input file must be present in the same directory from which the script operates, but the linksum CSV files are read from the /usr/share/opa/samples directory.
opaxlattopology
# reads default input 'topology.csv' and creates default
# output 'topology.0:0.xml'
opaxlattopology fabric_2.csv
# reads input 'fabric_2.csv' and creates default output
Both sample files contain examples of links between HFI and Edge SW (rows 4-7), HFI and Core SW (rows 8-11), and Edge SW and Core SW (rows 12-15).
The following environment variables allow user-specified MTU.
The linksum_swd06.csv and linksum_swd24.csv files are provided as stand-alone files in the /usr/share/opa/samples directory. However, they can be recreated (or modified) from the spreadsheet, if needed, by performing the following steps:
By default, the opaxlattopology script considers all of the hosts to have a single HFI (hfi1_0).
For Multi-Rail/Multi-Plane fabrics, you have the following options:
opaxlattopology <topologyfile>.csv <topologyfile>.xml
opaxlattopology -s hfi1_1 <topologyfile>.csv <topologyfile>.xml
Intel Corporation | Copyright(C) 2015-2018 |