- Table of Contents
-
- 01-Fundamentals Command Reference
- 00-Preface
- 01-CLI commands
- 02-RBAC commands
- 03-Login management commands
- 04-FTP and TFTP commands
- 05-File system management commands
- 06-Configuration file management commands
- 07-Software upgrade commands
- 08-ISSU commands
- 09-GIR commands
- 10-Preprovisioning commands
- 11-Device management commands
- 12-Tcl commands
- 13-Python commands
- 14-License management commands
- Related Documents
-
Title | Size | Download |
---|---|---|
09-GIR commands | 61.69 KB |
GIR commands
display gir snapshot
Use display gir snapshot to display the GIR snapshots on the device.
Syntax
display gir snapshot
Views
Any view
Predefined user roles
network-admin
network-operator
mdc-admin
mdc-operator
Usage guidelines
This command displays information about the before_maintenance and after_maintenance snapshots taken upon the most recent changes to maintenance mode and normal mode, respectively. This information includes the name and timestamp of each snapshot.
This information is helpful when you make a snapshot comparison decision to identify configuration inconsistencies that might cause service anomalies or the switchover failure of a protocol.
Examples
# Display the GIR snapshots on the device.
<Sysname> display gir snapshot
Name Time Description
before_maintenance Mon Aug 24 10:10:10 2020 Snapshot taken before maintenance
after_maintenance Mon Aug 24 11:10:10 2020 Snapshot taken after maintenance
Related commands
display gir snapshot compare
gir system-mode maintenance
display gir snapshot compare
Use display gir snapshot compare to compare the GIR snapshots.
Syntax
display gir snapshot compare snapshot1-name snapshot2-name [ verbose ]
Views
Any view
Predefined user roles
network-admin
network-operator
mdc-admin
mdc-operator
Parameters
snapshot1-name: Specifies the first GIR snapshot by its name, which can be before_maintenance or after_maintenance.
Snapshot2-name: Specifies the second GIR snapshot by its name, which can be before_maintenance or after_maintenance.
verbose: Displays detailed information about configuration inconsistencies. If you do not specify this keyword, the command displays summary information about the comparison results.
Usage guidelines
Use this command to compare the configuration of affected protocols before and after a GIR operation for inconsistencies.
The amount of time for comparison depends on the size of the snapshots. It will take a long time to compare large snapshots.
The snapshots are saved in NETCONF format. For more information about the feature modules and parameters in the command output, see the NETCONF XML API references for your device.
Examples
# Display summary information about GIR snapshot comparison results.
<Sysname> display gir snapshot compare before_maintenance after_maintenance
Feature before_maintenance after_maintenance changed
basic
# Interfaces 39 39 N
# ipv4 routes 7 7 N
# ipv6 routes 7 7 N
ifmgr
# interfaces up 1 0 Y
# interfaces down 38 39 Y
# vlan interfaces 2 2 N
# vlan interfaces up 0 0 N
# vlan interfaces down 2 2 N
# Display detailed information about GIR snapshot comparison results.
<Sysname> display gir snapshot compare before_maintenance after_maintenance verbose
Feature Tag before_maintenance after_maintenance
[ifmgr]
[IfIndex:258]
AdminStatus 1 2
OperStatus 1 3
[Route]
[VRF:N/A Topology:N/A ProtocolID: 1]
TotalRoutes 3 4
The output shows that the state of the interface with index 258 and the number of routes changed after the device entered the maintenance mode.
Related commands
display gir snapshot
display gir system-mode
Use display gir system-mode to display the current GIR mode.
Syntax
display gir system-mode
Views
Any view
Predefined user roles
network-admin
network-operator
mdc-admin
mdc-operator
Examples
# Display the current GIR mode.
<Sysname> display gir system-mode
System mode: Normal
gir system-mode maintenance
Use gir system-mode maintenance to place the device in maintenance mode.
Use undo gir system-mode maintenance to restore the default.
Syntax
gir system-mode maintenance
undo gir system-mode maintenance
Default
The device is in normal mode.
Views
System view
Predefined user roles
network-admin
mdc-admin
Usage guidelines
CAUTION: · Packet loss might occur when you switch to maintenance mode. · Do not restart the device or a process while GIR is switching mode. The system cannot roll back settings issued during mode switching. If you restart the device or a disruptive process, mode switching will be interrupted, with only some of the commands issued. |
Before you change the GIR mode, follow these restrictions and guidelines:
· Make sure the system is stable. Use the display system stable state command to identify the system state. The system is stable if the System State field displays Stable. For more information about this command, see device management commands in Fundamentals Command Reference.
· If the device is comparing snapshots, wait the comparison to end before you change the GIR mode.
· Before you change a DRNI system back to normal mode, execute the display drni mad verbose command to verify that no network interfaces are in DRNI MAD DOWN state. For more information about DRNI, see Layer 2—LAN Switching Configuration Guide.
After you change the GIR mode, follow these restrictions and guidelines:
· After you place the device in maintenance mode, do not modify the configuration of each protocol. If you modify the configuration of a protocol, the new configuration will overwrites the original configuration after the device exits maintenance mode.
· If a protocol fails in switchover, use the following methods to identify and remove the issue:
¡ Remove the issue based on the error message.
¡ Compare the snapshots to identify configuration inconsistencies that might cause the issue.
Examples
# Place the device in maintenance mode.
<Sysname> system-view
[Sysname] gir system-mode maintenance
Collecting commands... Please wait.
Configuration to be applied:
link-aggregation lacp isolate
bgp 1
isolate enable
Do you want to continue? [Y/N]: y
Generated a snapshot: before_maintenance.
Applying: link-aggregation lacp isolate…OK
Applying: bgp 1…OK
Applying: isolate enable…OK
Changed to maintenance mode successfully.
# Change the device back to normal mode.
[Sysname] undo gir system-mode maintenance
Collecting commands... Please wait.
Configuration to be applied:
undo link-aggregation lacp isolate
bgp 1
undo isolate enable
Do you want to continue? [Y/N]: y
Applying: undo link-aggregation lacp isolate…OK
Applying: bgp 1…OK
Applying: undo isolate enable…OK
Changed to normal mode successfully.
Generated a snapshot: after_maintenance.