目  录

1 软件升级

1.1 软件升级配置命令

1.1.1 boot-loader file

1.1.2 boot-loader update

1.1.3 display boot-loader

1.1.4 display install active

1.1.5 display install committed

1.1.6 install activate

1.1.7 install commit

1.1.8 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-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包。该参数只能指定非叠加补丁。由于每个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：表示待升级的成员设备的编号。

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

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

【使用指导】

应用场景

当前软件不能满足现网运行或用户业务需求时，可以使用本命令进行软件升级，实现设备性能优化，以满足用户的业务需求。

配置前提

请先查看软件包版本发布说明书，如果软件包需要License才能运行，且设备当前没有对应的有效的License时，需安装对应的License，再执行该命令。否则：

·     当使用软件包配置该命令时，只要指定某个的软件包当前没有有效的License，就会导致整条命令配置失败。

·     当使用IPE文件配置该命令时，只有当前没有有效的License的软件包配置失败，其它软件包会配置成功。

工作机制

成功执行该命令后，系统会用命令中指定的软件包替换现有的软件包列表。如果命令行中没有指定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.

H3C S5135S-24P4S-EI 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 digital signature of the file flash:/boot.bin on slot 1...Done.

Verifying digital signature of 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.

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

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

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

H3C S5135S-24P4S-EI 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：表示待升级的成员设备的编号。

【使用指导】

配置前提

请先查看软件包版本发布说明书，如果软件包需要License才能运行，且设备当前没有对应的有效的License时，需安装对应的License，再执行该命令。否则，会导致命令执行失败。

应用场景

对于新增的IRF成员设备，可以使用本命令同步启动软件包。

工作机制

通过该命令指定从设备的下次启动软件包时，系统会进行如下处理：

·     如果主设备当前是使用主用启动软件包列表启动的，则将其主用下次启动软件包列表中的软件包拷贝到从设备的对应目录下，并设置为从设备的主用下次启动软件包。如果这些软件包中有任一软件包不存在或者不可用，则命令执行失败。

·     如果主设备当前是使用备用启动软件包列表启动的，则将其备用下次启动软件包列表中的软件包拷贝到从设备的对应目录下，并设置为从设备的主用下次启动软件包。如果这些软件包中有任一软件包不存在或者不可用，则命令执行失败。

注意事项

如果主设备刚安装了补丁，在执行本命令前，请执行install commit命令刷新主设备的下次启动软件包列表。否则，可能导致从设备升级后与主设备的版本不一致。

【举例】

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

<Sysname> boot-loader update slot 2

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

Updating. Please wait...

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

Verifying digital signature of 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

1.1.3  display boot-loader

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

【命令】

display boot-loader [ slot slot-number ]

【视图】

任意视图

【缺省用户角色】

network-admin

network-operator

【参数】

slot slot-number：表示成员设备的编号。不指定该参数时，表示IRF中的所有成员设备。

【举例】

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

<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

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

【相关命令】

·     boot-loader file

1.1.4  display install active

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

【命令】

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

【视图】

任意视图

【缺省用户角色】

network-admin

network-operator

【参数】

slot slot-number：表示设备在IRF中的成员编号。不指定该参数时，表示IRF中的所有成员设备。

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

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

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

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

【相关命令】

·     install active

1.1.5  display install committed

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

【命令】

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

【视图】

任意视图

【缺省用户角色】

network-admin

network-operator

【参数】

slot slot-number：表示设备在IRF中的成员编号。不指定该参数时，表示IRF中的所有成员设备。

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:/ssh-feature.bin

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

<Sysname> display install committed verbose

Committed packages on slot 1:

 flash:/boot-t5101.bin

 [Package]

 Vendor: H3C

 Product: S5135S

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

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

 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

1.1.6  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：补丁包。该参数一次只能指定一个补丁包，但是可以通过多次执行此命令为设备激活多个补丁包。

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

slot slot-number：表示设备在IRF中的成员编号。

all：升级补丁包对应的所有成员设备。

【使用指导】

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

执行该命令时，如果filename不是存放在待升级成员设备上的文件，则系统会先将该文件拷贝到待升级成员设备上，再执行升级动作。

【举例】

# 升级设备1上的补丁包system-patch.bin。

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

【相关命令】

·     display install active

·     install commit

·     install deactivate

1.1.7  install commit

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

【命令】

install commit

【视图】

用户视图

【缺省用户角色】

network-admin

【使用指导】

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

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

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

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

有关主用/备用软件包的详细介绍请参见“基础配置指导”中的“软件升级”。

【举例】

# 确认软件包更改。

<Sysname> install commit

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

【相关命令】

·     install activate

·     install deactivate

1.1.8  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：表示设备在IRF中的成员编号。

【使用指导】

该命令只能对已经激活的软件包进行卸载操作。使用本命令卸载指定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