ethlinkanalysis - Man Page

ethlinkanalysis

Encapsulates the capabilities for link analysis. Additionally, this tool includes cable and fabric topology verification capabilities. This tool is built on top of ethreport (and its analysis capabilities), and accepts the same syntax for input topology and snapshot files.

In addition to being able to run assorted ethreport link analysis reports and generate human-readable output, this tool additionally analyzes the results and appends a concise summary of issues found to the FF_RESULT_DIR/punchlist.csv file.

ethlinkanalysis [-U] [-T  topology_inputs] [-X  snapshot_input] [-x  snapshot_suffix]

[-c  file] [-E  file] [-p  planes] [-f  host_files]  reports ...

--help

Produces full help text.

-U

Omits unexpected devices and links in punchlist file from verify reports.

-T topology_inputs

Specifies the name of topology input filenames separated by space. See ethreport for more information on topology_input files.

-X snapshot_input

Performs analysis using data in  snapshot_input.  snapshot_input must have been generated via a previous ethreport -o snapshot run.

-x snapshot_suffix

Creates a snapshot file per selected plane. The files are created in FF_RESULT_DIR with names of the form: snapshotSUFFIX.<plane_name>.xml.

-c file

Specifies the error thresholds configuration file. The default is /etc/eth-tools/ethmon.si.conf.

-E file

Ethernet Mgt configuration file. The default is /etc/eth-tools/mgt_config.xml.

-p planes

Fabric planes separated by space. The default is the first enabled plane defined in config file. Value 'ALL' will use all enabled planes.

-f host_files

Hosts files separated by space. It overrides the HostsFiles defined in Mgt config file for the corresponding planes. Value 'DEFAULT' will use the HostFile defined in Mgt config file for the corresponding plane.

reports

Supports the following reports:
errors Specifies link error analysis.

slowlinks Specifies links running slower than expected.

misconfiglinks Specifies links configured to run slower than supported.

misconnlinks Specifies links connected with mismatched speed potential.

all Includes the reports errors, slowlinks, misconfiglinks, and misconnlinks.

verifylinks Verifies links against topology input.

verifyextlinks Verifies links against topology input. Limits analysis to links external to systems.

verifyniclinks Verifies links against topology input. Limits analysis to NIC links.

verifyislinks Verifies links against topology input. Limits analysis to inter-switch links.

verifyextislinks Verifies links against topology input. Limits analysis to inter-switch links external to systems.

verifynics Verifies NICs against topology input.

verifysws Verifies switches against topology input.

verifynodes Verifies NICs and switches against topology input.

verifyall Verifies links, NICs, and switches against topology input.

A punchlist of bad links is also appended to the file: FF_RESULT_DIR/punchlist.csv

ethlinkanalysis errors

ethlinkanalysis slowlinks

ethlinkanalysis -p 'p1 p2' -f 'hosts1 DEFAULT' errors