- 产品与解决方案
- 行业解决方案
- 服务
- 支持
- 合作伙伴
- 关于我们
06-软件升级命令
本章节下载： 06-软件升级命令 (118.86 KB)
【命令】
boot-loader file file-url slot slot-number { main | backup }
【视图】
用户视图
【缺省级别】
3：管理级
【参数】
file file-url：文件名，为1～63个字符的字符串，如果用户输入的是相对路径，则执行命令时系统会自动将相对路径转换为绝对路径，同时要求绝对路径最多不能超过63个字符，否则，命令执行失败。格式为[drive:/]file-name，其中，
l [ ]表示该参数可选。
l drive用来指定文件在设备的哪个存储介质上，取值为存储介质的名称。
l file-name表示文件的名称，以.bin作为后缀名。
slot slot-number：指定设备编号，取值只能为1。
main：指定该文件为主用启动文件。主用启动文件用于引导、启动设备。
backup：指定该文件为备用启动文件。备用启动文件只用于异常情况下，当主用启动文件不可用时，引导、启动设备。
【描述】
boot-loader命令用来指定设备的下次启动文件。
必须先将下次启动文件保存到设备存储介质的根目录下，boot-loader命令才能执行成功。
相关配置可参考命令display boot-loader。
【举例】
# 指定下次启动时所用的主用启动文件为test.bin。
<Sysname> boot-loader file test.bin main
This command will set the boot file. 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
【视图】
用户视图
【缺省级别】
3：管理级
【参数】
update file file-url：升级Bootrom，file-url表示用于升级的文件名，为1～63个字符的字符串。file-url参数的详细介绍请参见1.1.1 boot-loader。
slot slot-number：指定设备编号，取值只能为1。
【描述】
bootrom命令用来升级设备的Bootrom程序。
必须先将Bootrom程序保存到设备存储介质的根目录下，bootrom命令用来才能执行成功。
【举例】
# 使用startup.bin文件升级设备的Bootrom程序。
<Sysname> bootrom update file startup.bin slot 1
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：指定设备编号，取值只能为1。
|：使用正则表达式对显示信息进行过滤。有关正则表达式的详细介绍，请参见“基础配置指导”中的“CLI”。
begin：从包含指定正则表达式的行开始显示。
exclude：只显示不包含指定正则表达式的行。
include：只显示包含指定正则表达式的行。
regular-expression：表示正则表达式，为1～256个字符的字符串，区分大小写。
【描述】
display boot-loader命令用来显示启动文件信息。
相关配置可参考命令boot-loader。
【举例】
# 显示本次启动和下次启动所采用的启动文件。
<Sysname> display boot-loader
Slot 1
The 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 |
表示设备编号 |
|
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 311005 0 1 1 0 1 0x82817d94
表1-2 display patch information命令显示信息描述表
|
字段 |
描述 |
|
The location of patches |
补丁文件的加载路径，可以通过patch location命令设置 |
|
Slot |
设备编号，取值只能为1 |
|
Version |
补丁版本号。该字段的前3个字符表示PATCH-FLAG的后缀 |
|
Temporary |
临时补丁数目 |
|
Common |
正式补丁数目 |
|
Current |
当前补丁总数目 |
|
Running |
处于运行状态的补丁数目 |
|
Active |
处于激活状态的补丁数目 |
|
Start-Address |
内存补丁区在内存中的起始地址 |
【命令】
patch active patch-number slot slot-number
【视图】
系统视图
【缺省级别】
3：管理级
【参数】
patch-number：补丁序号。该参数的有效值与使用的补丁文件有关，请以实际情况为准。
slot slot-number：指定设备编号，取值只能为1。
【描述】
patch active命令用来激活指定补丁，即运行该补丁。
执行该命令，补丁序号之前（包括该序号）的所有处于未激活状态的补丁将被激活，进入激活状态。
需要注意的是：
l 激活补丁前，必须先加载该补丁，否则，激活操作失败。
l 系统重启后，原处于激活状态的补丁会变成未激活状态，不再生效。如果想再次使用该补丁，需要再次激活。
【举例】
# 激活设备上3号及3号之前的补丁。
<Sysname> system-view
[Sysname] patch active 3 slot 1
【命令】
patch deactive patch-number slot slot-number
【视图】
系统视图
【缺省级别】
3：管理级
【参数】
patch-number：补丁序号。该参数的有效值与使用的补丁文件有关，请以实际情况为准。
slot 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：指定设备编号，取值只能为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]:”，
l 如果输入<Y>或者<y>，则会安装指定路径下的所有补丁，设备重启后这些补丁继续生效，补丁状态从IDLE转换到RUNNING。相当于依次执行了patch location、patch load、patch active和patch run命令。
l 如果输入<N>或者<n>，则会安装指定路径下的所有补丁，设备重启后这些补丁不再继续生效，补丁状态从IDLE转换到ACTIVE。相当于依次执行了patch location、patch load和patch active命令。
需要注意的是：
l 执行该命令前，请将补丁文件保存到设备存储介质的根目录下。
l 执行补丁安装操作后，系统会将补丁文件的加载路径修改成“patch install patch-location”中patch-location参数所指向的位置。比如，先配置了patch location xxx，再执行patch install yyy，此时系统会自动将补丁文件的加载路径从xxx改为yyy。
【举例】
# 加载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：指定设备编号，取值只能为1。
【描述】
patch load命令用来将补丁文件从存储介质加载到内存补丁区中。
执行该命令前，请将补丁文件保存到设备存储介质的根目录下。
【举例】
# 为设备加载补丁。
<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：指定设备编号，取值只能为1。
【描述】
patch run命令用来确认运行指定补丁，补丁序号之前（包括该序号）的激活状态补丁全部进入运行状态。
该命令只对处于激活状态的补丁有效，对于处于其它状态的补丁，该命令无效。
确认运行的补丁，在系统重启后，会继续生效。
【举例】
# 确认运行设备上3号及3号之前的补丁。
<Sysname> system-view
[Sysname] patch run 3 slot 1
不同款型规格的资料略有差异, 详细信息请向具体销售和400咨询。H3C保留在没有任何通知或提示的情况下对资料内容进行修改的权利!
支持
