SR Linux maintenance mode allows you to take a network element out of service so that maintenance actions can be performed; for example, to upgrade the software image on a router.
Using SR Linux maintenance mode, you can do this with minimal impact on traffic. SR Linux maintenance mode works as follows:
A maintenance group specifies a set of network resources to be taken out of service when maintenance mode is enabled. For example, a maintenance group can consist of one or more BGP neighbors and/or peer groups belonging to a one or more network instances.
Example:
The following example configures maintenance group mgroup1, consisting of the BGP neighbors in peer group headquarters1, which exists in the default network instance, as well as BGP neighbors in peer group headquarters2, which exists in network instance “black”. In the example, maintenance group mgroup1 is associated with maintenance profile mprof1.
A maintenance profile specifies policy changes that are applied to members of a maintenance group when maintenance mode is enabled for the group.
Example:
The following example configures maintenance profile mprof1. A maintenance group associated with this maintenance profile uses the policies specified in this maintenance profile when maintenance mode is enabled for the group. In this example, a maintenance group associated with this maintenance profile uses the routing policy drain-with-as-path-prepend.
The following example defines the routing policy drain-with-as-path-prepend:
To place a maintenance group into maintenance mode, change the setting for maintenance-mode in the group configuration to enable, then commit the configuration.
Example:
The following example enables maintenance mode for maintenance group mgroup1, and commits the configuration:
After enabling maintenance mode for a maintenance group, monitor the traffic on the interfaces in the group. When the traffic rate drops to an acceptable level, shut down the members of the maintenance group and perform the required service.
Example:
To monitor traffic for an interface, use the info from state command to show interface traffic statistics. For example:
To shut down the interface:
After performing the required maintenance operations, restore the maintenance group to service. To do this, change the setting for the maintenance-mode state in the group configuration to disable, then commit the configuration.
Example:
The following example takes maintenance group mgroup1 out of maintenance mode: