目  录

1 软件升级

1.1 软件升级配置命令

1.1.1 boot-loader file

1.1.2 bootrom backup

1.1.3 bootrom restore

1.1.4 bootrom update

1.1.5 bootrom-update security-check enable

1.1.6 display boot-loader

1.1.7 display install active

1.1.8 display install committed

1.1.9 install activate

1.1.10 install commit

1.1.11 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 }

【视图】

用户视图

【缺省用户角色】

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：指定该软件包为主用启动软件包。主用启动软件包用于引导设备启动。

【使用指导】

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

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

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

【举例】

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

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

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

XX images in IPE:

  boot.bin

  system.bin

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

File flash:/feature.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.

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

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

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

Verifying the file flash:/feature.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

1.1.2  bootrom backup

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

【命令】

bootrom backup slot slot-number-list

【视图】

用户视图

【缺省用户角色】

network-admin

【参数】

slot slot-number-list：取值只能为1。

【使用指导】

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.3  bootrom restore

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

【命令】

bootrom restore slot slot-number-list

【视图】

用户视图

【缺省用户角色】

network-admin

【参数】

slot slot-number-list：取值只能为1。

【举例】

# 恢复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.4  bootrom update

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：取值只能为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

1.1.5  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.6  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

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

【相关命令】

·     boot-loader file

1.1.7  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: S6890

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

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

 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命令显示信息描述表

【相关命令】

·     install active

1.1.8  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: S6890

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

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

 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

·     install commit

1.1.9  install activate

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次。有关指定文件夹和文件详细介绍请参见“基础配置指导”中的“文件系统管理”。

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

all：激活设备的补丁包。

【使用指导】

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

【举例】

# 激活设备上的补丁包system-patch.bin。

<Sysname> install activate system-patch.bin slot 1

【相关命令】

·     display install active

·     install commit

·     install deactivate

1.1.10  install commit

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

1.1.11  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命令对卸载操作进行确认。卸载补丁包时，若使用install deactivate patch filename all命令同时卸载补丁包，则无需执行install commit命令，所有补丁包在设备重启后继续失效。

【举例】

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

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

【相关命令】

·     display install active