01-基础配置命令参考

08-ISSU命令

1 ISSU

1.1 ISSU配置命令

1.1.1 display install active

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

【命令】

独立运行模式：

display install active [ verbose ]

IRF模式：

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

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

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

【举例】

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

<Sysname> display install active

Active packages on the device:

flash:/boot.bin

flash:/system.bin

flash:/feature.bin

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

<Sysname> display install active verbose

Active packages on the device:

flash:/boot.bin

[Package]

Vendor: XXX

Product: xxxx

Service name: boot

Platform version: 7.1.022

Product version: Test 2201

Supported board: xxx

[Component]

Component: boot

Description: boot package

flash:/system.bin

[Package]

Vendor: XXX

Product: xxxx

Service name: system

Platform version: 7.1.022

Product version: Test 2201

Supported board: xxx

[Component]

Component: system

Description: system package

flash:/feature.bin

[Package]

Vendor: XXX

Product: xxxx

Service name: test

Platform version: 7.1.022

Product version: Test 2201

Supported board: xxx

[Component]

Component: test

Description: test package

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

字段	描述
Active packages	处于激活状态的软件包的相关信息
flash:/boot.bin	软件包的名称
[Package]	软件包的信息
Vendor	生产厂商
Product	产品名称
Service name	软件包所包含的服务名称： · 如果显示为boot，表示该软件包为Boot包 · 如果显示为system，表示该软件包为System包 · 如果显示为patch，表示该软件包为补丁包 · 如果显示为其它值，则表示该软件包为提供某项功能的Feature包
Platform version	平台软件版本号
Product version	产品软件版本号
Supported board	软件包支持的设备类型
[Component]	组件信息，表示软件包的组成部分
Component	组件的名称
Description	组件的描述信息

【相关命令】

· install active

1.1.2 display install backup

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

【命令】

独立运行模式：

display install backup [ verbose ]

IRF模式：

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

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

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

【使用指导】

设备下次启动时使用的软件包的名称会记录在启动软件包列表中，启动软件包列表分为主用启动软件包列表和备用启动软件包列表，可以分别配置。

· 当设备启动时，优先使用主用启动软件包列表中的软件包。

· 如果主用启动软件包列表中的Boot包或System包不存在或者损坏，再使用备用启动软件包列表中的软件包。

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

【举例】

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

<Sysname> display install backup

Backup startup software images on the device:

flash:/boot-a0201.bin

flash:/system-a0201.bin

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

<Sysname> display install backup verbose

Backup startup software images on the device:

flash:/boot-a0201.bin

[Package]

Vendor: XXX

Product: xxxx

Service name: boot

Platform version: 7.1

Product version: Beta 1330

Supported board: xxx

[Component]

Component: boot

Description: boot package

flash:/system-a0201.bin

[Package]

Vendor: XXX

Product: xxxx

Service name: system

Platform version: 7.1

Product version: Beta 1330

Supported board: xxx

[Component]

Component: system

Description: system package

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

【相关命令】

· boot-loader file（基础配置命令参考/软件升级）

· display install committed

1.1.3 display install committed

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

【命令】

独立运行模式：

display install committed [ verbose ]

IRF模式：

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

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

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

【使用指导】

在设备上执行install commit命令确认运行当前的软件包后，这些软件包会被列入主用下次启动软件包，以便设备重启后，这些软件包能够继续生效。

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

【举例】

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

<Sysname> display install committed

Committed packages on the device:

flash:/boot-a0201.bin

flash:/system-a0201.bin

flash:/feature.bin

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

<Sysname> display install committed verbose

Committed packages on the device:

flash:/boot-a0201.bin

[Package]

Vendor: XXX

Product: xxxx

Service name: boot

Platform version: 7.1

Product version: Beta 1330

Supported board: xxx

[Component]

Component: boot

Description: boot package

flash:/system-a0201.bin

[Package]

Vendor: XXX

Product: xxxx

Service name: system

Platform version: 7.1

Product version: Beta 1330

Supported board: xxx

[Component]

Component: system

Description: system package

flash:/ssh-feature.bin

[Package]

Vendor: XXX

Product: xxxx

Service name: ssh

Platform version: 7.1

Product version: Beta 1330

Supported board: xxx

[Component]

Component: ssh

Description: ssh package

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

【相关命令】

