目  录

1 软件升级

1.1 软件升级配置命令

1.1.1 boot-loader blade force-load-mpu

1.1.2 boot-loader file

1.1.3 boot-loader update

1.1.4 bootrom backup

1.1.5 bootrom read

1.1.6 bootrom restore

1.1.7 bootrom update

1.1.8 bootrom-update security-check enable

1.1.9 display boot-loader

1.1.10 firmware update

1.1.11 install activate

1.1.12 install add

1.1.13 install commit

1.1.14 install deactivate

1.1.15 install remove

1.1.16 install verify

 

1 软件升级

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

1.1  软件升级配置命令

1.1.1  boot-loader blade force-load-mpu

boot-loader blade force-load-mpu命令用来设置安全引擎下次启动时强制从主控板加载软件版本。

undo boot-loader blade force-load-mpu命令取消安全引擎下次启动时强制从主控板加载软件版本。

【命令】

boot-loader blade force-load-mpu

undo boot-loader blade force-load-mpu

【视图】

用户视图

【缺省用户角色】

network-admin

【使用指导】

本命令仅对下次启动生效，启动完成后如需继续强制从主控板加载软件版本，请重新配置本命令。

主备倒换后，需要重新配置本命令才能生效。

【举例】

# 设置安全引擎下次启动时强制从主控板加载软件版本。

<Sysname> boot-loader blade force-load-mpu

1.1.2  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 [ cpu cpu-number ] } { backup | main }

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

【视图】

用户视图

【缺省用户角色】

network-admin

【参数】

boot：Boot包。

system：System包。

feature：Feature包。

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

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

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

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

slot slot-number：表示待升级的成员设备的编号。对于本产品，slot-number只能为固定取值，无论是否指定本参数，均表示整台设备。‌‌

cpu cpu-number：表示待升级的安全引擎的CPU编号。本参数专用于升级安全插卡上的安全引擎，其它单板以及安全插卡上其它CPU升级时，不需要指定该参数。

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.

H3C SecPath L1000-E images in IPE:

  boot.bin

  system.bin

This command will set the main startup software images. Please do not reboot any MPU during the upgrad. 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.

# 配置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 SecPath L1000-E images in IPE:

  Boot.bin

  System.bin

This command will set the main startup software images. Please do not reboot any MPU during the upgrad. 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.

Decompression completed.

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

【相关命令】

·     display boot-loader

1.1.3  boot-loader update

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

【命令】

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

【视图】

用户视图

【缺省用户角色】

network-admin

【参数】

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

slot slot-number：表示待升级的成员设备的编号。对于本产品，slot-number只能为固定取值，无论是否指定本参数，均表示整台设备。‌

【使用指导】

配置前提

应用场景

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

工作机制

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

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

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

注意事项

【举例】

# 同步指定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

1.1.4  bootrom backup

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

【命令】

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

本命令的支持情况与设备型号有关，请以设备的实际情况为准。

系列	型号	说明
M9000-AD系列	M9000-AD10	不支持
L5000-AD系列	L5000-AD820、L5000-AD830、L5000-AD820-G、L5000-AD560-G、L5000-AD520-G、L5000-AD540-G、L5000-AD150-G、L5000-AD170-G、L5000-AD190-G、L5000-AD540-G1、L5000-AD520-G1、L5000-AD190-G1、L5000-AD170-G1、L5000-AD150-G1、L5000-AD130-G1	不支持
L5000系列	L5060-G、L5000-CN530、L5030、L5060、L5080、L5000-E、L5000-AK535	支持
L1000系列	L1030、L1050、L1070、L1090、L1000-AK390、L1000-AK315、L1000-AK325	支持

 

【视图】

用户视图

【缺省用户角色】

network-admin

【参数】

slot slot-number-list：成员编号列表，表示同时备份多个成员设备的BootWare程序。表示方式为slot-number-list = { slot-number [ to slot-number ] }&<1-7>。其中，slot-number表示需要备份的设备在IRF中的成员编号。对于本产品，slot-number只能为固定取值，表示整台设备。‌‌

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

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

cpu cpu-number：备份指定CPU的BootWare程序。cpu-number表示CPU的编号。只有指定的slot支持多CPU时，才能配置该参数。

【使用指导】

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.5  bootrom read

bootrom read命令用来将BootWare程序从BootWare的Normal区读取到缺省文件系统中。

