maintenance-mode

Syntax

Hierarchy Level

Description

EVPN maintenance mode streamlines maintenance and upgrade operations in EVPN environments by minimizing traffic disruption. By isolating devices in a controlled manner, service interruptions during upgrades can be prevented. This feature operates seamlessly with multihomed edge-routed bridging (ERB) leaf nodes, rerouting traffic to alternate nodes to maintain network stability. It includes pre-checks and validations to ensure multihomed configurations, service tracking, and non-revertive designated forwarder (DF) settings are correctly configured.

Before initiating EVPN maintenance mode, prepare your network by ensuring out-of-band management capabilities and bandwidth availability to handle potential traffic loads when traffic is diverted to the multihomed peer. This feature does not support single-homed configurations or in-band network management during maintenance.

EVPN maintenance mode leverages the network isolation (NISO) configurations to disable the end-device facing access interfaces and divert traffic towards multihomed peer devices. This helps to isolate the node and prepare it for maintenance.

You initiate maintenance mode by configuring the set protocols evpn maintenance-mode erb-leaf action-type (validate-only|validate-and-set|force) statement. The validation options certify that your network is adequately configured before entering maintenance mode. These pre-checks verify multihomed configurations, enforce service tracking actions, and confirm non-revertive DF settings. By ensuring these conditions are met, the risk of service disruption during maintenance is reduced.

You can validate configurations before and after starting maintenance mode with the request evpn validate-maintenance-mode-pre-checks command. Then use show evpn maintenance-mode-status to view results of the pre-checks and monitor the current status. If you change any maintenance mode related configurations, rerun request evpn validate-maintenance-mode-pre-checks to update the validation.

Options

erb-leaf

Sets the maintenance-mode for an ERB leaf. action-type—Defines maintenance-mode action to take. force—Trigger maintenance-mode, ignores pre-check validations validate-and-set—Trigger maintenance-mode after pre-check validation validate-only—Validate maintenance-mode pre-checks, no action is taken

Required Privilege Level

routing—To view this statement in the configuration.

routing-control—To add this statement to the configuration.

Release Information

Statement introduced in Junos OS Release 25.3R1