- 产品与解决方案
- 行业解决方案
- 服务
- 支持
- 合作伙伴
- 新华三人才研学中心
- 关于我们
06-软件升级命令
本章节下载： 06-软件升级命令 (151.88 KB)
【命令】
boot-loader file file-url slot slot-number { main | backup }
【视图】
用户视图
【缺省级别】
3：管理级
【参数】
file file-url：文件名，为1～63个字符的字符串，如果用户输入的是相对路径，则执行命令时系统会自动将相对路径转换为绝对路径，同时要求绝对路径最多不能超过63个字符，否则，命令执行失败。格式为[drive:/]file-name，其中，
· [ ]表示该参数可选。
· drive用来指定文件在设备的哪个存储介质上，取值为存储介质的名称。如果设备上只有一个存储介质，可以不用输入该参数。
· file-name表示文件的名称，一般以.bin作为后缀名。
slot slot-number：表示设备所在的槽位号。
main：指定该文件为主用启动文件。主用启动文件用于引导、启动设备。
backup：指定该文件为备用启动文件。备用启动文件只用于异常情况下，当主用启动文件不可用时，引导、启动设备。
【描述】
boot-loader命令用来指定设备的下次启动文件。
必须先将下次启动文件保存到设备存储介质的根目录下，boot-loader命令才能执行成功。
相关配置可参考命令display boot-loader。
【举例】
# 指定下次启动时所用的主用启动文件为test.bin。
<Sysname> boot-loader file test.bin slot 1 main
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!
【命令】
boot-loader update file file-url slot { slot-number | all } { main | backup }
【视图】
用户视图
【缺省级别】
3：管理级
【参数】
file-url：文件名，为1～63个字符的字符串。该参数的详细介绍请参见1.1.1 boot-loader。
slot：指定设备的成员编号。
· slot-number：用来同步升级指定成员设备。
· all：用来同步升级所有成员设备。
main：指定该文件为主用启动文件。主用启动文件用于引导、启动设备。
backup：指定该文件为备用启动文件。备用启动文件只用于异常情况下，当主用启动文件不可用时，引导、启动设备。
【描述】
boot-loader update file命令用来同步升级指定设备的启动文件。
执行本命令相当于分步执行以下操作：
· 将指定文件拷贝到设备；
· 将该文件指定为该设备的下次启动文件。
【举例】
# 同步升级整个设备。
<Sysname> tftp 192.168.1.26 get main.bin
File will be transferred in binary mode
Downloading file from remote TFTP server, please wait...|
TFTP: 10105088 bytes received in 36 second(s)
File downloaded successfully.
<Sysname> boot-loader update file main.bin slot all main
This command will update the specified boot file of all boards. Continue? [Y/N]:Y
Now is updating, please wait...
<Sysname> reboot
【命令】
display boot-loader [ slot slot-number ] [ | { begin | exclude | include } regular-expression ]
【视图】
任意视图
【缺省级别】
2：系统级
【参数】
slot slot-number：显示设备的启动文件的信息。slot-number表示设备所在的槽位号。
|：使用正则表达式对显示信息进行过滤。有关正则表达式的详细介绍，请参见“基础配置指导”中的“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
Next main boot app is: flash:/test.bin
Next backup boot app is: flash:/
表1-1 display boot-loader命令显示信息描述表
|
字段 |
描述 |
|
Current boot app is |
设备本次启动时使用的启动文件 |
|
Next main boot app is |
设备下次启动时使用的主用启动文件 |
|
Next backup boot app is |
设备下次启动时使用的备用启动文件 |
【命令】
display patch [ | { begin | exclude | include } regular-expression ]
【视图】
任意视图
【缺省级别】
3：管理级
【参数】
|：使用正则表达式对显示信息进行过滤。有关正则表达式的详细介绍，请参见“基础配置指导”中的“CLI”。
begin：从包含指定正则表达式的行开始显示。
exclude：只显示不包含指定正则表达式的行。
include：只显示包含指定正则表达式的行。
regular-expression：表示正则表达式，为1～256个字符的字符串，区分大小写。
【描述】
display patch命令用来显示当前安装的补丁文件和对应的补丁包的版本。如果不是从补丁包中加载补丁，则不显示补丁包版本。
【举例】
# 显示当前安装的补丁文件和补丁包版本。
<Sysname> display patch
flash:/ patch-package.bin, B90H01a, loaded on slot(s):1
表1-2 display patch命令显示信息描述表
|
字段 |
描述 |
|
flash:/patch-package.bin |
安装的补丁文件的路径 |
|
Package-Version-001 |
补丁包的版本 |
|
loaded on slot(s): |
加载补丁的设备成员编号，如果设备上只有一个CPU，则直接显示slot-number |
【命令】
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
----------------------------------------------------------------------
0 RPE004 0 1 1 0 1 0x310bd74
表1-3 display patch information命令显示信息描述表
|
字段 |
描述 |
|
The location of patches |
补丁文件的加载路径，可以通过patch location命令设置 |
|
Slot |
设备的槽号，如果设备上只有一个CPU，则直接显示slot-number |
|
Version |
补丁版本号 |
|
Temporary |
临时补丁数目 |
|
Common |
正式补丁数目 |
|
Current |
当前补丁总数目 |
|
Running |
处于运行状态的补丁数目 |
|
Active |
处于激活状态的补丁数目 |
|
Start-Address |
内存补丁区在内存中的起始地址 |
【命令】
patch active [ patch-number ] slot slot-number
【视图】
系统视图
【缺省级别】
3：管理级
【参数】
patch-number：补丁序号。
slot slot-number：表示设备的槽位号。
【描述】
patch active命令用来激活补丁，即临时运行已加载的补丁。
执行该命令时，如果指定补丁序号，则表示补丁序号之前（包括该序号）的所有处于未激活状态的补丁将被激活；如果不指定补丁序号，则表示当前所有处于未激活状态的补丁将全部被激活。
需要注意的是：
· 激活补丁前，必须先加载该补丁，否则，激活操作失败。
· 系统重启后，原处于激活状态的补丁会变成未激活状态，不再生效。如果想再次使用该补丁，需要再次激活。
【举例】
# 激活设备上3号及3号之前已加载的补丁。
<Sysname> system-view
[Sysname] patch active 3 slot 1
# 激活设备上所有已加载的补丁。
<Sysname> system-view
[Sysname] patch active slot 1
【命令】
patch deactive [ patch-number ] slot slot-number
【视图】
系统视图
【缺省级别】
3：管理级
【参数】
patch-number：补丁序号。
slot slot-number：表示设备所在的槽位号。
【描述】
patch deactive命令用来停止运行补丁，恢复原版本软件的运行。
执行该命令时，如果指定补丁序号，则表示在此补丁序号之后（包括该序号）处于激活状态的补丁将全部进入未激活状态；如果不指定补丁序号，则表示当前所有处于激活状态的补丁将全部进入未激活状态。
对于处于运行状态的补丁，本命令无效。
【举例】
# 停止运行设备上3号及3号之后的补丁。
<Sysname> system-view
[Sysname] patch deactive 3 slot 1
# 停止运行设备上所有已激活的补丁。
<Sysname> system-view
[Sysname] patch deactive slot 1
【命令】
patch delete [ patch-number ] slot slot-number
【视图】
系统视图
【缺省级别】
3：管理级
【参数】
patch-number：补丁序号。
slot slot-number：表示设备的槽位号。
【描述】
patch delete命令用来将补丁从内存补丁区中删除。
执行该命令时，如果指定补丁序号，则表示补丁序号之后（包括该序号）的所有补丁将被删除；如果不指定补丁序号，则表示内存补丁区中的所有补丁将被删除。
执行该命令，只是将补丁从内存补丁区中删除，并不会将补丁从存储介质中删除，补丁回到初始状态（IDLE）。
【举例】
# 删除设备上3号及3号之后的补丁。
<Sysname> system-view
[Sysname] patch delete 3 slot 1
# 删除设备上所有补丁。
<Sysname> system-view
[Sysname] patch delete slot 1
【命令】
patch install { patch-location | file filename }
undo patch install
【视图】
系统视图
【缺省级别】
3：管理级
【参数】
patch-location：表示补丁文件所在的路径，为1～64个字符的字符串，格式为存储介质的根目录。该参数用于安装没有经过打包的补丁文件，补丁文件的名称必须符合要求，否则系统会因无法识别文件名而造成补丁操作失败。
file filename：表示补丁包文件的名称。该参数用于安装补丁包文件，补丁包是指打包的补丁文件，该文件中存放了相同版本不同类型的补丁文件。
【描述】
patch install命令用来一步式完成补丁的安装。undo patch install命令用来卸载补丁。
在执行patch install命令时，系统会提示“Do you want to continue running patches after reboot? [Y/N]:”，
· 如果输入<Y>或者<y>，则会安装指定路径下的所有补丁，补丁状态从IDLE转换到RUNNING，设备重启后这些补丁继续生效。
· 如果输入<N>或者<n>，则会安装指定路径下的所有补丁，补丁状态从IDLE转换到ACTIVE，设备重启后这些补丁不再继续生效。
执行该命令前，需要将补丁文件保存到指定路径：如果要从补丁包中安装补丁，则可以将补丁包保存在任意路径下，否则请将补丁文件保存到设备存储介质的根目录下。
如果设备以前安装过补丁，必须先将历史补丁卸载，才能安装新补丁。用户可以使用display patch information显示设备的补丁信息。
【举例】
# 加载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…
# 加载补丁文件包，并且要求设备重启后补丁继续生效。
<Sysname> system-view
[Sysname] patch install file patch_package.bin
Patches will be installed. Continue? [Y/N]:y
Do you want to run patches after reboot? [Y/N]:y
Installing patches…
【命令】
patch load slot slot-number [ file filename ]
【视图】
系统视图
【缺省级别】
3：管理级
【参数】
slot slot-number：表示设备的槽位号。
file filename：表示补丁包文件的名称。
【描述】
patch load命令用来将补丁文件从Flash加载到内存补丁区中。
如果指定了补丁包文件，则表示系统从补丁包中加载补丁；如果未指定补丁包文件，则表示从补丁文件中加载补丁，系统默认会从Flash中读取补并加载补丁文件。
执行该命令前，需要将补丁文件保存到指定路径：
如果要从补丁包中加载补丁，则可以将补丁包文件保存在任意路径下，否则请将补丁文件保存到设备存储介质的根目录下。
【举例】
# 从补丁文件中为设备加载补丁。
<Sysname> system-view
[Sysname] patch load slot 1
# 从补丁包中为设备加载补丁。
<Sysname> system-view
[Sysname] patch load slot 1 file flash:/patchpackage.bin
【命令】
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：表示设备的槽位号。
【描述】
patch run命令用来确认运行补丁，即确认激活状态的补丁进入运行状态。
执行该命令时，如果指定补丁序号，则表示确认运行补丁序号之前（包括该序号）的所有已激活的补丁；如果不指定补丁序号，则表示确认运行当前系统中所有已激活的补丁。
如果指定slot参数，则确认运行该设备上的所有补丁。
该命令只对处于激活状态的补丁有效，对于处于其它状态的补丁，该命令无效。
确认运行的补丁，在系统重启后，会继续生效。
【举例】
# 确认运行设备上3号及3号之前的补丁。
<Sysname> system-view
[Sysname] patch run 3 slot 1
# 确认运行设备上所有已激活的补丁。
<Sysname> system-view
[Sysname] patch run slot 1
不同款型规格的资料略有差异, 详细信息请向具体销售和400咨询。H3C保留在没有任何通知或提示的情况下对资料内容进行修改的权利!
支持
售前咨询
售后咨询
人工在线咨询
