01-Fundamentals Command Reference

HomeSupportResource CenterSwitchesS12500X-AF SeriesS12500X-AF SeriesTechnical DocumentsReference GuidesCommand ReferencesH3C S12500X-AF Switch Series Command References(R28xx)-6W10001-Fundamentals Command Reference
09-GIR commands
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

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.

 

  • Cloud & AI
  • InterConnect
  • Intelligent Computing
  • Security
  • SMB Products
  • Intelligent Terminal Products
  • Product Support Services
  • Technical Service Solutions
All Services
  • Resource Center
  • Policy
  • Online Help
All Support
  • Become a Partner
  • Partner Resources
  • Partner Business Management
All Partners
  • Profile
  • News & Events
  • Online Exhibition Center
  • Contact Us
All About Us
新华三官网