Name
opalinkanalysis — Encapsulates the capabilities for link analysis. Additionally, this tool includes cable and fabric topology verification capabilities.
Syntax
opalinkanalysis [-U] [-t portsfile] [-p ports] [-T topology_input] [-X snapshot_input] [-x snapshot_suffix] [-c file] reports...
Description
The opalinkanalysis tool is built on top of opareport (and its analysis capabilities) and accepts the same syntax for input topology and snapshot files.
In addition to being able to run assorted opareport 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.
Options
--helpProduces full help text.
-UOmits unexpected devices and links in
punchlistfile from verify reports.-tportsfileSpecifies the file with the list of local SuperNIC ports used to access fabric(s) for analysis. Default is
/etc/opa/ports.-pportsSpecifies the list of local SuperNIC ports used to access fabric(s) for analysis. Default is the first active port. Specified as
HFI:portas follows:Note
The first port on a SuperNIC is 1.
0:0First active port in the system.
0:yPort
yx:0First active port on SuperNIC
xx:ySuperNIC
xy
-Ttopology_inputSpecifies the name of a topology input file to use. Any
%Pmarkers in this filename are replaced with thehfi:portbeing operated on (such as 0:0 or 1:2). Default is/etc/opa/topology.%P.xml. IfNONEis specified, does not use anytopology_inputfiles. See for more information ontopology_inputfiles.-Xsnapshot_inputPerforms analysis using data in
snapshot_inputsnapshot_inputopareport -o snapshotrun. If an errors report is specified, snapshot must have been generated with theopareport -soption. When this option is used, only one port may be specified to select atopology_inputfile (unless-Tspecified). When this option is used,clearerrorsandclearhwerrorsreports are not permitted.-xsnapshot_suffixCreates a snapshot file per selected port. The files are created in
FF_RESULT_DIRwith names of the form:snapshotSUFFIX..HFI:PORT.xml-cfileSpecifies the error thresholds configuration file. The default is
/etc/opa/opamon.si.conf.reportsSupports the following reports:
errorsSpecifies link error analysis.
slowlinksSpecifies links running slower than expected.
misconfiglinksSpecifies links configured to run slower than supported.
misconnlinksSpecifies links connected with mismatched speed potential.
allIncludes all reports above (
errors,slowlinks,misconfiglinks, andmisconnlinks).verifylinksVerifies links against topology input.
verifyextlinksVerifies links against topology input. Limits analysis to links external to systems.
verifyfilinksVerifies links against topology input. Limits analysis to Fabric Interface (FI) links.
verifyislinksVerifies links against topology input. Limits analysis to inter-switch links.
verifyextislinksVerifies links against topology input. Limits analysis to inter-switch links external to systems.
verifyfisVerifies FIs against topology input.
verifyswsVerifies switches against topology input.
verifynodesVerifies FIs and switches against topology input.
verifysmsVerifies SMs against topology input.
verifyallVerifies links, FIs, switches, and SMs against topology input.
clearerrorsClears error counters, uses PM if available.
clearhwerrorsClears hardware error counters, bypasses PM.
clearIncludes
clearerrorsandclearhwerrors.
A punchlist of bad links is also appended to the file: FF_RESULT_DIR/punchlist.csv
Examples
opalinkanalysis errors opalinkanalysis errors clearerrors opalinkanalysis -p '1:1 1:2 2:1 2:2'
Environment Variables
The following environment variables are also used by this command:
PORTSList of ports, used in absence of
-tand-p.PORTS_FILEFile containing the list of ports, used in absence of
-tand-p.FF_TOPOLOGY_FILEFile containing
topology_input-T.