Product specifications

5 – Detailed Descriptions of Command LineTools
D000006-000 Rev A 5-73
Q
❥ fabric components (nodes, links, SMs, systems, and their SMA configuration)
❥ fabric PMA error counters and link speed mismatches
Note that the comparison includes components on the fabric. Therefore
operations such as shutting down a server will cause the server to no longer
appear on the fabric and will be flagged as a fabric change or failure by
fabric_analysis.
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_ANALYSIS_DIR - top level directory for baselines and failed health
checks.
FF_CURTIME - timestamp to use on directory created in FF_ANALYSIS_DIR,
default is the present date and time.
FF_FABRIC_HEALTH - iba_report options to use during a health check.
FF_DIFF_CMD -Linux command used to compare the baseline to the latest
snapshot.
For simple fabrics, the Fast Fabric host would be connected to a single fabric.
By default the first active port on the Fast Fabric host will be used to analyze the
fabric.
However, in more complex fabrics, the Fast Fabric host may be connected to
more than one fabric (e.g., an IB subnet). In this case the specific ports and/or
HCAs to use for fabric analysis may be specified. The HCA and port number
specified will become part of the filenames in the FF_ANALYSIS_DIR such that
unique status can be tracked for each fabric.
Specification of the ports to be used can be performed on the command line
using the -p option, in a file specified via the -t option, via the environment
variables PORTS or PORTS_FILE, or via the PORTS_FILE configuration option
in fastfabric.conf. If the specified file does not exist or is empty, the first
active port on the local system will be used. In more complex configurations
(such as where the Fast Fabric host is connected to multiple IB fabrics or IB
subnets), the user will need to specify the exact ports to use such that all fabrics
are analyzed. For more information, refer to the section “Selection of local Ports
(subnets)” on page 5-9.
By default the error analysis includes PMA counters and slow links (i.e., links
running below enabled speeds). However this can be changed via the
FF_FABRIC_HEALTH configuration parameter in fastfabric.conf (see
appendix B for more information). This parameter specifies the iba_report