ExtremeXOS® Command Reference Guide

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

Description

Configures how the ExtremeXOS software handles faults for the switch.

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

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).

Depending on your switch configuration, the following table shows how ExtremeSwitching series switches behave when the ExtremeXOS software detects a fault:

Table 1. System Behavior for ExtremeSwitching Series 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, 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.

History

This command was first available in ExtremeXOS 11.5.

Platform Availability

This command is available on the ExtremeSwitching X435, X440-G2, X450-G2, X460-G2, X465, X590, X620, X670-G2, X690, X695, and X870 series switches.

configure sys-health-check all level