opachassisanalysis

(Switch) Performs analysis of the chassis.

The opachassisanalysis tool checks the following for the Intel® Omni-Path Fabric Chassis:

Syntax

opachassisanalysis [-b|-e] [-s] [-d dir] [-F chassisfile] 
[-H 'chassis']

Options

--help
Produces full help text.
-b
Specifies the baseline mode. Default is the compare/check mode.
-e
Evaluates health only. Default is the compare/check mode.
-s
Saves history of failures (errors/differences).
-d dir
Specifies the top-level directory for saving baseline and history of failed checks. Default = /var/usr/lib/opa/analysis
-F chassisfile
Specifies the file with the chassis in the cluster. Default = /etc/opa/chassis
-H 'chassis'
Specifies the list of chassis on which to execute the command.

Example

opachassisanalysis

Environment Variables

The following environment variables are also used by this command:

CHASSIS
List of chassis, used if -F and -H options are not supplied.
CHASSIS_FILE
File containing list of chassis, used if -F and -H options are not supplied.
FF_ANALYSIS_DIR
Top-level directory for baselines and failed health checks.
FF_CHASSIS_CMDS

List of commands to issue during analysis, unused if -e option supplied.

FF_CHASSIS_HEALTH

Single command to issue to check overall health during analysis, unused if -b option supplied.

Details

Intel recommends that you set up SSH keys for chassis (see opasetupssh). If SSH keys are not set up, all chassis must be configured with the same admin password and the password must be kept in the /etc/opa/opafastfabric.conf configuration file.

The default set of FF_CHASSIS_CMDS is:

showInventory fwVersion showNodeDesc timeZoneConf timeDSTConf 
snmpCommunityConf snmpTargetAddr showChassisIpAddr showDefaultRoute

The commands specified in FF_CHASSIS_CMDS must be simple commands with no arguments. The output of these commands are compared to the baseline using FF_DIFF_CMD. Therefore, commands that include dynamically changing values, such as port packet counters, should not be included in this list.

FF_CHASSIS_HEALTH can specify one command (with arguments) to be used to check the chassis health. For chassis with newer firmware, the hwCheck command is recommended. For chassis with older firmware, a benign command, such as fruInfo, should be used. The default is hwCheck. Note that only the exit status of the FF_CHASSIS_HEALTH command is checked. The output is not captured and compared in a snapshot. However, on failure its output is saved to aid diagnosis.

The opachassisanalysis tool performs its analysis against one or more chassis in the fabric. As such, it permits the chassis to be specified using the -H, -F, CHASSIS, chassis_file or opafastfabric.conf. The handling of these options and settings is comparable to opacmdall -C and similar FastFabric Toolset commands against a chassis.

All files generated by opafabricanalysis start with chassis. in the file name.

The opachassisanalysis tool generates files such as the following within FF_ANALYSIS_DIR. The actual file names reflect the individual chassis commands that have been configured through the FF_CHASSIS_HEALTH and FF_CHASSIS_CMDS parameters:

Health Check
  • latest/chassis.hwCheck

    Output of hwCheck command for all selected chassis

Baseline: During a baseline run, the following files are also created in FF_ANALYSIS_DIR/latest.

Full Analysis: The following .diff files are only created if differences are detected.

If the -s option is used and failures are detected, files related to the checks that failed are also copied to a time-stamped directory name under FF_ANALYSIS_DIR.

Chassis Items Checked Against the Baseline

Based upon showInventory:

Based upon fwVersion:

Based upon showNodeDesc:

Based upon timeZoneConf and timeDSTConf:

Based upon snmpCommunityConf and snmpTargetAddr:

The following Chassis items are not checked against baseline:

Chassis Items Also Checked During Health Check

Based upon hwCheck: