Graceful Insertion and Removal

maintenance-template

To create a maintenance template, use the maintenance-template template_name command in the global configuration mode. To delete the template, use the no form of the command.

maintenance-template template_name

no maintenance-template template_name

Syntax Description

maintenance-template

Creates a template for GIR with a specific name.

template_name

Name of the maintanence template.

Command Default

Disabled.

Command Modes

Global configuration (config)

Command History

Release Modification

Cisco IOS XE Everest 16.6.1

This command was introduced.

Example:

Examples

The following example shows how to configure a maintenance template with the name g1: 

Device(config)# maintenance template g1

router routing protocol shutdown l2

To create instances that should be isolated within a maintenance template, use the router routing_protocol instance_id | shutdown l2 command in the maintenance template configuration mode. To delete the instance, use the no form of the command.

{ router routing_protocol instance_id | shutdown l2 }

no{ router routing_protocol instance_id | shutdown l2 }

Syntax Description

router

Configures instance associated with routing protocol.

routing_protocol

Routing protocol defined for the template.

instance_id

Instance ID associated with the routing protocol.

shutdown l2

Configures instance to shut down layer 2 interfaces.

Command Default

Disabled.

Command Modes

Maintenance template configuration (config-maintenance-temp)

Command History

Release Modification

Cisco IOS XE Everest 16.6.1

This command was introduced.

Example:

Examples

The following example shows how to create an instance for ISIS with an instance ID of one under maintenance template temp1: 

Device(config)# maintenance template g1
Device(config-maintenance-templ)# router isis 1

The following example shows how to create an instance for shutting down layer 2 interfaces under maintenance template g1: 

Device(config)# maintenance template g1
Device(config-maintenance-templ)# shutdown l2

start maintenance

To put the system into maintenance mode, use the start maintenance command in the privileged EXEC mode.

start maintenance

Syntax Description

start maintenance

Puts the system into maintenance mode.

Command Default

Disabled.

Command Modes

Privileged EXEC

Command History

Release Modification

Cisco IOS XE Everest 16.6.1

This command was introduced.

Example:

Examples

The following example shows how to start maintenance mode: 

Device# start maintenance

stop maintenance

To put the system out of maintenance mode, use the stop maintenance command in the privileged EXEC mode.

stop maintenance

Syntax Description

stop maintenance

Puts the system back into normal mode.

Command Default

Disabled.

Command Modes

Privileged EXEC

Command History

Release Modification

Cisco IOS XE Everest 16.6.1

This command was introduced.

Example:

Examples

The following example shows how to stop maintenance mode: 
Device# stop maintenance

system mode maintenance

To enter the system mode maintenance configuration mode, use the system mode maintenance command in the global configuration mode.

system mode maintenance

Syntax Description

system mode maintenance

Enters the maintenance configuration mode.

Command Default

Disabled.

Command Modes

Global configuration (config)

Command History

Release Modification

Cisco IOS XE Everest 16.6.1

This command was introduced.

Example:

Examples

The following example shows how to enter the maintenance configuration mode: 

Device(config)# system mode maintenance
Device(config-maintenance)#