· boot-loader file（基础配置命令参考/软件升级）

· display install backup

· install commit

1.1.4 display install inactive

display install inactive命令用来显示存储介质根目录下、没有被激活的所有软件包的相关信息。

【命令】

独立运行模式：

display install inactive [ verbose ]

IRF模式：

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

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

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

【举例】

# 显示存储介质根目录下、没有被激活的所有软件包的简要信息。

<Sysname> display install inactive

Inactive packages on the device:

flash:/ssh-feature.bin

# 显示存储介质根目录下、没有被激活的所有软件包的详细信息。

<Sysname> display install inactive verbose

Inactive packages on the device:

flash:/ssh-feature.bin

[Package]

Vendor: XXX

Product: XXXX

Service name: ssh

Platform version: 7.1

Product version: Beta 1330

Supported board: xxx

[Component]

Component: ssh

Description: ssh package

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

【相关命令】

· install deactivate

1.1.5 display install ipe-info

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

【命令】

display install ipe-info ipe-filename

ipe-filename：表示IPE文件名，以.ipe作为后缀名，从存储介质名开始为1～63个字符的字符串（包括存储介质名在内），不区分大小写。如果该IPE文件不存在，命令执行失败。

【使用指导】

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

当配置该命令时，命令中指定的IPE文件必须放在存储介质的根目录下，文件名中必须包含存储介质的名称，形如flash:/xx.ipe。（独立运行模式）

当配置该命令时，命令中指定的IPE文件必须放在存储介质的根目录下，文件名中必须包含存储介质的名称，形如flash:/xx.ipe或者slotn#flash:/xx.ipe，n为从设备的成员编号。（IRF模式）

【举例】

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

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

Verifying the file flash:/test.ipe on the device...Done.

H3C Device images in IPE:

boot.bin

system.bin

【相关命令】

· display install package

1.1.6 display install job

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

【命令】

display install job

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

<Sysname> display install job

JobID:5

Action:install activate flash:/ssh-feature.bin on the device

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

1.1.7 display install log

display install log命令用来显示与ISSU升级相关的日志。

【命令】

display install log [ log-id ] [ verbose ]

log-id：显示指定升级日志的信息。log-id表示升级日志的编号，不指定该参数时，则显示所有升级日志的信息。

verbose：表示显示日志的详细信息。不指定该参数时，仅显示日志的摘要信息。

【使用指导】

ISSU日志记录了软件包历史操作信息，每当用户执行一次安装、升级、卸载、删除、取消或回滚操作时，都会自动产生一条日志信息，记录下该操作的过程，以及操作结果是成功还是失败。每条日志均分配一个全局唯一的ID。

设备最多可保存50条ISSU日志，超出该规格时新日志会覆盖最老的日志。

【举例】

# 显示所有显示与软件包升级相关的日志。

<Sysname> display install log

Install job 1 started by user root at 04/28/2001 08:39:29.

Job 1 completed successfully at 04/28/2001 08:39:30.

Install job 1 started by user root at 04/28/2001 08:39:29.

Install activate flash:/ssh.bin on the device

Job 1 completed successfully at 04/28/2001 08:39:30.

Install job 1 started by user root at 04/28/2001 08:39:29.

Job 1 completed successfully at 04/28/2001 08:39:30.

-----------------------------------------------------------

Install job 2 started by user root at 04/28/2001 08:40:29.

Job 2 completed successfully at 04/28/2001 08:40:30.

Install job 2 started by user root at 04/28/2001 08:40:29.

Install activate flash:/route.bin on the device

Job 2 completed successfully at 04/28/2001 08:40:30.

Install job 2 started by user root at 04/28/2001 08:40:29.

Job 2 completed successfully at 04/28/2001 08:40:30.

# 显示系统中编号为1的软件包升级日志的详细信息。

<Sysname> display install log 1 verbose

Install job 1 started by user root at 04/28/2001 08:39:29.

Job 1 completed successfully at 04/28/2001 08:39:30.

Install job 1 started by user root at 04/28/2001 08:39:29.

Install activate flash:/ssh.bin on the device

Job 1 completed successfully at 04/28/2001 08:39:30.

Install job 1 started by user root at 04/28/2001 08:39:29.

Job 1 completed successfully at 04/28/2001 08:39:30.

Detail of activating packages on the device.

Get upgrade policy successfully.

Detail of activating packages on the device.

Uncompress package to system successfully.

Remove files from system successfully.

表1-2 display install log命令显示信息描述表

字段	描述
Install job 1 started by user root at 04/28/2001 08:39:29.	ISSU动作的执行者和执行时间
Job 1 completed successfully at 04/28/2001 08:39:30.	ISSU动作的完成时间
Install activate flash:/ssh.bin	执行的ISSU动作
Detail of activating packages	激活包动作的详细信息
Get upgrade policy successfully	表示升级决策处理成功
Uncompress package to system successfully	解压软件包文件到系统成功
Remove files from system successfully	从系统中删除文件成功

【相关命令】

· reset install log-history oldest

1.1.8 display install package

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

【命令】

display install package { filename | all } [ verbose ]

filename：表示软件包的文件名，以.bin作为后缀名，为1～63个字符的字符串，不区分大小写。

all：表示设备上存储介质根目录下的所有软件包。（独立运行模式）

all：表示主设备上存储介质根目录下的所有软件包。（IRF模式）

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

【使用指导】

当配置该命令时，命令中指定的软件包必须放在存储介质的根目录下，文件名中必须包含存储介质的名称，形如flash:/xx.bin。（独立运行模式）

当配置该命令时，命令中指定的软件包必须放在存储介质的根目录下，文件名中必须包含存储介质的名称，形如flash:/xx.bin或者slotn#flash:/xx.bin，n为从设备的成员编号。（IRF模式）

【举例】

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

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

flash:/system.bin

[Package]

Vendor: XXX

Product: xxxx

Service name: system

Platform version: 7.1.022

Product version: Beta 1330

Supported board: xxx

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

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

flash:/system.bin

[Package]

Vendor: XXX

Product: xxxx

Service name: system

Platform version: 7.1.022

Product version: Beta 1330

Supported board: xxx

[Component]

Component: system

Description: system package

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

1.1.9 display install rollback

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

【命令】

display install rollback [ point-id ]

point-id：回滚点的编号。

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

【举例】

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

<Sysname> display install rollback

Install rollback information 1 on the device:

Updating from flash:/route-1.bin

to flash:/route-2.bin.

Install rollback information 2 on the device:

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

· reset install rollback oldest

1.1.10 display install which

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

【命令】

独立运行模式：

display install which { component name | file filename }

IRF模式：

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

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

file filename：软件包所包含的文件的名称，为1～63个字符的字符串，不区分大小写。必须为纯文件名的形式。系统查询时，只有名称完全相同（除了大小写），才认为匹配成功。

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

【使用指导】

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

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

【举例】

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

<Sysname> display install which file sshc.cli

File sshc.cli is in following packages on the device:

flash:/system.bin

[Package]

Vendor: XXX

Product: xxxx

Service name: ssh

Platform version: 7.1.022

Product version: Beta 1330

Supported board: xxx

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

1.1.11 display version comp-matrix

display version comp-matrix命令用来显示软件版本兼容信息。

【命令】

display version comp-matrix

display version comp-matrix file { boot filename | system filename | feature filename&<1-30> } *

display version comp-matrix file ipe ipe-filename

boot：表示Boot包。

system：表示System包。

feature：表示Feature包。

filename：表示软件包的文件名，以.bin作为后缀名，为1～63个字符的字符串，不区分大小写。&<1-30>表示前面的参数最多可以输入30次。

ipe ipe-filename：IPE文件名，以.ipe作为后缀名，为1～63个字符的字符串，不区分大小写。

【使用指导】

· 当配置该命令时，命令中指定的软件包/IPE文件必须放在设备存储介质的根目录下，文件名中必须包含存储介质的名称，形如flash:/xx.bin（flash:/xx.ipe）。（独立运行模式）

· 当配置该命令时，命令中指定的软件包/IPE文件必须放在主设备存储介质的根目录下，文件名中必须且只能包含存储介质的名称，不能包含slot的信息，形如flash:/xx.bin（flash:/xx.ipe）。（IRF模式）

· 如果指定文件名，则显示指定软件包的兼容性信息，以及从当前运行版本升级到指定软件包版本需要采用的升级方式；如果不指定文件名，则显示设备当前运行版本的兼容性信息。

【举例】

# 显示设备当前正在使用的软件包的兼容信息。

<Sysname> display version comp-matrix

Boot image: flash:/cmw710-boot-a7122.bin

Version:

7.1.031

System image: flash:/cmw710-system-a7122.bin

Version:

V700R001B31D001

Version compatibility list:

V700R001B31D001

Version dependency boot list:

7.1.031

Feature image: flash:/cmw710-cfa-a7124.bin

Version:

V700R001B31D003

Version compatibility list:

V700R001B31D003

Version dependency system list:

V700R001B31D001

V700R001B31D002

# 显示文件flash:/boot-e2205.bin、flash:/system-e2205.bin、flash:/dhcp-e2205.re.bin和当前运行软件包的兼容信息。（不兼容版本显示信息举例）

<Sysname> display version comp-matrix file boot flash:/boot-e2205.bin system flash:/system-e2205.bin feature flash:/dhcp-e2205.re.bin

Verifying the file flash:/dhcp-e2205.re.bin on the device.....Done.

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

Verifying the file flash:/system-e2205.bin on the device.....Done.

Boot image: flash:/boot-e2205.bin

Version:

7.1.035

System image: flash:/system-e2205.bin

Version:

V200R001B02D012

Version compatibility list:

V200R001B02D012

Version dependency boot list:

7.1.035

Feature image: flash:/dhcp-e2205.re.bin

Version:

V200R001B02D012

Version compatibility list:

V200R001B02D012

Version dependency system list:

V200R001B02D012

V200R001B02D014

Incompatible upgrade.

表1-4 display version comp-matrix命令显示信息描述表

字段	描述
Verifying the file.	验证文件是否合法
Boot image: flash:/cmw710-boot-a7122.bin Version:	要显示的Boot包的相关信息，包括： · Boot包的名称 · Version：Boot包的版本
System image: flash:/cmw710-system-a7122.bin Version: V700R001B31D001 Version compatibility list: V700R001B31D001 Version dependency boot list: 7.1.031	要显示的System包的相关信息，包括： · System包的名称 · Version：System包的版本 · Version compatibility list：和该System包兼容的System包版本列表 · Version dependency boot list：依赖的Boot包版本列表，即安装该System包前，必须先安装如下版本的Boot包中的任意一个
Feature image: flash:/cmw710-cfa-a7124.bin Version: V700R001B31D003 Version compatibility list: V700R001B31D003 Version dependency system list: V700R001B31D001 V700R001B31D002	要显示的Feature包的相关信息，包括： · Feature包的名称 · Version：Feature包的版本 · Version compatibility list：和该Feature包兼容的Feature包版本列表 · Version dependency system list：依赖的System包版本列表，即安装该Feature包前，必须先安装如下版本的System包中的任意一个
Compatible info of S5120HI: Boot image: flash:/rpu-s5120hi-boot.bin Version: 7.1.041 System image: flash:/rpu-s5120hi-system.bin Version: D2402 Version compatibility list: D2402 Version dependency boot list: 7.1.041 Feature image: flash:/s5120hi-http-d2402.bin Version: D2404 Version compatibility list: D2404 Version dependency system list: D2402	要显示的PEX设备的相关信息，包括：要显示的Boot包的相关信息： · Boot包的名称 · Version：Boot包的版本要显示的System包的相关信息： · System包的名称 · Version：System包的版本 · Version compatibility list：和该System包兼容的System包版本列表 · Version dependency boot list：依赖的Boot包版本列表，即安装该System包前，必须先安装如下版本的Boot包中的任意一个要显示的Feature包的相关信息： · Feature包的名称 · Version：Feature包的版本 · Version compatibility list：和该Feature包兼容的Feature包版本列表 · Version dependency system list：依赖的System包版本列表，即安装该Feature包前，必须先安装如下版本的System包中的任意一个
Influenced service according to following table	如果升级，受影响的功能模块。只有版本兼容时，才会显示该信息
Incompatible upgrade	如果升级指定的软件包，则升级的方式为不兼容升级
Slot	设备在IRF中的成员编号。只有版本兼容时，才会显示该信息（IRF模式）
Upgrade Way	兼容升级策略。只有版本兼容时，才会显示该信息。取值可能为： · Service Upgrade：表示服务级增量升级，该方式下，仅对本业务模块有影响，对系统以及其他业务模块没有影响 · File Upgrade：表示文件级增量升级。该方式下，仅对系统内的、用户不可见的程序文件进行升级，对系统以及业务模块没有影响 · ISSU Reboot：表示通过软重启方式升级 · Reboot：表示通过重启方式升级

