01-基础配置命令参考

08-ISSU命令

1 ISSU

· 设备仅支持在IRF模式下使用ISSU功能。

· 目前设备运行在IRF模式下支持两个成员设备。

1.1 ISSU配置命令

1.1.1 display install active

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

【命令】

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

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

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

【举例】

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

<Sysname> display install active

Active packages on chassis 1 slot 1:

cfa0:/boot.bin

cfa0:/system.bin

cfa0:/feature.bin

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

<Sysname> display install active verbose

Active packages on chassis 1 slot 1:

cfa0:/boot.bin

[Package]

Vendor: XXX

Product: xxxx

Service name: boot

Platform version: 7.1.022

Product version: Test 2201

Supported board: mpu

[Component]

Component: boot

Description: boot package

cfa0:/system.bin

[Package]

Vendor: XXX

Product: xxxx

Service name: system

Platform version: 7.1.022

Product version: Test 2201

Supported board: mpu

[Component]

Component: system

Description: system package

cfa0:/feature.bin

[Package]

Vendor: XXX

Product: xxxx

Service name: test

Platform version: 7.1.022

Product version: Test 2201

Supported board: mpu

[Component]

Component: test

Description: test package

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

字段	描述
Active packages on chassis m slot n	某单板上处于激活状态的软件包的相关信息，其中m表示设备在IRF中的成员编号，n表示成员设备上该单板所在的槽位号
cfa0:/boot.bin	软件包的名称
[Package]	软件包的信息
Vendor	生产厂商
Product	产品名称
Service name	软件包所包含的服务名称： · 如果显示为boot，表示该软件包为Boot包 · 如果显示为system，表示该软件包为System包 · 如果显示为patch，表示该软件包为补丁包 · 如果显示为其它值，则表示该软件包为提供某项功能的Feature包
Platform version	平台软件版本号
Product version	产品软件版本号
Supported board	软件包支持的单板类型： · mpu表示主控板 · lc表示业务板 · sfc表示网板
[Component]	组件信息，表示软件包的组成部分
Component	组件的名称
Description	组件的描述信息

【相关命令】

· install active

1.1.2 display install backup

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

【命令】

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

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

【使用指导】

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

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

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

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

【举例】

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

<Sysname> display install backup

Backup startup software images on chassis 1 slot 1:

cfa0:/boot-a0201.bin

cfa0:/system-a0201.bin

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

<Sysname> display install backup verbose

Backup startup software images on slot 1:

cfa0:/boot-a0201.bin

[Package]

Vendor: H3C

Product: xxxx

Service name: boot

Platform version: 7.1

Product version: Beta 1330

Supported board: mpu

[Component]

Component: boot

Description: boot package

cfa0:/system-a0201.bin

[Package]

Vendor: H3C

Product: xxxx

Service name: system

Platform version: 7.1

Product version: Beta 1330

Supported board: mr, lc, sfc

[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 [ chassis chassis-number slot slot-number ] [ verbose ]

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

【使用指导】

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

【举例】

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

<Sysname> display install committed

Committed packages on slot 1:

cfa0:/boot-a0201.bin

cfa0:/system-a0201.bin

cfa0:/feature.bin

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

<Sysname> display install committed verbose

Committed packages on slot 1:

cfa0:/boot-a0201.bin

[Package]

Vendor: H3C

Product: xxxx

Service name: boot

Platform version: 7.1

Product version: Beta 1330

Supported board: mr, lc, sfc

[Component]

Component: boot

Description: boot package

cfa0:/system-a0201.bin

[Package]

Vendor: H3C

Product: xxxx

Service name: system

Platform version: 7.1

Product version: Beta 1330

Supported board: mr, lc, sfc

[Component]

Component: system

Description: system package

cfa0:/ssh-feature.bin

[Package]

Vendor: H3C

Product: xxxx

Service name: ssh

Platform version: 7.1

Product version: Beta 1330

Supported board: mr, lc, sfc

[Component]

Component: ssh

Description: ssh package

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

【相关命令】

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

· display install backup

1.1.4 display install inactive

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

【命令】

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

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

【举例】

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

<Sysname> display install inactive

Inactive packages on slot 1:

cfa0:/ssh-feature.bin

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

<Sysname> display install inactive verbose

Inactive packages on slot 1:

cfa0:/ssh-feature.bin

[Package]

Vendor: H3C

Product: XXXX

Service name: ssh

Platform version: 7.1

Product version: Beta 1330

Supported board: mr, lc, sfc

[Component]

Component: ssh

Description: ssh package

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

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文件必须放在存储介质的根目录下，文件名中必须含存储介质的名称，形如cfa0:/xx.ipe或者chassism#slotn#cfa0:/startup-boot.ipe，chassism#slotn用于指定全局备用主控板。

【举例】

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

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

Verifying the IPE file and the images...................Done.

H3C Device images in IPE:

boot.bin

system.bin

【相关命令】

· display install package

1.1.6 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 cfa0:/ssh.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 cfa0:/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.

# 显示系统中编号为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 cfa0:/ssh.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-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 cfa0:/ssh.bin on slot 1	执行的ISSU动作
Detail of activating packages on slot 1.	激活包动作的详细信息
Get upgrade policy successfully	表示升级决策处理成功
Uncompress package to system successfully	解压软件包文件到系统成功
Remove files from system successfully	从系统中删除文件成功

【相关命令】

· reset install log-history oldest

1.1.7 display install package

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

【命令】

display install package { filename | all } [ verbose ]

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

all：表示全局主用主控板上存储介质根目录下的所有软件包。）

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

【使用指导】

当配置该命令时，命令中指定的软件包必须放在存储介质的根目录下，文件名中必须含存储介质的名称，形如cfa0:/xx.bin或chassism#slotn#cfa0:/startup-boot.bin，chassism#slotn用于指定全局备用主控板。

【举例】

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

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

cfa0:/system.bin

[Package]

Vendor: H3C

Product: xxxx

Service name: system

Platform version: 7.1.022

Product version: Beta 1330

Supported board: mpu

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

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

cfa0:/system.bin

[Package]

Vendor: H3C

Product: xxxx

Service name: system

Platform version: 7.1.022

Product version: Beta 1330

Supported board: mpu

[Component]

Component: system

Description: system package

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

1.1.8 display install rollback

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

【命令】

display install rollback [ point-id ]

point-id：回滚点的编号。

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

issu命令升级过程中不会记录回滚点，因此，在issu命令升级过程中执行该命令，没有信息可显示。

【举例】

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

<Sysname> display install rollback

Install rollback information 1 on slot 1:

Updating from cfa0:/route-1.bin

to cfa0:/route-2.bin.

Install rollback information 2 on slot 1:

Deactivating cfa0:/route-2.bin

以上显示信息表明：设备上共有两个回滚点，回滚点1是将cfa0:/route-1.bin升级到了cfa0:/route-2.bin，回滚点2是将cfa0:/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为软件包的名称

【相关命令】

· reset install rollback oldest

1.1.9 display install which

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

【命令】

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

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

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

【使用指导】

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

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

【举例】

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

<Sysname> display install which file sshc.cli

File sshc.cli is in following packages on slot 1:

cfa0:/system.bin

[Package]

Vendor: xxx

Product: xxxx

Service name: ssh

Platform version: 7.1.022

Product version: Beta 1330

Supported board: mr, lc, sfc

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

1.1.10 display issu state

display issu state命令用来显示当前ISSU升级所处的状态，以及ISSU升级的相关信息。

【命令】

display issu state

issu命令升级需要经过一系列的操作步骤，升级过程中有严格的步骤要求，执行升级步骤会导致ISSU状态的变化，通过该命令的显示信息可以帮助管理员确定下一步需执行的操作。

【举例】

# 执行issu load命令后，在原主设备上显示ISSU状态。

<Sysname> display issu state

ISSU state: Loaded

Compatibility: Compatible

Work state: Independent active

Upgrade method: Chassis by chassis

Upgraded chassis:

chassis 2

Current upgrading chassis: None

Previous version list:

boot: 7.1.041, Demo 2402

system: 7.1.041, Demo 2402

ssh: 7.1.041, Demo 2402

Previous software images:

cfa0:/boot.bin

cfa0:/system.bin

cfa0:/ssh.bin

Upgrade version list:

system: 7.1.041, Demo 2403

ssh: 7.1.041, Demo 2403

Upgrade software images:

cfa0:/system04.bin

cfa0:/ssh04.bin

表1-4 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：表示兼容升级 · Unknown：没有升级
Work state	设备的工作模式，取值可能为： · Normal：表示正常模式
Upgrade method	升级方式，取值为 Chassis by chassis：在IRF中多成员设备运行的情况下，表示以成员设备为单位进行升级，先升级备设备，再升级原主设备
Upgraded chassis	完成升级的成员设备。取值为Unknown时，表示设备处于回滚过程中
Current version list	设备没有升级，表示当前系统软件版本
Current software images	设备没有升级，表示当前运行软件包的名称
Previous version list	进行ISSU升级前的系统软件版本
Previous software images	进行ISSU升级前版本文件
Upgrade version list	正在ISSU升级的目标版本
Upgrade software images	正在ISSU升级中用到的目标文件

· issu run switchover

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文件必须放在全局主用主控板存储介质的根目录下，文件名中必须且只能包含存储介质的名称，不能包含chassis和slot的信息，形如cfa0:/xx.bin（cfa0:/xx.ipe）。

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

【举例】

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

<Sysname> display version comp-matrix

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

Version:

7.1.031

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

Version:

V700R001B31D001

Version compatibility list:

V700R001B31D001

Version dependency boot list:

7.1.031

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

Version:

V700R001B31D003

Version compatibility list:

V700R001B31D003

Version dependency system list:

V700R001B31D001

V700R001B31D002

# 查看当前软件版本和cmw710-cfa-a7122.bin软件版本的兼容性信息。（兼容版本显示信息举例）

<Sysname> display version comp-matrix file feature cfa0:/cmw710-cfa-a7122.bin

Feature image: cfa0:/cmw710-cfa-a7122.bin

Version:

V700R001B31D002

Version compatibility list:

V700R001B31D001

V700R001B31D002

Version dependency system list:

V700R001B31D001

V700R001B31D002

Chassis Slot Upgrade Way

1 0 Service Upgrade

1 0.1 Service Upgrade

1 7 Service Upgrade

1 9 Service Upgrade

2 0 Service Upgrade

2 0.1 Service Upgrade

2 1 Service Upgrade

2 6 Service Upgrade

Influenced service according to following table on chassis 1 slot 0:

cfa0:/cmw710-cfa-a7122.bin

CFA

Influenced service according to following table on chassis 1 slot 7:

cfa0:/cmw710-cfa-a7122.bin

CFA

Influenced service according to following table on chassis 1 slot 9:

cfa0:/cmw710-cfa-a7122.bin

CFA

Influenced service according to following table on chassis 1 slot 0.1:

cfa0:/cmw710-cfa-a7122.bin

CFA

Influenced service according to following table on chassis 2 slot 0:

cfa0:/cmw710-cfa-a7122.bin

CFA

Influenced service according to following table on chassis 2 slot 1:

cfa0:/cmw710-cfa-a7122.bin

CFA

Influenced service according to following table on chassis 2 slot 6:

cfa0:/cmw710-cfa-a7122.bin

CFA

Influenced service according to following table on chassis 2 slot 0.1:

cfa0:/cmw710-cfa-a7122.bin

CFA

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

字段	描述
Boot image: cfa0:/cmw710-boot-a7122.bin Version:	要显示的Boot包的相关信息，包括： · Boot包的名称 · Version：Boot包的版本
System image: cfa0:/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: cfa0:/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: cfa0:/rpu-s5120hi-boot.bin Version: 7.1.041 System image: cfa0:/rpu-s5120hi-system.bin Version: D2402 Version compatibility list: D2402 Version dependency boot list: 7.1.041 Feature image: cfa0:/s5120hi-http-d2402.bin Version: D2404 Version compatibility list: D2404 Version dependency system list: D2402	要显示的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	如果升级指定的软件包，则升级的方式为不兼容升级
Chassis	设备在IRF中的成员编号。只有版本兼容时，才会显示该信息
Slot	单板所在的槽位号。只有版本兼容时，才会显示该信息
Upgrade Way	兼容升级策略。只有版本兼容时，才会显示该信息。取值可能为： · Service Upgrade：表示服务级增量升级，该方式下，仅对本业务模块有影响，对系统以及其他业务模块没有影响 · File Upgrade：表示文件级增量升级。该方式下，仅对系统内的、用户不可见的程序文件进行升级，对系统以及业务模块没有影响 · Reboot：表示通过重启方式升级

【相关命令】

· issu load

1.1.12 issu accept

issu accept命令用来确认ISSU兼容升级，接受已升级的软件版本，并删除回滚定时器。

执行本命令后，系统会删除回滚定时器，本次ISSU升级过程中不会再进行自动回滚，用户可以执行issu rollback命令进行手动回滚。

此命令为可选命令，可以不执行此命令，直接执行后面的issu commit命令完成升级过程。

【举例】

# 版本兼容情况下，确认升级步骤。

<Sysname> issu accept

【相关命令】

· issu load

· issu run switchover

1.1.13 issu commit

issu commit命令用来对原主设备及未升级的从设备进行兼容版本升级。所有成员设备完成升级后，本次升级结束，ISSU回到初始状态。执行此命令后不能再通过ISSU回滚命令或者回滚定时器进行回滚操作。

【命令】

issu commit chassis chassis-number

chassis chassis-number：待升级的原主设备以及其它从设备的成员编号。

【使用指导】

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

【举例】

# 在多成员设备，版本兼容情况下，升级原主设备（假设成员编号为2）和其他成员（假设成员编号为1）。

<Sysname> issu commit chassis 2

Copying file cfa0:/feature.bin to chassis2#slot1#cfa0:/feature.bin...Done.

Upgrade summary according to following table:

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

· issu run switchover

1.1.14 issu load

issu load命令用来升级从设备的启动软件包并将从设备的主用下次启动软件包设置为指定的软件包。

【命令】

issu load file { boot filename | system filename | feature filename&<1-30> } * chassis chassis-number&<1-3>

issu load file ipe ipe-filename chassis chassis-number&<1-3>

boot：表示Boot包。

system：表示System包。

feature：表示Feature包。

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

chassis chassis-number：表示从设备在IRF中的成员编号。&<1-3>表示前面的参数最多可以输入3次。

· 当要升级的软件包的版本和设备当前运行的软件包的版本兼容时，只允许输入一个chassis-number；

· 当要升级的软件包的版本和设备当前运行的软件包的版本不兼容时，可以输入多个chassis-number，一次升级多个成员设备。

【使用指导】

当配置该命令时，命令中指定的软件包/IPE文件必须放在全局主用主控板存储介质的根目录下，文件名中必须且只能包含存储介质的名称，不能包含chassis和slot的信息，形如cfa0:/xx.bin（cfa0:/xx.ipe）。

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

当IRF中有多个成员设备时，chassis chassis-number请指定为从设备的成员编号。输入该命令后，系统将自动执行以下操作：

· 进行版本兼容性检查。

· 确定升级策略。兼容升级的策略包括增量和重启升级。其中，增量升级会升级对应的进程；重启升级会自动重启对应的成员设备。

· 按照升级策略进行升级从设备，并将从设备的主用下次启动软件包设置为issu load命令中指定的包。

【举例】

# 版本兼容情况下，使用cfa0:/feature.bin升级成员2上的Feature包。

<Sysname> issu load file feature cfa0:/feature.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

Copying file cfa0:/feature.bin to chassis2#slot0#cfa0:/feature.bin...Done.

Copying file cfa0:/feature.bin to chassis2#slot1#cfa0:/feature.bin...Done.

Upgrade summary according to following table:

cfa0:/feature.bin

Running Version New Version

Alpha 7122 Alpha 7123

Chassis Slot Upgrade Way

2 0 Service Upgrade

2 1 Service Upgrade

2 2 Service Upgrade

2 3 Service Upgrade

2 4 Service Upgrade

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

表1-6 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 image file.................................Done.	检验软件包的合法性。只有使用IPE文件升级时，才显示该信息
Decompressing file A to B...........................Done.	将文件从位置A解压缩到位置B。只有使用IPE文件升级时，才显示该信息
Copying file B to C......Done.	将文件从位置B拷贝到位置C。当配置全局备用主控板时才有该提示信息（IRF模式）
Upgrade summary according to following table	升级信息摘要
Running Version	设备当前运行的相同类型软件包的产品版本号
New Version	将要升级的软件包的产品版本号
Chassis	设备在IRF中的成员编号
Slot	单板所在的槽位号
Upgrade Way	升级策略，取值可能为： · Service Upgrade：表示服务级增量升级，该方式下，仅对本业务模块有影响，对系统以及其他业务模块没有影响 · File Upgrade：表示文件级增量升级。该方式下，仅对系统内的、用户不可见的程序文件进行升级，对系统以及业务模块没有影响 · Reboot：表示通过重启方式升级
Upgrading software images to compatible versions. Continue? [Y/N]	询问用户是否执行兼容升级操作
Upgrading software images to incompatible versions. Continue? [Y/N]	询问用户是否执行不兼容升级操作

1.1.15 issu rollback

issu rollback命令用来回滚到升级前的版本。

【命令】

issu rollback

设备支持手动回滚，手工回滚由issu rollback命令触发。

· 当ISSU升级状态为Loading时进行手工回滚，可能会回滚失败。回滚操作结束后，请使用display version命令来查看设备当前运行的版本，验证回滚结果。

· 当ISSU升级状态为Loaded和Accepted时，支持手工回滚。

· 兼容升级、ISSU升级状态为Switching和Switchover时，支持手工回滚。

· ISSU升级状态为Switching时，不支持手工回滚。

· Switching状态时如果进行手工回滚，整个系统是会重启。

· 当ISSU升级状态为Commiting时，不允许进行手工回滚操作。

· 多成员设备的情况下，执行issu run switchover后，再进行回滚操作，回滚只保证版本回到升级前，但不能保证主备状态和升级前一致。

【举例】

# 回滚到升级之前的版本。

<Sysname> issu rollback

This command will quit the ISSU process and roll back to the previous version. Continue? [Y/N]:y

· issu run switchover

1.1.16 issu run switchover

issu run switchover命令在升级兼容软件包的情况下，用来进行ISSU倒换。

【命令】

issu run switchover

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

当设备上有多个成员设备时，输入该命令后，系统将自动执行兼容版本升级操作，增量升级时系统会对升级的进程进行了进程级主备倒换；重启升级时系统会将当前主设备的主控板使用原版本重新启动，将刚使用issu load命令升级完成的从设备选举为IRF的主设备。

需要注意的是：

· 兼容版本升级时，如果未执行issu accept或者issu commit命令，则系统会自动回滚到升级前的版本。

· 兼容版本升级时，如果业务板和网板无法使用增量升级，这种情况下业务板和网板会重启，并从新主控板加载最新的软件包，途经此业务板和网板的流量会中断，流量恢复时间是“业务板和网板启动时间+业务板和网板状态恢复时间”。

【举例】

# 版本兼容情况下，进行主备倒换。

<Sysname> issu run switchover

Upgrade summary according to following table:

cfa0:/feature.bin

Running Version New Version

Alpha 7122 Alpha 7123

Chassis Slot Switchover Way

1 0 Active standby process switchover

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

表1-7 issu load命令显示信息描述表

字段	描述
Copying file A to B......Done.	将文件从位置A拷贝到位置B。
Switchover Way	倒换方式，取值可能为： · Active standby process switchover：表示主备进程的倒换 · Global active standby MPU switchover：表示全局主备主控板之间的倒换
其它字段	请参见表1-6