06-软件升级命令
本章节下载: 06-软件升级命令 (135.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。
【举例】
# 指定下次启动时所用的主用启动文件为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!
【命令】
bootrom { backup | read | restore | update file file-url } [ all | part ]
【视图】
用户视图
【缺省级别】
3:管理级
【参数】
read:读取Bootrom,即将Bootrom程序从Bootrom存储器的Normal区读取到CF卡中以作备份。当Bootrom存储器损坏,可以重新运行CF卡上的Bootrom文件来恢复Bootrom。
restore:恢复Bootrom,即将Bootrom代码从Bootrom存储器的Backup区恢复到Normal区。如果当前的Bootrom被损坏,并且在损坏前备份了Bootrom,可以用restore操作来恢复Bootrom。
backup:备份Bootrom,即将Bootrom代码从Bootrom存储器的Normal区备份到Backup区,以便Normal区损坏时,可以从Backup区恢复Bootrom程序。建议在升级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 completed! Please check the file!
读取Bootrom程序后,会发现设备的存储介质上生成了文件extbtm.bin和basicbtm.bin:
<Sysname> dir
Directory of cfa0:/
0 drw- - Jul 07 2009 21:09:12 logfile
1 -rw- 15074620 Aug 08 2008 13:03:44 test.bin
2 -rw- 139 Sep 24 2008 06:51:38 system.xml
3 -rw- 524288 Aug 13 2008 17:07:18 extbtm.bin
4 -rw- 524288 Aug 13 2008 17:07:18 basicbtm.bin
5 -rw- 4232 Sep 24 2008 06:51:40 startup.cfg
250088 KB total (223700 KB free)
File system type of cfa0: FAT16
# 备份Bootrom程序。
<Sysname> bootrom backup all
Now backuping bootrom, please wait...
Backup bootrom completed!
# 恢复Bootrom程序。
<Sysname> bootrom restore all
This command will restore bootrom file, Continue? [Y/N]:y
Now restoring bootrom, please wait...
Restore bootrom completed!
# 使用wx5004.bin文件升级设备的Bootrom程序。
<Sysname> bootrom update file wx5004.bin
This command will update bootrom file, Continue? [Y/N]:y
Now updating bootrom, please wait...
Update bootrom success!
【命令】
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 boot file used at this reboot:cfa0:/test.bin attribute: main
The boot file used at the next reboot:cfa0:/test.bin attribute: main
The boot file used at the next reboot:cfa0:/test.bin attribute: backup
Failed to get the secure boot file used at the next reboot!
表1-1 display boot-loader命令显示信息描述表
字段 |
描述 |
The boot file used at this reboot |
系统本次启动时使用的启动文件 |
attribute |
启动文件的属性:main表示主用;backup表示备用 |
The boot file used at the next reboot |
系统下次启动时使用的启动文件 |
Failed to get the secure boot file used at the next reboot! |
获取下次启动时使用的安全启动文件失败(主用、备用下次启动文件均不存在或者损坏时,如果启动设备,将使用安全启动文件启动) |
【命令】
display patch [ | { begin | exclude | include } regular-expression ]
【视图】
任意视图
【缺省级别】
3:管理级
【参数】
|:使用正则表达式对显示信息进行过滤。有关正则表达式的详细介绍,请参见“基础配置指导”中的“CLI配置”。
begin:从包含指定正则表达式的行开始显示。
exclude:只显示不包含指定正则表达式的行。
include:只显示包含指定正则表达式的行。
regular-expression:表示正则表达式,为1~256个字符的字符串,区分大小写。
【描述】
display patch命令用来显示当前安装的补丁文件和对应的补丁包的版本。如果不是从补丁包中加载补丁,则不显示补丁包版本。
【举例】
# 显示当前安装的补丁文件和补丁包版本:
<Sysname> display patch
cfa0:/patch-xxx.bin, B90H01a, loaded on slot(s):0
表1-2 display patch命令显示信息描述表
字段 |
描述 |
cfa0:/patch-xxx.bin |
安装的补丁文件的路径 |
B90H01a |
补丁包的版本 |
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: cfa0:
Slot Version Temporary Common Current Active Running Start-Address
----------------------------------------------------------------------
1 MPU004 0 1 1 0 1 0x310bd74
表1-3 display patch information命令显示信息描述表
字段 |
描述 |
The location of patches |
补丁文件的加载路径,可以通过patch location命令设置 |
Slot |
无意义 |
Version |
补丁版本号。该字段的前3个字符表示PATCH-FLAG的后缀,后面的数字00x表示补丁的编号(只有补丁加载后,系统才能读取到补丁的编号信息) |
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
# 激活所有已加载的补丁。
<Sysname> system-view
[Sysname] patch active
【命令】
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命令,则系统不会改变加载路径。
【举例】
# 加载CF卡上的补丁文件,并且要求设备重启后补丁继续生效。
<Sysname> system-view
[Sysname] patch install cfa0:
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]
# 加载补丁文件包,并且要求设备重启后补丁继续生效。
<Sysname> system-view
[Sysname] patch install file:/patch_packeg.bin
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命令用来将补丁文件从存储介质(比如Flash、CF卡)加载到内存补丁区中。
如果指定了补丁包文件,则表示系统从补丁包中加载补丁;如果未指定补丁包文件,则表示从补丁文件中加载补丁。
执行该命令前,需要将补丁文件保存到指定路径。如果要从补丁包中加载补丁,则可以将补丁包文件保存在任意路径下,否则请将补丁文件保存到设备存储介质的根目录下。
【举例】
# 从补丁文件中加载补丁。
<Sysname> system-view
[Sysname] patch load
# 从补丁包中加载补丁。
<Sysname> system-view
[Sysname] patch load file cfa0:/patchpackege.bin
【命令】
patch location patch-location
【视图】
系统视图
【缺省级别】
3:管理级
【参数】
patch-location:表示补丁文件所在的路径,为1~64个字符的字符串,格式通常为存储介质的根目录。
【描述】
patch location命令用来设置补丁文件的加载路径。
缺省情况下,补丁文件的加载路径为flash或者cfa0:。
如果是要安装补丁包,则也无需配置该命令。
当设备支持多个存储介质时,用户可以将补丁文件保存到其它存储介质。此时,需要使用该命令告知系统补丁文件的位置,执行补丁加载操作时,系统会将该路径下指定后缀的补丁加载到对应的单板。如果设备只有一个存储介质,而且补丁文件只能放在固定路径,则不需要配置该命令。
需要注意的是,执行patch install命令会修改补丁文件的加载路径。比如,先配置了patch location xxx,再执行patch install yyy,此时系统会自动将补丁文件的加载路径从xxx改为yyy。如果执行patch install命令的同时指定了具体的补丁包文件,则不会改变补丁文件的加载路径。
【举例】
# 设置补丁文件加载路径为CF卡的根目录。
<Sysname> system-view
[Sysname] patch location cfa0:
【命令】
patch run [ patch-number ]
【视图】
系统视图
【缺省级别】
3:管理级
【参数】
patch-number:补丁序号。该参数的有效值与使用的补丁文件有关,请以实际情况为准。
【描述】
patch run命令用来确认运行补丁,即确认激活状态的补丁进入运行状态。
执行该命令时,如果指定补丁序号,则表示确认运行补丁序号之前(包括该序号)的所有已激活的补丁;如果不指定补丁序号,则表示确认运行当前系统中所有已激活的补丁。
该命令只对处于激活状态的补丁有效,对于处于其它状态的补丁,该命令无效。
确认运行的补丁,在系统重启后,会继续生效。
【举例】
# 确认运行3号及3号之前的补丁。
<Sysname> system-view
[Sysname] patch run 3
# 确认运行所有已激活的补丁。
<Sysname> system-view
[Sysname] patch run
不同款型规格的资料略有差异, 详细信息请向具体销售和400咨询。H3C保留在没有任何通知或提示的情况下对资料内容进行修改的权利!