1.1.12 install abort

install abort命令用来取消正在执行中的ISSU操作。

【命令】

install abort [ job-id ]

job-id：任务ID。不指定该参数时，则取消正在执行中的操作。

【使用指导】

当用户执行install activate、install add、install commit、install deactivate、install remove或install rollback to命令时，系统会创建相应的任务。为了管理和监控这些任务，系统会给每个任务分配一个任务ID。一个任务ID代表一条命令。其中，只有正在进行的激活或卸载操作可以使用install abort命令进行取消操作，取消后回退到操作前状态。

【举例】

# 取消正在执行中的操作。

<Sysname> install abort

【相关命令】

· display install job

1.1.13 install activate

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

【命令】

独立运行模式：

install activate { boot filename | system filename | feature filename&<1-30> } * [ test ]

install activate patch filename

IRF模式：

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

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

boot：表示Boot包。

system：表示System包。

feature：表示Feature包。

patch：表示补丁包。用于快速修复系统Bug。

filename：表示软件包的文件名，以.bin作为后缀名，从存储介质名开始为1～63个字符的字符串（包括存储介质名在内），不区分大小写。&<1-30>表示前面的参数最多可以输入30次。

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

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

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

【使用指导】

· 只有进行激活处理后，软件包才能生效。

· 被激活的软件包只在本次运行的系统中生效。要使被激活的软件包在设备重启后继续生效，还需要执行install commit命令。

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

(1) 当在独立运行模式下配置该命令时：

· 命令中指定的软件包必须放在设备存储介质的根目录下，文件名中必须包含存储介质的名称，形如flash:/xx.bin。

(2) 当在IRF模式下配置该命令时：

· 命令中指定的软件包必须放在存储介质的根目录下，文件名中必须包含存储介质的名称，形如flash:/xx.bin或slot2#flash:/xx.bin。

· 如果指定的slot参数为成员设备的成员编号，则执行该命令，如果指定的不是该成员设备上的软件包，会先将软件包拷贝到该成员设备上，再升级该成员设备。

· 从设备重启后，会自动批量备份主设备的配置和状态数据。请等待批量备份完成后，即分别通过display device和display system internal ha service-group命令查看到所有设备处于normal状态和所有服务的action显示为0后，再执行install activate命令，否则，命令会执行失败。

【举例】

# 显示Feature包ssh2.bin的升级策略。（独立运行模式）

<Sysname> install activate feature flash:/ssh2.bin test

Verifying the file flash:/ssh2.bin on the device.....Done.

Upgrade summary according to following table:

flash:/ssh2.bin

Running Version New Version

Beta 1330 Beta 1331

Upgrade Way: Service Upgrade

Influenced service according to following table:

flash:/ssh2.bin

SSH IFMGR CFA LAGG

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

# 显示从设备2上的Feature包ssh2.bin。的升级策略（IRF模式）

<Sysname> install activate feature flash:/ssh2.bin slot 2 test

Copying file flash:/ssh2.bin to slot2#flash:/ssh2.bin......Done.

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

Upgrade summary according to following table:

flash:/ssh2.bin

Running Version New Version

Beta 1330 Beta 1331

Slot Upgrade Way

2 Service Upgrade

Influenced service according to following table:

flash:/ssh2.bin

SSH IFMGR CFA LAGG

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

# 激活System包system.bin和Feature包feature.bin。（独立运行模式）

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

Verifying the file flash:/feature.bin on the device.....Done.

Verifying the file flash:/system.bin on the device.....Done.

Upgrade summary according to following table:

flash:/system.bin

Running Version New Version

Beta 1330 Beta 1331

flash:/feature.bin

Running Version New Version

NONE Beta 1330

Upgrade Way: Service Upgrade

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

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

# 激活从设备2上的System包system.bin和Feature包feature.bin。（IRF模式）

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

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

Copying file flash:/feature.bin to slot2#flash:/feature.bin......Done.

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

Beta 1330 Beta 1331

flash:/feature.bin

Running Version New Version

None Beta 1330

Slot Upgrade Way

2 Service Upgrade

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

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

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

