目  录

1 软件升级

1.1 软件升级配置命令

1.1.1 boot-loader file

1.1.2 boot-loader update

1.1.3 bootrom backup

1.1.4 bootrom restore

1.1.5 bootrom update

1.1.6 bootrom-update security-check enable

1.1.7 display boot-loader

1.1.8 display install active

1.1.9 display install backup

1.1.10 display install committed

1.1.11 display install inactive

1.1.12 display install ipe-info

1.1.13 display install job

1.1.14 display install package

1.1.15 display install rollback

1.1.16 display install which

1.1.17 display version

1.1.18 display version-update-record

1.1.19 install abort

1.1.20 install activate

1.1.21 install add

1.1.22 install commit

1.1.23 install deactivate

1.1.24 install remove

1.1.25 install rollback to

1.1.26 install verify

1.1.27 reset version-update-record

 

1 软件升级

如果将可插拔存储介质内的软件包指定为设备下次启动时使用的软件包，重启设备时不要将可插拔存储介质从设备上拔出，否则可能导致设备无法正常启动。建议将固定存储介质中的软件包指定为设备下次启动时使用的软件包。

1.1  软件升级配置命令

1.1.1  boot-loader file

boot-loader file命令用来配置设备下次启动时使用的软件包。

【命令】

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

boot-loader file ipe-filename [ patch filename&<1-30> ] { all | slot slot-number } { backup | main [ undecompressed ] }

【视图】

用户视图

【缺省用户角色】

network-admin

【参数】

boot：Boot包。

system：System包。

feature：Feature包。

patch：Patch包。该参数既可以指定叠加补丁也可以指定非叠加补丁。叠加补丁最多可以同时安装30个；由于每个非叠加补丁包只能为一个Boot、System和Feature包打补丁，所以非叠加补丁最多只能同时安装16个。

filename&<1-30>：软件包的名称，形如filesystemname/filename.bin。该文件必须保存在设备任一文件系统的根目录下，该参数中必须包含文件系统的名称，从存储介质名称开始最多可输入63个字符。&<1-30>表示前面的参数最多可以输入30次。有关指定文件夹和文件详细介绍请参见“基础配置指导”中的“文件系统管理”。

ipe-filename：IPE（Image Package Envelope，复合软件包套件）文件的名称，形如filesystemname/filename.ipe。该文件必须保存在设备任一文件系统的根目录下，该参数中必须包含文件系统的名称，从存储介质名称开始最多可输入63个字符。有关指定文件夹和文件详细介绍请参见“基础配置指导”中的“文件系统管理”。

all：指定系统中软件包适用的所有的硬件。

slot slot-number：为本设备在DDC中的成员编号。

backup：指定该软件包为备用启动软件包。备用启动软件包用于主用启动软件包不可用或异常情况时，引导设备启动。

main：指定该软件包为主用启动软件包。主用启动软件包用于引导设备启动。

undecompressed：表示不解压IPE包，直接将其设置为下次启动软件包。不指定该参数时，设备将立即解压IPE包并将解压出的BIN包设置为下次启动软件包。当设备存储介质上空间足够的时候，建议不要指定该参数。

【使用指导】

 

成功执行该命令后，系统会用命令中指定的软件包替换现有的软件包列表。如果命令行中没有指定Feature包，则更新后的软件包列表中不会有Feature包。

需要重启系统来完成指定下次启动软件包的加载。

系统会自动检查指定slot上对应路径下是否存在同名文件，如果不存在，则直接从指定路径拷贝一份并设置为下次启动软件包；如果存在，则提示用户是否从指定路径拷贝一份并设置为下次启动软件包。

【举例】

# 配置主用下次启动软件为flash:/all.ipe。

<Sysname> boot-loader file slot1#flash:/all.ipe all main

Verifying the file flash:/all.ipe on slot 1......................................Done.

XX 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.

The images that have passed all examinations will be used as the main startup software images at the next reboot on slot 1.

File flash:/Boot.bin already exists on slot 2.

Do you want to overwrite the file?

 Y: Overwrite the file.

 N: Not overwrite the file.

 A: From now on, overwrite or not overwrite without prompt.

Please make a choice. [Y/N/A]:a

What type of overwrite operation do you want to perform?

 Y: Overwrite without prompt.

 N: Not overwrite or display prompt.

 Q: Return to the previous step.

Please make a choice. [Y/N/Q]:y

An existing file will be overwritten without prompt if it has the same name as any upgrade file.

Loading......................Done.

Loading......................Done.

Loading......................Done.

Loading......................Done.

Loading......................Done.

Loading......................Done.

The images that have passed all examinations will be used as the main startup software images at the next reboot on slot 2.

The images that have passed all examinations will be used as the main startup software images at the next reboot on slot 3.

Decompression completed.

Do you want to delete flash:/all.ipe now? [Y/N]:n

【相关命令】

·     display boot-loader

1.1.2  boot-loader update

boot-loader update命令用来实现当前软件版本的自动同步。

【命令】

boot-loader update { all | slot slot-number }

【视图】

用户视图

【缺省用户角色】

network-admin

【参数】

all：表示同步升级所有备设备。

slot slot-number：为本设备在DDC中的成员编号。

【使用指导】

【举例】

# 同步指定slot的软件版本。

<Sysname> boot-loader update slot 2

This command will update the specified standby MPU. Continue? [Y/N]:y

Updating. Please wait...

Verifying the file flash:/boot.bin on slot 1...Done.

Verifying the file flash:/system.bin on slot 1....Done.

Copying main startup software images to slot 2. Please wait...

Done.

Setting copied images as main startup software images for slot 2...

The images that have passed all examinations will be used as the main startup software images at the next reboot on slot 2.

Done.

Successfully updated the startup software images of slot 2.

【相关命令】

·     display boot-loader

·     install commit

1.1.3  bootrom backup

bootrom backup命令用来将BootWare程序从BootWare的Normal区备份到Backup区。

【命令】

bootrom backup slot slot-number-list [ subslot subslot-number-list ] [ all | part ]

【视图】

用户视图

【缺省用户角色】

network-admin

【参数】

slot slot-number-list：成员编号列表。表示方式为slot-number-list = { slot-number [ to slot-number ] }&<1-7>。其中，slot-number表示需要备份的设备在DDC中的成员编号。

subslot subslot-number-list：子槽位号列表，表示同时备份多个子卡的BootWare程序。表示方式为subslot-number-list = { subslot-number [ to subslot-number ] }&<1-7>。其中，subslot-number表示需要备份的子卡所在的子槽位号。&<1-7>表示前面的参数最多可以输入7次。不使用该参数时，表示备份的是单板的BootWare程序。

all：操作BootWare程序的全部内容。不指定all和part参数时，默认使用all。

part：只操作BootWare程序的扩展段（BootWare程序分为两部分：基本段和扩展段，基本段提供BootWare菜单的基本操作项，扩展段提供更多的BootWare菜单操作项）。不指定all和part参数时，默认使用all。

【使用指导】

BootWare分为Normal区和Backup区：

·     Normal区用于存放BootWare程序。设备启动时，会自动读取Normal区的BootWare程序。如果Normal区的BootWare程序不可用，再自动读取Backup区的BootWare程序。

·     Backup区用于存放BootWare程序的副本。如果在设备运行过程中，Normal区的BootWare程序被损坏或者需要版本回退，可以使用bootrom restore命令将BootWare程序从Backup区恢复到Normal区。

【举例】

# 将BootWare程序从BootWare的Normal区备份到Backup区。

<Sysname> bootrom backup slot 1

Now backing up the Boot ROM, please wait...

......Done.

【相关命令】

·     bootrom restore

1.1.4  bootrom restore

bootrom restore命令用来将BootWare程序从BootWare的Backup区恢复到Normal区。

【命令】

bootrom restore slot slot-number-list [ subslot subslot-number-list ]

【视图】

用户视图

【缺省用户角色】

network-admin

【参数】

slot slot-number-list：成员编号列表，表示同时恢复多个成员设备的BootWare程序。表示方式为slot-number-list = { slot-number [ to slot-number ] }&<1-7>。其中，slot-number表示需要恢复的设备在DDC中的成员编号。

subslot subslot-number-list：子槽位号列表，表示同时恢复多个子卡的BootWare程序。表示方式为subslot-number-list = { subslot-number [ to subslot-number ] }&<1-7>。其中，subslot-number表示需要恢复的子卡所在的子槽位号。&<1-7>表示前面的参数最多可以输入7次。不使用该参数时，表示不恢复子卡。

【举例】

# 恢复BootWare程序。

<Sysname> bootrom restore slot 1

  This command will restore the Boot ROM file on the specified board(s), Continue? [Y/N]:y

  Now restoring the Boot ROM, please wait...

......Done.

【相关命令】

·     bootrom backup

1.1.5  bootrom update

bootrom update命令用来将文件系统中的BootWare程序加载到BootWare的Normal区。

【命令】

bootrom update file file slot slot-number-list [ subslot subslot-number-list ]

【视图】

用户视图

【缺省用户角色】

network-admin

【参数】

file file：文件系统中包含BootWare程序的文件，file表示用于BootWare程序升级的文件的名称，为1～63个字符的字符串。

slot slot-number-list：成员编号列表，表示同时升级多个成员设备的BootWare程序。表示方式为slot-number-list = { slot-number [ to slot-number ] }&<1-7>。其中，slot-number表示需要升级的设备在DDC中的成员编号。

subslot subslot-number-list：子槽位号列表，表示同时升级多个子卡的BootWare程序。表示方式为subslot-number-list = { subslot-number [ to subslot-number ] }&<1-7>。其中，subslot-number表示需要升级的子卡所在的子槽位号。&<1-7>表示前面的参数最多可以输入7次。不使用该参数时，表示不升级子卡。

【使用指导】

 

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

1.1.6  bootrom-update security-check enable

bootrom-update security-check enable命令用来开启BootWare程序合法性检查功能。

undo bootrom-update security-check enable命令用来关闭BootWare程序合法性检查功能。

【命令】

bootrom-update security-check enable

undo bootrom-update security-check enable

【缺省情况】

BootWare程序合法性检查功能处于开启状态。

【视图】

系统视图

【缺省用户角色】

network-admin

【使用指导】

如果开启了本功能，则在升级BootWare程序时，设备会先检查BootWare文件的合法性：包括BootWare文件是否有效以及是否和硬件匹配等。检查通过后，才会升级。

【举例】

# 启动BootWare升级时的合法性检查功能。

<Sysname> system-view

[Sysname] bootrom-update security-check enable

1.1.7  display boot-loader

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

【命令】

display boot-loader [ slot slot-number ]

【视图】

任意视图

【缺省用户角色】

network-admin

network-operator

【参数】

slot slot-number：为本设备在DDC中的成员编号。如果不指定本参数，则默认为本设备的成员编号。

【举例】

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

<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_backup.bin

  flash:/system_backup.bin

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

<Sysname> display boot-loader

Software images on slot 1:

Current software images:

  Image                 Version

  flash:/boot.bin       Release 0053

  flash:/system.bin     Release 0053

Main startup software images:

  Image                 Version

  flash:/boot.bin       Release 0054

  flash:/system.bin     Release 0054

Backup startup software images:

  Image                 Version

  flash:/b-boot.bin     --

  flash:/b-system.bin   --

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

字段	描述
Software images	启动软件包的相关信息
Current software images	最近一次启动使用的启动软件包列表
Main startup software images	主用下次启动软件包列表
Image	软件包的名称
Version	软件包的版本号 当软件包被损坏或删除导致无法读取到版本号，则显示为—
Backup startup software images	备用下次启动软件包列表

‌

【相关命令】

·     boot-loader file

1.1.8  display install active

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

【命令】

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

【视图】

任意视图

【缺省用户角色】

network-admin

network-operator

【参数】

slot slot-number：为本设备在DDC中的成员编号。如果不指定本参数，则默认为本设备的成员编号。

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

【举例】

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

<Sysname> display install active

Active packages on slot 1:

  flash:/boot.bin

  flash:/system.bin

  flash:/feature1.bin

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

<Sysname> display install active verbose

Active packages on slot 1:

flash:/boot.bin

 [Package]

 Vendor: H3C

 Product: S12500

 Service name: boot

 Platform version: 7.1.070

 Product version: Test 0001015

 Supported board: mpu

 [Component]

 Component: boot

 Description: boot package

 

flash:/system.bin

 [Package]

 Vendor: H3C

 Product: S12500

 Service name: system

 Platform version: 7.1.070

 Product version: Test 0001015

 Supported board: mpu

 [Component]

 Component: system

 Description: system package

 

flash:/feature1.bin

 [Package]

 Vendor: H3C

 Product: S12500

 Service name: test

 Platform version: 7.1.070

 Product version: Test 0001015

 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	软件包支持的硬件类型： ·     mpu表示设备
[Component]	组件信息，表示软件包的组成部分
Component	组件的名称
Description	组件的描述信息

 

【相关命令】

install active

1.1.9  display install backup

display install backup命令用来显示设备下次启动时使用的备用软件包的相关信息。

【命令】

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

【视图】

任意视图

【缺省用户角色】

network-admin

network-operator

【参数】

slot slot-number：为本设备在DDC中的成员编号。如果不指定本参数，则默认为本设备的成员编号。

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

【使用指导】

当主用启动软件包列表中的Boot包或System包不存在或者损坏时，使用备用启动软件包列表中的软件包。有关设备下次启动时使用的软件包的详细介绍请参见“基础配置指导”中的“软件升级”。

执行boot-loader file命令可以修改设备下次启动时使用的备用软件包列表。

【举例】

# 显示设备下次启动时使用的备用软件包的相关信息。

<Sysname> display install backup

Backup startup software images on slot 1:

  flash:/boot.bin

  flash:/system.bin

# 显示设备下次启动时使用的备用软件包的详细信息。

<Sysname> display install backup verbose

Backup startup software images on slot 1:

 flash:/boot.bin

 [Package]

 Vendor: H3C

 Product: S12500

 Service name: boot

 Platform version: 7.1.070

 Product version: Test 0001015

 Supported board: mpu_x86_64

 [Component]

 Component: boot

 Description: boot package

 

 flash:/system.bin

 [Package]

 Vendor: H3C

 Product: S12500

 Service name: system

 Platform version: 7.1.070

 Product version: Test 0001015

 Supported board: mpu_x86_64

 [Component]

 Component: system

 Description: system package

【相关命令】

·     boot-loader file

·     display install committed

 

1.1.10  display install committed

display install committed命令用来显示设备下次启动时使用的主用软件包的相关信息。

【命令】

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

【视图】

任意视图

【缺省用户角色】

network-admin

network-operator

【参数】

slot slot-number：为本设备在DDC中的成员编号。如果不指定本参数，则默认为本设备的成员编号。

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

【使用指导】

某些install命令可以修改设备的软件包列表，但需要执行install commit命令来确认运行当前的软件包，这些软件包才会被列入主用下次启动软件包，使得设备重启后，这些软件包能够继续生效。可以使用本命令查看已被确认为下次启动的软件包。

执行install commit和boot-loader file命令都可以修改设备下次启动时使用的主用软件包列表。

【举例】

# 显示设备下次启动时使用的主用软件包的相关信息。

<Sysname> display install committed

Committed packages on slot 1:

 flash:/boot.bin

 flash:/system.bin

 flash:/feature1.bin

# 显示设备下次启动时使用的主用软件包的详细信息。

<Sysname> display install committed verbose

Committed packages on slot 1:

 flash:/boot.bin

 [Package]

 Vendor: H3C

 Product: S12500

 Service name: boot

 Platform version: 7.1.070

 Product version: Test 0001015

 Supported board: mpu

 [Component]

 Component: boot

 Description: boot package

 

 flash:/system.bin

 [Package]

 Vendor: H3C

 Product: S12500

 Service name: system

 Platform version: 7.1.070

 Product version: Test 0001015

 Supported board: mpu

 [Component]

 Component: system

 Description: system package

 

flash:/feature1.bin

 [Package]

 Vendor: H3C

 Product: S12500

 Service name: feature1

 Platform version: 7.1.070

 Product version: Test 0001015

 Supported board: mpu

 [Component]

 Component: feature1

 Description: feature1 package

【相关命令】

·     boot-loader file

·     display install backup

·     install commit

1.1.11  display install inactive

display install inactive命令用来显示文件系统根目录下没有被激活的所有软件包的相关信息。

【命令】

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

【视图】

任意视图

【缺省用户角色】

network-admin

network-operator

【参数】

slot slot-number：为本设备在DDC中的成员编号。如果不指定本参数，则默认为本设备的成员编号。

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

【举例】

# 显示文件系统根目录下没有被激活的所有软件包的简要信息。

<Sysname> display install inactive

Inactive packages on slot 1:

 flash:/feature1.bin

# 显示文件系统根目录下没有被激活的所有软件包的详细信息。

<Sysname> display install inactive verbose

Inactive packages on slot 1:

flash:/feature1.bin

 [Package]

 Vendor: H3C

 Product: S12500

 Service name: feature1

 Platform version: 7.1.070

 Product version: Test 0001015

 Supported board: mpu_x86_64

 [Component]

 Component: feature1

 Description: feature1 package

【相关命令】

install deactivate

1.1.12  display install ipe-info

display install ipe-info命令用来显示IPE文件包含的软件包列表。

【命令】

display install ipe-info ipe-filename

【视图】

任意视图

【缺省用户角色】

network-admin

network-operator

【参数】

ipe-filename：表示IPE文件的名称，形如filesystemname/filename.ipe。该文件必须保存在设备任一文件系统的根目录下，该参数中必须包含文件系统的名称，从存储介质名称开始最多可输入63个字符。有关指定文件夹和文件详细介绍请参见“基础配置指导”中的“文件系统管理”。

【使用指导】

IPE文件是一个或多个软件包的集合。用户获得IPE文件后，可以选择其中的软件包进行升级。

【举例】

# 显示flash:/test.ipe的IPE信息。

<Sysname> display install ipe-info flash:/test.ipe

Verifying the file flash:/test.ipe on slot 1................Done.

H3C S12500AI-OPEN images in IPE:

【相关命令】

display install package

 

1.1.13  display install job

display install job命令用来显示系统中正在执行的激活、卸载或回滚操作。

【命令】

display install job

【视图】

任意视图

【缺省用户角色】

network-admin

network-operator

【举例】

# 显示系统中正在执行的激活、卸载、回滚操作。

<Sysname> display install job

 JobID:5

  Action:install activate flash:/feature1.bin on slot 1

以上显示信息表明：设备正在执行install activate flash:/feature1.bin slot 1操作。

1.1.14  display install package

display install package命令用来显示软件包的相关信息。

【命令】

display install package { filename | all } [ verbose ]

【视图】

任意视图

【缺省用户角色】

network-admin

network-operator

【参数】

filename：软件包的名称，形如filesystemname/filename.bin。该文件必须保存在设备任一文件系统的根目录下，该参数中必须包含文件系统的名称，从存储介质名称开始最多可输入63个字符。有关指定文件夹和文件详细介绍请参见“基础配置指导”中的“文件系统管理”。

all：表示设备上各文件系统根目录下的所有软件包。

verbose：显示软件包的基本信息和软件包所包含的组件。不指定该参数时，仅显示软件包的基本信息。

【举例】

# 显示软件包system.bin的相关信息。

<Sysname> display install package flash:/system.bin

  flash:/system.bin

  [Package]

  Vendor: H3C

  Product: S12500

  Service name: system

  Platform version: 7.1.070

  Product version: Test 0001015

  Supported board: mpu_x86_64

# 显示软件包system.bin的详细信息。

<Sysname> display install package flash:/system.bin verbose

  flash:/system.bin

  [Package]

  Vendor: H3C

  Product: S9855_9825

  Service name: system

  Platform version: 7.1.070

  Product version: Test 0001015

  Supported board: mpu_x86_64

  [Component]

  Component: system

  Description: system package

1.1.15  display install rollback

display install rollback命令用来显示回滚点的相关信息。

【命令】

display install rollback [ point-id ]

【视图】

任意视图

【缺省用户角色】

network-admin

network-operator

【参数】

point-id：回滚点的编号。如果未指定point-id，则显示所有回滚点的相关信息。

【使用指导】

可以通过这个命令查看回滚点信息，以便进行相应的回滚操作。

【举例】

# 显示所有回滚点的相关信息。

<Sysname> display install rollback

Install rollback information 1 on slot 1:

  Updating from flash:/route-1.bin

         to flash:/route-2.bin.

 

Install rollback information 2 on slot 1:

   Deactivating flash:/route-2.bin

以上显示信息表明：设备上共有两个回滚点，回滚点1是将flash:/route-1.bin升级至flash:/route-2.bin，回滚点2是卸载flash:/route-2.bin。

表1-3 display install rollback命令显示信息描述表

字段	描述
Install rollback information n	回滚点信息，n为回滚点编号
Updating from A to B	从软件包A升级到软件包B，A和B为软件包的名称
Deactivating A	卸载软件包A，A为软件包的名称

 

【相关命令】

install rollback

1.1.16  display install which

display install which命令用来显示一个组件或文件的所属软件包，以及该软件包的相关信息。

【命令】

display install which { component name | file filename } [ slot slot-number ]

【视图】

任意视图

【缺省用户角色】

network-admin

network-operator

【参数】

component name：软件包所包含的组件的名称。

file filename：软件包所包含的文件的名称，为1～63个字符的字符串，不区分大小写。必须为纯文件名的形式。

slot slot-number：为本设备在DDC中的成员编号。如果不指定本参数，则默认为本设备的成员编号。

【使用指导】

组件是特性的集合，组件中的特性是同时安装/卸载的。

当软件包运行错误，系统提示xx组件或者xx文件运行错误的时候，可以根据组件名/文件名使用该命令查找它属于哪个软件包，从而帮助进一步定位是否是软件包本身有缺陷。通过检验该软件包，定位是否为软件包的问题。使用install verify命令可以对软件包进行检验。

执行该命令后，系统会扫描指定位置的所有文件系统根目录下的所有软件包，将包含该组件/文件的软件包都依次显示。

【举例】

# 显示文件pkg_ctr属于哪个软件包以及该软件包的相关信息。

<Sysname> display install which file pkg_ctr

Verifying the file flash:/system-t0001015.bin on slot 1..........................Done.

Found pkg_ctr in flash:/system-t0001015.bin on slot 1.

  flash:/system-t0001015.bin

  [Package]

  Vendor: H3C

  Product: S12500

  Service name: system

  Platform version: 7.1.070

  Product version: Test 0001015

  Supported board: mpu_x86_64

 

Verifying the file flash:/boot-d2601007.bin on slot 1.....Done.

表1-4 display install which命令显示信息描述表

字段	描述
Verifying the file	验证文件是否合法
Found pkg_ctr	找到文件
[Package]	软件包的信息
Vendor	生产厂商
Product	产品名称
Service name	软件包所包含的服务名称： ·     如果显示为boot，表示该软件包为Boot包 ·     如果显示为system，表示该软件包为System包 ·     如果显示为patch，表示该软件包为补丁包 ·     如果显示为其它值，则表示该软件包为提供某项功能的Feature包
Platform version	平台软件版本号
Product version	产品软件版本号
Supported board	软件包支持的硬件类型： mpu_x86_64表示集中式设备
File xxx was not found in the image packages under the root directory of the storage medium	在存储介质根目录下的所有包中都没有找到指定文件

 

1.1.17  display version

display version命令用来显示系统版本信息。

【命令】

display version

【视图】

任意视图

【缺省用户角色】

network-admin

network-operator

【举例】

# 查看系统版本信息。

<Sysname> display version

H3C Comware Software, Version 9.1.058, Demo 5230P1099                          

Copyright (c) 2004-2024 New H3C Technologies Co., Ltd. All rights reserved.    

H3C S12500AI-36DH20EP-NCPN uptime is 0 weeks, 0 days, 7 hours, 35 minutes      

Last reboot reason : Memory exhaust reboot                                     

                                                                                

Boot image: flash:/S12500AI-OPEN-CMW910-BOOT-D5230P1099.bin                    

Boot image version: 9.1.058, Demo 5230P1099                                    

  Compiled Dec 25 2024 16:00:00                                                

System image: flash:/S12500AI-OPEN-CMW910-SYSTEM-D5230P1099.bin                

System image version: 9.1.058, Demo 5230P1099                                  

  Compiled Dec 25 2024 16:00:00

 

其它显示信息略……

表1-5 display version命令显示信息描述表

字段	描述
H3C Comware Software, Version 9.1.058, Demo 5230P1099	表示设备使用的软件版本
Copyright (c) 2004-2024 New H3C Technologies Co., Ltd. All rights reserved.	表示设备的版权申明
H3C S12500AI-36DH20EP-NCPN uptime is 0 weeks, 0 days, 7 hours, 35 minutes	表示设备的型号以及本次启动后的持续运行时间
Last reboot reason	表示设备上次重启的原因，主要取值有： ·     User reboot：表示用户通过命令行、SNMP等方式重启设备 ·     Cold reboot：表示断电导致的重启 ·     Kernel abnormality reboot：表示内核异常导致的重启 ·     DeadLoop reboot：表示内核死循环导致的重启 ·     DEV HandShake reboot：表示设备管理握手失败导致的重启 ·     SlaveSwitch reboot：表示主备倒换导致的重启 ·     （暂不支持）IRF Merge reboot：表示IRF合并重启本设备 ·     Auto Update reboot：表示版本自动升级导致的重启 ·     Memory exhaust reboot：表示内存耗尽导致的重启 ·     Recover GOLD-detected error：GOLD检查失败重启 ·     Criticalprocess abnormality reboot：设备核心进程异常重启
Boot image: flash:/S12500AI-OPEN-CMW910-BOOT-D5230P1099.bin                     Boot image version: 9.1.058, Demo 5230P1099	表示设备当前运行过程中使用的Boot包以及该软件包的版本、编译时间

‌

1.1.18  display version-update-record

display version-update-record命令用来显示启动软件包版本更新操作的记录。

【命令】

display version-update-record

【视图】

任意视图

【缺省用户角色】

network-admin

network-operator

【使用指导】

设备启动时会记录当前使用的启动软件包版本信息，如果在运行过程中进行启动软件包版本更新操作，系统会记录该次更新的简要信息，包括升级时间和版本，以便管理员了解相关信息。设备重启这些记录也不会被删除。

【举例】

# 显示设备启动软件包版本更新操作的记录。

<Sysname> display version-update-record

Record 1  (updated on Jan 18 2020 at 06:23:54):

 *Name        : comware-cmw710-boot.bin

  Version     : 7.1.070 Test 0001

  Compile time: Jan 25 2020 15:52:43

 

 *Name        : comware-cmw710-system.bin

  Version     : 7.1.070 Test 0001

  Compile time: Jan 25 2020 15:52:43

表1-6 display version-update-record命令显示信息描述表

字段	描述
Record n (updated on Jan 18 2020 at 06:23:54)	最近的第n次更新的UTC时间，Record 1为最新的一次更新
*Name	软件包的名称。带*符号，表示软件包的版本和升级前的版本有变化；不带*符号，表示版本没有变化
Version	软件包的版本号
Compile time	版本编译时间

‌

【相关命令】

·     reset version-update-record

1.1.19  install abort

install abort命令用来取消正在执行中的激活或卸载操作。

【命令】

install abort [ job-id ]

【视图】

用户视图

【缺省用户角色】

network-admin

【参数】

job-id：任务ID。不指定该参数时，则取消正在执行中的所有激活和卸载操作。

【使用指导】

当用户执行install activate、install add、install commit、install deactivate、install remove或install rollback to命令时，系统会创建相应的任务。为了管理和监控这些任务，系统会给每个任务分配一个任务ID。一个任务ID代表一条命令。可以使用display install job命令来查看任务ID。

使用本命令取消正在进行的激活或卸载操作后，系统回退到操作前的状态。

【举例】

# 取消正在执行中的所有激活和卸载操作。

<Sysname> install abort

【相关命令】

display install job

1.1.20  install activate

install activate命令用来激活Feature包或补丁包。

【命令】

install activate feature filename&<1-30> slot slot-number [ test ]

install activate patch filename { all | slot slot-number }

【视图】

用户视图

【缺省用户角色】

network-admin

【参数】

feature：Feature包。

patch：补丁包。该参数一次只能指定一个补丁包，但是可以通过多次执行此命令为设备激活多个补丁包。

filename&<1-30>：软件包的名称，形如filesystemname/filename.bin。该文件必须保存在设备任一文件系统的根目录下，该参数中必须包含文件系统的名称，从存储介质名称开始最多可输入63个字符。&<1-30>表示前面的参数最多可以输入30次。有关指定文件夹和文件详细介绍请参见“基础配置指导”中的“文件系统管理”。

all：该参数暂无实际作用。

slot slot-number：为本设备在DDC中的成员编号。

test：查看指定软件包的升级策略。不带该参数时，表示直接执行升级操作。

【使用指导】

 

本命令可以指定一个或多个BIN包升级，但要求升级完成后的启动列表上的所有软件包版本一致。否则将出现如下情况：

·     当前启动列表无Patch包时，仅升级部分bin包，且升级包的版本号与另一部分bin包版本号不一致，升级失败。

·     当前启动列表有Patch包时，升级除patch包以外的bin包，且所有升级包版本号一致，升级成功但Patch包被卸载。

此时存在如下两种解决方法：

·     升级启动列表里的所有bin包。

¡     如果是IPE包内的BIN包未包含设备上运行的部分Feature包，那么需要先获取到这些部分Feature包与IPE包版本相同的升级包，通过install add命令将IPE包解压缩成BIN包后再指定启动列表里的所有BIN包一起升级。

¡     如果升级包已解决了上一版本的补丁问题，那么不需要升级Patch包。

确保Feature包上的功能在设备上处于关闭状态，再使用install deactivate命令卸载这些Feature包之后再升级启动列表上剩下的BIN包。

使用本命令激活设备上的软件包后，被激活的软件包只在本次运行的系统中生效。要使被激活的软件包在设备重启后继续生效，还需要执行install commit命令。激活补丁包时，若使用install activate patch filename all命令同时激活所有硬件上的补丁包，则无需执行install commit命令，所有补丁包在设备重启后继续生效。

【举例】

# 显示设备上的Feature包feature1.bin的升级策略。

<Sysname> install activate feature flash:/feature1.bin slot 1 test

Copying file flash:/feature1.bin to slot1#flash:/feature1.bin......Done.

Verifying the file flash:/feature1.bin on slot 1.....Done.

Upgrade summary according to following table:

 

flash:/feature1.bin

  Running Version             New Version

  Test 0001015                Test 0001016

 

  Slot                        Upgrade Way

  1                           Service Upgrade

 

Influenced service according to following table:

flash:/feature1.bin

     Feature1

以上显示信息表明，该软件将采用增量方式升级。并且升级过程中会重启功能模块Feature1。

# 激活设备上的Patch包patch1.bin。

<Sysname> install activate patch flash:/patch1.bin slot 1

Copying file flash:/patch1.bin to slot1#flash:/patch1.bin......Done.

Verifying the file flash:/patch1.bin on slot 1.....Done.

This operation might take several minutes, please wait...Done.

表1-7 install activate命令显示信息描述表

字段	描述
Copying file A to B......Done.	将文件从位置A拷贝到位置B。
Verifying the file flash:/xx.bin.....Done.	验证文件是否合法
Upgrade summary according to following table	升级摘要信息
Running Version	设备当前运行的相同类型软件包的产品版本号
New Version	目标软件包的产品版本号
Upgrade Way	兼容升级策略，取值可能为： ·     Service Upgrade：表示服务级增量升级 ·     File Upgrade：表示文件级增量升级 ·     Reboot：表示通过重启方式升级
Influenced service according to following table	将受影响的功能模块
Upgrading software images to compatible versions. Continue? [Y/N]	询问用户是否执行兼容升级操作
This operation might take several minutes, please wait	升级操作需要花费一定时间，请等待
Done.	表示激活成功
Operation failed.	表示激活失败
Install command does not support incompatible upgrade.	不能使用install命令来升级不兼容版本

 

【相关命令】

·     display install active

·     install commit

·     install deactivate

1.1.21  install add

install add命令用来解压缩IPE文件。

【命令】

install add ipe-filename filesystem

【视图】

用户视图

【缺省用户角色】

network-admin

【参数】

ipe-filename：IPE文件的名称，形如filesystemname/filename.ipe。该文件必须保存在设备任一文件系统的根目录下，该参数中必须包含文件系统的名称，从存储介质名称开始最多可输入63个字符。有关指定文件夹和文件详细介绍请参见“基础配置指导”中的“文件系统管理”。

filesystem：解压缩IPE文件保存的目的文件系统的名称。

【使用指导】

由于使用install命令激活的软件包只能是.bin软件包，所以在使用install命令激活软件包之前需要使用install add命令将IPE文件进行解压缩。

用户获取IPE文件后，可以使用display install ipe-info命令查看该IPE文件中包含了哪些软件包，可以通过install add命令将IPE文件解压生成软件包，再利用生成的软件包更新设备软件。

【举例】

# 解压缩all.ipe文件到存储介质flash上。

<Sysname> install add flash:/all.ipe flash:

Verifying the file flash:/all.ipe on slot 1...Done.

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

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

1.1.22  install commit

install commit命令用来确认软件包更改。

【命令】

install commit

【视图】

用户视图

【缺省用户角色】

network-admin

【使用指导】

该命令会将补丁包文件添加到系统当前使用的软件包列表：

·     如果系统使用了主用软件包启动，该命令会将补丁包文件添加到主用软件包列表中。

·     如果系统使用了备用软件包启动，该命令会将补丁包文件添加到备用软件包列表中。

只有在进行如下情况的配置修改设备当前的软件包列表时才需要执行本命令用来确认软件包更改：

·     执行install activate命令，且为增量升级方式时

·     执行install deactivate命令时

·     执行install rollback命令时

当执行install activate命令，且为重启升级方式时，因为用户在执行install activate命令时，系统已经修改了下次启动软件列表，所以，即便不再执行install commit命令，升级软件包也会在系统重启后继续生效。

boot-loader file命令和install commit命令都可以变更主用下次启动软件包列表，最新的配置生效。两条命令的不同之处在于，install commit命令自动使用当前激活的软件包列表作为主用下次启动软件包列表。而boot-loader file命令还可以指定其它当前未激活的软件包，可以配置为主用或者备用下次启动软件包列表。

【举例】

# 确认软件包更改。

<Sysname> install commit

This operation will take several minutes, please wait...........................Done.

The current software images have been saved as the startup software images.

Current software images on slot 1:

  flash:/boot.bin

  flash:/system.bin

【相关命令】

·     install activate

·     install deactivate

·     install rollback

1.1.23  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-number：为本设备在DDC中的成员编号。

【使用指导】

该命令只能对已经激活的软件包进行卸载操作。使用本命令卸载设备上的软件包后，卸载的软件包的特性功能在本次系统运行中失效。如果要使卸载的软件包在设备重启后继续失效，请执行install commit命令对卸载操作进行确认。卸载补丁包时，若使用install deactivate patch filename all命令同时卸载所有硬件上的补丁包，则无需执行install commit命令，所有补丁包在设备重启后继续失效。

【举例】

# 卸载设备上的patch包route-patch.bin。

<Sysname> install deactivate patch flash:/route-patch.bin slot 1

This operation might take several minutes, please wait...Done.

【相关命令】

·     display install active

·     display install inactive

1.1.24  install remove

install remove命令用来删除没有激活的软件包。

【命令】

install remove [ slot slot-number ] { filename | inactive }

【视图】

用户视图

【缺省用户角色】

network-admin

【参数】

filename：软件包的名称，形如filesystemname/filename.bin。该文件必须保存在设备任一文件系统的根目录下，该参数中必须且只能包含文件系统的名称，不能包含文件系统位置信息，从存储介质名称开始最多可输入63个字符。有关指定文件夹和文件详细介绍请参见“基础配置指导”中的“文件系统管理”。

slot slot-number：为本设备在DDC中的成员编号。如果不指定本参数，则默认为本设备的成员编号。

inactive：表示将删除指定文件系统根目录下、没有被激活的所有软件包。

【使用指导】

执行该命令后，指定的软件包将从设备上被彻底删除，用户将不能使用该软件包进行回滚或回退操作。

【举例】

# 删除软件包flash:/feature1.bin。

<Sysname> install remove flash:/feature1.bin

1.1.25  install rollback to

install rollback to命令用来回滚到指定的回滚点，即按回滚点上记录的信息，进行回滚操作。

【命令】

install rollback to { point-id | original }

【视图】

用户视图

【缺省用户角色】

network-admin

【参数】

point-id：回滚点的编号，当系统中至少存在两个回滚点的时候，才能输入该参数。可以用display install rollback命令查看系统中存在的回滚点。

original：回滚到升级初始状态。

【使用指导】

每次激活或者卸载软件包之后，系统将这些变化记录为回滚点。通过回滚功能，可将系统回滚到某个历史状态，或者恢复到升级初始状态。

当升级方式为增量升级时，软件包回滚只在设备本次运行过程中生效，用户只有通过install commit命令确认软件包的更改后，才能使此次的回滚操作在系统重启后生效。系统最多支持50个回滚点，当回滚点超过最大值时，旧的回滚点会被删除，新的回滚点会被保存。

当升级方式为重启升级时，系统不会保留任何回滚点，只支持回滚到系统升级初始状态。

补丁包不支持回滚操作。

【举例】

# 回滚到回滚点1。

<Sysname> install rollback to 1

This operation might take several minutes, please wait...Done.

# 回滚到升级的初始状态。可通过观察active列表和回滚点的变化看出执行的结果。

<Sysname> display install active

Active packages on slot 1:

  flash:/boot-t0001015.bin

  flash:/system-t0001015.bin

  flash:/feature1-t0001015.bin

<Sysname> display install rollback

Install rollback information 1 on slot 1:

  Updating from no package

         to flash:/feature1-t0001015.bin.

以上显示信息表明，当前激活的包有三个，但是确认的只有两个，回滚点1是激活了flash:/feature1-t0001015.bin。

<Sysname> install rollback to original

This operation might take several minutes, please wait...Done.

<Sysname> display install active

Active packages on slot 1:

  flash:/boot-t0001015.bin

  flash:/system-t0001015.bin

<Sysname> display install committed

Committed packages on slot 1:

  flash:/boot-t0001015.bin

  flash:/system-t0001015.bin

执行install rollback to original命令后，设备运行的软件集恢复到升级初始状态，flash:/feature1-t0001015.bin被卸载。

【相关命令】

display install rollback

1.1.26  install verify

install verify命令用来执行对软件包状态、完整性和一致性的检验。

【命令】

install verify

【视图】

用户视图

【缺省用户角色】

network-admin

【使用指导】

为了保证设备进行升级之后能够正常运行，需要执行本命令对软件包进行如下检验：

完整性：检验Boot包、System包和Feature包的完整性。

一致性：检验系统内各激活的软件包列表的差异，以方便用户知道系统内各软件包版本是否一致。

软件包状态：检查各设备上激活的软件包列表和确认的软件包列表之间的差异，以方便用户知道是否有未确认的软件包。

使用该命令，能帮助用户进行软件包检查：

·     当系统提示软件包不完整时，请重新下载并安装软件包。

·     当系统提示软件包不一致时，请使用install activate、install deactivate以及install commit命令来确保它们的一致。

【举例】

# 检验设备上软件包状态、完整性和一致性信息。

<Sysname> install verify

Active packages on slot 1 are the reference packages.

Packages will be compared with the reference packages.

This operation will take several minutes, please wait...

  Verifying packages on slot 1:

  Start to check active package completeness.

Verifying the file flash:/boot-t0001015.bin on slot 1.....................Done.

    flash:/boot-t0001015.bin verification successful.

Verifying the file flash:/system-t0001015.bin on slot 1.....................Done.

    flash:/system-t0001015.bin verification successful.

  Start to check active package consistency.

    Active packages are consistent with committed packages on their own board.

    Active packages are consistent with the reference packages.

  Verifying packages on slot 2:

  Start to check active package completeness.

Verifying the file flash:/boot-t0001015.bin on slot 2.....................Done.

    flash:/boot-t0001015.bin verification successful.

Verifying the file flash:/system-t0001015.bin on slot 2.....................Done.

    flash:/system-t0001015.bin verification successful.

  Start to check active package consistency.

    Active packages are consistent with committed packages on their own board.

    Active packages are consistent with the reference packages.

Verification is done.

1.1.27  reset version-update-record

reset version-update-record命令用来清除启动软件包版本更新操作的记录。

【命令】

reset version-update-record

【视图】

系统视图

【缺省用户角色】

network-admin

【举例】

# 清除设备启动软件包版本更新操作的记录。

<Sysname> system-view

[Sysname] reset version-update-record

This command will delete all records of version update. Continue? [Y/N]:y

【相关命令】

·     display version-update-record