Your company here — click to reach over 10,000 unique daily visitors

ethxlattopology - Man Page



Generates a topology XML file of a cluster using your customized <topologyfile>.csv and core switch linksum files, e.g. linksum_swd06.csv, and linksum_swd24.csv as input. The output topology XML file can be used to bring up and verify the cluster.


ethxlattopology [-d  level] [-v  level] [-i  level] [-K] [-N] [-f  linkfiles]

[-o  report] [-p  plane] [source [dest]]



Produces full help text.

-d level

Specifies the output detail level. Default is 0. Levels are additive.

By default, the top level is always produced. Switch, rack, and rack group topology files can be added to the output by choosing the appropriate level. If the output at the group or rack level is specified, then group or rack names must be provided in the spreadsheet. Detailed output can be specified in any combination. A directory for each topology XML file is created hierarchically, with group directories (if specified) at the highest level, followed by rack and switch directories (if specified).
1 Core switch topology files.

2 Rack topology files.

4 Rack group topology files.

-v level

Specifies the verbose level. Range is 0 - 8. Default is 2. Levels are additive.

0 No output.

1 Progress output.

2 Reserved.

4 Time stamps.

8 Reserved.

-i level

Specifies the output indent level. Default is 4.


Specifies DO NOT clean temporary files.

Prevents temporary files in each topology directory from being removed. Temporary files contain CSV formatted lists of links, NICs, and switches used to create a topology XML file. Temporary files are not typically needed after a topology file is created, or can be retained for subsequent inspection or processing.


Specifies DO NOT generate Port Numbers from Port IDs.

This will introduce slightly poorer topology-loading performance. Useful when it is difficult to generate Port Numbers, such as complicated Port ID formats, or not enough Port IDs to train the Port Number generator.

-f linkfiles

Specifies the space separated core switch linksum files.

-o report

Specifies the report type for output. By default, all the sections are generated.

Report Types:
brnodes Creates the <Node> section xml for the csv input.

links Creates the <LinkSummary> section xml for the csv input.

-p plane

Specifies the plane name. Default is plane.


Specifies the source csv file. Default is topology.csv.


Specifies the output xml file. Default is topology.xml.

The default output file name can be used to specify destination folder.


The ethxlattopology script reads your customized <topologyfile>.csv file from the local directory, and reads the core switch linksum files specified by -f argument. Two sample topology XLSX files, detailed_topology.xlsx and minimal_topology.xlsx, are located in the /usr/share/eth-tools/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. Do the same thing on the "Internal xxx Links" tab to create your own internal core switch linksum csv files.


ethxlattopology -f "/usr/share/eth-tools/samples/linksum_swd06.csv /usr/share/eth-tools/samples/linksum_swd24.csv" /tmp/detailed_topology.csv

Parsing linksum file: /usr/share/eth-tools/samples/linksum_swd06.csv

Parsing linksum file: /usr/share/eth-tools/samples/linksum_swd24.csv

Parsing /tmp/detailed_topology.csv

Generating links for Core:core1

Generating links for Core:core2

Processing Leaves of partially populated Core:core2

Processing spines of partially populated Core:core2

Generating topology.xml file(s)


Both sample files contain examples of links between NIC and Edge SW (rows 4-7), NIC and Core SW (rows 8-11), and Edge SW and Core SW (rows 12-15).

Environment Variables

The following environment variables allow user-specified MTU.


If set, it overrides default MTU on switch-to-switch links. Default is 10240.


If set, it overrides default MTU on switch-to-NIC links. Default is 10240.

Multi-Rail and Multi-Plane Fabrics

For Multi-Rail/Multi-Plane fabrics, you have the following options:


Intel Corporation Copyright(C) 2020-2024 EFSFFCLIRG (Man Page)