06-软件升级命令
本章节下载: 06-软件升级命令 (264.86 KB)
· 设备运行于FIPS模式时,本特性的相关配置相对于非FIPS模式有所变化,具体差异请见本文相关描述。有关FIPS模式的详细介绍请参见“安全配置指导”中的“FIPS”。
· 本章中典型配置举例中的配置,如无特殊说明,均以设备运行在非FIPS模式下的命令行为准。
· FIPS模式下不支持FTP/TFTP,如果传输文件请使用SFTP。
【命令】
boot-loader file file-url slot { all | slot-number } { main | backup }
【视图】
用户视图
【缺省级别】
3:管理级
【参数】
file file-url:文件名,为1~63个字符的字符串,如果用户输入的是相对路径,则执行命令时系统会自动将相对路径转换为绝对路径,同时要求绝对路径最多不能超过63个字符,否则,命令执行失败。格式为[drive:/]file-name,其中,
· [ ]表示该参数可选,
· drive用来指定文件在设备的哪个存储介质上,取值为flash。
· file-name表示文件的名称,以.bin作为后缀名。
slot { all | slot-number }:指定设备编号。slot-number取值只能为1。使用slot all和slot 1配置效果相同。
main:指定该文件为主用启动文件。
backup:指定该文件为备用启动文件。备用启动文件只用于异常情况下,当主用启动文件不可用时,使用备用启动文件启动设备。
【描述】
boot-loader命令用来指定设备的下次启动文件。
需要注意的是:必须先将下次启动文件保存到设备存储介质的根目录下,boot-loader命令才能执行成功。
相关配置可参考命令display boot-loader。
在FIPS模式下,执行该命令后,系统先对启动文件的签名进行校验,只有通过校验后,该命令才能配置成功。
【举例】
# 指定下次启动时所用的主用启动文件为test.bin。
<Sysname> boot-loader file test.bin slot 1 main
Verifying boot file ......
This command will set the boot file of the specified board. Continue? [Y/N]:y
The specified file will be used as the main boot file at the next reboot on slot 1!
【命令】
bootrom update file file-url slot slot-number-list
【视图】
用户视图
【缺省级别】
3:管理级
【参数】
update file file-url:升级Bootrom,file-url表示用于升级的文件名,为1~63个字符的字符串。file-url参数的详细介绍请参见1.1.1 boot-loader。
slot slot-number-list:指定设备编号。slot-number-list 取值只能为1。
【描述】
bootrom命令用来升级设备的Bootrom程序。
需要注意的是:必须先将Bootrom程序保存到设备存储介质的根目录下,bootrom命令才能执行成功。
在FIPS模式下,执行该命令后,系统先对Bootrom文件的签名进行校验,只有通过校验后,该命令才能配置成功。
【举例】
# 升级Bootrom程序。
<H3C>bootrom update file test.bin slot 1
Verifying bootrom file ......
This command will update bootrom file on the specified board(s), Continue? [Y/N]:y
Now updating bootrom, please wait...
BootRom file updating finished!
【命令】
bootrom-update security-check enable
undo bootrom-update security-check enable
【视图】
系统视图
【缺省级别】
2:系统级
【参数】
无
【描述】
bootrom-update security-check enable命令用来启动Bootrom升级时的合法性检查功能。undo bootrom-update security-check enable命令用来关闭Bootrom升级时的合法性检查功能。
缺省情况下,Bootrom升级时的合法性检查功能是打开的。
如果使能了该功能,则在升级Bootrom时,会先检查Bootrom文件的合法性、是否有效以及是否和硬件匹配等。
【举例】
# 启动Bootrom升级时的合法性检查功能。
<Sysname> system-view
[Sysname] bootrom-update security-check enable
【命令】
display boot-loader [ slot slot-number ] [ | { begin | exclude | include } regular-expression ]
【视图】
任意视图
【缺省级别】
2:系统级
【参数】
slot slot-number:指定设备编号。slot-number取值只能为1。
|:使用正则表达式对显示信息进行过滤。有关正则表达式的详细介绍,请参见“基础配置指导”中的“CLI”。
begin:从包含指定正则表达式的行开始显示。
exclude:只显示不包含指定正则表达式的行。
include:只显示包含指定正则表达式的行。
regular-expression:表示正则表达式,为1~256个字符的字符串,区分大小写。
【描述】
display boot-loader命令用来显示启动文件信息。
相关配置可参考命令boot-loader。
【举例】
# 显示本次启动和下次启动所采用的启动文件(注意:本命令的显示信息与设备型号有关,请以设备的实际情况为准)。
<Sysname> display boot-loader
Slot 1
Current boot app is: flash:/test.bin
The main boot app is: flash:/test.bin
The backup boot app is: flash:/test.bin
表1-1 display boot-loader命令显示信息描述表
字段 |
描述 |
Slot 1 |
表示本设备的编号为1 |
The current boot app is |
设备本次启动时使用的启动文件 |
The main boot app is |
设备下次启动时使用的主用启动文件 |
The backup boot app is |
设备下次启动时使用的备用启动文件 |
【命令】
display patch information [ | { begin | exclude | include } regular-expression ]
【视图】
任意视图
【缺省级别】
3:管理级
【参数】
|:使用正则表达式对显示信息进行过滤。有关正则表达式的详细介绍,请参见“基础配置指导”中的“CLI”。
begin:从包含指定正则表达式的行开始显示。
exclude:只显示不包含指定正则表达式的行。
include:只显示包含指定正则表达式的行。
regular-expression:表示正则表达式,为1~256个字符的字符串,区分大小写。
【描述】
display patch information命令用来显示热补丁的信息。
【举例】
# 显示热补丁的信息。
<Sysname> display patch information
The location of patches: flash:
Slot Version Temporary Common Current Active Running Start-Address
----------------------------------------------------------------------
1 XXX002 0 1 1 0 0 0x4accf74
2 XXX 0 0 0 0 0 0x4accf74
表1-2 display patch information命令显示信息描述表
字段 |
描述 |
The location of patches |
补丁文件的加载路径,可以通过patch location命令设置 |
Slot |
设备的成员编号 |
Version |
补丁版本号。该字段的前3个字符表示PATCH-FLAG的后缀 |
Temporary |
临时补丁数目 |
Common |
正式补丁数目 |
Current |
当前补丁总数目 |
Running |
处于运行状态的补丁数目 |
Active |
处于激活状态的补丁数目 |
Start-Address |
内存补丁区在内存中的起始地址 |
【命令】
patch active patch-number slot slot-number
【视图】
系统视图
【缺省级别】
3:管理级
【参数】
patch-number:补丁序号。该参数的有效值与使用的补丁文件有关,请以实际情况为准。
slot slot-number:指定设备编号。slot-number取值只能为1。
【描述】
patch active命令用来激活指定补丁,即运行该补丁。
执行该命令,补丁序号之前(包括该序号)的所有处于未激活状态的补丁将被激活,进入激活状态。
需要注意的是:
· 激活补丁前,必须先加载该补丁,否则,激活操作失败。
· 系统重启后,原处于激活状态的补丁会变成未激活状态,不再生效。如果想再次使用该补丁,需要再次激活。
【举例】
# 激活设备上3号及3号之前的补丁。
<Sysname> system-view
[Sysname] patch active 3 slot 1
【命令】
patch deactive patch-number slot slot-number
【视图】
系统视图
【缺省级别】
3:管理级
【参数】
patch-number:补丁序号。该参数的有效值与使用的补丁文件有关,请以实际情况为准。
slot slot-number:指定设备编号。slot-number取值只能为1。
【描述】
patch deactive命令用来停止运行指定补丁,恢复原版本软件的运行。
执行该命令,在此补丁序号之后(包括该序号)处于激活状态的补丁全部进入未激活状态。
对于处于运行状态的补丁,本命令无效。
【举例】
# 停止运行设备上3号及3号之后的补丁。
<Sysname> system-view
[Sysname] patch deactive 3 slot 1
【命令】
patch delete patch-number slot slot-number
【视图】
系统视图
【缺省级别】
3:管理级
【参数】
patch-number:补丁序号。该参数的有效值与使用的补丁文件有关,请以实际情况为准。
slot slot-number:指定设备编号。slot-number取值只能为1。
【描述】
patch delete命令用来将补丁从内存补丁区中删除,补丁序号之后(包括该序号)的所有补丁被删除。
执行该命令,只是将补丁从内存补丁区中删除,并不会将补丁从存储介质中删除,补丁回到初始状态(IDLE)。
【举例】
# 删除设备上3号及3号之后的补丁。
<Sysname> system-view
[Sysname] patch delete 3 slot 1
【命令】
patch install patch-location
undo patch install
【视图】
系统视图
【缺省级别】
3:管理级
【参数】
patch-location:表示补丁文件所在的路径,为1~64个字符的字符串,格式通常为存储介质的根目录。
【描述】
patch install命令用来一步式完成补丁的安装。undo patch install命令用来卸载补丁。
在执行patch install命令时,系统会提示“Do you want to continue running patches after reboot? [Y/N]:”,
· 如果输入<Y>或者<y>,则会安装指定路径下的所有补丁,设备重启后这些补丁继续生效,补丁状态从IDLE转换到RUNNING。相当于依次执行了patch location、patch load、patch active和patch run命令。
· 如果输入<N>或者<n>,则会安装指定路径下的所有补丁,设备重启后这些补丁不再继续生效,补丁状态从IDLE转换到ACTIVE。相当于依次执行了patch location、patch load和patch active命令。
· 如果设备以前安装过补丁,必须先将历史补丁卸载,才能安装新补丁。用户可以使用display patch information显示设备的补丁信息。
· 在FIPS模式下,执行该命令后,系统先对补丁文件的签名进行校验,只有通过校验后,该命令才能配置成功。
【举例】
# 加载Flash上的补丁文件,并且要求设备重启后补丁继续生效。
<Sysname> system-view
[Sysname] patch install flash:
Patches will be installed. Continue? [Y/N]:y
Do you want to run patches after reboot? [Y/N]:y
Installing patches…
Installation completed, and patches will continue to run after reboot.
[Sysname]
【命令】
patch load slot slot-number
【视图】
系统视图
【缺省级别】
3:管理级
【参数】
slot slot-number:指定设备编号。slot-number取值只能为1。
【描述】
patch load命令用来将补丁文件从存储介质加载到内存补丁区中。
在FIPS模式下,执行该命令后,系统先对补丁文件的签名进行校验,只有通过校验后,该命令才能配置成功。
【举例】
# 为设备加载补丁。
<Sysname> system-view
[Sysname] patch load slot 1
【命令】
patch location patch-location
【视图】
系统视图
【缺省级别】
3:管理级
【参数】
patch-location:表示补丁文件所在的路径,为1~64个字符的字符串,格式通常为存储介质的根目录。
【描述】
patch location命令用来设置补丁文件的加载路径。
缺省情况下,补丁文件的加载路径为flash:。
【举例】
# 设置补丁文件加载路径为Flash的根目录。
<Sysname> system-view
[Sysname] patch location flash:
【命令】
patch run patch-number [ slot slot-number ]
【视图】
系统视图
【缺省级别】
3:管理级
【参数】
patch-number:补丁序号。该参数的有效值与使用的补丁文件有关,请以实际情况为准。
slot slot-number:指定设备编号。slot-number取值只能为1。
【描述】
patch run命令用来确认运行指定补丁,补丁序号之前(包括该序号)的激活状态补丁全部进入运行状态。
该命令只对处于激活状态的补丁有效,对于处于其它状态的补丁,该命令无效。
确认运行的补丁,在系统重启后,会继续生效。
【举例】
# 确认运行设备上3号及3号之前的补丁。
<Sysname> system-view
[Sysname] patch run 3 slot 1
不同款型规格的资料略有差异, 详细信息请向具体销售和400咨询。H3C保留在没有任何通知或提示的情况下对资料内容进行修改的权利!