system maintenance

Enters system maintenance mode.

Syntax

system maintenance
no system maintenance

Command Default

By default, system maintenance mode is not enabled.

Modes

Privileged EXEC mode

Usage Guidelines

Planned maintenance operations such as software upgrade, SFP replacement, cable replacement, and node replacement can require that the device be shutdown or restared. This can result in traffic disruption even if alternate paths are available. Maintenance mode provides graceful traffic diversion to alternate traffic paths, helping to minimize traffic loss during such planned operations.

When an alternate path is available, the BGP and MCT protocols redirect traffic away from the node that is going into maintenance mode. When maintenance mode is enabled, all protocols that are running on the maintenance mode node are notified and redirection of traffic (convergence) begins in stages.

The no form of the command disables maintenance mode. In config-system-maintenance sub-mode, the no enable command also disables maintenance mode.

The enable-on-reboot parameter allows the device to enter maintenance mode after a reboot, allowing any network errors and the device that gets added back to the network.

Maintenance mode is not supported for the following features: BGP address-family, Flowspec, Layer 3 VPN, VPLS, and VLL (virtual leased line).

Examples

The following example enables system maintenance mode and specifies a convergence time of 120 seconds.

SLX # configure terminal
SLX (config)# system maintenance
SLX (config-system-maintenance)# convergence-time 120
SLX (config-system-maintenance)# shutdown-time 360
SLX (config-system-maintenance)# enable

The following example disables maintenance mode.

SLX(config)# no system maintenance

The following example also disables maintenance mode.

device(config-system-maintenance)# no enable

The following example enables system reboot into maintenance mode

SLX # configure terminal
SLX (config)# system maintenance
SLX (config-system-maintenance)# enable-on-reboot