字段	描述
Copying file A to B......Done.	将文件从位置A拷贝到位置B。当配置从设备时才有该提示信息（IRF模式）
Verifying the file.	验证文件是否合法
Upgrade summary according to following table	升级摘要信息
Running Version	设备当前运行的相同类型软件包的产品版本号
New Version	目标软件包的产品版本号
Slot	设备在IRF中的成员编号（IRF模式）
Upgrade Way	兼容升级策略，取值可能为： · Service Upgrade：表示服务级增量升级，该方式下，仅对本业务模块有影响，对系统以及其他业务模块没有影响 · File Upgrade：表示文件级增量升级。该方式下，仅对系统内的、用户不可见的程序文件进行升级，对系统以及业务模块没有影响 · ISSU Reboot：表示通过软重启方式升级 · Reboot：表示通过重启方式升级
Influenced service according to following table	将受影响的功能模块
Upgrading software images to compatible versions. Continue? [Y/N]	询问用户是否执行兼容升级操作
This operation maybe 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.14 install add

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

【命令】

install add ipe-filename medium-name:

ipe-filename：IPE文件名，以.ipe作为后缀名，从存储介质名开始为1～63个字符的字符串（包括存储介质名在内），不区分大小写。

medium-name：存储介质的名称，形如flash。（独立运行模式）

medium-name：存储介质的名称。如果是解压缩到主设备上，则为flash；如果是解压缩到从设备上，则为slotn#flash，n为从设备的成员编号。（IRF模式）

【使用指导】

IPE文件是多个软件包的集合。将多个软件包整合成一个IPE文件对外发布，以便减少BIN包之间的版本管理问题。

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

当配置该命令时，命令中指定的IPE文件必须放在设备存储介质的根目录下，文件名中必须包含存储介质的名称，形如flash:/xx.ipe。（独立运行模式）

当配置该命令时，命令中指定的IPE文件必须放在存储介质的根目录下，文件名中必须包含存储介质的名称，形如flash:/xx.ipe或slot1#flash:/xx.ipe。（IRF模式）

【举例】

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

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

Verifying image file..........................Done.

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

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

1.1.15 install commit

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

执行install activate、install deactivate、install rollback命令会修改设备当前运行的软件包列表，使得只有符合用户需求的软件运行，不符合要求的不运行。

· 当执行install activate命令，且为增量升级方式时，这些修改只在设备的本次运行过程有效，要使这个修改结果在设备下次重启后继续生效，需要再执行install commit命令进行确认，确认后的软件包会列入设备主用下次启动软件包列表。

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

· 当执行install deactivate或install rollback命令，这些修改只在设备的本次运行过程有效，要使这个修改结果在设备下次重启后继续生效，需要再执行install commit命令进行确认。

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

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

【举例】

# 确认软件包更改。

<Sysname> install commit

【相关命令】

· install activate

· install deactivate

· install rollback

1.1.16 install deactivate

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

【命令】

独立运行模式：

install deactivate feature filename&<1-30>

install deactivate patch filename

IRF模式：

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

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

filename：表示需要卸载Feature包或补丁包的文件名，以.bin作为后缀名，为1～63个字符的字符串，不区分大小写。&<1-30>表示前面的参数最多可以输入30次。

all：表示安装了该补丁包的所有成员设备。

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

【使用指导】

该命令只能对已经激活的软件包进行卸载操作。卸载的软件包的特性功能在本次系统运行中失效。如果要使卸载的软件包在设备重启后继续失效，请执行install commit命令对卸载操作进行确认。

当配置该命令时，文件名中必须包含存储介质的名称，形如flash:/xx.bin。（独立运行模式）

当配置该命令时，文件名中必须且只能包含存储介质的名称，不能包含slot的信息，形如flash:/xx.bin。（IRF模式）

从设备重启后，会自动批量备份主设备的配置和状态数据。请等待批量备份完成后，即分别通过display device和display system internal ha service-group命令查看到所有设备处于normal状态和所有服务的action显示为0后，再执行install deactivate命令，否则，命令会执行失败。（IRF模式）

【举例】

# 卸载设备上的patch包route-patch.bin。（独立运行模式）

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

# 卸载成员设备1上的patch包route-patch.bin。（IRF模式）

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

【相关命令】

· display install active

· display install inactive