• 产品与解决方案
  • 行业解决方案
  • 服务
  • 支持
  • 合作伙伴
  • 新华三人才研学中心
  • 关于我们

01-基础配置命令参考

目录

07-ISSU命令

本章节下载 07-ISSU命令  (137.48 KB)

07-ISSU命令


1 ISSU

说明

本特性仅S5500-EI系列交换机支持。

 

1.1  ISSU命令

1.1.1  display issu rollback-timer

【命令】

display issu rollback-timer [ | { begin | exclude | include } regular-expression ]

【视图】

任意视图

【缺省级别】

1:监控级

【参数】

|:使用正则表达式对显示信息进行过滤。有关正则表达式的详细介绍,请参见“基础配置指导”中的“CLI”。

begin:从包含指定正则表达式的行开始显示。

exclude:只显示不包含指定正则表达式的行。

include:只显示包含指定正则表达式的行。

regular-expression:表示正则表达式,为1~256个字符的字符串,区分大小写。

【描述】

display issu rollback-timer命令用来显示版本回滚定时器的相关信息。

需要注意的是,本次设置的版本回滚定时器时长在下次使用ISSU升级时才会生效,所以可能出现本次回滚超时时间大于已设置的定时器时长的情况。

相关命令可参见命令issu rollback-timer

【举例】

# 查看版本回滚定时器设置和本次回滚超时时长。

<Sysname> display issu rollback-timer

RollBack timer is in process.

Configured Rollback Timer: 45 minutes.

Left: 43 minutes.

表1-1 display issu rollback-timer命令显示信息描述表

字段

描述

RollBack timer is in process

ISSU升级正在进行中,版本回滚定时器处于工作状态

RollBack timer is not in process

版本回滚定时器处于非工作状态,有以下三种情况:

·     没有进行ISSU升级

·     ISSU升级已完成

·     ISSU升级过程中,启动文件的自动回滚功能已失效(执行issu accept或者issu commit命令都会删除版本回滚定时器)

Configured Rollback Timer

用户配置的版本回滚定时器的时长

Left

距离版本回滚定时器超时的剩余时间(只有版本回滚定时器处于工作状态时才显示)

 

1.1.2  display issu state

【命令】

display issu state [ | { begin | exclude | include } regular-expression ]

【视图】

任意视图

【缺省级别】

1:监控级

【参数】

|:使用正则表达式对显示信息进行过滤。有关正则表达式的详细介绍,请参见“基础配置指导”中的“CLI”。

begin:从包含指定正则表达式的行开始显示。

exclude:只显示不包含指定正则表达式的行。

include:只显示包含指定正则表达式的行。

regular-expression:表示正则表达式,为1~256个字符的字符串,区分大小写。

【描述】

display issu state命令用来查看当前IRF进行ISSU升级所处的状态(包括:新启动文件版本和原启动文件版本是否兼容,具体采用的ISSU升级方式等相关信息)。

ISSU升级由一系列步骤组成,升级过程中有严格的步骤要求,通过该命令的显示信息来帮忙管理员确定下一步需执行的操作。

【举例】

# 进行ISSU升级前,查看ISSU状态。

<Sysname> display issu state

ISSU state: Init

Compatibility: Unknown

Work State: Normal

# 执行issu load命令后,在Master设备上查看ISSU状态。

<Sysname> display issu state

ISSU state: Load

Compatibility: Compatible

Work State: Normal

Upgrade Method: Board by board

Original version:   version1

Original boot file is flash:/soft-version1.bin

Upgrade version:  version2

Upgrade boot file is flash:/soft-version2.bin

表1-2 display issu state命令显示信息描述表

字段

描述

ISSU state

ISSU升级所处阶段,取值可能为:

·     Init:表示还没有进行ISSU升级或者ISSU升级已经完成

·     Load:表示IRF中指定Slave设备已经完成升级,版本回滚定时器自动创建且处于正常工作状态

·     Switchover:表示已手动触发Master设备重启(已执行issu run switchover命令)

·     Accept:表示已确认ISSU升级,版本回滚定时器失效,在此次ISSU升级过程中系统不会再进行自动回滚

·     Commit:表示IRF系统中成员设备尚未全部完成升级。进入该状态后,不能通过手动或自动回滚方式进行启动文件的版本回滚

Compatibility

版本兼容性检查结果,取值可能为:

·     Compatible:表示设备当前运行的启动文件与新启动文件版本兼容

·     Incompatible:表示设备当前运行的启动文件与新启动文件不兼容。不兼容版本升级需要在执行issu load命令时携带force参数,指定成员设备用新启动文件重启后,进入Recover状态

·     Unknown:表示指定的启动文件版本不支持ISSU功能、或者不能通过ISSU功能来进行启动文件的升级。不能采用ISSU方式进行IRF系统的启动文件升级

Work State

IRF系统的工作模式,取值可能为

·     Normal:表示正常模式

·     Independent Active:表示采用ISSU非兼容方式升级、该指定成员设备用新启动文件重启后进入了Recover状态。

Upgrade Method

ISSU升级方式,取值为Board by board

Original version

