选择区域语言: EN CN HK

01-基础配置命令参考

07-ISSU命令

本章节下载  (122.25 KB)

docurl=/cn/Service/Document_Software/Document_Center/Switches/Catalog/S5830/S5830/Command/Command_Manual/H3C_S5830_CR-Release_(R1115[R1118])-6W102/01/201501/853324_30005_0.htm

07-ISSU命令


1 ISSU命令

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升级正在进行中,版本回滚定时器处于工作状态

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: incompatible

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命令)

Compatibility

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

·     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 S5830-52SC

 

Running Version: version1

Version Compatibility List:

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

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

Number of Matrices in Table = 1

Matrix for S5830-52SC

 

Running Version: version1

Version Compatibility List:

version2 (Incompatible)

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

字段

描述

Number of Matrices in Table

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

Matrix for xx

xx系列设备的产品版本

Running Version

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

Version Compatibility List

版本兼容信息列表

 

1.1.4  issu load

【命令】

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

【视图】

系统视图

【缺省级别】

2:系统级

【参数】

file upgrading-filename:表示新启动文件,取值为1~63个字符的字符串。

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

·     [ ]表示该参数可选。

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

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

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

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

force:用来对不兼容版本的启动文件进行强制升级。如果新启动文件与当前启动文件不兼容,则需要使用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.5  issu rollback

【命令】

issu rollback slot slot-number

【视图】

系统视图

【缺省级别】

2:系统级

【参数】

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

【描述】

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

需要注意的是:当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.6  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升级操作,启动文件将恢复到升级前的版本。

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

【举例】

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

<Sysname> system-view

[Sysname] issu rollback-timer 30

1.1.7  issu run switchover

【命令】

issu run switchover slot slot-number

【视图】

系统视图

【缺省级别】

2:系统级

【参数】

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

【描述】

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

需要注意的是:不兼容版本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保留在没有任何通知或提示的情况下对资料内容进行修改的权利!