- 产品与解决方案
- 行业解决方案
- 服务
- 支持
- 合作伙伴
- 新华三人才研学中心
- 关于我们
06-软件升级命令
本章节下载： 06-软件升级命令 (169.89 KB)
【命令】
boot-loader file file-url [ main | backup ]
【视图】
用户视图
【缺省级别】
3：管理级
【参数】
file file-url：文件名，为1～63个字符的字符串，如果用户输入的是相对路径，则执行命令时系统会自动将相对路径转换为绝对路径，同时要求绝对路径最多不能超过63个字符，否则，命令执行失败。格式为[drive:/]file-name，其中，
· [ ]表示该参数可选，
· drive用来指定文件在设备的哪个存储介质上，取值为存储介质的名称。设备上只有一个存储介质，可以不用输入该参数。
· file-name表示文件的名称，一般以.bin作为后缀名。
· main：指定该文件为主用启动文件。本参数的支持情况与设备的型号有关，请参见“命令参考导读”中的“命令行及参数差异情况”部分的介绍。主用启动文件用于引导、启动设备。
· backup：指定该文件为备用启动文件。本参数的支持情况与设备的型号有关，请参见“命令参考导读”中的“命令行及参数差异情况”部分的介绍。备用启动文件只用于异常情况下，当主用启动文件不可用时，引导、启动设备。
【描述】
boot-loader命令用来指定设备的下次启动文件。
必须先将下次启动文件保存到设备存储介质的根目录下，boot-loader命令才能执行成功。
相关配置可参考命令display boot-loader。
【举例】
# 指定下次启动时所用的启动文件为wa2600a_fat.bin。
<Sysname> boot-loader file wa2600a_fat.bin
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 { read | update file file-url } [ all | part ]
【视图】
用户视图
【缺省级别】
3：管理级
【参数】
read：读取Bootrom，即将Bootrom程序从Bootrom存储器的Normal区读取到Flash中以作备份。当Bootrom存储器损坏，可以重新运行Flash上的Bootrom文件来恢复Bootrom。
update file file-url：升级Bootrom，file-url表示用于升级的文件名，为1～63个字符的字符串。file-url参数的详细介绍请参见1.1.1 boot-loader。
all：操作Bootrom的全部内容。不指定all和part参数时，默认使用all。
part：只操作Bootrom的扩展内容（Bootrom分两部分：常规部分和扩展部分，常规部分提供Bootrom的基本操作项，扩展部分提供更多的Bootrom操作项）。不指定all和part参数时，默认使用all。
【描述】
bootrom命令用来读取、恢复、备份或升级设备或子卡的Bootrom程序。
必须先将Bootrom程序保存到设备存储介质的根目录下，bootrom命令用来才能执行成功。
【举例】
# 读取Bootrom程序。
<Sysname> bootrom read all
Now reading bootrom, please wait...
Read bootrom! Please wait...
Start reading basic bootrom!
Read basic bootrom completed!
Start reading extended bootrom!
Read extended bootrom completed!
Read bootrom completed! Please check the file!
【命令】
display boot-loader [ | { begin | exclude | include } regular-expression ]
【视图】
任意视图
【缺省级别】
2：系统级
【参数】
|：使用正则表达式对显示信息进行过滤。有关正则表达式的详细介绍，请参见“基础配置指导”中的“CLI配置”。
begin：从包含指定正则表达式的行开始显示。
exclude：只显示不包含指定正则表达式的行。
include：只显示包含指定正则表达式的行。
regular-expression：表示正则表达式，为1～256个字符的字符串，区分大小写。
【描述】
display boot-loader命令用来显示启动文件信息。
相关配置可参考命令boot-loader。
【举例】
# 显示本次启动和下次启动所采用的启动文件信息。
<Sysname> display boot-loader
The current boot app is: flash:/wa2600a_fat.bin
The app that will boot upon reboot is: flash:/wa2600a_fat.bin
表1-1 display boot-loader命令显示信息描述表
|
字段 |
描述 |
|
The current boot app is |
系统本次启动时使用的启动文件 |
|
The app that will boot upon reboot is |
系统下次启动时使用的启动文件 |
【命令】
display patch [ | { begin | exclude | include } regular-expression ]
【视图】
任意视图
【缺省级别】
3：管理级
【参数】
|：使用正则表达式对显示信息进行过滤。有关正则表达式的详细介绍，请参见“基础配置指导”中的“CLI配置”。
begin：从包含指定正则表达式的行开始显示。
exclude：只显示不包含指定正则表达式的行。
include：只显示包含指定正则表达式的行。
regular-expression：表示正则表达式，为1～256个字符的字符串，区分大小写。
【描述】
display patch命令用来显示当前安装的补丁文件。
本命令的支持情况与设备型号有关，请参见“命令参考导读”中的“命令行及参数差异情况”部分的介绍。
【举例】
# 显示当前安装的补丁文件：
<Sysname> display patch
flash:/patch_mpu.bin, loaded on slot(s):0
表1-2 display patch命令显示信息描述表
|
字段 |
描述 |
|
flash:/patch_mpu.bin |
安装的补丁文件的路径 |
|
loaded on slot(s):0 |
加载补丁的单板编号 |
【命令】
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 MPU 0 0 0 0 0 0x81fa6850
表1-3 display patch information命令显示信息描述表
|
字段 |
描述 |
|
The location of patches |
补丁文件的加载路径，可以通过patch location命令设置 |
|
Slot |
无意义 |
|
Version |
补丁版本号。 |
|
Temporary |
临时补丁数目 |
|
Common |
正式补丁数目 |
|
Current |
当前补丁总数目 |
|
Running |
处于运行状态的补丁数目 |
|
Active |
处于激活状态的补丁数目 |
|
Start-Address |
内存补丁区在内存中的起始地址 |
【命令】
patch active [ patch-number ]
【视图】
系统视图
【缺省级别】
3：管理级
【参数】
patch-number：补丁序号。
【描述】
patch active命令用来激活补丁，即临时运行已加载的补丁。
执行该命令时，如果指定补丁序号，则表示补丁序号之前（包括该序号）的所有处于未激活状态的补丁将被激活；如果不指定补丁序号，则表示当前所有处于未激活状态的补丁将全部被激活。
需要注意的是：
· 激活补丁前，必须先加载该补丁，否则，激活操作失败。
· 系统重启后，原处于激活状态的补丁会变成未激活状态，不再生效。如果想再次使用该补丁，需要再次激活。
本命令的支持情况与设备型号有关，请参见“命令参考导读”中的“命令行及参数差异情况”部分的介绍。
【举例】
# 激活3号及3号之前已加载的补丁。
<Sysname> system-view
[Sysname] patch active 3
【命令】
patch deactive [ patch-number ]
【视图】
系统视图
【缺省级别】
3：管理级
【参数】
patch-number：补丁序号。
【描述】
patch deactive命令用来停止运行补丁，恢复原版本软件的运行。
执行该命令时，如果指定补丁序号，则表示在此补丁序号之后（包括该序号）处于激活状态的补丁将全部进入未激活状态；如果不指定补丁序号，则表示当前所有处于激活状态的补丁将全部进入未激活状态。
对于处于运行状态的补丁，本命令无效。
本命令的支持情况与设备型号有关，请参见“命令参考导读”中的“命令行及参数差异情况”部分的介绍。
【举例】
# 停止运行3号及3号之后的补丁。
<Sysname> system-view
[Sysname] patch deactive 3
# 停止运行所有已激活的补丁。
<Sysname> system-view
[Sysname] patch deactive
【命令】
patch delete [ patch-number ]
【视图】
系统视图
【缺省级别】
3：管理级
【参数】
patch-number：补丁序号。
【描述】
patch delete命令用来将补丁从内存补丁区中删除。
执行该命令时，如果指定补丁序号，则表示补丁序号之后（包括该序号）的所有补丁将被删除；如果不指定补丁序号，则表示内存补丁区中的所有补丁将被删除。
执行该命令，只是将补丁从内存补丁区中删除，并不会将补丁从存储介质中删除，补丁回到初始状态（IDLE）。
本命令的支持情况与设备型号有关，请参见“命令参考导读”中的“命令行及参数差异情况”部分的介绍。
【举例】
# 删除3号及3号之后的补丁。
<Sysname> system-view
[Sysname] patch delete 3
# 删除所有补丁。
<Sysname> system-view
[Sysname] patch delete
【命令】
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。相当于依次执行了patch location、patch load、patch active和patch run命令。对于不在槽位的单板，系统会记录该槽位上应该进行的补丁操作，当有单板插入时，系统会根据记录对该单板安装相应的补丁。
· 如果输入<N>或者<n>，则会安装指定路径下的所有补丁，设备或单板重启后这些补丁不再继续生效，补丁状态从IDLE转换到ACTIVE。相当于依次执行了patch location、patch load和patch active命令。
执行该命令前，需要将补丁文件保存到设备存储介质的根目录下。
执行补丁安装操作后，系统会将补丁文件的加载路径修改成“patch install patch-location”中patch-location参数所指向的位置。比如，先配置了patch location xxx，再执行patch install yyy，此时系统会自动将补丁文件的加载路径从xxx改为yyy。如果执行patch install file filename命令，则系统不会改变加载路径。
本命令的支持情况与设备型号有关，请参见“命令参考导读”中的“命令行及参数差异情况”部分的介绍。
【举例】
# 加载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 [ file filename ]
【视图】
系统视图
【缺省级别】
3：管理级
【参数】
file filename：表示补丁文件的名称。
【描述】
patch load命令用来将补丁文件从存储介质加载到内存补丁区中。
执行该命令前，需要将补丁文件保存到设备存储介质的根目录下。
本命令的支持情况与设备型号有关，请参见“命令参考导读”中的“命令行及参数差异情况”部分的介绍。
【举例】
# 从补丁文件中加载补丁。
<Sysname> system-view
[Sysname] patch load
【命令】
patch location patch-location
【视图】
系统视图
【缺省级别】
3：管理级
【参数】
patch-location：表示补丁文件所在的路径，为1～64个字符的字符串，格式通常为存储介质的根目录，也可能是存储介质的根目录+补丁文件名称的形式。
【描述】
patch location命令用来设置补丁文件的加载路径。
缺省情况下，补丁文件的加载路径为flash:。
需要注意的是，执行patch install命令会修改补丁文件的加载路径。比如，先配置了patch location xxx，再执行patch install yyy，此时系统会自动将补丁文件的加载路径从xxx改为yyy。
本命令的支持情况与设备型号有关，请参见“命令参考导读”中的“命令行及参数差异情况”部分的介绍。
【举例】
# 设置补丁文件加载路径为Flash的根目录。
<Sysname> system-view
[Sysname] patch location flash:
【命令】
patch run [ patch-number ]
【视图】
系统视图
【缺省级别】
3：管理级
【参数】
patch-number：补丁序号。
【描述】
patch run命令用来确认运行补丁，即确认激活状态的补丁进入运行状态。
执行该命令时，如果指定补丁序号，则表示确认运行补丁序号之前（包括该序号）的所有已激活的补丁；如果不指定补丁序号，则表示确认运行当前系统中所有已激活的补丁。
该命令只对处于激活状态的补丁有效，对于处于其它状态的补丁，该命令无效。
确认运行的补丁，在系统重启后，会继续生效。
本命令的支持情况与设备型号有关，请参见“命令参考导读”中的“命令行及参数差异情况”部分的介绍。
【举例】
# 确认运行3号及3号之前的补丁。
<Sysname> system-view
[Sysname] patch run
# 确认运行所有已激活的补丁。
<Sysname> system-view
[Sysname] patch run
【命令】
password-recovery enable
undo password-recovery enable
【视图】
系统视图
【缺省级别】
管理级
【参数】
无
【描述】
password-recovery enable命令用来使能密码恢复功能。undo password-recovery enable命令用来关闭密码恢复功能。
缺省情况下，密码恢复功能处于使能状态。
需要注意的是：
· 当用户口令丢失时，如果使能了密码恢复功能，用户可以在保留原有配置文件的情况下重新设置用户口令；如果关闭了密码恢复功能，用户只可以恢复出厂配置，系统将自动删除主用和备用的配置文件；
· 对于安全性要求较高的用户，关闭密码恢复功能可以有效地保护设备配置文件信息不被未认证用户获取。
【举例】
# 关闭密码恢复功能。
<Sysname> system-view
[Sysname] undo password-recovery enable
不同款型规格的资料略有差异, 详细信息请向具体销售和400咨询。H3C保留在没有任何通知或提示的情况下对资料内容进行修改的权利!
支持
售前咨询
售后咨询
人工在线咨询
