09-GIR命令
本章节下载: 09-GIR命令 (194.29 KB)
display gir snapshot命令用来显示GIR快照信息。
【命令】
display gir snapshot
【视图】
任意视图
【缺省用户角色】
network-admin
network-operator
mdc-admin
mdc-operator
【使用指导】
用户可以通过本命令查看生成的快照信息,如果模式切换过程中有业务模块命令下发失败,可以通过比较生成的快照进行确认。
【举例】
# 显示GIR快照信息。
<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
表1-1 display gir snapshot命令显示信息描述表
字段 |
描述 |
Name |
GIR快照名,取值包括: · before_maintenance:设备进入维护模式前生成的GIR快照 · after_maintenance:设备退出维护模式后生成的GIR快照 |
Time |
GIR快照的生成时间 |
Description |
GIR快照的描述信息,取值包括: · Snapshot taken before maintenance:表示该快照是设备进入维护模式前生成的 · Snapshot taken after maintenance:表示该快照是设备退出维护模式后立即生成的 |
【相关命令】
· gir system-mode maintenance
· display gir snapshot compare
display gir snapshot compare命令用来显示GIR快照的比较信息。
【命令】
display gir snapshot compare snapshot1-name snapshot2-name [ verbose ]
【视图】
任意视图
【缺省用户角色】
network-admin
network-operator
mdc-admin
mdc-operator
【参数】
snapshot1-name:表示参与比较的第一个GIR快照的名称,取值为before_maintenance或after_maintenance。
snapshot2-name:表示参与比较的第二个GIR快照的名称,取值为before_maintenance或after_maintenance。
verbose:显示GIR快照的详细比较信息,且只显示有差异的信息。如果未指定本参数,则显示GIR快照的概要比较信息。
【使用指导】
用户可以通过本命令确认设备模式切换前后是否存在配置差异。如果有配置差异,请用户根据具体的差异信息排查原因。
当参与比较的快照较大时,会耗时较长。
快照存放的为当前配置对应的NETCONF文件,如果想要了解Feature和Tag字段的详细含义,请参见《NETCONF XML API手册》。
【举例】
# 显示GIR快照的概要比较信息。
<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
表1-2 display gir snapshot compare命令显示概要信息描述表
字段 |
描述 |
Feature |
特性名称 |
before_maintenance |
对应特性在before_maintenance中的配置信息条数和接口个数 |
after_maintenance |
对应特性在after_maintenance中的配置信息条数和接口个数 |
Changed |
对应特性的配置信息差异标记,取值包括: · Y:表示配置信息有差异 · N:表示配置信息没有差异 |
# 显示GIR快照的详细比较信息。
<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
以上信息表示,设备切换到维护模式后:
· 接口索引为258的接口状态发生了改变。
· 路由表的条数也发生了改变。
表1-3 display gir snapshot compare命令显示详细信息描述表
字段 |
描述 |
Feature |
特性名称 |
Tag |
参与比较的Tag |
before_maintenance |
对应字段在before_maintenance中的取值 |
after_maintenance |
对应字段在after_maintenance中的取值 |
【相关命令】
· display gir snapshot
display gir system-mode命令用来显示当前GIR模式。
【命令】
display gir system-mode
【视图】
任意视图
【缺省用户角色】
network-admin
network-operator
mdc-admin
mdc-operator
【举例】
# 显示当前GIR模式。
<Sysname> display gir system-mode
System mode:Normal
表1-4 display gir system-mode命令显示信息描述表
字段 |
描述 |
System mode |
系统模式,取值包括: · Normal:普通模式 · Maintenance:维护模式 |
【相关命令】
· gir system-mode maintenance
gir system-mode maintenance命令用来将设备从普通模式切换到维护模式。
undo gir system-mode maintenance命令用来将设备从维护模式切换到普通模式。
【命令】
gir system-mode maintenance
undo gir system-mode maintenance
【缺省情况】
设备处于普通模式。
【视图】
系统视图
【缺省用户角色】
network-admin
mdc-admin
【使用指导】
· 执行本命令后,可能会发生流量丢包导致相关业务中断,请谨慎使用。
· 在模式切换过程中,请不要重启设备或进程,设备重启或部分进程重启可能会中止模式切换,而且已下发的业务模块命令无法回滚。
执行本命令前,请注意:
· 请在设备处于稳定状态时执行本命令,避免命令下发失败。用户可以执行display system stable state命令查看设备状态。有关display system stable state命令的详细介绍,请参见“基础配置命令参考”中的“设备管理”。
· 如果设备正在进行快照显示和比较,请等待快照显示和比较命令结束后再执行模式切换命令。
· 在M-LAG应用场景下,如果要将设备从维护模式切回到普通模式,请先执行display m-lag mad verbose命令确认设备接口状态未处于“M-LAG MAD DOWN”状态,再执行undo gir system-mode maintenance命令。有关M-LAG的详细介绍,请参见“二层技术-以太网交换配置指导”中的“M-LAG”。
执行本命令后,请注意:
· 切换到维护模式后,请不要修改各业务模块的配置,否则可能会导致退出维护模式后,设备配置与原来配置不一致。
· 若业务模块的命令下发失败,会提示失败信息,但不会影响其它命令下发。如果某业务模块的命令下发失败,用户可根据业务模块的具体提示信息排查失败原因。
在进行模式切换时,部分命令行执行需要一定时间,存在延迟生效的情况。系统会等待一段时间后再执行下一条命令,具体的等待时间请以设备的实际情况为准。
【举例】
# 将设备从普通模式切换到维护模式。
<Sysname> system-view
[Sysname] gir system-mode maintenance
Collecting commands... Please wait.
Configuration to be applied:
bgp 1
isolate enable
link-aggregation lacp isolate bagg
Do you want to continue? [Y/N]: y
Generated a snapshot: before_maintenance.
Applying: bgp 1…OK
Applying: isolate enable…OK
It takes 30 seconds to proceed to the next command.
Applying: link-aggregation lacp isolate bagg…OK
Changed to maintenance mode successfully.
# 将设备从维护模式切换到普通模式。
[Sysname] undo gir system-mode maintenance
Collecting commands... Please wait.
Configuration to be applied:
undo link-aggregation lacp isolate bagg
bgp 1
undo isolate enable
Do you want to continue? [Y/N]: y
Applying: undo link-aggregation lacp isolate bagg…OK
It takes 30 seconds to proceed to the next command.
Applying: bgp 1…OK
Applying: undo isolate enable…OK
Changed to normal mode successfully.
Generated a snapshot: after_maintenance.
不同款型规格的资料略有差异, 详细信息请向具体销售和400咨询。H3C保留在没有任何通知或提示的情况下对资料内容进行修改的权利!