- 产品与解决方案
- 行业解决方案
- 服务
- 支持
- 合作伙伴
- 新华三人才研学中心
- 关于我们
08-ISSU命令
本章节下载： 08-ISSU命令 (289.89 KB)
1.1.3 display install committed
1.1.4 display install inactive
1.1.5 display install ipe-info
1.1.9 display install rollback
1.1.11 display issu rollback-timer
1.1.13 display version comp-matrix
display install active命令用来显示当前系统中处于激活状态的软件包的相关信息。
【命令】
（独立运行模式）
display install active [ slot slot-number ] [ verbose ]
（IRF模式）
display install active [ chassis chassis-number slot slot-number ] [ verbose ]
【视图】
任意视图
【缺省用户角色】
network-admin
network-operator
【参数】
slot slot-number：表示单板所在的槽位号。不指定该参数时，表示设备上的所有单板。（独立运行模式）
chassis chassis-number slot slot-number：chassis-number表示设备在IRF中的成员编号，slot-number表示单板所在的槽位号。不指定该参数时，表示IRF中的所有单板。（IRF模式）
verbose：显示处于激活状态的软件包的详细信息，包括软件包的名称、基本信息和所包含的组件。不指定该参数时，仅显示软件包的名称。
【举例】
# 显示设备上处于激活状态的软件包的简要信息。（独立运行模式）
<Sysname> display install active
Active packages on slot 1:
flash:/boot.bin
flash:/system.bin
flash:/feature1.bin
# 显示设备上处于激活状态的软件包的简要信息。（IRF模式）
<Sysname> display install active
Active packages on chassis 1 slot 1:
flash:/boot.bin
flash:/system.bin
flash:/patch1.bin
# 显示设备上处于激活状态的软件包的详细信息。（独立运行模式）
<Sysname> display install active verbose
Active packages on slot 1:
flash:/boot.bin
[Package]
Vendor: H3C
Product: S12500-X
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: S12500-X
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: S12500-X
Service name: test
Platform version: 7.1.070
Product version: Test 0001015
Supported board: mpu
[Component]
Component: test
Description: test package
# 显示设备上处于激活状态的软件包的详细信息。（IRF模式）
<Sysname> display install active verbose
Active packages on chassis 1 slot 1:
flash:/boot.bin
[Package]
Vendor: H3C
Product: S12500-X
Service name: boot
Platform version: 7.1.070
Product version: Test 0001015
Supported board: mpu lpu
[Component]
Component: boot
Description: boot package
flash:/system.bin
[Package]
Vendor: H3C
Product: S12500-X
Service name: system
Platform version: 7.1.070
Product version: Test 0001015
Supported board: mpu lpu
[Component]
Component: system
Description: system package
flash:/patch1.bin
[Package]
Vendor: H3C
Product: S12500-X
Service name: test
Platform version: 7.1.070
Product version: Test 0001015
Supported board: mpu lpu
[Component]
Component: test
Description: test package
表1-1 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表示主控板 · lpu表示业务板 · sfc表示网板 |
|
[Component] |
组件信息，表示软件包的组成部分 |
|
Component |
组件的名称 |
|
Description |
组件的描述信息 |
【相关命令】
· install active
display install backup命令用来显示设备下次启动时使用的备用软件包的相关信息。
【命令】
（独立运行模式）
display install backup [ slot slot-number ] [ verbose ]
（IRF模式）
display install backup [ chassis chassis-number slot slot-number ] [ verbose ]
【视图】
任意视图
【缺省用户角色】
network-admin
network-operator
【参数】
slot slot-number：表示单板所在的槽位号。不指定该参数时，表示设备上的所有单板。（独立运行模式）
chassis chassis-number slot slot-number：chassis-number表示设备在IRF中的成员编号，slot-number表示单板所在的槽位号。不指定该参数时，表示IRF中的所有单板。（IRF模式）
verbose：显示详细信息，包括软件包的名称、基本信息和所包含的组件。不指定该参数时，仅显示软件包的名称。
【使用指导】
当主用启动软件包列表中的Boot包或System包不存在或者损坏时，使用备用启动软件包列表中的软件包。有关设备下次启动时使用的软件包的详细介绍请参见“基础配置指导”中的“软件升级”。
执行boot-loader file命令可以修改设备下次启动时使用的备用软件包列表。
【举例】
# 显示设备下次启动时使用的备用软件包的相关信息。（独立运行模式）
<Sysname> display install backup
Backup startup software images on slot 1:
flash:/boot.bin
flash:/system.bin
# 显示设备下次启动时使用的备用软件包的相关信息。（IRF模式）
<Sysname> display install backup
Backup startup software images on chassis 1 slot 1:
flash:/boot.bin
flash:/system.bin
# 显示设备下次启动时使用的备用软件包的详细信息。（独立运行模式）
<Sysname> display install backup verbose
Backup startup software images on slot 1:
flash:/boot.bin
[Package]
Vendor: H3C
Product: S12500-X
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: S12500-X
Service name: system
Platform version: 7.1.070
Product version: Test 0001015
Supported board: mpu
[Component]
Component: system
Description: system package
# 显示设备下次启动时使用的备用软件包的详细信息。（IRF模式）
<Sysname> display install backup verbose
Backup startup software images on chassis 1 slot 1:
flash:/boot.bin
[Package]
Vendor: H3C
Product: S12500-X
Service name: boot
Platform version: 7.1.070
Product version: Test 0001015
Supported board: mpu lpu
[Component]
Component: boot
Description: boot package
flash:/system.bin
[Package]
Vendor: H3C
Product: S12500-X
Service name: system
Platform version: 7.1.070
Product version: Test 0001015
Supported board: mpu lpu
[Component]
Component: system
Description: system package
Backup startup software images on chassis 2 slot 1:
flash:/boot.bin
[Package]
Vendor: H3C
Product: S12500-X
Service name: boot
Platform version: 7.1.070
Product version: Test 0001015
Supported board: mpu lpu
[Component]
Component: boot
Description: boot package
flash:/system.bin
[Package]
Vendor: H3C
Product: S12500-X
Service name: system
Platform version: 7.1.070
Product version: Test 0001015
Supported board: mpu lpu
[Component]
Component: system
Description: system package
本命令显示信息的描述请参见表1-1。
【相关命令】
· boot-loader file（基础配置命令参考/软件升级）
· display install committed
display install committed命令用来显示设备下次启动时使用的主用软件包的相关信息。
【命令】
（独立运行模式）
display install committed [ slot slot-number ] [ verbose ]
（IRF模式）
display install committed [ chassis chassis-number slot slot-number ] [ verbose ]
【视图】
任意视图
【缺省用户角色】
network-admin
network-operator
【参数】
slot slot-number：表示单板所在的槽位号。不指定该参数时，表示设备上的所有单板。（独立运行模式）
chassis chassis-number slot slot-number：chassis-number表示设备在IRF中的成员编号，slot-number表示单板所在的槽位号。不指定该参数时，表示IRF中的所有单板。（IRF模式）
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
# 显示设备下次启动时使用的主用软件包的相关信息。（IRF模式）
<Sysname> display install committed
Committed packages on chassis 1 slot 1:
flash:/boot.bin
flash:/system.bin
flash:/patch1.bin
# 显示设备下次启动时使用的主用软件包的详细信息。（独立运行模式）
<Sysname> display install committed verbose
Committed packages on slot 1:
flash:/boot.bin
[Package]
Vendor: H3C
Product: S12500-X
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: S12500-X
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: S12500-X
Service name: feature1
Platform version: 7.1.070
Product version: Test 0001015
Supported board: mpu
[Component]
Component: feature1
Description: feature1 package
# 显示设备下次启动时使用的主用软件包的详细信息。（IRF模式）
<Sysname> display install committed verbose
Committed packages on chassis 1 slot 1:
flash:/boot.bin
[Package]
Vendor: H3C
Product: S12500-X
Service name: boot
Platform version: 7.1.070
Product version: Test 0001015
Supported board: mpu lpu
[Component]
Component: boot
Description: boot package
flash:/system.bin
[Package]
Vendor: H3C
Product: S12500-X
Service name: system
Platform version: 7.1.070
Product version: Test 0001015
Supported board: mpu lpu
[Component]
Component: system
Description: system package
flash:/patch1.bin
[Package]
Vendor: H3C
Product: S12500-X
Service name: patch1
Platform version: 7.1.070
Product version: Test 0001015
Supported board: mpu lpu
[Component]
Component: patch1
Description: patch1 package
Committed packages on chassis 2 slot 1:
flash:/boot.bin
[Package]
Vendor: H3C
Product: S12500-X
Service name: boot
Platform version: 7.1.070
Product version: Test 0001015
Supported board: mpu lpu
[Component]
Component: boot
Description: boot package
flash:/system.bin
[Package]
Vendor: H3C
Product: S12500-X
Service name: system
Platform version: 7.1.070
Product version: Test 0001015
Supported board: mpu lpu
[Component]
Component: system
Description: system package
flash:/patch1.bin
[Package]
Vendor: H3C
Product: S12500-X
Service name: patch1
Platform version: 7.1.070
Product version: Test 0001015
Supported board: mpu lpu
[Component]
Component: patch1
Description: patch1 package
本命令显示信息的描述请参见表1-1。
【相关命令】
· boot-loader file（基础配置命令参考/软件升级）
· display install backup
· install commit
display install inactive命令用来显示文件系统根目录下没有被激活的所有软件包的相关信息。
【命令】
（独立运行模式）
display install inactive [ slot slot-number ] [ verbose ]
（IRF模式）
display install inactive [ chassis chassis-number slot slot-number ] [ verbose ]
【视图】
任意视图
【缺省用户角色】
network-admin
network-operator
【参数】
slot slot-number：表示单板所在的槽位号。不指定该参数时，表示设备上的所有单板。（独立运行模式）
chassis chassis-number slot slot-number：chassis-number表示设备在IRF中的成员编号，slot-number表示单板所在的槽位号。不指定该参数时，表示IRF中的所有单板。（IRF模式）
verbose：显示详细信息，包括软件包的名称、基本信息和所包含的组件。不指定该参数时，仅显示软件包的名称。
【举例】
# 显示文件系统根目录下没有被激活的所有软件包的简要信息。（独立运行模式）
<Sysname> display install inactive
Inactive packages on slot 1:
flash:/feature1.bin
# 显示文件系统根目录下没有被激活的所有软件包的简要信息。（IRF模式）
<Sysname> display install inactive
Inactive packages on chassis 1 slot 1:
flash:/patch1.bin
Inactive packages on chassis 2 slot 1:
flash:/patch1.bin
# 显示文件系统根目录下没有被激活的所有软件包的详细信息。（独立运行模式）
<Sysname> display install inactive verbose
Inactive packages on slot 1:
flash:/feature1.bin
[Package]
Vendor: H3C
Product: S12500-X
Service name: feature1
Platform version: 7.1.070
Product version: Test 0001015
Supported board: mpu
[Component]
Component: feature1
Description: feature1 package
# 显示文件系统根目录下没有被激活的所有软件包的详细信息。（IRF模式）
<Sysname> display install inactive verbose
Inactive packages on chassis 1 slot 1:
flash:/patch1.bin
[Package]
Vendor: H3C
Product: S12500-X
Service name: patch1
Platform version: 7.1.070
Product version: Test 0001015
Supported board: mpu lpu
[Component]
Component: patch1
Description: patch1 package
Inactive packages on chassis 2 slot 1:
flash:/patch1.bin
[Package]
Vendor: H3C
Product: S12500-X
Service name: patch1
Platform version: 7.1.070
Product version: Test 0001015
Supported board: mpu lpu
[Component]
Component: patch1
Description: patch1 package
本命令显示信息的描述请参见表1-1。
【相关命令】
· install deactivate
display install ipe-info命令用来显示IPE文件包含的软件包列表。
【命令】
display install ipe-info ipe-filename
【视图】
任意视图
【缺省用户角色】
network-admin
network-operator
【参数】
ipe-filename：表示IPE文件的名称，形如filesystemname/filename.ipe。该文件必须保存在设备任一文件系统的根目录下，该参数中必须包含文件系统的名称，从存储介质名称开始最多可输入63个字符。有关指定文件夹和文件详细介绍请参见“基础配置指导”中的“文件系统管理”。
【使用指导】
IPE文件是一个或多个软件包的集合。用户获得IPE文件后，可以选择其中的软件包进行升级。
【举例】
# 显示flash:/test.ipe的IPE信息。（独立运行模式）
<Sysname> display install ipe-info flash:/test.ipe
Verifying the file flash:/test.ipe on slot 1................Done.
H3C S12516X-AF images in IPE:
boot.bin
system.bin
# 显示flash:/test.ipe的IPE信息。（IRF模式）
<Sysname> display install ipe-info flash:/test.ipe
Verifying the file flash:/test.ipe on chassis 1 slot 1................Done.
H3C S12516X-AF images in IPE:
boot.bin
system.bin
【相关命令】
· display install package
display install job命令用来显示系统中正在执行的激活、卸载或回滚操作。
【命令】
display install job
【视图】
任意视图
【缺省用户角色】
network-admin
network-operator
【举例】
# 显示系统中正在执行的激活、卸载、回滚操作。（独立运行模式）
<Sysname> display install job
JobID:5
Action:install activate flash:/feature1.bin on slot 1
以上显示信息表明：设备正在执行install activate flash:/feature1.bin slot 1操作。
# 显示系统中正在执行的激活、卸载、回滚操作。（IRF模式）
<Sysname> display install job
JobID:5
Action:install activate flash:/patch1.bin on chassis 1 slot 1
以上显示信息表明：设备正在执行install activate flash:/patch1.bin chassis 1 slot 1操作。
display install log命令用来显示与ISSU升级相关的日志。
【命令】
display install log [ log-id ] [ verbose ]
【视图】
任意视图
【缺省用户角色】
network-admin
network-operator
【参数】
log-id：显示指定升级日志的信息。log-id表示升级日志的编号，不指定该参数时，则显示所有ISSU升级日志的信息。
verbose：显示日志的详细信息。不指定该参数时，仅显示日志的摘要信息。
【使用指导】
ISSU日志记录了软件包历史操作信息，每当用户执行一次安装、升级、卸载、删除、取消或回滚操作时，都会自动产生一条日志信息，记录下该操作的过程，以及操作结果是成功还是失败。每条日志均分配一个全局唯一的ID。
设备最多可保存50条ISSU日志，达到该规格时新日志会覆盖最老的日志。
若设备重启，则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:/feature1.bin on slot 1
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 slot 1
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.
# 显示所有显示与软件包升级相关的日志。（IRF模式）
<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:/patch1.bin on chassis 1 slot 1
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 chassis 1 slot 1
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:/feature1.bin on slot 1
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 slot 1.
Get upgrade policy successfully.
Detail of activating packages on slot 1.
Uncompress package to system successfully.
Remove files from system successfully.
# 显示系统中编号为1的软件包升级日志的详细信息。（IRF模式）
<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:/patch1.bin on chassis 1 slot 1
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 chassis 1 slot 1.
Get upgrade policy successfully.
Detail of activating packages on chassis 1 slot 1.
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:/feature1.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
display install package命令用来显示软件包的相关信息。
【命令】
display install package { filename | all } [ verbose ]
【视图】
任意视图
【缺省用户角色】
network-admin
network-operator
【参数】
filename：软件包的名称，形如filesystemname/filename.bin。该文件必须保存在设备任一文件系统的根目录下，该参数中必须包含文件系统的名称，从存储介质名称开始最多可输入63个字符。有关指定文件夹和文件详细介绍请参见“基础配置指导”中的“文件系统管理”。
all：表示主用主控板上各文件系统根目录下的所有软件包。（独立运行模式）
all：表示全局主用主控板上各文件系统根目录下的所有软件包。（IRF模式）
verbose：显示软件包的基本信息和软件包所包含的组件。不指定该参数时，仅显示软件包的基本信息。
【举例】
# 显示软件包system.bin的相关信息。
<Sysname> display install package flash:/system.bin
flash:/system.bin
[Package]
Vendor: H3C
Product: S12500-X
Service name: system
Platform version: 7.1.070
Product version: Test 0001015
Supported board: mpu
# 显示软件包system.bin的详细信息。
<Sysname> display install package flash:/system.bin verbose
flash:/system.bin
[Package]
Vendor: H3C
Product: S12500-X
Service name: system
Platform version: 7.1.070
Product version: Test 0001015
Supported board: mpu
[Component]
Component: system
Description: system package
本命令显示信息的描述请参见表1-1。
display install rollback命令用来显示回滚点的相关信息。
【命令】
display install rollback [ point-id ]
【视图】
任意视图
【缺省用户角色】
network-admin
network-operator
【参数】
point-id：回滚点的编号。如果未指定point-id，则显示所有回滚点的相关信息。
【使用指导】
可以通过这个命令查看回滚点信息，以便进行相应的回滚操作。
issu命令升级过程中不会记录回滚点，因此，在issu命令升级过程中执行该命令，没有信息可显示。
【举例】
# 显示所有回滚点的相关信息。（独立运行模式）
<Sysname> display install rollback
Install rollback information 1 on slot 1:
Updating from flash:/route-1.bin
to flash:/route-2.bin.
Install rollback information 2 on slot 1:
Deactivating flash:/route-2.bin
# 显示所有回滚点的相关信息。（IRF模式）
<Sysname> display install rollback
Install rollback information 1 on chassis 1 slot 1
Updating from flash:/route-1.bin
to flash:/route-2.bin.
Install rollback information 2 on chassis 1 slot 1
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
display install which命令用来显示一个组件或文件的所属软件包，以及该软件包的相关信息。
【命令】
（独立运行模式）
display install which { component name | file filename } [ slot slot-number ]
（IRF模式）
display install which { component name | file filename } [ chassis chassis-number slot slot-number ]
【视图】
任意视图
【缺省用户角色】
network-admin
network-operator
【参数】
component name：软件包所包含的组件的名称。
file filename：软件包所包含的文件的名称，为1～63个字符的字符串，不区分大小写。必须为纯文件名的形式。
slot slot-number：表示单板所在的槽位号。不指定该参数时，表示设备上的所有单板。（独立运行模式）
chassis chassis-number slot slot-number：chassis-number表示设备在IRF中的成员编号，slot-number表示单板所在的槽位号。不指定该参数时，表示IRF中的所有单板。（IRF模式）
【使用指导】
组件是特性的集合，组件中的特性是同时安装/卸载的。
当软件包运行错误，系统提示xx组件或者xx文件运行错误的时候，可以根据组件名/文件名使用该命令查找它属于哪个软件包，从而帮助进一步定位是否是软件包本身有缺陷。通过检验该软件包，定位是否为软件包的问题。使用install verify命令可以对软件包进行检验。
执行该命令后，系统会扫描指定位置的所有文件系统根目录下的所有软件包，将包含该组件/文件的软件包都依次显示。
【举例】
# 显示文件pkg_ctr属于哪个软件包以及该软件包的相关信息。（独立运行模式）
<Sysname> display install which file pkg_ctr
Verifying the file flash:/system-t0001015.bin on slot 1..........................Done.
Found pkg_ctr in flash:/system-t0001015.bin on slot 1.
flash:/system-t0001015.bin
[Package]
Vendor: H3C
Product: S12500-X
Service name: system
Platform version: 7.1.070
Product version: Test 0001015
Supported board: mpu
Verifying the file flash:/boot-d2601007.bin on slot 1.....Done.
# 显示文件pkg_ctr属于哪个软件包以及该软件包的相关信息。（IRF模式）
<Sysname> display install which file pkg_ctr
Verifying the file flash:/system-t0001015.bin on chassis 1 slot 1...........Done.
Found pkg_ctr in flash:/system-t0001015.bin on chassis 1 slot 1.
flash:/system-t0001015.bin
[Package]
Vendor: H3C
Product: S12500-X
Service name: system
Platform version: 7.1.070
Product version: Test 0001015
Supported board: mpu lpu
Verifying the file flash:/boot-d2601007.bin on slot 1.....Done.
表1-4 display install which命令显示信息描述表
|
字段 |
描述 |
|
Verifying the file |
验证文件是否合法 |
|
Found pkg_ctr |
找到文件 |
|
[Package] |
软件包的信息 |
|
Vendor |
生产厂商 |
|
Product |
产品名称 |
|
Service name |
软件包所包含的服务名称： · 如果显示为boot，表示该软件包为Boot包 · 如果显示为system，表示该软件包为System包 · 如果显示为patch，表示该软件包为补丁包 · 如果显示为其它值，则表示该软件包为提供某项功能的Feature包 |
|
Platform version |
平台软件版本号 |
|
Product version |
产品软件版本号 |
|
Supported board |
软件包支持的硬件类型： · mpu表示主控板 · lpu表示业务板 · sfc表示网板 |
|
File xxx was not found in the image packages under the root directory of the storage medium |
在存储介质根目录下的所有包中都没有找到指定文件 |
display issu rollback-timer命令用来显示回滚定时器的相关信息。
【命令】
display issu rollback-timer
【视图】
任意视图
【缺省用户角色】
network-admin
network-operator
【使用指导】
因为新设置的回滚定时器时长会在下次ISSU升级中生效，因此，可能出现剩余时间大于定时器时长的情况。
【举例】
# 执行issu run switchover命令后，显示回滚定时器的相关信息。
<Sysname> display issu rollback-timer
Rollback timer: Working
Rollback interval：45 minutes
Rollback time remaining : 40 minutes
# 执行issu accept命令后，显示回滚定时器的相关信息。
<Sysname> display issu rollback-timer
Rollback timer: Not working
Rollback interval：30 minutes
# 当前没有进行ISSU升级，显示回滚定时器的相关信息。
<Sysname> display issu rollback-timer
Rollback timer: Not working
Rollback interval：45 minutes
表1-5 display issu rollback-timer命令显示信息描述表
|
字段 |
描述 |
|
Rollback timer |
回滚定时器是否处于工作状态： · Working：回滚定时器已经启动 · Not working：回滚定时器没有启动或者已经超时 |
|
Rollback interval |
用户配置的回滚定时器的时间，单位为分钟 |
|
Rollback time remaining |
距离回滚定时器超时的时间，单位为分钟 |
【相关命令】
· issu rollback-timer
display issu state命令用来显示当前ISSU升级所处的状态，以及ISSU升级的相关信息。
【命令】
display issu state
【视图】
任意视图
【缺省用户角色】
network-admin
network-operator
【使用指导】
issu命令升级需要经过一系列的操作步骤，升级过程中有严格的步骤要求，执行升级步骤会导致ISSU状态的变化，通过该命令的显示信息可以帮助管理员确定下一步需执行的操作。
该命令不能显示install命令升级过程中设备所处的状态，因为install命令升级过程没有用到状态机。
【举例】
# 当前设备没有ISSU升级，显示ISSU状态。（独立运行模式）
<Sysname> display issu state
ISSU state: Init
Compatibility: Unknown
Work state: Normal
Upgrade method: Card by card
Upgraded slot: None
Current upgrading slot: None
Current version list:
boot: 7.1.070, Test 0001015
system: 7.1.070, Test 0001015
feature1: 7.1.070, Test 0001015
Current software images:
flash:/boot-t0001015.bin
flash:/system-t0001015.bin
flash:/feature1-t0001015.bin
# issu load命令执行过程中，显示ISSU状态。（独立运行模式）
<Sysname> display issu state
ISSU state: Loading
Compatibility: Incompatible
Work state: Normal
Upgrade method: Card by card
Upgraded slot: None
Current upgrading slot:
slot 1
Previous version list:
boot: 7.1.070, Test 0001015
system: 7.1.070, Test 0001015
feature1: 7.1.070, Test 0001015
Previous software images:
flash:/boot-t0001015.bin
flash:/system-t0001015.bin
flash:/feature1-t0001015.bin
Upgrade version list:
boot: 7.1.070, Test 0001016
system: 7.1.070, Test 0001016
feature1: 7.1.070, Test 0001016
Upgrade software images：
flash:/boot-t0001016.bin
flash:/system-t0001016.bin
flash:/feature1-t0001016.bin
# 在单成员设备情况下，当前设备没有ISSU升级，显示ISSU状态。（IRF模式）
<Sysname> display issu state
ISSU state: Init
Compatibility: Unknown
Work state: Normal
Upgrade method: Card by card
Upgraded slot: None
Current upgrading slot: None
Current version list:
boot: 7.1.070, Test 0001015
system: 7.1.070, Test 0001015
feature1: 7.1.070, Test 0001015
Current software images:
flash:/boot-t0001015.bin
flash:/system-t0001015.bin
flash:/feature1-t0001015.bin
# 在单成员设备情况下，执行issu load命令后，在全局主用主控板上显示ISSU状态。（IRF模式）
<Sysname> display issu state
ISSU state: Loaded
Compatibility: Compatible
Work state: Normal
Upgrade method: Card by card
Upgraded slot:
chassis 1 slot 1
Current upgrading slot: None
Previous version list:
boot: 7.1.070, Test 0001015
system: 7.1.070, Test 0001015
feature1: 7.1.070, Test 0001015
Previous software images:
flash:/boot-t0001015.bin
flash:/system-t0001015.bin
flash:/feature1-t0001015.bin
Upgrade version list:
boot: 7.1.070, Test 0001016
system: 7.1.070, Test 0001016
feature1: 7.1.070, Test 0001016
Upgrade software images:
flash:/boot-t0001016.bin
flash:/system-t0001016.bin
flash:/feature1-t0001016.bin
# 在多成员设备情况下，执行issu load命令后，在原主设备上显示ISSU状态。（IRF模式）
<Sysname> display issu state
ISSU state: Loaded
Compatibility: Incompatible
Work state: Independent active
Upgrade method: Chassis by chassis
Upgraded chassis:
chassis 2
Current upgrading chassis: None
Previous version list:
boot: 7.1.070, Test 0001015
system: 7.1.070, Test 0001015
patch1: 7.1.070, Test 0001015
Previous software images:
flash:/boot-t0001015.bin
flash:/system-t0001015.bin
flash:/patch1-t0001015.bin
Upgrade version list:
boot: 7.1.070, Test 0001016
system: 7.1.070, Test 0001016
patch1: 7.1.070, Test 0001016
Upgrade software images:
flash:/boot-t0001016.bin
flash:/system-t0001016.bin
flash:/patch1-t0001016.bin
表1-6 display issu state命令显示信息描述表
|
字段 |
描述 |
|
ISSU state |
ISSU升级状态，取值可能为： · Init：表示还没有开始ISSU升级或者ISSU升级已经完成 · Loading：表示正在执行issu load操作 · Loaded：表示issu load操作完成 · Switching：表示正在执行issu run switchover操作 · Switchover：表示issu run switchover操作完成 · Accepted：表示issu accept操作完成 · Committing：表示正在执行issu commit操作 · Rollbacking：表示系统正在回滚中 · Unknown：在非原主用主控板上查看，表示设备正在升级过程中 |
|
Compatibility |
版本兼容性检查结果，取值可能为： · Compatible：表示兼容升级 · Incompatible：表示不兼容升级 · Unknown：没有升级 |
|
Work state |
设备的工作模式，取值可能为： · Normal：表示正常模式 · Independent active：表示独立主控模式。当升级到不兼容版本时，先升级的备用主控板就会进入独立主控模式。该模式使得同一设备上的不同主控板可以运行不同的软件版本 |
|
Upgrade method |
升级方式，取值可能为： · Card by card：表示以主控板为单位进行升级，升级完一块主控板再升级另一块主控板 · Chassis by chassis： ¡ 在IRF中多成员设备运行的情况下，表示以成员设备为单位进行升级，先升级一台从设备，再升级原主设备和还没有升级的从设备（兼容升级） ¡ 在IRF中多成员设备运行的情况下，表示以成员设备为单位进行升级，先升级一台或多台从设备，再升级原主设备和还没有升级的从设备（不兼容升级） |
|
Upgraded slot |
完成升级的单板。取值为Unknown时，表示设备处于回滚过程中（独立运行模式） |
|
Current upgrading slot |
正在升级的单板。取值为Unknown时，表示设备处于回滚过程中（独立运行模式） |
|
Upgraded chassis |
完成升级的成员设备。取值为Unknown时，表示设备处于回滚过程中（IRF模式） |
|
Current upgrading chassis |
正在升级的成员设备。取值为Unknown时，表示设备处于回滚过程中（IRF模式）（单成员设备） |
|
Current version list |
设备没有升级，表示当前系统软件版本 |
|
Current software images |
设备没有升级，表示当前运行软件包的名称 |
|
Previous version list |
进行ISSU升级前的系统软件版本 Unknown：不兼容升级的时候，在非原主用主控板上查看，表示设备正在升级过程中 |
|
Previous software images |
进行ISSU升级前版本文件 Unknown：不兼容升级的时候，在非原主用主控板上查看，表示设备正在升级过程中 |
|
Upgrade version list |
正在ISSU升级的目标版本 Unknown：不兼容升级的时候，在非原主用主控板上查看，表示设备正在升级过程中 |
|
Upgrade software images |
正在ISSU升级中用到的目标文件 Unknown：不兼容升级的时候，在非原主用主控板上查看，表示设备正在升级过程中 |
【相关命令】
· issu accept
· issu commit
· issu load
· issu rollback
· issu run switchover
display version comp-matrix显示设备将采用的ISSU升级策略。
【命令】
display version comp-matrix file { boot filename | system filename | feature filename&<1-30> | patch filename&<1-30> } *
display version comp-matrix file ipe ipe-filename [ patch filename&<1-30> ]
【视图】
任意视图
【缺省用户角色】
network-admin
network-operator
【参数】
boot：Boot包。
system：System包。
feature：Feature包。
patch：补丁包。
filename&<1-30>：软件包的名称，形如filesystemname/filename.bin。该文件必须保存在设备任一文件系统的根目录下，该参数中必须包含文件系统的名称，从存储介质名称开始最多可输入63个字符。&<1-30>表示前面的参数最多可以输入30次。有关指定文件夹和文件详细介绍请参见“基础配置指导”中的“文件系统管理”。
ipe ipe-filename：IPE文件名，ipe-filename表示IPE文件的名称，形如filesystemname/filename.ipe。该文件必须保存在设备任一文件系统的根目录下，该参数中必须包含文件系统的名称，从存储介质名称开始最多可输入63个字符。有关指定文件夹和文件详细介绍请参见“基础配置指导”中的“文件系统管理”。
【使用指导】
只要设备上有一个软件包不兼容，均判定为不兼容升级方式，需要重启整个系统。
【举例】
# 显示设备将采用的ISSU升级策略（独立运行模式）
<Sysname> display version comp-matrix file feature flash:/feature1-t0001015.bin patch flash:/feature-patch1-t0001015.bin
Verifying the file flash:/feature1-t0001015.bin on slot 0.....Done.
Verifying the file flash:/feature-patch1-t0001015.bin on slot 0.....Done.
Slot Upgrade Way
0 Service Upgrade
1 Service Upgrade
2 Service Upgrade
Influenced service according to following table on slot 0:
flash:/feature1-t0001015.bin
Feature1
Influenced service according to following table on slot 2:
flash:/feature1-t0001015.bin
Feature1
Influenced service according to following table on slot 1:
flash:/feature1-t0001015.bin
Feature1
表1-7 display version comp-matrix命令显示信息描述表
|
字段 |
描述 |
|
Verifying the file flash:/xx.bin.....Done. |
验证文件是否合法 |
|
Influenced service according to following table |
如果升级，受影响的功能模块。只有版本兼容时，才会显示该信息 |
|
Incompatible upgrade |
如果升级指定的软件包，则升级的方式为不兼容升级 |
|
Upgrade Way |
兼容升级策略。只有版本兼容时，才会显示该信息。取值可能为： · Service Upgrade：表示服务级增量升级 · File Upgrade：表示文件级增量升级 · Reboot：表示通过重启方式升级 · Sequence Reboot：表示逐次重启方式升级 有关兼容升级的具体介绍请参见“基础配置指导”中的“ISSU配置” |
【相关命令】
· issu load
install abort命令用来取消正在执行中的激活或卸载操作。
【命令】
install abort [ job-id ]
【视图】
用户视图
【缺省用户角色】
network-admin
【参数】
job-id：任务ID。不指定该参数时，则取消正在执行中的所有激活和卸载操作。
【使用指导】
当用户执行install activate、install add、install commit、install deactivate、install remove或install rollback to命令时，系统会创建相应的任务。为了管理和监控这些任务，系统会给每个任务分配一个任务ID。一个任务ID代表一条命令。可以使用display install job命令来查看任务ID。
使用本命令取消正在进行的激活或卸载操作后，系统回退到操作前的状态。
【举例】
# 取消正在执行中的所有激活和卸载操作。
<Sysname> install abort
【相关命令】
· display install job
install activate命令用来激活或查看软件包。
【命令】
（独立运行模式）
install activate { boot filename | system filename | feature filename&<1-30> } * slot slot-number [ test ]
install activate patch filename { all | slot slot-number }
（IRF模式）
install activate { boot filename | system filename | feature filename&<1-30> } * chassis chassis-number slot slot-number [ test ]
install activate patch filename { all | chassis chassis-number slot slot-number }
【视图】
用户视图
【缺省用户角色】
network-admin
【参数】
boot：Boot包。
system：System包。
feature：Feature包。
patch：补丁包。该参数一次只能指定一个补丁包，但是可以通过多次执行此命令为设备激活多个补丁包。该参数既可以指定叠加补丁也可以指定非叠加补丁。叠加补丁最多可以安装30个；由于每个Boot、System和Feature包只能安装一个非叠加补丁，所以非叠加补丁最多只能同时安装16个。有关叠加补丁和非叠加补丁的详细解释请参见，“基础配置指导”的“软件升级”。
filename&<1-30>：软件包的名称，形如filesystemname/filename.bin。该文件必须保存在设备任一文件系统的根目录下，该参数中必须包含文件系统的名称，从存储介质名称开始最多可输入63个字符。&<1-30>表示前面的参数最多可以输入30次。有关指定文件夹和文件详细介绍请参见“基础配置指导”中的“文件系统管理”。
all：升级补丁包对应的所有单板。（独立运行模式）
all：升级补丁包对应的所有单板。（IRF模式）
slot slot-number：表示单板所在的槽位号。（独立运行模式）
slot slot-number：表示设备在IRF中的成员编号。
chassis chassis-number slot slot-number：chassis-number表示设备在IRF中的成员编号，slot-number表示单板所在的槽位号。（IRF模式）
test：查看指定软件包的升级策略。不带该参数时，表示直接执行升级操作。
【使用指导】
请先查看软件包版本发布说明书，如果某软件包需要License才能运行，且设备当前没有对应的有效的License时，需安装对应的License，再执行该命令。否则，会导致命令执行失败。
本命令可以指定一个或多个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命令。激活补丁包时，若使用install activate patch filename all命令同时激活所有硬件上的补丁包，则无需执行install commit命令，所有补丁包在设备重启后继续生效。
执行命令行时，如果filename不是存放在待升级主控板上的文件，则系统会先将该文件拷贝到待升级主控板上，再执行升级动作。
如果指定的slot参数为主用主控板所在的槽位号，则执行该命令，会同时升级主用主控板和业务板；如果指定的slot参数为备用主控板所在的槽位号，则执行该命令，只会升级备用主控板。（独立运行模式）
如果指定的chassis chassis-number slot slot-number参数为全局主用主控板所在的槽位号，则执行该命令，会同时升级该主控板和该主控板所在设备的所有业务板。如果指定的chassis chassis-number slot slot-number参数为全局备用主控板所在的槽位号，则执行该命令，只会升级该主控板。（IRF模式）
从设备重启后，会自动批量备份主设备的配置和状态数据。请使用display system stable state命令查看设备是否处于稳定状态。只有System State处于Stable状态，才能执行该命令。否则，命令执行失败。关于display system stable state命令的详细介绍请参见“基础配置命令参考”中的“设备管理”。（IRF模式）
【举例】
# 显示备用主控板1上的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。
# 激活备用主控板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的1号单板（全局备用主控板）上的Patch包patch1.bin。（IRF模式）
<Sysname> install activate patch flash:/patch1.bin chassis 1 slot 1
Copying file flash:/patch1.bin to chassis1#slot1#flash:/patch1.bin......Done.
Verifying the file flash:/patch1.bin on chassis 1 slot 1.....Done.
This operation might take several minutes, please wait...Done.
表1-8 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：表示通过重启方式升级 · Sequence Reboot：表示逐次重启方式 有关兼容升级的具体介绍请参见“基础配置指导”中的“ISSU配置” |
|
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
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.
install commit命令用来确认软件包更改。
【命令】
install commit
【视图】
用户视图
【缺省用户角色】
network-admin
【使用指导】
请先查看软件包版本发布说明书，如果某软件包需要License才能运行，且设备当前没有对应的有效的License时，需安装对应的License，再执行该命令。否则，会导致命令执行失败。
该命令会将补丁包文件添加到系统当前使用的软件包列表：
· 如果系统使用了主用软件包启动，该命令会将补丁包文件添加到主用软件包列表中。
· 如果系统使用了备用软件包启动，该命令会将补丁包文件添加到备用软件包列表中。
只有在进行如下情况的配置修改设备当前的软件包列表时才需要执行本命令用来确认软件包更改：
· 执行install activate命令，且为增量升级方式时
· 执行install deactivate命令时
· 执行install rollback命令时
当执行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
Current software images on slot 2:
flash:/boot.bin
flash:/system.bin
【相关命令】
· install activate
· install deactivate
· install rollback
install deactivate命令用来卸载Feature包或补丁包。
【命令】
（独立运行模式）
install deactivate feature filename&<1-30> slot slot-number
install deactivate patch filename { all | slot slot-number }
（IRF模式）
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：表示安装了该补丁包的所有单板。（IRF模式）
slot slot-number：表示单板所在的槽位号。（独立运行模式）
chassis chassis-number slot slot-number：chassis-number表示设备在IRF中的成员编号，slot-number表示单板所在的槽位号。（IRF模式）
【使用指导】
从设备重启后，会自动批量备份主设备的配置和状态数据。请使用display system stable state命令查看设备是否处于稳定状态。只有System State处于Stable状态，才能执行该命令。否则，命令执行失败。关于display system stable state命令的详细介绍请参见“基础配置命令参考”中的“设备管理”。
该命令只能对已经激活的软件包进行卸载操作。使用本命令卸载指定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
This operation might take several minutes, please wait...Done.
# 卸载成员设备1的1号槽位单板上的patch包route-patch.bin。（IRF模式）
<Sysname> install deactivate patch flash:/route-patch.bin chassis 1 slot 1
This operation might take several minutes, please wait...Done.
【相关命令】
· display install active
· display install inactive
install remove命令用来删除没有激活的软件包。
【命令】
（独立运行模式）
install remove [ slot slot-number ] { filename | inactive }
（IRF模式）
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中的所有单板。（IRF模式）
inactive：表示将删除指定文件系统根目录下、没有被激活的所有软件包。
【使用指导】
执行该命令后，指定的软件包将从设备上被彻底删除，用户将不能使用该软件包进行回滚或回退操作。
【举例】
# 删除软件包flash:/feature1.bin。
<Sysname> install remove flash:/feature1.bin
install rollback to命令用来回滚到指定的回滚点，即按回滚点上记录的信息，进行回滚操作。
【命令】
install rollback to { point-id | original }
【视图】
用户视图
【缺省用户角色】
network-admin
【参数】
point-id：回滚点的编号，当系统中至少存在两个回滚点的时候，才能输入该参数。可以用display install rollback命令查看系统中存在的回滚点。
original：回滚到ISSU升级初始状态。
【使用指导】
每次激活或者卸载软件包之后，系统将这些变化记录为回滚点。通过回滚功能，可将系统回滚到某个历史状态，或者恢复到ISSU升级初始状态。
当升级方式为增量升级时，软件包回滚只在设备本次运行过程中生效，用户只有通过install commit命令确认软件包的更改后，才能使此次的回滚操作在系统重启后生效。系统最多支持50个回滚点，当回滚点超过最大值时，旧的回滚点会被删除，新的回滚点会被保存。
当升级方式为重启升级时，系统不会保留任何回滚点，只支持回滚到系统升级初始状态。
补丁包不支持回滚操作。
【举例】
# 回滚到回滚点1。
<Sysname> install rollback to 1
This operation might take several minutes, please wait...Done.
# 回滚到ISSU升级的初始状态。可通过观察active列表和回滚点的变化看出执行的结果。
<Sysname> display install active
Active packages on slot 1:
flash:/boot-t0001015.bin
flash:/system-t0001015.bin
flash:/feature1-t0001015.bin
<Sysname> display install rollback
Install rollback information 1 on slot 1:
Updating from no package
to flash:/feature1-t0001015.bin.
以上显示信息表明，当前激活的包有三个，但是确认的只有两个，回滚点1是激活了flash:/feature1-t0001015.bin。
<Sysname> install rollback to original
This operation might take several minutes, please wait...Done.
<Sysname> display install active
Active packages on slot 1:
flash:/boot-t0001015.bin
flash:/system-t0001015.bin
<Sysname> display install committed
Committed packages on slot 1:
flash:/boot-t0001015.bin
flash:/system-t0001015.bin
执行install rollback to original命令后，设备运行的软件集恢复到ISSU升级初始状态，flash:/feature1-t0001015.bin被卸载。
【相关命令】
· display install rollback
install verify命令用来执行对软件包状态、完整性和一致性的检验。
【命令】
install verify
【视图】
用户视图
【缺省用户角色】
network-admin
【使用指导】
为了保证设备进行ISSU升级之后能够正常运行，需要执行本命令对软件包进行如下检验：
完整性：检验Boot包、System包和Feature包的完整性。
一致性：检验系统内各激活的软件包列表的差异，以方便用户知道系统内各软件包版本是否一致。
软件包状态：检查各设备上激活的软件包列表和确认的软件包列表之间的差异，以方便用户知道是否有未确认的软件包。
使用该命令，能帮助用户进行软件包检查：
· 当系统提示软件包不完整时，请重新下载并安装软件包。
· 当系统提示软件包不一致时，请使用install activate、install deactivate以及install commit命令来确保它们的一致。
【举例】
# 检验设备上软件包状态、完整性和一致性信息。（独立运行模式）
<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.
# 检验设备上软件包状态、完整性和一致性信息。（IRF模式）
<Sysname> install verify
Active packages on chassis 1 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 chassis 1 slot 1:
Start to check active package completeness.
Verifying the file flash:/boot-t0001015.bin on chassis 1 slot 1.....................Done.
flash:/boot-t0001015.bin verification successful.
Verifying the file flash:/system-t0001015.bin on chassis 1 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 chassis 2 slot 1:
Start to check active package completeness.
Verifying the file flash:/boot-t0001015.bin on chassis 2 slot 1.....................Done.
flash:/boot-t0001015.bin verification successful.
Verifying the file flash:/system-t0001015.bin on chassis 2 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.
issu accept命令用来确认ISSU兼容升级，接受已升级的软件版本，并删除回滚定时器。
【命令】
issu accept
【视图】
用户视图
【缺省用户角色】
network-admin
【使用指导】
执行本命令后，系统会删除回滚定时器，本次ISSU升级过程中不会再进行自动回滚，用户可以执行issu rollback命令进行手动回滚。
ISSU不兼容升级时，不需要执行该命令。
【举例】
# 版本兼容情况下，确认升级步骤。
<Sysname> issu accept
【相关命令】
· issu load
· issu run switchover
issu commit命令用来对原主用主控板进行兼容版本升级。（独立运行模式）
对于单成员设备双主控的情况，issu commit命令用来对原主用主控板进行兼容版本升级。（IRF模式）
对于多成员设备的情况，issu commit命令用来对原主设备及未升级的从设备进行兼容版本升级。（IRF模式）
【命令】
（独立运行模式）
issu commit slot slot-number
（IRF模式）（单成员设备）
issu commit chassis chassis-number slot slot-number
（IRF模式）（多成员设备）
issu commit chassis chassis-number
【视图】
用户视图
【缺省用户角色】
network-admin
【参数】
slot slot-number：原主用主控板所在的槽位号。（独立运行模式）
chassis chassis-number slot slot-number：原主用主控板所在的槽位号。（IRF模式）（单成员设备）
chassis chassis-number：待升级的原主设备以及其它从设备的成员编号。（IRF模式）（多成员设备）
【使用指导】
从设备重启后，会自动批量备份主设备的配置和状态数据。请使用display system stable state命令查看设备是否处于稳定状态。只有System State处于Stable状态，才能执行该命令。否则，命令执行失败。关于display system stable state命令的详细介绍请参见“基础配置命令参考”中的“设备管理”。
对于单成员设备双主控或分布式设备独立运行模式的情况，升级完成后ISSU回到初始状态。执行此命令后，不能再通过ISSU回滚命令或者回滚定时器进行回滚操作。（独立运行模式）
对于多成员设备的情况，所有成员设备完成升级后，本次升级结束，ISSU回到初始状态。执行此命令后，不能再通过ISSU回滚命令或者回滚定时器进行回滚操作。如果有多个成员设备需要通过issu commit命令进行升级，需要等到一个成员设备重启、重新加入IRF后再进行下一个成员设备的升级，否则可能造成升级错误。（IRF模式）
【举例】
# 在双主控板，版本兼容情况下，升级原主用主控板。（独立运行模式）
<Sysname> issu commit slot 0
Upgrade summary according to following table:
flash:/feature1.bin
Running Version New Version
Test 0001015 Test 0001016
Slot Upgrade Way
0 Service Upgrade
Upgrading software images to compatible versions. Continue? [Y/N]:y
This operation might take several minutes, please wait...Done.
# 在单主控板，版本兼容情况下，确认原主用主控板的升级。（独立运行模式）
<Sysname> issu commit slot 0
# 在多成员设备，版本兼容情况下，升级原主设备（假设成员编号为3）和其他成员（假设成员编号为4和1）。（IRF模式）
<Sysname> issu commit chassis 3
Copying file flash:/feature1.bin to chassis3#slot1#flash:/feature1.bin...Done.
Verifying the file flash:/feature1.bin on chassis 3 slot 1..............Done.
Upgrade summary according to following table:
flash:/feature1.bin
Running Version New Version
Alpha 7122 Alpha 7123
Chassis Slot Upgrade Way
3 0 Service Upgrade
3 1 Service Upgrade
3 2 Service Upgrade
3 3 Service Upgrade
3 4 Service Upgrade
Upgrading software images to compatible versions. Continue? [Y/N]:y
This operation might take several minutes, please wait...Done.
<Sysname> issu commit chassis 4
Copying file flash:/feature1.bin to chassis4#slot0#flash:/feature1.bin...Done.
Verifying the file flash:/feature1.bin on chassis 4 slot 0..............Done.
Copying file flash:/feature1.bin to chassis4#slot1#flash:/feature1.bin...Done.
Verifying the file flash:/feature1.bin on chassis 4 slot 1..............Done
Upgrade summary according to following table:
flash:/feature1.bin
Running Version New Version
Test 0001015 Test 0001016
Chassis Slot Upgrade Way
4 0 Service Upgrade
4 1 Service Upgrade
4 2 Service Upgrade
4 3 Service Upgrade
4 4 Service Upgrade
Upgrading software images to compatible versions. Continue? [Y/N]:y
This operation might take several minutes, please wait...Done.
<Sysname> issu commit chassis 1
Copying file flash:/feature1.bin to chassis1#slot0#flash:/feature1.bin...Done.
Verifying the file flash:/feature1.bin on chassis 1 slot 0..............Done.
Copying file flash:/feature1.bin to chassis1#slot1#flash:/feature1.bin...Done.
Verifying the file flash:/feature1.bin on chassis 1 slot 1..............Done.
Upgrade summary according to following table:
flash:/feature1.bin
Running Version New Version
Test 0001015 Test 0001016
Chassis Slot Upgrade Way
1 0 Service Upgrade
1 1 Service Upgrade
1 2 Service Upgrade
1 3 Service Upgrade
1 4 Service Upgrade
Upgrading software images to compatible versions. Continue? [Y/N]:y
This operation might take several minutes, please wait...Done.
# 在单成员设备双主控板，版本兼容情况下，升级原主用主控板。（IRF模式）
<Sysname> issu commit chassis 1 slot 0
Verifying the file flash:/feature1.bin on chassis 1 slot 1..............Done.
Upgrade summary according to following table:
flash:/feature1.bin
Running Version New Version
Test 0001015 Test 0001016
Chassis Slot Upgrade Way
1 0 Service Upgrade
Upgrading software images to compatible versions. Continue? [Y/N]:y
This operation might take several minutes, please wait...Done.
# 在单成员设备单主控板，版本兼容情况下，确认升级。（IRF模式）
<Sysname> issu commit chassis 1 slot 0
本命令显示信息的描述请参见表1-9。
【相关命令】
· issu accept
· issu load
· issu run switchover
issu load命令用来升级备用主控板的启动软件包并将备用主控板的主用下次启动软件包设置为指定的软件包。（独立运行模式）（IRF模式）（单成员设备）
issu load命令用来升级从设备的启动软件包并将从设备的主用下次启动软件包设置为指定的软件包。（IRF模式）（多成员设备）
【命令】
（独立运行模式）
issu load file { boot filename | system filename | feature filename&<1-30> | patch filename&<1-30> } * slot slot-number [ reboot ]
issu load file ipe ipe-filename slot slot-number [ patch filename&<1-30> ] [ reboot ]
（IRF模式）（单成员设备）
issu load file { boot filename | system filename | feature filename&<1-30> | patch filename&<1-30> } * chassis chassis-number slot slot-number [ reboot ]
issu load file ipe ipe-filename [ patch filename&<1-30> ] chassis chassis-number slot slot-number [ reboot ]
（IRF模式）（多成员设备）
issu load file { boot filename | system filename | feature filename&<1-30> | patch filename&<1-30> } * chassis chassis-number&<1-3> [ reboot ]
issu load file ipe ipe-filename [ patch filename&<1-30> ] chassis chassis-number&<1-3> [ reboot ]
【视图】
用户视图
【缺省用户角色】
network-admin
【参数】
boot：Boot包。
system：System包。
feature：Feature包。最多可指定30个。
patch：补丁包。该参数既可以指定叠加补丁也可以指定非叠加补丁。叠加补丁最多可以安装30个；由于每个Boot、System和Feature包只能安装一个非叠加补丁，所以非叠加补丁最多只能同时安装16个。有关叠加补丁和非叠加补丁的详细解释请参见，“基础配置指导”的“软件升级”。
filename&<1-30>：表软件包的名称，形如filesystemname/filename.bin。该文件必须保存在主用主控板/全局主用主控板任一文件系统的根目录下，该参数中必须包含文件系统的名称，从存储介质名称开始最多可输入63个字符。&<1-30>表示前面的参数最多可以输入30次。有关指定文件夹和文件详细介绍请参见“基础配置指导”中的“文件系统管理”。
ipe ipe-filename：IPE文件，ipe-filename表示IPE文件的名称，形如filesystemname/filename.ipe。该文件必须保存在主用主控板/全局主用主控板任一文件系统的根目录下，该参数中必须包含文件系统的名称，从存储介质名称开始最多可输入63个字符。有关指定文件夹和文件详细介绍请参见“基础配置指导”中的“文件系统管理”。
slot slot-number：表示备用主控板的槽位号。如果设备只有一块主控板，则输入主用主控板的槽位号，用来完成整个设备的升级。（独立运行模式）
chassis chassis-number slot slot-number：如果IRF中只有一块主控板，则输入主用主控板所在设备的成员编号以及该主控板所在的槽位号，用来完成整个IRF的升级；如果设备上有两块主控板，则输入备用主控板所在设备的成员编号以及备用主控板所在的槽位号。（IRF模式）（单成员设备）
chassis chassis-number：表示从设备在IRF中的成员编号。&<1-3>表示前面的参数最多可以输入3次。（IRF模式）（多成员设备）
· 当要升级的软件包的版本和设备当前运行的软件包的版本兼容时，只允许输入一个chassis-number；
· 当要升级的软件包的版本和设备当前运行的软件包的版本不兼容时，可以输入多个chassis-number，一次升级多个成员设备。
reboot：表示在版本兼容的情况下，如果决策出来的结果是文件级增量升级、服务级增量升级则强制使用兼容重启升级重启单板以完成升级。不指定该参数时，系统会按照决策结果进行升级。
【使用指导】
本命令可以指定一个或多个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包。
对于独立运行模式/IRF模式单成员设备， 输入该命令后，系统将自动执行以下操作：
· 进行版本兼容性检查。
· 确定升级策略。
· 按照升级策略进行升级主用主控板/备用主控板，并将主用主控板/备用主控板的主用下次启动软件包设置为issu load命令中指定的包。
对于IRF模式多成员设备， 输入该命令后，系统将自动执行以下操作：
· 进行版本兼容性检查。
· 确定升级策略。
· 按照升级策略进行升级从设备，并将从设备的主用下次启动软件包设置为issu load命令中指定的包。
从设备重启后，会自动批量备份主设备的配置和状态数据。请使用display system stable state命令查看设备是否处于稳定状态。只有System State处于Stable状态，才能执行该命令。否则，命令执行失败。关于display system stable state命令的详细介绍请参见“基础配置命令参考”中的“设备管理”。（IRF模式）
【举例】
# 在双主控板，版本兼容情况下，使用flash:/feature1.bin升级备用主控板1上的Feature包，并安装Feature包的补丁包。（独立运行模式）
<Sysname> issu load file feature flash:/feature1.bin patch flash:/feature1-patch1.bin slot 1
This operation will delete the rollback point information for the previous upgrade and maybe get unsaved configuration lost. Continue? [Y/N]:Y
Verifying the file flash:/feature1.bin on slot 0...Done.
Verifying the file flash:/feature1-patch1.bin on slot 0...Done.
Copying file flash:/feature1.bin to slot1#flash:/feature1.bin......Done.
Copying file flash:/feature1-patch1.bin to slot1#flash:/feature1-patch1.bin......Done.
Verifying the file flash:/feature1.bin on slot 1...Done.
Verifying the file flash:/feature1-patch1.bin on slot 1...Done.
Identifying the upgrade methods….Done.
Upgrade summary according to following table:
flash:/feature1.bin
Running Version New Version
Test 0001015 Test 0001016
flash:/feature1-patch1.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.
# 在双主控板，增量升级情况下，使用flash:/feature1.bin升级备用主控板1上的Feature包，并安装Feature包的补丁包，带reboot参数。（独立运行模式）
<Sysname> issu load file feature flash:/feature1.bin slot 1 patch flash:/feature1-patch1.bin reboot
This operation will delete the rollback point information for the previous upgrade and maybe get unsaved configuration lost. Continue? [Y/N]:Y
Verifying the file flash:/feature1.bin on slot 0...Done.
Verifying the file flash:/feature1-patch1.bin on slot 0...Done.
Copying file flash:/feature1.bin to slot1#flash:/feature1.bin......Done.
Copying file flash:/feature1-patch1.bin to slot1#flash:/feature1-patch1.bin......Done.
Verifying the file flash:/feature1.bin on slot 1...Done.
Verifying the file flash:/feature1-patch1.bin on slot 1...Done.
Identifying the upgrade methods….Done.
Upgrade summary according to following table:
flash:/feature1.bin
Running Version New Version
Test 0001015 Test 0001016
flash:/feature1-patch1.bin
Running Version New Version
None Test 0001016
Slot Upgrade Way
1 Reboot
Upgrading software images to compatible versions. Continue? [Y/N]:y
This operation might take several minutes, please wait...Done.
# 在双主控板，版本不兼容情况下，使用flash:/feature1.bin升级备用主控板1上的Feature包，并安装Feature包的补丁包。（独立运行模式）
<Sysname> issu load file feature flash:/feature1.bin patch flash:/feature1-patch1.bin slot 1
This operation will delete the rollback point information for the previous upgrade and maybe get unsaved configuration lost. Continue? [Y/N]:Y
Verifying the file flash:/feature1.bin on slot 0...Done.
Verifying the file flash:/feature1-patch1.bin on slot 0...Done.
Copying file flash:/feature1.bin to slot1#flash:/feature1.bin......Done.
Copying file flash:/feature1-patch1.bin to slot1#flash:/feature1-patch1.bin......Done.
Verifying the file flash:/feature1.bin on slot 1...Done.
Verifying the file flash:/feature1-patch1.bin on slot 1...Done.
Identifying the upgrade methods….Done.
Upgrade summary according to following table:
flash:/feature1.bin
Running Version New Version
Test 0001015 Test 0001016
flash:/feature1-patch1.bin
Running Version New Version
None Test 0001016
Slot Upgrade Way
1 Reboot
Upgrading software images to incompatible versions. Continue? [Y/N]:y
This operation might take several minutes, please wait...Done.
# 在单主控板，版本兼容情况下，使用flash:/feature1.bin升级slot 0上的Feature包，并给feature包打补丁。（独立运行模式）
<Sysname>issu load file feature flash:/feature1.bin patch flash:/feature1-patch1.bin slot 0
This operation will delete the rollback point information for the previous upgrade and maybe get unsaved configuration lost. Continue? [Y/N]:Y
Verifying the file flash:/feature1.bin on slot 0...Done.
Verifying the file flash:/feature1-patch1.bin on slot 0...Done.
Identifying the upgrade methods….Done.
Upgrade summary according to following table:
flash:/feature1.bin
Running Version New Version
Test 0001015 Test 0001016
flash:/feature1-patch1.bin
Running Version New Version
None Test 0001016
Slot Upgrade Way
0 Service Upgrade
2 Service Upgrade
3 Service Upgrade
4 Service Upgrade
Upgrading software images to compatible versions. Continue? [Y/N]:y
This operation might take several minutes, please wait...Done.
# 在单主控板，增量升级情况下，使用flash:/feature1.bin升级slot 0上的Feature包，并给feature包打补丁，带reboot参数。（独立运行模式）
<Sysname>issu load file feature flash:/feature1.bin patch flash:/feature1-patch1.bin slot 0 reboot
This operation will delete the rollback point information for the previous upgrade and maybe get unsaved configuration lost. Continue? [Y/N]:Y
Verifying the file flash:/feature1.bin on slot 0...Done.
Verifying the file flash:/feature1-patch1.bin on slot 0...Done.
Identifying the upgrade methods….Done.
Upgrade summary according to following table:
flash:/feature1.bin
Running Version New Version
Test 0001015 Test 0001016
flash:/feature1-patch1.bin
Running Version New Version
None Test 0001016
Slot Upgrade Way
0 Reboot
2 Reboot
3 Reboot
4 Reboot
Upgrading software images to compatible versions. Continue? [Y/N]:y
This operation might take several minutes, please wait...Done.
# 在单主控板，版本不兼容情况下，使用flash:/feature1.bin升级主用主控板slot 0上的Feature包，并给feature包打补丁。（独立运行模式）
<Sysname> issu load file feature flash:/feature1.bin patch flash:/feature1-patch1.bin slot 0
This operation will delete the rollback point information for the previous upgrade and maybe get unsaved configuration lost. Continue? [Y/N]:Y
Verifying the file flash:/feature1.bin on slot 0...Done.
Verifying the file flash:/feature1-patch1.bin on slot 0...Done.
Identifying the upgrade methods….Done.
Upgrade summary according to following table:
flash:/feature1.bin
Running Version New Version
Test 0001015 Test 0001016
flash:/feature-patch1.bin
Running Version New Version
None Test 0001016
Slot Upgrade Way
0 Reboot
2 Reboot
3 Reboot
4 Reboot
Upgrading software images to incompatible versions. Continue? [Y/N]:y
This operation might take several minutes, please wait...Done.
# 使用flash:/version.ipe及其补丁文件升级从设备2上的IPE文件。（IRF模式）
<Sysname> issu load file ipe flash:/version-t0001015.ipe patch flash:/system-patch1.bin chassis 2
This operation will delete the rollback point information for the previous upgrade and maybe get unsaved configuration lost. Continue? [Y/N]:y
Verifying image file flash:/version-t0001015.ipe on chassis 2 slot 0.................Done.
Verifying image file flash:/version-t0001015.ipe on chassis 2 slot 1.................Done.
Decompressing file BOOT-T0001015.bin to flash:/BOOT-E1133.bin.............Done.
Decompressing file SYSTEM-T0001015.bin to flash:/SYSTEM-E1133.bin...........Done.
Decompressing file system-patch1.bin to flash:/system-patch1.bin...........Done.
Decompression completed.
Do you want to delete flash:/version-t0001015.ipe now? [Y/N]:n
Upgrade summary according to following table:
flash:/BOOT-T0001015.bin
Running Version New Version
Test 0001015 Test 0001016
flash:/SYSTEM-E1133.bin
Running Version New Version
Test 0001015 Test 0001016
flash:/system-patch1.bin
Running Version New Version
None Test 0001016
Chassis Slot Upgrade Way
2 0 Reboot
2 1 Reboot
Upgrading software images to compatible versions. Continue? [Y/N]:y
This operation might take several minutes, please wait...Done.
表1-9 issu load命令显示信息描述表
|
字段 |
描述 |
|
This operation will delete the rollback point information for the previous upgrade and maybe get unsaved configuration lost. Continue? [Y/N] |
当前操作会删除上一次ISSU升级的日志信息和回滚点，并且未保存的配置可能会丢失，询问用户是否继续执行升级操作 |
|
Verifying the file flash:/xx.bin................................Done. |
验证文件是否合法 |
|
Decompressing file A to B...........................Done. |
将文件从位置A解压缩到位置B。只有使用IPE文件升级时，才显示该信息 |
|
Copying file B to C......Done. |
将文件从位置B拷贝到位置C。当配置备用主控板时才有该提示信息（独立运行模式） 将文件从位置B拷贝到位置C。当配置全局备用主控板时才有该提示信息（IRF模式） |
|
Identifying the upgrade methods….Done. |
获取升级策略 |
|
Upgrade summary according to following table |
升级信息摘要 |
|
Running Version |
设备当前运行的相同类型软件包的产品版本号 |
|
New Version |
将要升级的软件包的产品版本号 |
|
Upgrade Way |
升级策略，取值可能为： · Service Upgrade：表示服务级增量升级 · File Upgrade：表示文件级增量升级。 · Reboot：表示通过重启方式升级 · Sequence Reboot：表示逐次重启方式 有关兼容升级的具体介绍请参见“基础配置指导”中的“ISSU配置” |
|
Upgrading software images to compatible versions. Continue? [Y/N] |
询问用户是否执行兼容升级操作 |
|
Upgrading software images to incompatible versions. Continue? [Y/N] |
询问用户是否执行不兼容升级操作 |
|
This operation might take several minutes, please wait |
升级操作需要花费一定时间，请等待 |
|
Done. |
表示激活成功 |
|
Operation failed. |
表示激活失败 |
issu one-step命令用来一步完成ISSU升级。
【命令】
（独立运行模式）
issu one-step file { boot filename | system filename | feature filename&<1-30> | patch filename&<1-30> } * [ slot slot-number ] [ reboot ]
issu one-step file ipe ipe-filename [ patch filename&<1-30> ] [ slot slot-number ] [ reboot ]
（IRF模式）（单成员设备）
issu one-step file { boot filename | system filename | feature filename&<1-30> | patch filename&<1-30> } * [ chassis chassis-number slot slot-number ] [ reboot ]
issu one-step file ipe ipe-filename [ patch filename&<1-30> ] [ chassis chassis-number slot slot-number ] [ reboot ]
（IRF模式）（多成员设备）
issu one-step file { boot filename | system filename | feature filename&<1-30> | patch filename&<1-30> } * [ chassis chassis-number&<1-3> ] [ reboot ]
issu one-step file ipe ipe-filename [ patch filename&<1-30> ] [ chassis chassis-number&<1-3> ] [ reboot ]
【视图】
用户视图
【缺省用户角色】
network-admin
【参数】
boot：Boot包。
system：System包。
feature：Feature包。最多可指定30个。
patch：补丁包。该参数既可以指定叠加补丁也可以指定非叠加补丁。叠加补丁最多可以安装30个；由于每个Boot、System和Feature包只能安装一个非叠加补丁，所以非叠加补丁最多只能同时安装16个。有关叠加补丁和非叠加补丁的详细解释请参见，“基础配置指导”的“软件升级”。
filename&<1-30>：表软件包的名称，形如filesystemname/filename.bin。该文件必须保存在主用主控板/全局主用主控板任一文件系统的根目录下，该参数中必须包含文件系统的名称，从存储介质名称开始最多可输入63个字符。&<1-30>表示前面的参数最多可以输入30次。有关指定文件夹和文件详细介绍请参见“基础配置指导”中的“文件系统管理”。
ipe ipe-filename：IPE文件，ipe-filename表示IPE文件的名称，形如filesystemname/filename.ipe。该文件必须保存在主用主控板/全局主用主控板任一文件系统的根目录下，该参数中必须包含文件系统的名称，从存储介质名称开始最多可输入63个字符。有关指定文件夹和文件详细介绍请参见“基础配置指导”中的“文件系统管理”。
slot slot-number：表示备用主控板的槽位号，该备用主控板将在设备升级后，成为新的主用主控板。如果设备只有一块主控板，则输入主用主控板的槽位号，用来完成整个设备的升级。不指定该参数时，表示升级后的主用主控板由系统自动指定。（独立运行模式）
chassis chassis-number slot slot-number：如果IRF中只有一块主控板，则输入主用主控板所在设备的成员编号及槽位号，用来完成整个IRF的升级；如果设备上有两块主控板，则输入备用主控板所在设备的成员编号及槽位号。该主控板将在IRF升级后，成为新的全局主用主控板。不指定该参数时，表示升级后的主用主控板由系统自动指定。（IRF模式）（单成员设备）
chassis chassis-number：表示从设备在IRF中的成员编号。&<1-3>表示前面的参数最多可以输入3次。（IRF模式）（多成员设备）
当要升级的软件包的版本和设备当前运行的软件包的版本兼容时，只允许输入一个chassis-number；
当要升级的软件包的版本和设备当前运行的软件包的版本不兼容时，可以输入多个chassis-number，一次升级多个成员设备，系统会自动选择一个成员设备作为新的主设备。
不指定该参数时，表示升级后的主设备由系统自动指定。
reboot：表示在版本兼容的情况下，如果决策出来的结果是文件级增量升级、服务级增量升级则强制使用兼容重启升级重启单板以完成升级。不指定该参数时，系统会按照决策结果进行升级。
【使用指导】
执行本命令后，系统将自动完成ISSU升级，升级过程中将不能执行回滚及其他任何操作。
命令指定的目标版本软件包必须是同样支持ISSU一键式升级的版本软件包。
本命令可以指定一个或多个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包。
从设备重启后，会自动批量备份主设备的配置和状态数据。请使用display system stable state命令查看设备是否处于稳定状态。只有System State处于Stable状态，才能执行该命令。否则，命令执行失败。关于display system stable state命令的详细介绍请参见“基础配置命令参考”中的“设备管理”。（IRF模式）
【举例】
# 一步完成ISSU升级：使用flash:/boot.bin升级Boot包，使用flash:/system.bin升级System包，使用flash:/feature1.bin升级Feature包。
<Sysname> issu one-step file boot flash:/boot.bin system flash:/system.bin feature flash:/feature1.bin
This operation will delete the rollback point information for the previous upgrade and maybe get unsaved configuration lost. Continue? [Y/N]:Y
This operation might take several minutes, please wait...Done.
# 一步完成ISSU升级：使用flash:/boot.bin升级Boot包，使用flash:/system.bin升级System包，使用flash:/feature1.bin升级Feature包，升级过程中强制采用兼容重启升级方式。
<Sysname> issu one-step file boot flash:/boot.bin system flash:/system.bin feature flash:/feature1.bin flash:/feature1.bin reboot
This operation will delete the rollback point information for the previous upgrade and maybe get unsaved configuration lost. Continue? [Y/N]:Y
This operation might take several minutes, please wait...Done.
表1-10 表1-11 issu one-step命令显示信息描述表
|
字段 |
描述 |
|
This operation will delete the rollback point information for the previous upgrade and maybe get unsaved configuration lost. Continue? [Y/N] |
当前操作会删除上一次ISSU升级的日志信息和回滚点，并且未保存的配置可能会丢失，询问用户是否继续执行升级操作 |
issu quit命令用来强制结束ISSU升级流程。
【命令】
issu quit
【视图】
系统视图
【缺省用户角色】
network-admin
【使用指导】
ISSU升级异常是指设备的ISSU状态不是Init状态，而升级已经停止；或者设备进入Init状态，但升级并未完成。
执行install activate、issu load命令的ISSU升级流程中可能出现ISSU升级异常。
执行此命令将结束整个ISSU流程，系统恢复到Init状态。当ISSU升级异常且不能再次进行升级或回滚操作时，可以使用本命令强制结束ISSU升级流程。
强制结束ISSU升级流程之后，系统的升级可能并未完成。请检查系统状态是否符合ISSU升级要求。若系统状态符合ISSU升级要求，可以使用boot-loader或者install命令恢复版本为初始状态之后尝试重新升级。若重新升级再次失败，请联系技术支持。
【举例】
# 强制结束ISSU升级流程。
<Sysname> system-view
[Sysname] issu quit
This command stops the ongoing ISSU process. Execute this command only under the guidance of the technical support. Continue? [Y/N]:y
Succeeded.
【相关命令】
· install activate
· issu load
issu rollback命令用来回滚到升级前的版本。
【命令】
issu rollback
【视图】
用户视图
【缺省用户角色】
network-admin
【使用指导】
设备支持自动回滚和手动回滚，自动回滚定时器的时长由issu rollback-timer命令配置；手工回滚由issu rollback命令触发。
当ISSU升级状态为如下几种情况时，支持手工回滚：
· Loaded
· Switching（兼容升级）
· Switchover（兼容升级）
· Accepted
在重启升级的Switching状态下如果进行手工回滚或者发生自动回滚和在不兼容升级的Switching状态下发生自动回滚，则：（独立运行模式）
· 已升级的备用主控板重启，此时主用主控板可能因正在进行主备倒换重启而导致断流。
· 回滚只保证版本回到升级前，但不能保证主备状态和升级前一致。
建议不要在Switching状态下进行手工回滚，并且设置足够长的自动回滚定时器时长。
在重启升级的Switching状态下如果进行手工回滚或者发生自动回滚和在不兼容升级的Switching状态下发生自动回滚，将会导致如下现象：（IRF模式）
· 已升级的从设备重启，此时主用主设备可能因正在进行主备倒换重启而导致断流。
· 回滚只保证版本回到升级前，但不能保证主备状态和升级前一致。
建议不要在Switching状态下进行手工回滚，并且设置足够长的自动回滚定时器时长。
【举例】
# 回滚到升级之前的版本。
<Sysname> issu rollback
This command will quit the ISSU process and roll back to the previous version. Continue? [Y/N]:y
【相关命令】
· issu accept
· issu commit
· issu load
· issu run switchover
issu rollback-timer命令用来设置回滚定时器时长。
undo issu rollback-timer命令用来恢复缺省情况。
【命令】
issu rollback-timer minutes
undo issu rollback-timer
【缺省情况】
回滚定时器的时长为45分钟。
【视图】
系统视图
【缺省用户角色】
network-admin
【参数】
minutes：回滚定时器的时长，取值范围为0～120，单位为分钟。如果时长设置为0，则表示关闭自动回滚功能。
【使用指导】
设备只有在兼容版本升级时，满足如下条件的情况下才能启动回滚定时器：
· 存在多个成员设备的IRF系统。
· IRF模式下的单成员设备配备两块主控板。
· 独立运行模式下配备两块主控板。
兼容版本升级的情况下，执行issu run switchover命令后系统会自动启动回滚定时器。如果在指定的时间内（回滚定时器超时前）未执行issu accept或者issu commit命令，则系统会自动回滚到升级前的版本。
新设置的时长会在下次ISSU升级中生效。
【举例】
# 设置回滚定时器时长为50分钟。
<Sysname> system-view
[Sysname] issu rollback-timer 50
【相关命令】
· issu rollback
issu run switchover命令用来进行ISSU倒换。
【命令】
issu run switchover
【视图】
用户视图
【缺省用户角色】
network-admin
【使用指导】
(1) 独立运行模式
当设备上只有一块主控板并需要升级时，不需要使用此命令。
当设备上有两块主控板时，输入该命令后，系统在不同情况下将自动执行不同的操作：
· 兼容升级：增量升级时系统会将升级的进程进行进程级主备倒换，并升级业务板和网板；重启升级时系统会将当前主用主控板使用原版本重新启动，将刚使用issu load命令升级的备用主控板上倒换成主用主控板，并升级业务板和网板。
· 不兼容升级：当前主用主控板、业务板和网板以新版本重新启动，刚使用issu load命令升级的备用主控板倒换成主用主控板，原有主用主控板、业务板和网板重启完成后即完成升级过程。
(2) IRF模式
当设备上只有一个成员并且只有一个主控板且需要升级时，不需要使用此命令。
当设备上只有一个成员设备，多个主控板时，输入该命令后，系统在不同情况下将自动执行不同的操作：
· 兼容升级：增量升级时系统会将升级的进程进行进程级主备倒换，并升级业务板和网板；重启升级时系统会将当前主用主控板使用原版本重新启动，将刚使用issu load命令升级的备用主控板上倒换成主用主控板，并升级业务板和网板。
· 不兼容升级：当前主用主控板、业务板和网板以新版本重新启动，刚使用issu load命令升级的备用主控板倒换成主用主控板，原有主用主控板、业务板和网板重启完成后即完成升级过程。
当设备上有多个成员设备时，输入该命令后，系统在不同情况下将自动执行不同的操作：
· 兼容版本升级：增量升级时系统会对升级的进程进行了进程级主备倒换；重启升级时系统会将当前主设备的主控板使用原版本重新启动，将刚使用issu load命令升级完成的从设备选举为IRF的主设备。
· 不兼容版本升级：执行issu load后IRF分裂，生成两个的IRF。执行issu run switchover重启并升级原IRF，原IRF重启后加入新的IRF即完成升级过程，系统选择新IRF的主设备为合并后IRF的主设备。
从设备重启后，会自动批量备份主设备的配置和状态数据。请使用display system stable state命令查看设备是否处于稳定状态。只有System State处于Stable状态，才能执行该命令。否则，命令执行失败。关于display system stable state命令的详细介绍请参见“基础配置命令参考”中的“设备管理”。
兼容版本升级时，如果在回滚定时器超时时仍未执行issu accept或者issu commit命令，则系统会自动回滚到升级前的版本。
兼容版本升级时，如果业务板和网板无法使用增量升级， 业务板和网板会重启，并从新主控板加载最新的软件包，途经此业务板和网板的流量会中断，流量恢复时间是“业务板和网板启动时间+业务板和网板状态恢复时间”。
不兼容版本升级执行issu run switchover之后，即完成升级过程。
【举例】
# 在双主控板，版本兼容情况下，进行主备倒换，同时升级业务板和网板。（独立运行模式）
<Sysname> issu run switchover
Upgrade summary according to following table:
flash:/feature1.bin
Running Version New Version
Test 0001015 Test 0001016
Slot Switchover Way
0 Active standby process switchover
Slot Upgrade Way
2 Service Upgrade
3 Service Upgrade
4 Service Upgrade
Upgrading software images to compatible versions. Continue? [Y/N]:y
This operation might take several minutes, please wait...Done.
# 在双主控板，版本不兼容情况下，进行主备倒换，同时升级原主板、业务板和网板。（独立运行模式）
<Sysname> issu run switchover
Upgrade summary according to following table:
flash:/feature1.bin
Running Version New Version
Test 0001015 Test 0001016
Slot Upgrade Way
0 Reboot
2 Reboot
3 Reboot
4 Reboot
Upgrading software images to incompatible versions. Continue? [Y/N]:y
This operation might take several minutes, please wait...Done.
# 进行主备倒换。（IRF模式）
Upgrade summary according to following table:
flash:/boot-t0001015.bin
Running Version New Version
Test 0001015 Test 0001016
flash:/system-t0001015.bin
Running Version New Version
Test 0001015 Test 0001016
Chassis Slot Switchover Way
2 1 Global active standby MPU switchover
Upgrading software images to compatible versions. Continue? [Y/N]:y
This operation might take several minutes, please wait...Done.
表1-11 issu run switchover命令显示信息描述表
|
字段 |
描述 |
|
Switchover Way |
倒换方式，取值可能为： · Active standby process switchover：表示主备进程的倒换 · Active standby MPU switchover：表示主备主控板之间的倒换（独立运行模式） · Global active standby MPU switchover：表示全局主备主控板之间的倒换（IRF模式） |
|
其它字段 |
请参见表1-9 |
【相关命令】
· issu load
reset install log-history oldest命令用来清除ISSU日志。
【命令】
reset install log-history oldest log-number
【视图】
用户视图
【缺省用户角色】
network-admin
【参数】
log-number：ISSU日志的数量。
【使用指导】
执行本命令后，系统将按创建时间由早到晚的顺序清除指定数量的ISSU日志。
【举例】
# 清除2条最早的ISSU日志。
<Sysname> reset install log-history oldest 2
【相关命令】
· display install log
reset install rollback oldest命令用来清除ISSU回滚点。
【命令】
reset install rollback oldest point-id
【视图】
用户视图
【缺省用户角色】
network-admin
【参数】
point-id：系统存储的回滚点的编号。
【使用指导】
使用本命令，清除指定回滚点以及在此回滚点之前创建的所有回滚点。
【举例】
# 清除编号为2以及在此回滚点之前创建的所有回滚点。
<Sysname> reset install rollback oldest 2
【相关命令】
· display install rollback
不同款型规格的资料略有差异, 详细信息请向具体销售和400咨询。H3C保留在没有任何通知或提示的情况下对资料内容进行修改的权利!
支持
售前咨询
售后咨询
人工在线咨询