进行ISSU升级前,IRF系统中各成员设备运行的启动文件

Original boot file

ISSU升级前,设备运行的启动文件的保存路径

Upgrade version

新启动文件的版本信息(NA表示还没有获取到启动文件的版本信息,可能成员设备还在升级过程中,没有完成版本信息的交互)

Upgrade boot file

新启动文件的保存路径

 

1.1.3  display version comp-matrix

【命令】

display version comp-matrix [ file upgrading-filename ] [ | { begin | exclude | include } regular-expression ]

【视图】

任意视图

【缺省级别】

1:监控级

【参数】

file upgrading-filename:用来显示指定文件与当前运行启动文件的版本兼容性信息。

指定的启动文件upgrading-filename必须是Flash中已经存在的文件,采用的输入格式为[drive:/]file-name

·     [ ]表示该参数可选。

·     drive用来指定文件在IRF中哪个成员设备的Flash上,取值为[ slotslot-number# ]flash:。

·     file-name表示新启动文件的名称。

如果用户输入指定启动文件的格式采用相对路径file-name,则执行命令时系统会自动将相对路径转换为绝对路径[drive:/]file-name。绝对路径最多不能超过63个字符,否则,命令执行失败。

|:使用正则表达式对显示信息进行过滤。有关正则表达式的详细介绍,请参见“基础配置指导”中的“CLI”。

begin:从包含指定正则表达式的行开始显示。

exclude:只显示不包含指定正则表达式的行。

include:只显示包含指定正则表达式的行。

regular-expression:表示正则表达式,为1~256个字符的字符串,区分大小写。

【描述】

display version comp-matrix命令用来显示启动文件的版本兼容性信息。

·     如果指定upgrading-filename,则显示当前启动文件与指定启动文件间的版本兼容性信息。

·     如果不指定upgrading-filename,则显示当前启动文件版本的兼容数据库信息(兼容数据库是设备内部的一段内存区,记录了历史版本的编号以及与当前运行的启动文件是否兼容等信息)。

【举例】

# 显示当前启动文件版本的兼容数据库信息。

<Sysname> display version comp-matrix

Number of Matrices in Table = 1

Matrix for S5500-EI

 

Running Version: version1

Version Compatibility List:

Version2 (Compatible)

Version3 (Compatible)

# 执行issu load操作后,查看当前启动文件和新启动文件software.bin的版本兼容性信息。

<Sysname> display version comp-matrix file software.bin

Number of Matrices in Table = 1

Matrix for S5500-EI

 

Running Version: version1

Version Compatibility List:

version2 (Compatible)

表1-3 display version comp-matrix命令显示信息描述表

字段

描述

Number of Matrices in Table

当前IRF系统中包含的产品版本数量

Matrix for xx

xx系列设备的产品版本

Running Version

IRF系统当前运行的启动文件版本

Version Compatibility List

版本兼容信息列表

AA (Compatible)

版本为AA的启动文件与当前运行的启动文件兼容

BB (Incompatible)

版本为BB的启动文件与当前运行的启动文件不兼容(进行ISSU升级时issu load命令需带force参数)

CC (Unknown)

版本为CC的启动文件与当前运行的启动文件兼容性未知

 

1.1.4  issu accept

【命令】

issu accept slot slot-number

【视图】

系统视图

【缺省级别】

2:系统级

【参数】

slot slot-number:表示IRF中成员设备的编号,必须和issu load命令中指定的slot-number相同。

【描述】

issu accept命令用来确认ISSU升级,从而取消启动文件的自动回滚功能。

执行此命令后,启动文件的版本回滚定时器失效,IRF系统无法将成员设备的启动文件自动回滚恢复到原始版本。

相关配置可参见命令issu loadissu commit

【举例】

# 对已升级的成员设备(假设所在槽位号为1)进行确认。

<Sysname> system-view

[Sysname] issu accept slot 1

1.1.5  issu commit

【命令】

issu commit slot slot-number

【视图】

系统视图

【缺省级别】

2:系统级

【参数】

slot slot-number:IRF系统中尚未进行ISSU升级的成员设备的编号。

【描述】

issu commit命令用来对IRF系统中尚未升级的成员设备进行升级。

执行该命令且所有IRF成员设备都使用新版本启动文件运行后,ISSU升级结束(不能再通过issu rollback命令或者版本回滚定时器进行版本回滚)。

相关配置可参见命令issu loadissu accept

【举例】

# 对IRF系统中尚未进行ISSU升级的成员设备进行升级(假设成员编号为2)。

<Sysname> system-view

[Sysname] issu commit slot 2

The specified board will reboot and be upgraded. Continue? [Y/N]:y

1.1.6  issu load

【命令】

issu load file upgrading-filename slot slot-number [ force ]

【视图】

系统视图

【缺省级别】

2:系统级

【参数】

file upgrading-filename:表示新启动文件。

新启动文件upgrading-filename必须是Flash根目录中已经存在的文件,采用的输入格式为[drive:/]file-name

·     [ ]表示该参数可选。

·     drive用来指定文件在IRF中哪个成员设备的Flash上,取值为[ slotslot-number# ]flash:。

·     file-name表示新启动文件的名称。

如果用户输入新启动文件的格式采用相对路径file-name,则执行命令时系统会自动将相对路径转换为绝对路径[drive:/]file-name。绝对路径最多不能超过64个字符,否则,命令执行失败。

slot slot-number:表示成员设备的编号。

force:用来对不兼容版本的启动文件进行强制升级。如果新启动文件与当前启动文件不兼容,则需要使用force参数进行强制升级,否则不能使用ISSU进行升级;如果新启动文件与当前启动文件兼容,则不管是否使用force参数,都能使用ISSU进行升级。

【描述】

issu load file upgrading-filename slot slot-number [ force ]命令用来升级指定的Slave设备。

执行此命令以后,指定Slave设备将使用新的启动文件进行自动重启

需要注意的是:

·     执行issu load命令前,要求Master设备和slave设备上运行的启动文件必须相同(即文件版本、文件名和路径都相同),否则,无法进行ISSU升级。

·     执行issu load命令前,请确保新启动文件已保存到所有IRF成员设备的Flash中,如未保存则不能采用ISSU方式进行启动文件升级。

·     执行issu load命令前,请确保IRF系统中所有成员设备当前运行的启动文件相同,如果不同则不能采用ISSU方式进行启动文件升级

【举例】

# 升级指定的Slave(假设成员编号为2),使用的升级启动文件为new.bin。

<Sysname> system-view

[Sysname] issu load file new.bin slot 2

This command will begin ISSU, and the specified board will reboot and be upgrade

d. Please save the current running configuration first; otherwise, the configura

tion may be lost.Continue? [Y/N]: y

1.1.7  issu rollback

【命令】

issu rollback slot slot-number

【视图】

系统视图

【缺省级别】

2:系统级

【参数】

slot slot-number:IRF系统中已升级的成员设备的编号,取值必须和issu load命令中指定的slot-number相同。

【描述】

issu rollback命令用来取消此次ISSU升级,并将成员设备的启动文件手动回滚恢复到原始版本。

需要注意的是:

·     当IRF系统成员设备在ISSU升级重启过程中不允许进行启动文件版本的手动回滚。

·     在用户执行issu commit命令以后,IRF系统中尚未进行ISSU升级的成员设备将进行升级重启,此时不允许进行启动文件版本的手动回滚。

相关配置可参见命令issu load

【举例】

# 取消ISSU升级,将成员设备的启动文件手动回滚恢复到原始版本(假设issu load时指定的成员设备编号为1)。

<Sysname> system-view

[Sysname] issu rollback slot 1

This command will quit the ISSU process and the specified board  will roll back to the previous version. Continue? [Y/N]:y

1.1.8  issu rollback-timer

【命令】

issu rollback-timer minutes

undo issu rollback-timer

【视图】

系统视图

【缺省级别】

2:系统级

【参数】

minutes:版本回滚定时器的超时时长,取值范围为0~120,单位为分钟。取值为0则表示关闭自动回滚功能,在执行issu load命令时不会创建版本回滚定时器。

【描述】

issu rollback-timer命令用来设置版本回滚定时器的超时时长。undo issu rollback-timer命令用来恢复缺省情况。

缺省情况下,版本回滚定时器的超时时长为45分钟。

执行issu load命令后,如果直到版本回滚定时器超时、还未执行issu commit命令对IRF系统中尚未升级的成员设备进行ISSU升级、或未通过issu accept命令取消自动回滚功能,则设备将自动终止ISSU升级操作,启动文件将恢复到升级前的版本。

需要注意的是,在进行ISSU升级过程中,当执行了issu load命令以后,如果再修改版本回滚定时器的超时时长,修改后的超时时长对此次ISSU升级无效。

【举例】

# 设置版本回滚定时器的时长为30分钟。

<Sysname> system-view

[Sysname] issu rollback-timer 30

1.1.9  issu run switchover

【命令】

issu run switchover slot slot-number

【视图】

系统视图

【缺省级别】

2:系统级

【参数】

slot slot-number:IRF系统中已升级的成员设备的编号,取值必须和issu load命令中指定的slot-number相同。

【描述】

issu run switchover命令用来手工触发原Master设备重启。

需要注意的是:

·     兼容版本ISSU升级过程中,执行issu run switchover命令后,如果直到版本回滚定时器超时、还未执行issu commit命令对IRF系统中尚未升级的成员设备进行ISSU升级、或未通过issu accept命令取消自动回滚功能,则设备将自动终止ISSU升级操作,启动文件将恢复到升级前的版本。

·     不兼容版本ISSU升级过程中,执行本命令以后,除了指定的Slave设备,其余IRF成员设备将使用新版本启动文件进行重启,重启完成后ISSU升级结束。

相关配置可参见命令issu load

【举例】

# 手工触发原Master设备重启

<Sysname> system-view

[Sysname] issu run switchover slot 1

Master will reboot, switch the specified board to master and update the line card. Continue? [Y/N]:y

不同款型规格的资料略有差异, 详细信息请向具体销售和400咨询。H3C保留在没有任何通知或提示的情况下对资料内容进行修改的权利!

新华三官网
联系我们