07-软件升级命令
本章节下载: 07-软件升级命令 (140.39 KB)
如果将可插拔存储介质内的软件包指定为设备下次启动时使用的软件包,重启设备时不要将可插拔存储介质从设备上拔出,否则可能导致设备无法正常启动。建议将固定存储介质中的软件包指定为设备下次启动时使用的软件包。
boot-loader file命令用来配置设备下次启动时使用的软件包。
【命令】
boot-loader file boot filename system filename [ feature filename&<1-30> ] [ patch filename&<1-16> ] { all | slot slot-number } { backup | main }
boot-loader file ipe-filename [ patch filename&<1-16> ] { all | slot slot-number } { backup | main }
【视图】
用户视图
【缺省用户角色】
network-admin
【参数】
boot:Boot包。
system:System包。
feature:Feature包。
patch:Patch包。
filename&<1-30>:软件包的名称,形如filesystemname/filename.bin。该文件必须保存在设备任一文件系统的根目录下,该参数中必须包含文件系统的名称,从存储介质名称开始最多可输入63个字符。&<1-30>表示前面的参数最多可以输入30次。有关指定文件夹和文件详细介绍请参见“基础配置指导”中的“文件系统管理”。
ipe-filename:IPE(Image Package Envelope,复合软件包套件)文件的名称,形如filesystemname/filename.ipe。该文件必须保存在设备任一文件系统的根目录下,该参数中必须包含文件系统的名称,从存储介质名称开始最多可输入63个字符。有关指定文件夹和文件详细介绍请参见“基础配置指导”中的“文件系统管理”。
all:指定所有设备。效果与slot参数相同。
slot slot-number:指定设备编号。slot-number取值只能为1。
backup:指定该软件包为备用启动软件包。备用启动软件包用于主用启动软件包不可用或异常情况时,引导设备启动。
main:指定该软件包为主用启动软件包。主用启动软件包用于引导设备启动。
【使用指导】
成功执行该命令后,系统会用命令中指定的软件包替换现有的软件包列表。如果命令行中没有指定Feature包,则更新后的软件包列表中不会有Feature包。
需要重启系统来完成指定下次启动软件包的加载。
系统会自动检查指定slot上对应路径下是否存在同名文件,如果不存在,则直接从指定路径拷贝一份并设置为下次启动软件包;如果存在,则提示用户是否从指定路径拷贝一份并设置为下次启动软件包。
【举例】
# 配置指定slot下次启动时所用的主用启动文件为flash:/all.ipe。
<Sysname> boot-loader file flash:/all.ipe slot 1 main
Verifying the IPE file and the images............Done.
H3C WS5820-52X-WiNet Switch images in IPE:
boot.bin
system.bin
This command will set the main startup software images. Continue? [Y/N]:Y
Add images to slot 1.
File flash:/boot.bin already exists on slot 1.
File flash:/system.bin already exists on slot 1.
Overwrite the existing files? [Y/N]:Y
Decompressing file boot.bin to flash:/boot.bin........................Done.
Decompressing file system.bin to flash:/system.bin...............................Done.
Verifying the file flash:/boot.bin on slot 1...Done.
Verifying the file flash:/system.bin on slot 1.............Done.
The images that have passed all examinations will be used as the main startup software images at the next reboot on slot 1.
【相关命令】
· display boot-loader
bootrom update命令用来将文件系统中的BootWare程序加载到BootWare的Normal区。
【命令】
bootrom update file file slot slot-number-list
【视图】
用户视图
【缺省用户角色】
network-admin
【参数】
file file:文件系统中包含BootWare程序的文件,file表示用于BootWare程序升级的文件的名称,为1~63个字符的字符串。
slot slot-number-list:指定设备编号。slot-number-list取值只能为1。
【使用指导】
BootWare程序通过Boot包(*.bin)发布,产品会将需要升级的设备的BootWare程序集成到Boot包中。此时可以使用本命令将升级文件指定为Boot包,系统会根据设备的型号自动将相应的BootWare程序加载到BootWare中;也可以在升级Boot包的同时完成BootWare程序的加载。
执行该命令后,设备会将文件系统中的BootWare程序加载到BootWare的Normal区。设备启动时,会直接使用Normal区的BootWare程序。因此,如果文件系统空间不足,BootWare程序加载完成之后,BootWare文件可以删除。
加载后,要使新的BootWare程序生效,需要重启设备。
【举例】
# 使用Flash根目录下的a.bin文件升级设备的BootWare程序。
<Sysname> bootrom update file flash:/a.bin slot 1
This command will update the Boot ROM file on the specified board(s), Continue? [Y/N]:y
Now updating the Boot ROM, please wait................Done.
【相关命令】
· boot-loader file
display boot-loader命令用来显示本次启动和下次启动所采用的启动软件包的名称。
【命令】
display boot-loader [ slot slot-number ]
【视图】
任意视图
【缺省用户角色】
network-admin
network-operator
【参数】
slot slot-number:指定设备编号。slot-number-list取值只能为1。
【举例】
# 显示本次启动和下次启动所采用的启动软件包的名称。
<Sysname> display boot-loader
Software images on slot 1:
Current software images:
flash:/boot.bin
flash:/system.bin
Main startup software images:
flash:/boot.bin
flash:/system.bin
Backup startup software images:
flash:/boot.bin
flash:/system.bin
表1-1 display boot-loader命令显示信息描述表
字段 |
描述 |
Software images |
启动软件包的相关信息 |
Current software images |
最近一次启动使用的启动软件包列表 |
Main startup software images |
主用下次启动软件包列表 |
Backup startup software images |
备用下次启动软件包列表 |
【相关命令】
· boot-loader file
display install active命令用来显示当前系统中处于激活状态的软件包的相关信息。
【命令】
display install active [ slot slot-number ] [ verbose ]
【视图】
任意视图
【缺省用户角色】
network-admin
network-operator
【参数】
slot slot-number:指定设备编号。slot-number-list取值只能为1。
verbose:显示处于激活状态的软件包的详细信息,包括软件包的名称、基本信息和所包含的组件。不指定该参数时,仅显示软件包的名称。
【举例】
# 显示设备上处于激活状态的软件包的简要信息。
<Sysname> display install active
Active packages on slot 1:
flash:/boot.bin
flash:/system.bin
flash:/feature.bin
# 显示设备上处于激活状态的软件包的详细信息。
<Sysname> display install active verbose
Active packages on slot 1:
flash:/boot.bin
[Package]
Vendor: H3C
Product: WS5820
Service name: boot
Platform version: 7.1.022
Product version: Test 2201
Supported board: mpu
[Component]
Component: boot
Description: boot package
flash:/system.bin
[Package]
Vendor: H3C
Product: WS5820
Service name: system
Platform version: 7.1.022
Product version: Test 2201
Supported board: mpu
[Component]
Component: system
Description: system package
flash:/feature.bin
[Package]
Vendor: H3C
Product: WS5820
Service name: test
Platform version: 7.1.022
Product version: Test 2201
Supported board: mpu
[Component]
Component: test
Description: test package
表1-2 display install active命令显示信息描述表
字段 |
描述 |
Active packages on the device |
处于激活状态的软件包的相关信息 |
flash:/boot.bin |
软件包的名称 |
[Package] |
软件包的信息 |
Vendor |
生产厂商 |
Product |
产品名称 |
Service name |
软件包所包含的服务名称: · 如果显示为boot,表示该软件包为Boot包 · 如果显示为system,表示该软件包为System包 · 如果显示为boot patch,表示该软件包为Boot包的补丁包;如果显示为system patch,表示该软件包为System包的补丁包 · 如果显示为其它值,则表示该软件包为提供某项功能的Feature包 |
Platform version |
平台软件版本号 |
Product version |
产品软件版本号 |
Supported board |
(暂不支持)软件包支持的设备类型 |
[Component] |
组件信息,表示软件包的组成部分 |
Component |
组件的名称 |
Description |
组件的描述信息 |
【相关命令】
· install active
display install committed命令用来显示设备下次启动时使用的主用软件包的相关信息。
【命令】
display install committed [ slot slot-number ] [ verbose ]
【视图】
任意视图
【缺省用户角色】
network-admin
network-operator
【参数】
slot slot-number:指定设备编号。slot-number-list取值只能为1。
verbose:显示详细信息,包括软件包的名称、基本信息和所包含的组件。不指定该参数时,仅显示软件包的名称。
【使用指导】
某些install命令可以修改设备的软件包列表,但需要执行install commit命令来确认运行当前的软件包,这些软件包才会被列入主用下次启动软件包,使得设备重启后,这些软件包能够继续生效。可以使用本命令查看已被确认为下次启动的软件包。
执行install committed和boot-loader file命令都可以修改设备下次启动时使用的主用软件包列表。
【举例】
# 显示设备下次启动时使用的主用软件包的相关信息。
<Sysname> display install committed
Committed packages on slot 1:
flash:/boot-t5101.bin
flash:/system-t5101.bin
flash:/feature.bin
# 显示设备下次启动时使用的主用软件包的详细信息。
<Sysname> display install committed verbose
Committed packages on slot 1:
flash:/boot-t5101.bin
[Package]
Vendor: H3C
Product: WS5820
Service name: boot
Platform version: 7.1
Product version: Beta 1330
Supported board: mpu
[Component]
Component: boot
Description: boot package
flash:/system-t5101.bin
[Package]
Vendor: H3C
Product: WS5820
Service name: system
Platform version: 7.1
Product version: Beta 1330
Supported board: mpu
[Component]
Component: system
Description: system package
flash:/ssh-feature.bin
[Package]
Vendor: H3C
Product: WS5820
Service name: ssh
Platform version: 7.1
Product version: Beta 1330
Supported board: mpu
[Component]
Component: ssh
Description: ssh package
本命令显示信息的描述请参见表1-2。
【相关命令】
· boot-loader file
· install commit
install activate命令用来Feature包或补丁包。
【命令】
install activate feature filename&<1-30> slot slot-number
install activate patch filename { all | slot slot-number }
【视图】
用户视图
【缺省用户角色】
network-admin
【参数】
feature:Feature包。
patch:补丁包。用于快速修复系统Bug。
filename&<1-30>:软件包的名称,形如filesystemname/filename.bin。该文件必须保存在设备任一文件系统的根目录下,该参数中必须包含文件系统的名称,从存储介质名称开始最多可输入63个字符。&<1-30>表示前面的参数最多可以输入30次。有关指定文件夹和文件详细介绍请参见“基础配置指导”中的“文件系统管理”。
all:指定所有设备。效果与slot参数相同。
slot slot-number:指定设备编号。slot-number取值只能为1。
【使用指导】
使用本命令激活指定硬件上的软件包后,被激活的软件包只在本次运行的系统中生效。要使被激活的软件包在设备重启后继续生效,还需要执行install commit命令。激活补丁包时,若使用install activate patch filename all命令同时激活所有硬件上的补丁包,则无需执行install commit命令,所有补丁包在设备重启后继续生效。
【举例】
# 升级设备1上的补丁包system-patch.bin。
<Sysname> install activate system-patch.bin slot 1
【相关命令】
· display install active
· install commit
· install deactivate
install commit命令用来确认软件包更改。
【命令】
install commit
【视图】
用户视图
【缺省用户角色】
network-admin
【使用指导】
该命令会将补丁包文件添加到系统时使用的软件包列表:
· 如果系统使用了主用软件包启动,该命令会将补丁包文件添加到主用软件包列表中。
· 如果系统使用了备用软件包启动,该命令会将补丁包文件添加到备用软件包列表中。
执行install activate、install deactivate命令会修改设备当前运行的软件包列表,使得只有符合用户需求的软件运行,不符合要求的不运行。
当用户对补丁包执行install activate或install deactivate命令后,该补丁包会被安装或卸载,同时会修改设备当前运行的软件包列表,如果用户希望当前的配置在设备重启后依然生效,可使用install commit命令确认本次操作。
【举例】
# 确认软件包更改。
<Sysname> install commit
This operation will take several minutes, please wait...........................Done.
【相关命令】
· install activate
· install deactivate
install deactivate命令用来卸载Feature包或补丁包。
【命令】
install deactivate feature filename&<1-30> slot slot-number
install deactivate patch filename { all | slot slot-number }
【视图】
用户视图
【缺省用户角色】
network-admin
【参数】
feature:Feature包。
patch:补丁包。
filename&<1-30>:软件包的名称,形如filesystemname/filename.bin。该参数中必须且只能包含文件系统的名称,不能包含文件系统位置信息,从存储介质名称开始最多可输入63个字符。&<1-30>表示前面的参数最多可以输入30次。有关指定文件夹和文件详细介绍请参见“基础配置指导”中的“文件系统管理”。
all:指定所有设备。效果与slot参数相同。
slot slot-number:指定设备编号。slot-number取值只能为1。
【使用指导】
该命令只能对已经激活的软件包进行卸载操作。使用本命令卸载指定slot上的软件包后,卸载的软件包的特性功能在本次系统运行中失效。如果要使卸载的软件包在设备重启后继续失效,请执行install commit命令对卸载操作进行确认。卸载补丁包时,若使用install deactivate patch filename all命令同时卸载所有slot上的补丁包,则无需执行install commit命令,所有补丁包在设备重启后继续失效。
【举例】
# 卸载指定slot上的patch包route-patch.bin。
<Sysname> install deactivate patch flash:/route-patch.bin slot 1
【相关命令】
· display install active
不同款型规格的资料略有差异, 详细信息请向具体销售和400咨询。H3C保留在没有任何通知或提示的情况下对资料内容进行修改的权利!