【命令】

bootrom read slot slot-number-list [ cpu cpu-number ] [ all | part ]

本命令的支持情况与设备型号有关，请以设备的实际情况为准。

系列	型号	说明
M9000-AD系列	M9000-AD10	不支持
L5000-AD系列	L5000-AD820、L5000-AD830、L5000-AD820-G、L5000-AD560-G、L5000-AD520-G、L5000-AD540-G、L5000-AD150-G、L5000-AD170-G、L5000-AD190-G、L5000-AD540-G1、L5000-AD520-G1、L5000-AD190-G1、L5000-AD170-G1、L5000-AD150-G1、L5000-AD130-G1	不支持
L5000系列	L5060-G、L5000-CN530、L5030、L5060、L5080、L5000-E、L5000-AK535	支持
L1000系列	L1030、L1050、L1070、L1090、L1000-AK390、L1000-AK315、L1000-AK325	支持

 

【视图】

用户视图

【缺省用户角色】

network-admin

【参数】

slot slot-number-list：成员编号列表，表示同时读取多个成员设备的BootWare程序。表示方式为slot-number-list = { slot-number [ to slot-number ] }&<1-7>。其中，slot-number表示需要读取的设备在IRF中的成员编号。对于本产品，slot-number只能为固定取值，无论是否指定本参数，均表示整台设备。‌‌

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

part：只操作BootWare程序的扩展段。不指定all和part参数时，默认使用all。

cpu cpu-number：读取指定CPU的BootWare程序。cpu-number表示CPU的编号。只有指定的slot支持多CPU时，才能配置该参数。

【使用指导】

成功执行本命令后，系统会自动生成basicbtm.bin和extendbtm.bin文件并保存到缺省文件系统中。其中，basicbtm.bin存储了BootWare程序的基本段，extendbtm.bin存储了BootWare程序的扩展段。

【举例】

# 读取BootWare程序。

<Sysname> bootrom read slot 1

  Now reading the Boot ROM, please wait...

.........Done.

【相关命令】

·     bootrom update

1.1.6  bootrom restore

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

【命令】

bootrom restore slot slot-number-list [ cpu cpu-number ] [ all | part ]

本命令的支持情况与设备型号有关，请以设备的实际情况为准。

系列	型号	说明
M9000-AD系列	M9000-AD10	不支持
L5000-AD系列	L5000-AD820、L5000-AD830、L5000-AD820-G、L5000-AD560-G、L5000-AD520-G、L5000-AD540-G、L5000-AD150-G、L5000-AD170-G、L5000-AD190-G、L5000-AD540-G1、L5000-AD520-G1、L5000-AD190-G1、L5000-AD170-G1、L5000-AD150-G1、L5000-AD130-G1	不支持
L5000系列	L5060-G、L5000-CN530、L5030、L5060、L5080、L5000-E、L5000-AK535	支持
L1000系列	L1030、L1050、L1070、L1090、L1000-AK390、L1000-AK315、L1000-AK325	支持

 

【视图】

用户视图

【缺省用户角色】

network-admin

【参数】

slot slot-number-list：成员编号列表，表示同时恢复多个成员设备的BootWare程序。表示方式为slot-number-list = { slot-number [ to slot-number ] }&<1-7>。其中，slot-number表示需要恢复的设备在IRF中的成员编号。对于本产品，slot-number只能为固定取值，表示整台设备。‌‌

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

part：只操作BootWare程序的扩展段。不指定all和part参数时，默认使用all。

cpu cpu-number：恢复指定CPU的BootWare程序。cpu-number表示CPU的编号。只有指定的slot支持多CPU时，才能配置该参数。

【举例】

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

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

【命令】

bootrom update file file slot slot-number-list [ cpu cpu-number ] [ all | part ]

本命令的支持情况与设备型号有关，请以设备的实际情况为准。

系列	型号	说明
M9000-AD系列	M9000-AD10	不支持
L5000-AD系列	L5000-AD820、L5000-AD830、L5000-AD820-G、L5000-AD560-G、L5000-AD520-G、L5000-AD540-G、L5000-AD150-G、L5000-AD170-G、L5000-AD190-G、L5000-AD540-G1、L5000-AD520-G1、L5000-AD190-G1、L5000-AD170-G1、L5000-AD150-G1、L5000-AD130-G1	不支持
L5000系列	L5060-G、L5000-CN530、L5030、L5060、L5080、L5000-E、L5000-AK535	支持
L1000系列	L1030、L1050、L1070、L1090、L1000-AK390、L1000-AK315、L1000-AK325	支持

 

【视图】

用户视图

【缺省用户角色】

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表示需要升级的设备在IRF中的成员编号。对于本产品，slot-number只能为固定取值，表示整台设备。‌‌

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

part：只操作BootWare程序的扩展段。不指定all和part参数时，默认使用all。

cpu cpu-number：更新指定CPU的BootWare程序。cpu-number表示CPU的编号。只有指定的slot支持多CPU时，才能配置该参数。

【使用指导】

应用场景

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

工作机制

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

注意事项

系统将文件系统中的BootWare程序加载到BootWare的Normal区前会对文件系统中包含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.8  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

本命令的支持情况与设备型号有关，请以设备的实际情况为准。

系列	型号	说明
M9000-AD系列	M9000-AD10	不支持
L5000-AD系列	L5000-AD820、L5000-AD830、L5000-AD820-G、L5000-AD560-G、L5000-AD520-G、L5000-AD540-G、L5000-AD150-G、L5000-AD170-G、L5000-AD190-G、L5000-AD540-G1、L5000-AD520-G1、L5000-AD190-G1、L5000-AD170-G1、L5000-AD150-G1、L5000-AD130-G1	不支持
L5000系列	L5060-G、L5000-CN530、L5030、L5060、L5080、L5000-E、L5000-AK535	支持
L1000系列	L1030、L1050、L1070、L1090、L1000-AK390、L1000-AK315、L1000-AK325	支持

 

【缺省情况】

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

【视图】

系统视图

【缺省用户角色】

network-admin

【使用指导】

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

【举例】

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

<Sysname> system-view

[Sysname] bootrom-update security-check enable

1.1.9  display boot-loader

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

【命令】

display boot-loader [ slot slot-number [ cpu cpu-number ] ]

【视图】

任意视图

【缺省用户角色】

network-admin

network-operator

【参数】

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

cpu cpu-number：表示安全引擎的CPU编号。本参数专用于显示安全引擎本次启动和下次启动所采用的启动软件包的名称。

【举例】

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

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

字段	描述
Software images	启动软件包的相关信息
Current software images	最近一次启动使用的启动软件包列表
Main startup software images	主用下次启动软件包列表
Backup startup software images	备用下次启动软件包列表 显示为None时，表示未指定备用下次启动软件包

 

【相关命令】

·     boot-loader file

 

1.1.10  firmware update

firmware update命令用来升级CPLD、FPGA等固件。

【命令】

firmware update slot slot-number [ subslot subslot-number ] { cpld cpld-number | cpu cpu-number | fpga fpga-number | module module-number } file filename

【视图】

用户视图

【缺省用户角色】

network-admin

【参数】

slot slot-number：指定IRF成员设备，slot-number表示设备在IRF中的成员编号。对于本产品，slot-number只能为固定取值，表示整台设备。‌‌

subslot subslot-number：子卡所在的子槽位号。不指定该参数时，表示单板上的所有子卡。

cpld cpld-number：表示需要升级CPLD（Complex Programmable Logical Device 复杂可编程逻辑器件），cpld-number表示固件的编号。

fpga fpga-number：表示需要升级FPGA（Field Programmable Gate Array 现场可编程门阵列），fpga-number表示固件的编号。

cpu cpu-number：表示需要升级CPU，cpu-number表示CPU的编号。

module module-number：表示需要升级指定模块，module-number表示模块的编号。

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

【使用指导】

固件升级后需要对其所在的板卡/设备进行下电后重新上电才能生效。请根据实际支持情况，选择下电方式：

·     切断外部电源

·     插拔板卡

【举例】

# 升级指定slot的1号CPLD。‌‌

<Sysname> firmware update slot 1 cpld 1 file package.bin

Updating firmware for CPLD on the specified card or subcard. Continue?[Y/N]:y

Updating the firmware…

Please power cycle the card or subcard to activate the firmware.

 

1.1.11  install activate

install activate命令用来激活软件包。

【命令】

‌

install activate { boot filename | system filename | feature filename&<1-30> } * slot slot-number

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

‌

install activate { boot filename | system filename | feature filename&<1-30> } * chassis chassis-number slot slot-number

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

【视图】

用户视图

【缺省用户角色】

network-admin

【参数】

boot：Boot包。

system：System包。

feature：Feature包。

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

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

all：升级补丁包对应的所有单板。‌

all：升级补丁包对应的所有单板。‌

slot slot-number：表示单板所在的槽位号。‌

chassis chassis-number slot slot-number：chassis-number表示设备在IRF中的成员编号，slot-number表示单板所在的槽位号。‌

【使用指导】

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

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

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

对于安全引擎，执行命令行时，如果filename不是存放在待升级安全引擎上的文件，则系统会先将该文件拷贝到待升级安全引擎上，再执行升级动作。

如果指定的slot参数为主用主控板所在的槽位号，则执行该命令，会同时升级主用主控板和业务板；如果指定的slot参数为备用主控板所在的槽位号，则执行该命令，只会升级备用主控板。‌

如果指定的chassis chassis-number slot slot-number参数为全局主用主控板所在的槽位号，则执行该命令，会同时升级该主控板和所有业务板。如果指定的chassis chassis-number slot slot-number参数为全局备用主控板所在的槽位号，则执行该命令，只会升级该主控板。‌

从设备重启后，会自动批量备份主设备的配置和状态数据。请使用display system stable state命令查看设备是否处于稳定状态。只有System State处于Stable状态，才能执行该命令。否则，命令执行失败。关于display system stable state命令的详细介绍请参见“基础配置命令参考”中的“设备管理”。‌

【举例】

# 激活备用主控板1上的System包system.bin和Feature包feature1.bin。‌

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

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

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

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

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

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

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

Upgrade summary according to following table:

 

flash:/system.bin

  Running Version             New Version

  Test 0001015                Test 0001016

 

flash:/feature1.bin

  Running Version             New Version

  None                        Test 0001016

 

  Slot                        Upgrade Way

  1                           Service Upgrade

Upgrading software images to compatible versions. Continue? [Y/N]:y

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

表1-2 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.12  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.13  install commit

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

【命令】

install commit

【视图】

用户视图

【缺省用户角色】

network-admin

【使用指导】

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

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

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

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

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

·     install rollback

1.1.14  install deactivate

install deactivate命令用来卸载Feature包或补丁包。

【命令】

‌

install deactivate feature filename&<1-30> slot slot-number

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

‌

install deactivate feature filename&<1-30> chassis chassis-number slot slot-number

install deactivate patch filename { all | chassis chassis-number slot slot-number }

【视图】

用户视图

【缺省用户角色】

network-admin

【参数】

feature：Feature包。

patch：补丁包。该参数一次只能指定一个补丁包，若要卸载多个补丁包，则需要多次执行此命令。

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

all：表示安装了该补丁包的所有单板。‌

all：表示安装了该补丁包的所有单板。‌

slot slot-number：表示单板所在的槽位号。‌

chassis chassis-number slot slot-number：chassis-number表示设备在IRF中的成员编号，slot-number表示单板所在的槽位号。‌

【使用指导】

从设备重启后，会自动批量备份主设备的配置和状态数据。请使用display system stable state命令查看设备是否处于稳定状态。只有System State处于Stable状态，才能执行该命令。否则，命令执行失败。关于display system stable state命令的详细介绍请参见“基础配置命令参考”中的“设备管理”。

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

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

【相关命令】

·     display install active

·     display install inactive

1.1.15  install remove

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

【命令】

‌

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

‌

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

【视图】

用户视图

【缺省用户角色】

network-admin

【参数】

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

slot slot-number：表示单板所在的槽位号。不指定该参数时，表示设备上的所有单板。‌

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

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

【使用指导】

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

【举例】

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

<Sysname> install remove flash:/feature1.bin

1.1.16  install verify

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

【命令】

install verify

【视图】

用户视图

【缺省用户角色】

network-admin

【使用指导】

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

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

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

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

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

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

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

【举例】

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

<Sysname> install verify

Active packages on the device are the reference packages.

Packages will be compared with the reference packages.

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

  Verifying packages on the device:

  Start to check active package completeness.

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

   flash:/boot-t0001015.bin verification successful.

Verifying the file flash:/system-t0001015.bin on the device............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.

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

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

  Start to check active package completeness.

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

    flash:/boot-t0001015.bin verification successful.

Verifying the file flash:/system-t0001015.bin on slot 0.....................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 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.

Verification is done.

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

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