07-ISSU命令
本章节下载: 07-ISSU命令 (137.48 KB)
本特性仅S5500-EI系列交换机支持。
【命令】
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 |
距离版本回滚定时器超时的剩余时间(只有版本回滚定时器处于工作状态时才显示) |
【命令】
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 |
新启动文件的保存路径 |
【命令】
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的启动文件与当前运行的启动文件兼容性未知 |
【命令】
issu accept slot slot-number
【视图】
系统视图
【缺省级别】
2:系统级
【参数】
slot slot-number:表示IRF中成员设备的编号,必须和issu load命令中指定的slot-number相同。
【描述】
issu accept命令用来确认ISSU升级,从而取消启动文件的自动回滚功能。
执行此命令后,启动文件的版本回滚定时器失效,IRF系统无法将成员设备的启动文件自动回滚恢复到原始版本。
相关配置可参见命令issu load和issu commit。
【举例】
# 对已升级的成员设备(假设所在槽位号为1)进行确认。
<Sysname> system-view
[Sysname] issu accept slot 1
【命令】
issu commit slot slot-number
【视图】
系统视图
【缺省级别】
2:系统级
【参数】
slot slot-number:IRF系统中尚未进行ISSU升级的成员设备的编号。
【描述】
issu commit命令用来对IRF系统中尚未升级的成员设备进行升级。
执行该命令且所有IRF成员设备都使用新版本启动文件运行后,ISSU升级结束(不能再通过issu rollback命令或者版本回滚定时器进行版本回滚)。
相关配置可参见命令issu load和issu accept。
【举例】
# 对IRF系统中尚未进行ISSU升级的成员设备进行升级(假设成员编号为2)。
<Sysname> system-view
[Sysname] issu commit slot 2
The specified board will reboot and be upgraded. Continue? [Y/N]:y
【命令】
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
【命令】
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
【命令】
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
【命令】
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保留在没有任何通知或提示的情况下对资料内容进行修改的权利!