NAME

       opachassisanalysis

       (Switch) Performs analysis of the chassis.

       The  opachassisanalysis  tool  checks  the  following  for  the  Intel(R) Omni-Path Fabric
       Chassis:

       •      Chassis  configuration  (as  reported  by  the  chassis   commands   specified   in
              FF_CHASSIS_CMDS in opafastfabric.conf).

       •      Chassis  health  (as reported by the chassis command specified in FF_CHASSIS_HEALTH
              in opafastfabric.conf).

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 is /var/usr/lib/opa/analysis

       -F chassisfile

                 Specifies the file with the chassis in the cluster. Default is /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.

       •      baseline/chassis.fwVersion Output of fwVersion command for all selected chassis.

       •      baseline/chassis.showChassisIpAddr Output of the showChassisIpAddr. command for all
              selected chassis.

       •      baseline/chassis.showDefaultRoute  Output  of  the showDefaultRoute command for all
              selected chassis.

       •      baseline/chassis.showNodeDesc Output of the showNodeDesc command for  all  selected
              chassis.

       •      baseline/chassis.showInventory Output of the showInventory command for all selected
              chassis.

       •      baseline/chassis.snmpCommunityConf Output of the snmpCommunityConf command for  all
              selected chassis.

       •      baseline/chassis.snmpTargetAddr  Output  of  the  snmpTargetAddr  command  for  all
              selected chassis.

       •      baseline/chassis.timeDSTConf Output of the timeDSTConf  command  for  all  selected
              chassis.

       •      baseline/chassis.timeZoneConf  Output  of the timeZoneConf command for all selected
              chassis.

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

       •      latest/chassis.hwCheck Output of the hwCheck command for all selected chassis.

       •      latest/chassis.fwVersion Output of the fwVersion command for all selected chassis.

       •      latest/chassis.fwVersion.diff diff of the baseline and latest fwVersion.

       •      latest/chassis.showChassisIpAddr Output of the showChassisIpAddr  command  for  all
              selected chassis.

       •      latest/chassis.showChassisIpAddr.diff     diff     of     baseline    and    latest
              showChassisIpAddr.

       •      latest/chassis.showDefaultRoute Output of  the  showDefaultRoute  command  for  all
              selected chassis.

       •      latest/chassis.showDefaultRoute.diff   diff   of   the   baseline  and  the  latest
              showDefaultRoute.

       •      latest/chassis.showNodeDesc Output of the showNodeDesc  command  for  all  selected
              chassis.

       •      latest/chassis.showNodeDesc.diff diff of the baseline and latest showNodeDesc.

       •      latest/chassis.showInventory  Output  of the showInventory command for all selected
              chassis.

       •      latest/chassis.showInventory.diff diff of the baseline and latest showInventory.

       •      latest/chassis.snmpCommunityConf Output of the snmpCommunityConf  command  for  all
              selected chassis.

       •      latest/chassis.snmpCommunityConf.diff    diff    of   the   baseline   and   latest
              snmpCommunityConf.

       •      latest/chassis.snmpTargetAddr Output of the snmpTargetAddr command for all selected
              chassis.

       •      latest/chassis.snmpTargetAddr.diff diff of the baseline and latest snmpTargetAddr.

       •      latest/chassis.timeDSTConf  Output  of  the  timeDSTConf  command  for all selected
              chassis.

       •      latest/chassis.timeDSTConf.diff diff of the baseline and latest timeDSTConf.

       •      latest/chassis.timeZoneConf Output of the timeZoneConf  command  for  all  selected
              chassis.

       •      latest/chassis.timeZoneConf.diff diff of the baseline and latest timeZonfConf.

       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 :

       •      Addition/removal  of  Chassis  FRUsReplacement  is  only  checked  for  FRUs   that
              showInventory displays the serial number.

       •      Removal of redundant FRUs (spines, power supply, fan)

       Based upon fwVersion:

       •      Changes to primary or alternate FW versions installed in cards in chassis.

       Based upon showNodeDesc:

       •      Changes  to  configured  node  description  for chassis. Note changes detected here
              would also be detected in fabric level analysis.

       Based upon timeZoneConf and timeDSTConf:

       •      Changes to the chassis time zone and daylight savings time configuration.

       Based upon snmpCommunityConf and snmpTargetAddr:

       •      Changes to SNMP persistent configuration within the chassis.

       The following Chassis items are not checked against baseline:

       •      Changes  to  the  chassis  configuration  on  the  management  LAN  (for   example,
              showChassisIpAddr,  showDefaultRoute). Such changes typically result in the chassis
              not responding on the LAN at the expected address that is detected by failures that
              perform other chassis checks.

Chassis Items Also Checked During Health Check

       Based upon hwCheck:

       •      Overall health of FRUs in chassis:

       •      Status of Fans in chassis

       •      Status of Power Supplies in chassis

       •      Temp/Voltage for each card

       •      Presence of adequate power/cooling of FRUs

       •      Presence of N+1 power/cooling of FRUs

       •      Presence of Redundant AC input