health command

This command displays the current health status of the command target. It can also be used to display the alerts that are active for the command target.

You can only specify one command target each time you run the health command.

For the compute node command target, one of the following health states is returned. This state will reflect the highest health state reported by any other component installed in the compute node, unless the state reported by the compute node itself is higher.

For command targets other than a compute node, one of the following health states is returned. For the Flex System Enterprise Chassis, this state will reflect the highest health state reported by any other component installed in the chassis, unless the state reported by the chassis itself is higher.

Note: The various CMM interfaces use different terms to indicate the same condition:
  • Web interface: Critical symbol for critical system event, Attention symbol for non-critical system event, Normal symbol for normal system event
  • SNMP: Critical/Bad, Warning, Good
  • CLI: Critical, Non-critical, OK

If command syntax is not correctly entered, or if a command fails to run, an error message is returned. See Common errors for a list of error messages that apply to all commands or health command errors for a list of error messages that are specific to the health command.

Table 1. health command.

The command table is a multi-row, four-column table where each row describes a CMM CLI command option: column one lists command function, column two provides a detailed command description, column three shows command-option syntax, and column four lists valid command targets.

Function What it does Command Target (see paths in Command targets)
Display health status Displays the current health status of the command target.
  • Possible return values for the compute node target are:
    • ok
    • non-critical
    • critical
  • Possible return values for other targets are:
    • ok
    • system level
    • non-critical
    • critical
health
Flex System Enterprise Chassis:
  • system
Primary CMM:
  • mm[p]
  • mm[P]
  • mm[x]
  • where x is the primary CMM bay number.
Compute node:
  • blade[x]
  • where x is the node bay number.
I/O module:
  • switch[x]
  • where x is the I/O-bay number.
Power supply:
  • power[x]
  • where x is the power supply bay number.
Fan module:
  • blower[x]
  • where x is the fan module bay number.
Display health status for tree Displays the current health status of the tree structure of devices present in the Flex System Enterprise Chassis, starting at the command target level. If CMM bays are part of the tree, they will be identified as primary or standby (redundant).
  • Possible return values for the compute node target are:
    • ok
    • non-critical
    • critical
  • Possible return values for other targets are:
    • ok
    • system level
    • non-critical
    • critical
health -l depth
where depth
  • 1 displays health status of the current command target
  • 2 , all , or a displays a full tree display, starting at the command target level
Flex System Enterprise Chassis:
  • system
Primary CMM:
  • mm[p]
  • mm[P]
  • mm[x]
  • where x is the primary CMM bay number.
Compute node:
  • blade[x]
  • where x is the node bay number.
I/O module:
  • switch[x]
  • where x is the I/O-bay number.
Power supply:
  • power[x]
  • where x is the power supply bay number.
Fan module:
  • blower[x]
  • where x is the fan module bay number.
Display health status and alerts Displays the current health status and active alerts for the command target.
  • Possible return values for the compute node target are:
    • ok
    • non-critical
    • critical
  • Possible return values for other targets are:
    • ok
    • system level
    • non-critical
    • critical
  • Active alert information provides short text descriptions of alerts that are active for each monitored component.

The total amount of information returned from the health -f command is limited to 1024 bytes.

health -f
Flex System Enterprise Chassis:
  • system
Primary CMM:
  • mm[p]
  • mm[P]
  • mm[x]
  • where x is the primary CMM bay number.
Compute node:
  • blade[x]
  • where x is the node bay number.
I/O module:
  • switch[x]
  • where x is the I/O-bay number.
Power supply:
  • power[x]
  • where x is the power supply bay number.
Fan module:
  • blower[x]
  • where x is the fan module bay number.
Display results with timestamp Adds display of timestamp information to status command output. health -t
Note: The -t option must be used with the -f option.
Flex System Enterprise Chassis:
  • system
Primary CMM:
  • mm[p]
  • mm[P]
  • mm[x]
  • where x is the primary CMM bay number.
Compute node:
  • blade[x]
  • where x is the node bay number.
I/O module:
  • switch[x]
  • where x is the I/O-bay number.
Power supply:
  • power[x]
  • where x is the power supply bay number.
Fan module:
  • blower[x]
  • where x is the fan module bay number.
Example: To display the health status and alerts in a tree structure with time stamps for all components installed in the Flex System Enterprise Chassis, that are valid command targets, while the Flex System Enterprise Chassis is set as the default command target, at the system> prompt, type
health -l a -f -t

The following example shows the information that is returned from these commands:

system> health -l a -f -t
system   :                    Critical
         bladegroup[3]
                  blade[1]  : OK
                  blade[2]  : Critical
                  (04/04/13, 08:57:08) Node Node 03 - 02 message: System-management
                  software, (IMM2 FW Failover) unsupported software version, node 
                  system-management processor firmware boot block.
         blade[4]  :          Non-Critical
         (04/04/13, 08:43:54) Node Node 04 device Storage back plane[01] VPD is  
         not valid.
         blade[5]  :          Critical
         (04/04/13, 08:57:08) Node Node 05 message: System firmware, firmware 
         progress (Firmware Error) error. Error, See reference code BA15D001  
         (53087D2D BA15D001 00000000 00000000 00000000 00000000 00000000 00000000 
         00000000 00000000)
         bladeenclosure[7]
                  blade[1]  : OK
                  blade[2]  : OK
         bladeenclosure[11]
                  blade[1]  : Critical
                  (04/04/13, 08:57:08) Node Node 11 - 01 message: System-management
                  software, (IMM2 FW Failover) unsupported software version, node 
                  system-management processor firmware boot block.
                  blade[2]  : OK
         blower[1] :          OK
         blower[2] :          OK
         blower[3] :          OK
         blower[4] :          OK
         blower[5] :          OK
         blower[6] :          OK
         blower[7] :          OK
         blower[8] :          OK
         blower[9] :          OK
         blower[10]:          OK
         power[1]  :          Non-Critical
         (04/04/13, 08:43:49) Power supply Power Supply 01 is off. AC fault.
                  blower[1] : OK
         power[2]  :          Non-Critical
         (04/04/13, 08:43:49) Power supply Power Supply 02 is off. AC fault.
                  blower[1] : OK
         power[3]  :          Non-Critical
         (04/04/13, 08:43:49) Power supply Power Supply 03 is off. AC fault.
                  blower[1] : OK
         power[4]  :          OK
                  blower[1] : OK
         power[5]  :          OK
                  blower[1] : OK
         power[6]  :          OK
                  blower[1] : OK
         mm[2]     :          OK
         (04/04/13, 08:50:52) Hot air exiting from the rear of the chassis might 
         be recirculated in the inlet air at the front of the chassis. Slot 11: 
         28.00C, Slot 3: 21.00C.
         switch[2] :          OK
         switch[3] :          OK
         mt[1]     :          OK
         fanmux[1] :          OK
         fanmux[2] :          OK
system>