目  录

1 ISSU

1.1 ISSU配置命令

1.1.1 display install active

1.1.2 display install committed

1.1.3 display install ipe-info

1.1.4 display install package

1.1.5 display issu state

1.1.6 display version comp-matrix

1.1.7 install activate

1.1.8 install add

1.1.9 install commit

1.1.10 install deactivate

1.1.11 issu load

1.1.12 issu run switchover

 

1 ISSU

 

1.1  ISSU配置命令

1.1.1  display install active

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

【命令】

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

【视图】

任意视图

【缺省用户角色】

network-admin

network-operator

【参数】

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

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

【举例】

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

<Sysname> display install active

Active packages on chassis 1 slot 11:

  flash:/boot.bin

  flash:/system.bin

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

<Sysname> display install active verbose

Active packages on chassis 1 slot 11:

  flash:/boot-a0045p80.bin                                        

  [Package]                                                                    

  Vendor: H3C                                                                  

  Product: xxx                                                                

  Service name: boot                                                           

  Platform version: 7.1.045P80                                                 

  Product version: Alpha 0045P80                                                

  Supported board: mpu lc sfc                                                  

  Version type: debug                                                          

  [Component]                                                                   

  Component: boot                                                              

  Description: boot package                                                    

                                                                                

  flash:/system-a0045p80.bin                                      

  [Package]                                                                    

  Vendor: H3C                                                                  

  Product: xxx                                                               

  Service name: system                                                         

  Platform version: 7.1.045                                                    

  Product version: Alpha 0045P80                                               

  Supported board: mpu lc sfc                                                  

  Version type: debug                                                          

  [Component]                                                                   

  Component: system                                                            

  Description: system package

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

字段	描述
Active packages on chassis m slot n	某单板上处于激活状态的软件包的相关信息，其中m表示设备在IRF中的成员编号，n表示成员设备上该单板所在的槽位号
boot.bin	软件包的名称
[Package]	软件包的信息
Vendor	生产厂商
Product	产品名称
Service name	软件包所包含的服务名称 ·      如果显示为boot，表示该软件包为Boot包 ·      如果显示为system，表示该软件包为System包 ·      如果显示为patch，表示该软件包为补丁包
Platform version	平台软件版本号
Product version	产品软件版本号
Patch version	补丁包的版本号
Supported board	软件包支持的单板类型： ·      mpu表示交换引擎板 ·      lpu表示业务板
Version type	软件版本的类型： ·      Debug表示调试版本 ·      Release表示正式发布的版本
[Component]	组件信息，表示软件包的组成部分
Component	组件的名称
Description	组件的描述信息

 

【相关命令】

·            install active

1.1.2  display install committed

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

【命令】

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

【视图】

任意视图

【缺省用户角色】

network-admin

network-operator

【参数】

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

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

【使用指导】

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

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

【举例】

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

<Sysname> display install committed

Committed packages on chassis 1 slot 11:

 flash:/boot-a0201.bin

 flash:/system-a0201.bin

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

<Sysname> display install committed verbose

Committed packages on chassis 1 slot 11:

 flash:/boot-a0201.bin

 [Package]

 Vendor: H3C

 Product: xxxx

 Service name: boot

 Platform version: 7.1

 Product version: Beta 1330

 Supported board: mr, lc, sfc

 Version type: debug

 [Component]

 Component: boot

 Description: boot package

 

 flash:/system-a0201.bin

 [Package]

 Vendor: H3C

 Product: xxxx

 Service name: system

 Platform version: 7.1

 Product version: Beta 1330

 Supported board: mr, lc, sfc

 Version type: debug

 [Component]

 Component: system

 Description: system package

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

【相关命令】

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

·            install commit

1.1.3  display install ipe-info

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

【命令】

display install ipe-info ipe-file

【视图】

任意视图

【缺省用户角色】

network-admin

network-operator

【参数】

ipe-file：表示IPE文件名，以.ipe作为后缀名，为1～63个字符的字符串，不区分大小写。如果该IPE文件不存在，命令执行失败。

【使用指导】

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

当配置该命令时，命令中指定的IPE文件必须放在成员设备交换引擎板存储介质的根目录下，文件名中必须含存储介质的名称，可根据需要包含chassis和slot的信息，形如flash:/xx.ipe或者chassism#slotn#flash:/startup-boot.ipe，chassism#slotn用于指定全局备用交换引擎板，m为设备的成员编号，n为成员设备上交换引擎板所在的槽位号。

【举例】

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

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

Verifying image file...Done.

Images in IPE:

  boot.bin

  system.bin

【相关命令】

·            display install package

1.1.4  display install package

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

【命令】

display install package { filename | all } [ verbose ]

【视图】

任意视图

【缺省用户角色】

network-admin

network-operator

【参数】

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

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

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

【使用指导】

当配置该命令时，命令中指定的软件包必须放在成员设备交换引擎板存储介质的根目录下，文件名中必须含存储介质的名称，可根据需要包含chassis和slot的信息，形如flash:/xx.bin或chassism#slotn#flash:/startup-boot.bin，chassism#slotn用于指定全局备用交换引擎板，m为设备的成员编号，n为成员设备上交换引擎板所在的槽位号。

【举例】

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

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

  flash:/system.bin

  [Package]

  Vendor: H3C

  Product: xxxx

  Service name: system

  Platform version: 7.1.022

  Product version: Beta 1330

  Supported board: mpu

  Version type: debug

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

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

  flash:/system.bin

  [Package]

  Vendor: H3C

  Product: xxxx

  Service name: system

  Platform version: 7.1.022

  Product version: Beta 1330

  Supported board: mpu

  Version type: debug

  [Component]

  Component: system

  Description: system package

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

1.1.5  display issu state

display issu state命令用来显示当前ISSU升级所处的状态，升级的软件包和升级前的软件包的版本是否兼容，以及ISSU升级的相关信息。

【命令】

display issu state

【视图】

任意视图

【缺省用户角色】

network-admin

network-operator

【使用指导】

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.041, Demo 2402

  system: 7.1.041, Demo 2402

Current software images:

  flash:/boot.bin

  flash:/system.bin

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

<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.041, Demo 2402

  system: 7.1.041, Demo 2402

Previous software images:

  flash:/boot.bin

  flash:/system.bin

Upgrade version list:

  system: 7.1.041, Demo 2403

Upgrade software images:

  flash:/system04.bin

表1-2 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	版本兼容性检查结果，取值可能为： ·      Incompatible：表示不兼容升级 ·      Unknown：没有升级
Work state	设备的工作模式，取值可能为： ·      Normal：表示正常模式 ·      Independent active：表示独立主控模式。当升级到不兼容版本时，先升级的备用交换引擎板就会进入独立主控模式。该模式使得同一设备上的不同交换引擎板可以运行不同的软件版本
Upgrade method	升级方式，Chassis by chassis：在IRF中多成员设备运行的情况下，表示以成员设备为单位进行升级，先升级备设备，再升级原主设备
Upgraded slot	完成升级的slot
Current upgrading slot	正在升级的slot
Upgraded chassis	完成升级的chassis
Current upgrading chassis	正在升级的chassis
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 load

·            issu run switchover

1.1.6  display version comp-matrix

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

【命令】

display version comp-matrix

display version comp-matrix file { boot filename | system filename } *

display version comp-matrix file ipe ipe-filename

【视图】

任意视图

【缺省用户角色】

network-admin

network-operator

【参数】

boot：表示Boot包。

system：表示System包。

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

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

【使用指导】

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

·            如果指定文件名，则显示指定软件包的版本和当前运行版本的的兼容性信息。

·            如果不指定文件名，则显示设备当前运行版本的兼容性信息，兼容信息记录当前版本的版本信息和当前软件包兼容的软件版本信息。

【举例】

# 显示文件flash:/boot-e2205.bin、flash:/system-e2205.bin和当前运行软件包的兼容信息。

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

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

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

字段	描述
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包中的任意一个

 

【相关命令】

·            issu load

1.1.7  install activate

install activate命令用来激活补丁包。

【命令】

install activate patch filename chassis chassis-number slot slot-number

【视图】

用户视图

【缺省用户角色】

network-admin

【参数】

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

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

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

【使用指导】

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

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

·            命令中指定的软件包必须放在全局主用交换引擎板存储介质主用交换引擎板的根目录下，文件名中必须且只能包含存储介质的名称，不能包含chassis和slot的信息，形如flash:/xx.bin。

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

【举例】

# 激活备用交换引擎板11上的patch包patch.bin。

<Sysname> install activate patch flash:/patch.bin slot 11

Copying file flash:/patch.bin to slot11#flash:/patch.bin......Done.

Upgrade summary according to following table:

 

flash:/patch.bin

  Running Version             New Version

  None                        Beta 1330

 

  Slot                        Upgrade Way

  11                          Service Upgrade

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

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

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

字段	描述
Copying file A to B......Done.	将文件从位置A拷贝到位置B。当配置全局备用交换引擎板时才有该提示信息
Upgrade summary according to following table	升级摘要信息
Running Version	设备当前运行的相同类型软件包的产品版本号
New Version	目标软件包的产品版本号
Chassis	设备在IRF中的成员编号
Upgrade Way	兼容升级策略

 

【相关命令】

·            display install active

·            install commit

·            install deactivate

1.1.8  install add

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

【命令】

install add ipe-file medium-name:

【视图】

用户视图

【缺省用户角色】

network-admin

【参数】

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

medium-name：存储介质的名称。如果是解压缩到全局主用交换引擎板上，则为flash；如果是解压缩到全局备用交换引擎板上，则为chassism#slotn#flash，m为设备的成员编号，n为成员设备上交换引擎板所在的槽位号。

【使用指导】

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

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

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

【举例】

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

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

1.1.9  install commit

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

【命令】

install commit

【视图】

用户视图

【缺省用户角色】

network-admin

【使用指导】

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

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

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

【举例】

# 确认软件包更改。

<Sysname> install commit

【相关命令】

·            install activate

·            install deactivate

1.1.10  install deactivate

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

【命令】

install deactivate patch filename chassis chassis-number slot slot-number

【视图】

用户视图

【缺省用户角色】

network-admin

【参数】

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

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

【使用指导】

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

从设备重启后，会自动去批量配置主设备的配置和状态数据。请等待批量配置完成后，即分别通过display device和displaysystem internal ha service-group查看到所有板处于normal状态，再执行install deactivate命令，否则，命令会执行失败。

【举例】

# 卸载成员设备1的10号槽位的单板上的补丁包patch.bin。

<Sysname> install deactivate patch flash:/patch.bin chassis 1 slot 10

【相关命令】

·            display install active

1.1.11  issu load

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

【命令】

issu load file { boot filename | system filename } * chassis chassis-number

issu load file ipe ipe-filename chassis chassis-number

【视图】

用户视图

【缺省用户角色】

network-admin

【参数】

boot：表示Boot包。

system：表示System包。

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

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

【使用指导】

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

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

当IRF中有多个成员设备时，chassis chassis-number请指定为从设备的成员编号。输入该命令后，系统将自动执行以下操作，按照升级策略进行升级从设备，并将从设备的主用下次启动软件包设置为issu load命令中指定的包。

【举例】

# 使用flash:/version.ipe升级从设备2。

<Sysname>issu load file ipe flash:/version.ipe chassis 2

This operation will delete the rollback point information for the previous upgrade and maybe get unsaved configuration lost. Continue? [Y/N]:Y

Upgrade summary according to following table:

 

flash:/version.ipe

  Running Version             New Version

  Alpha 7122                  Alpha 7123

 

  Chassis   Slot              Upgrade Way 

  2         10                 Reboot

  2         11                 Reboot

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

表1-5 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。当配置全局备用交换引擎板时才有该提示信息
Upgrade summary according to following table	升级信息摘要
Running Version	设备当前运行的相同类型软件包的产品版本号
New Version	将要升级的软件包的产品版本号
Chassis	设备在IRF中的成员编号
Slot	单板所在的槽位号

 

1.1.12  issu run switchover

issu run switchover命令用来进行ISSU倒换，并且将剩余待升级的框进行升级。

【命令】

issu run switchover

【视图】

用户视图

【缺省用户角色】

network-admin

【使用指导】

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

当设备上有多个成员设备时，输入该命令后，系统将自动执行以下操作：

·            执行issu load后IRF分裂，生成两个的IRF。执行issu run switchover重启并升级原IRF，原IRF重启后加入新的IRF即完成升级过程，系统选择新IRF的主设备为合并后IRF的主设备。

·            执行issu run switchover之后，即完成升级过程。

【举例】

# 进行主备倒换，同时升级成员设备2（主设备）。

<Sysname> issu run switchover

Upgrade summary according to following table:

 

flash:/version.ipe

  Running Version             New Version

  Alpha 7122                  Alpha 7123

 

  Chassis   Slot              Upgrade Way

  2         10                 Reboot

  2         11                 Reboot

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

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

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

 

【相关命令】

·            issu load