configure sys-health-check all level

configure sys-health-check all level [normal | strict]

Description

Configures how the ExtremeXOS software handles faults for BlackDiamond X8 and BlackDiamond 8800 series switches and Summit family switches.

Syntax Description

normal Upon a fault detection, the switch only sends a message to the syslog. This is the default setting.
strict Upon a fault detection, the switch takes the action configured by the configure sys-recovery-level slot or the command.

Default

The default setting is normal.

Usage Guidelines

On a BlackDiamond X8 series switch or a BlackDiamond 8800 series switch, use this command in conjunction with the configure sys-recovery-level slot [all | slot_number] [none | reset | shutdown] command to implement your network's fault handling strategy.

On the Summit family switches, use this command in conjunction with the configure sys-recovery-level switch [none | reset | shutdown] command to implement your network‘s fault handling strategy.

ExtremeXOS 11.5 enhances the number of switch-fabric tests completed and monitored by the polling module of the system health checker. Additionally with ExtremeXOS 11.5, you can now configure how ExtremeXOS handles a detected fault based on the configuration of the configure sys-recovery-level slot [all | slot_number] [none | reset | shutdown] or the configure sys-recovery-level switch [none | reset | shutdown] command.

If you configure the strict parameter, the switch takes the action configured by the configure sys-recovery-level slot or the configure sys-recovery-level switch command, which can include logging only or restarting, rebooting, or shutting down the suspect device.

To maintain a smooth upgrade for devices running ExtremeXOS 11.4 and earlier, the switch-fabric tests introduced in ExtremeXOS 11.5 are set to only log error messages (?normal mode‘) by default. However, we recommend that you configure ?strict mode‘ so the system can attempt to recover by utilizing the action configured in the configure sys-recovery-level slot or the configure sys-recovery-level switch command (which by default is reset).

System Behavior for the BlackDiamond X8 Series Switches and BlackDiamond 8800 Series Switches

Depending on your switch configuration, the following table shows how the BlackDiamond X8 series switches and BlackDiamond 8800 series switches behave when the ExtremeXOS software detects a fault:
expand icon

System behavior for the BlackDiamond X8 and 8800 series switches

Fault Handling Configuration Module Recovery Configuration Behavior

configure sys-health-check all level normal

configure sys-recovery-level slot none

The switch sends messages to the syslog.

Same as above.

configure sys-recovery-level slot reset

Same as above.

Same as above.

configure sys-recovery-level slot shutdown

Same as above.

configure sys-health-check all level strict

configure sys-recovery-level slot none

Same as above.

Same as above.

configure sys-recovery-level slot reset

ExtremeXOS reboots the affected switch or module.

Same as above.

configure sys-recovery-level slot shutdown

ExtremeXOS shuts down the affected switch or module.

System Behavior for Summit Family Switches

Depending on your switch configuration, the following table shows how Summit family switches behave when the ExtremeXOS software detects a fault:
expand icon

System behavior for Summit family switches

Fault Handling Configuration Hardware Recovery Configuration Behavior

configure sys-health-check all level normal

configure sys-recovery-level switch none

The switch sends messages to the syslog.

Same as above.

configure sys-recovery-level switch reset

Same as above.

Same as above.

configure sys-recovery-level switch shutdown

Same as above.

configure sys-health-check all level strict

configure sys-recovery-level switch none

Same as above.

Same as above.

configure sys-recovery-level switch reset

ExtremeXOS reboots the affected switch.

Same as above.

configure sys-recovery-level switch shutdown

ExtremeXOS shuts down the affected switch.

Displaying the System Health Check Setting

To display the system health check setting, including polling and how ExtremeXOS handles faults on the switch, use the following command:

show switch

The system health check setting, displayed as SysHealth check, shows the polling setting and how ExtremeXOS handles faults. The polling setting appears as Enabled, and the fault handling setting appears in parenthesis next to the polling setting. In the following truncated output from a BlackDiamond 8810 switch, the system health check setting appears as SysHealth check: Enabled (Normal):

SysName:          TechPubs Lab
SysName:          BD-8810Rack3
SysLocation:
SysContact:       support@extremenetworks.com, +1 888 257 3000
System MAC:       00:04:96:1F:A2:60
SysHealth check:  Enabled (Normal)
Recovery Mode:    None
System Watchdog:  Enabled

If you use the strict parameter, which configures the switch to take the action configured by the configure sys-recovery-level slot or the configure sys-recovery-level switch command, (Strict) would appear next to Enabled.

Example

On a BlackDiamond 8800 series switch, the following command configures the switch to forward faults to be handled by the level set by the configure sys-recovery-level slot command:

configure sys-health-check all level strict

On Summit family switches, the following command configures the switch to forward faults to be handled by the level set by the configure sys-recovery-level switch command:

configure sys-health-check all level strict

History

This command was first available in ExtremeXOS 11.5.

Platform Availability

This command is available only on the BlackDiamond X8 and 8800 series switches, SummitStack, and Summit family switches.