01 基础配置命令参考

07-软件升级命令

1 软件升级

1.1 软件升级配置命令

1.1.1 boot-loader file

1.1.2 bootrom update

1.1.3 display boot-loader

1.1.4 display install active

1.1.5 display install committed

1.1.6 display install inactive

1.1.7 display install package

1.1.8 install activate

1.1.9 install commit

1.1.10 install deactivate

1.1.11 install remove

1 软件升级

1.1 软件升级配置命令

1.1.1 boot-loader file

boot-loader file命令用来指定设备下次启动时使用的软件包/IPE文件。

【命令】

boot-loader file boot boot-package system system-package [ feature feature-package&<1-30> ] slot slot-number { backup | main }

boot-loader file ipe-filename slot slot-number { backup | main }

boot boot-package：Boot包的名称，以.bin作为后缀名，为1～63个字符的字符串，不区分大小写。

system system-package：System包的名称，以.bin作为后缀名，为1～63个字符的字符串，不区分大小写。

feature feature-package：Feature包的名称，以.bin作为后缀名，为1～63个字符的字符串，不区分大小写。{ feature-package }&<1-30>表示前面的参数最多可以输入30次。

ipe-filename：表示IPE（Image Package Envelope，复合软件包套件）文件名，以.ipe作为后缀名，为1～63个字符的字符串，不区分大小写。

slot slot-number：指定设备编号，取值只能为1。

backup：指定该软件包为备用启动软件包，并将该软件包的名称添加到备用启动软件包列表。备用启动软件包用于主用启动软件包不可用或异常情况时，引导设备启动。

main：指定该软件包为主用启动软件包，并将该软件包的名称添加到主用启动软件包列表。主用启动软件包用于引导设备启动。

【使用指导】

当配置该命令时，命令中指定的软件包（IPE文件）必须放在设备存储介质主分区的根目录下，文件名中必须包含存储介质的名称，形如flash:/xx.bin（flash:/xx.ipe）。

【举例】

# 指定设备下次启动时所用的备用启动文件为flash:/all.ipe。

<Sysname> boot-loader file flash:/all.ipe slot 1 backup

Verifying image file...........................Done.

Images in IPE:

boot.bin

system.bin

This command will set the backup startup software images. Continue? [Y/N]:Y

Add images to target slot.

flash:/boot.bin already exists on slot 1.

flash:/system.bin already exists on slot 1.

Overwrite it? [Y/N]:y

Decompressing file boot.bin to flash:/boot.bin........................Done.

Decompressing file system.bin to flash:/system.bin...............................Done.

The specified file list will be used as the backup startup software images at the next reboot on slot 1.

【相关命令】

· display boot-loader

1.1.2 bootrom update

bootrom update命令用来加载Boot ROM程序。

【命令】

bootrom update file file-url slot slot-number-list

file file-url：Flash中包含Boot ROM程序的文件，file-url表示用于Boot ROM程序升级的文件的名称，为1～63个字符的字符串。

slot slot-number-list：指定设备编号，取值只能为1。

【使用指导】

Boot ROM程序通过Boot包（*.bin）发布，产品会将需要升级的设备的Boot ROM程序集成到Boot包中。此时，可是使用bootrom update命令，将升级文件指定为Boot包，系统会根据设备的型号自动将相应的Boot ROM程序加载到Boot ROM中；也可以在升级Boot包的同时完成Boot ROM程序的加载。

执行该命令后，设备会将Flash中的Boot ROM程序加载到Boot ROM的Normal区。设备启动时，会直接使用Normal区的Boot ROM程序。因此，如果Flash空间不足，Boot ROM程序加载完成之后，Boot ROM文件可以删除。

加载后，要使新的Boot ROM程序生效，需要重启设备。

【举例】

# 使用a.btm文件升级设备的Boot ROM程序。

<Sysname> bootrom update file a.btm

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

1.1.3 display boot-loader

display boot-loader命令用来显示本次启动和下次启动所采用的启动软件包的名称。

【命令】

display boot-loader [ slot slot-number ]

slot slot-number：指定设备编号，取值只能为1。

【举例】

# 显示本次启动和下次启动所采用的启动软件包的名称。

<Sysname> display boot-loader

Software images on slot 1:

Current software images:

flash:/simware-cmw710-boot-a1701.bin

flash:/simware-cmw710-system-a1701.bin

Main startup software images:

flash:/simware-cmw710-boot-a1701.bin

flash:/simware-cmw710-system-a1701.bin

flash:/simware-cmw710-ssh-a1701.bin

Backup startup software images:

flash:/simware-cmw710-boot-a1701.bin

flash:/simware-cmw710-system-a1701.bin

表1-1 display boot-loader命令显示信息描述表

字段	描述
Software images on slot n	成员编号为n的某成员设备的启动软件包的相关信息
Current software images	最近一次启动使用的启动软件包列表
Main startup software images	主用下次启动软件包列表
Backup startup software images	备用下次启动软件包列表

【相关命令】

· boot-loader file

1.1.4 display install active

display install active命令用来显示当前系统中处于激活状态的软件包的相关信息。

【命令】

display install active [ slot slot-number ] [ verbose ]

slot slot-number：成员设备的编号，编号只能取1。

verbose：显示处于激活状态的软件包的详细信息，包括软件包的名称、基本信息和所包含的组件。不指定该参数时，仅显示软件包的名称。

【举例】

# 显示设备上处于激活状态的软件包的简要信息。

<Sysname> display install active

Active packages on slot 1:

flash:/boot.bin

flash:/system.bin

flash:/ssh-feature.bin

# 显示设备上处于激活状态的软件包的详细信息。

<Sysname> display install active verbose

Active packages on slot 1:

flash:/boot.bin

[Package]

Vendor: H3C

Product: xxxx

Service name: boot

Platform version: 7.1.046

Product version: Test 2201

Supported board: mpu

[Component]

Component: boot

Description: boot package

flash:/system.bin

[Package]

Vendor: H3C

Product: xxxx

Service name: system

Platform version: 7.1.046

Product version: Test 2201

Supported board: mpu

[Component]

Component: system

Description: system package

表1-2 display install active命令显示信息描述表

字段	描述
Active packages on slot 1	某成员设备上处于激活状态的软件包的相关信息，其中1表示设备的成员编号
boot.bin	软件包的名称
[Package]	软件包的信息
Vendor	生产厂商
Product	产品名称
Service name	软件包所包含的服务名称 · 如果显示为boot，表示该软件包为Boot包 · 如果显示为system，表示该软件包为System包 · 如果显示为patch，表示该软件包为补丁包 · 如果显示为其它值，则表示该软件包为提供某项功能的Feature包
Platform version	平台软件版本号
Product version	产品软件版本号
Supported board	软件包支持的单板类型，仅支持mpu参数（mpu为主控板）
[Component]	组件信息，表示软件包的组成部分
Component	组件的名称
Description	组件的描述信息