opafabricanalysis

(All) Performs analysis of the fabric.

Syntax

opafabricanalysis [-b|-e] [-s] [-d dir] 
[-c file] [-t portsfile] [-p ports] 
[-T topology_input]

Options

-b
Baseline mode, default is compare/check mode.
-e
Evaluate health only, default is compare/check mode.
-s
Save history of failures (errors/differences).
-d dir
Top-level directory for saving baseline and history of failed checks. Default = /var/opt/opa/analysis
-c file
Error thresholds config file. Default = /etc/sysconfig/opa/opamon.conf
-t portsfile
File with list of local HFI ports used to access fabric(s) for analysis. Default = /etc/sysconfig/opa/ports
-p ports
List of local HFI ports used to access fabric(s) for analysis. Default is the first active port. Specified as HFI:port as follows:
0:0
First active port in system
0:y
Port y within system
x:0
First active port on HFI x
x:y
HFI x, port y
-T topology_input
Name of topology input file to use. Any %P markers in this filename are replaced with the HFI:port being operated on (such as 0:0 or 1:2). Default = /etc/sysconfig/opa/topology.%P.xml. If -T NONE is specified, no topology input file is used. See opareport for more information.

Example

opafabricanalysis
opafabricanalysis -p '1:1 2:1'

The fabric analysis tool checks the following:

Note: The comparison includes components on the fabric. Therefore, operations such as shutting down a server cause the server to no longer appear on the fabric and are flagged as a fabric change or failure by opafabricanalysis.

Environment Variables

The following environment variables are also used by this command:

PORTS
List of ports, used in absence of -t and -p.
PORTS_FILE
File containing list of ports, used in absence of -t and -p.
FF_TOPOLOGY_FILE
File containing topology_input (may have %P marker in filename), used in absence of -T.
FF_ANALYSIS_DIR
Top level directory for baselines and failed health checks.

Details

For simple fabrics, the Intel® Omni-Path Fabric Suite FastFabric Toolset host is connected to a single fabric. By default, the first active port on the FastFabric Toolset host is used to analyze the fabric. However, in more complex fabrics, the FastFabric Toolset host may be connected to more than one fabric or subnet. In this case, you can specify the ports or HFIs to use with one of the following methods:

If the specified port does not exist or is empty, the first active port on the local system is used. In more complex configurations, you must specify the exact ports to use for all fabrics to be analyzed. For more information, refer to .

You can specify the topology_input file to be used with one of the following methods:

If the specified file does not exist, no topology_input file is used. Alternately the filename can be specified as NONE to prevent use of an input file.

For more information, refer to opareport.

By default, the error analysis includes PMA counters and slow links (that is, links running below enabled speeds). You can change this using the FF_FABRIC_HEALTH configuration parameter in opafastfabric.conf. This parameter specifies the opareport options and reports to be used for the health analysis. It also can specify the PMA counter clearing behavior (-I seconds, -C, or none at all). See Appendix A in the Intel® Omni-Path Fabric Suite FastFabric User Guide for more information.

When a topology_input file is used, it can also be useful to extend FF_FABRIC_HEALTH to include fabric topology verification options such as -o verifylinks.

The thresholds for PMA counter analysis default to /etc/sysconfig/opa/opamon.conf. However, you can specify an alternate configuration file for thresholds using the -c option. The opamon.si.conf file can also be used to check for any non-zero values for signal integrity (SI) counters.

All files generated by opafabricanalysis start with fabric in their file name. This is followed by the port selection option identifying the port used for the analysis. Default is 0:0.

The opafabricanalysis tool generates files such as the following within FF_ANALYSIS_DIR:

Fabric items checked against the baseline

Based on opareport -o links:

Based on opareport -o comps:

Location (port, node) and number of SMs in fabric. Includes:

Fabric items also checked during health check

Based on opareport -s -C -o errors -o slowlinks: