目  录

1 软件升级

1.1 软件升级配置命令

1.1.1 boot-loader file

1.1.2 display boot-loader

1.1.3 display install active

1.1.4 display install committed

1.1.5 display install inactive

1.1.6 display version

1.1.7 display version-update-record

1.1.8 install activate

1.1.9 install commit

1.1.10 install deactivate

 

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：指定设备编号，取值只能为1。

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

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

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

【使用指导】

 

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

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

【举例】

# 配置指定slot下次启动时所用的主用启动文件为flash:/all.ipe。

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

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

H3C S6880-48Y8C 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.

# 配置指定slot下次启动时所用的主用启动文件为flash:/all.ipe，且不解压IPE包。

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

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 image. Continue? [Y/N]:Y

File flash:/all.ipe already exists on slot 1.

Overwrite the existing files? [Y/N]:Y

Copying file flash:/all.ipe to slot1#flash:/all.ipe...Done.

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

【相关命令】

·     display boot-loader

1.1.2  display boot-loader

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

【命令】

display boot-loader [ slot slot-number ]

【视图】

任意视图

【缺省用户角色】

network-admin

network-operator

【参数】

slot slot-number：指定设备编号，取值只能为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

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

<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.3  display install active

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

【命令】

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

【视图】

任意视图

【缺省用户角色】

network-admin

network-operator

【参数】

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

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: S6880

 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: S6880

 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: S6880

 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.4  display install committed

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

【命令】

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

【视图】

任意视图

【缺省用户角色】

network-admin

network-operator

【参数】

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

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: S6880

 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: S6880

 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: S6880

 Service name: feature1

 Platform version: 7.1.070

 Product version: Test 0001015

 Supported board: mpu

 [Component]

 Component: feature1

 Description: feature1 package

本命令显示信息的描述请参见表1-2。

【相关命令】

·     boot-loader file

·     display install backup

·     install commit

1.1.5  display install inactive

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

【命令】

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

【视图】

任意视图

【缺省用户角色】

network-admin

network-operator

【参数】

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

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: S6880

 Service name: feature1

 Platform version: 7.1.070

 Product version: Test 0001015

 Supported board: mpu

 [Component]

 Component: feature1

 Description: feature1 package

本命令显示信息的描述请参见表1-2。

【相关命令】

install deactivate

1.1.6  display version

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

【命令】

display version

【视图】

任意视图

【缺省用户角色】

network-admin

network-operator

【举例】

# 查看系统版本信息。

<Sysname> display version

H3C Comware Software, Version 9.1.043, ESS 1111

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

H3C S6880-48Y8C uptime is 0 weeks, 0 days, 0 hours, 5 minutes                                                                      

Last reboot reason : User reboot

 

Boot image: flash:/s6880-cmw910-boot-e1111.bin                                                                                     

Boot image version: 9.1.043, ESS 1111                                                                                               

  Compiled May 18 2022 14:00:00                                                                                                    

System image: flash:/s6880-cmw910-system-e1111.bin                                                                                  

System image version: 9.1.043, ESS 1111                                                                                            

  Compiled May 18 2022 14:00:00

 

其它显示信息略……

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

字段	描述
H3C Comware Software, Version 9.1.043, ESS 1111	表示设备使用的软件版本
Copyright (c) 2004-2022 New H3C Technologies Co., Ltd. All rights reserved	表示设备的版权申明
H3C S6880-48Y8C uptime is 0 weeks, 0 days, 0 hours, 5 minutes	表示设备的型号以及本次启动后的持续运行时间
Last reboot reason	表示设备上次重启的原因，主要取值有： ·     User reboot：表示用户通过命令行、SNMP等方式重启设备 ·     Cold reboot：表示断电导致的重启 ·     Kernel abnormality reboot：表示内核异常导致的重启 ·     DeadLoop reboot：表示内核死循环导致的重启 ·     DEV HandShake reboot：表示设备管理握手失败导致的重启 ·     Auto Update reboot：表示版本自动升级导致的重启 ·     Memory exhaust reboot：表示内存耗尽导致的重启 ·     Recover GOLD-detected error：GOLD检查失败重启 ·     Criticalprocess abnormality reboot：设备核心进程异常重启
Boot image: flash:/s6880-cmw910-boot-e1111.bin Boot image version: 9.1.043, ESS 1111                                                                                                 Compiled May 18 2022 14:00:00	表示设备当前运行过程中使用的Boot包以及该软件包的版本、编译时间

‌

1.1.7  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-4 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.8  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：指定设备编号，取值只能为1。

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命令。

【举例】

# 显示设备上的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-5 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.9  install commit

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

【命令】

install commit

【视图】

用户视图

【缺省用户角色】

network-admin

【使用指导】

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

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

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

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

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

·     执行install deactivate命令时

当执行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

1.1.10  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：指定设备编号，取值只能为1。

【使用指导】

该命令只能对已经激活的软件包进行卸载操作。使用本命令卸载设备上的软件包后，卸载的软件包的特性功能在本次系统运行中失效。如果要使卸载的软件包在设备重启后继续失效，请执行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