目  录

1 ISSU

1.1 通过issu命令升级配置命令

1.1.1 display issu rollback-timer

1.1.2 display issu state

1.1.3 display version comp-matrix

1.1.4 issu accept

1.1.5 issu commit

1.1.6 issu load

1.1.7 issu rollback

1.1.8 issu rollback-timer

1.1.9 issu run switchover

1.2 通过install命令升级配置命令

1.2.1 display install active

1.2.2 display install backup

1.2.3 display install committed

1.2.4 display install inactive

1.2.5 display install ipe-info

1.2.6 display install job

1.2.7 display install log

1.2.8 display install package

1.2.9 display install rollback

1.2.10 display install which

1.2.11 install abort

1.2.12 install activate

1.2.13 install add

1.2.14 install commit

1.2.15 install deactivate

1.2.16 install remove

1.2.17 install rollback to

1.2.18 install verify

1.2.19 reset install log-history oldest

1.2.20 reset install rollback oldest

 

1 ISSU

1.1  通过issu命令升级配置命令

1.1.1  display issu rollback-timer

display issu rollback-timer命令用来显示回滚定时器时长设置和剩余时长。

【命令】

display issu rollback-timer

【视图】

任意视图

【缺省用户角色】

network-admin

network-operator

【使用指导】

因为新设置的回滚定时器时长会在下次ISSU升级中生效，因此，可能出现剩余时间大于定时器时长的情况。

【举例】

# 执行issu load命令后，查看回滚定时器时设置和剩余时长。

<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-1 display issu rollback-timer命令显示信息描述表

字段	描述
Rollback timer	回滚定时器是否处于工作状态： ·       Working：回滚定时器已经启动 ·       Not working：回滚定时器没有启动或者已经超时
Rollback interval	用户配置的回滚定时器的时间，单位为分钟
Rollback time remaining	距离回滚定时器超时的时间，单位为分钟

 

【相关命令】

·              issu rollback-timer

1.1.2  display issu state

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

【命令】

display issu state

【视图】

任意视图

【缺省用户角色】

network-admin

network-operator

【使用指导】

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

  system: Comware V700R001B34D001

  ssh: Comware V700R001B34D001

Current software images:

  cfa0:/boot.bin

  cfa0:/system.bin

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

  system: Comware V700R001B33D001

  ssh: Comware V700R001B33D001

Previous software images:

  cfa0:/boot.bin

  cfa0:/system.bin

  cfa0:/ssh.bin

Upgrade version list:

  boot: 7.1.034

  system: Comware V700R001B34D001

  ssh: Comware V700R001B34D001

Upgrade software images：

  cfa0:/boot02.bin

  cfa0:/system04.bin

  cfa0:/ssh04.bin

# issu load命令执行过程中，查看ISSU状态。（IRF模式单成员设备）

<Sysname> display issu state

ISSU state: Loading

Compatibility: Incompatible

Work state: Normal

Upgrade method: Card by card

Upgraded slot: None

Current upgrading slot:

  chassis 1 slot 1

Previous version list:

  boot: 7.1.033

  system: Comware V700R001B33D001

  ssh: Comware V700R001B33D001

Previous software images:

  cfa0:/boot.bin

  cfa0:/system.bin

  cfa0:/ssh.bin

Upgrade version list:

  boot: 7.1.034

  system: Comware V700R001B34D001

  ssh: Comware V700R001B34D001

Upgrade software images：

  cfa0:/boot02.bin

  cfa0:/system04.bin

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

  system: Comware V700R001B33D001

  ssh: Comware V700R001B33D001

Previous software images:

  cfa0:/boot.bin

  cfa0:/system.bin

  cfa0:/ssh.bin

Upgrade version list:

  boot: 7.1.034

  system: Comware V700R001B34D001

  ssh: Comware V700R001B34D001

Upgrade software images:

  cfa0:/system02.bin

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

  system: Comware V700R001B33D001

  ssh: Comware V700R001B33D001

Previous software images:

  cfa0:/boot.bin

  cfa0:/system.bin

  cfa0:/ssh.bin

Upgrade version list:

  boot: 7.1.034

  system: Comware V700R001B34D001

  ssh: Comware V700R001B34D001

Upgrade software images:

  cfa0:/system04.bin

  cfa0:/ssh04.bin

表1-1 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	完成升级的slot
Current upgrading slot	正在升级的slot
Upgraded chassis	完成升级的chassis（IRF模式）
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

·              issu accept

·              issu commit

·              issu rollback

1.1.3  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

【视图】

任意视图

【缺省用户角色】

network-admin

network-operator

【参数】

boot：表示Boot包。

system：表示System包。

feature：表示Feature包。

filename：表示软件包的文件名，为1～63个字符的字符串。该文件必须是主用主控板存储介质根目录下，后缀名为.bin的文件，且文件名中必须包含存储介质的名称，且不能包含slot信息，形如flash:/a.bin。filename&<1-30>表示前面的参数最多可以输入30次。（独立运行模式）

filename：表示软件包的文件名，为1～63个字符的字符串。该文件必须是全局主用主控板存储介质根目录下，后缀名为.bin的文件，且文件名中必须包含存储介质的名称，且不能包含chassis和slot信息，形如flash:/a.bin。filename&<1-30>表示前面的参数最多可以输入30次。（IRF模式）

ipe ipe-filename：IPE文件名，以.ipe作为后缀名，为1～63个字符的字符串。该文件必须是设备存储介质根目录下，后缀名为.ipe的文件，且文件名中必须包含存储介质的名称，形如flash:/a.ipe。（独立运行模式）

ipe ipe-filename：IPE文件名，以.ipe作为后缀名，为1～63个字符的字符串。该文件必须是设备存储介质根目录下，后缀名为.ipe的文件，且文件名中必须包含存储介质的名称，形如flash:/a.ipe。（IRF模式）

【使用指导】

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

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

【举例】

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

<Sysname> display version comp-matrix

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

  Version:

  7.1.034

 

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

  Version:

  V700R001B34D001

  Version compatibility list:

  V700R001B34D001

  Version dependency boot list:

  7.1.034

 

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

  Version: V700R001B34D003

  Version compatibility list:

  V700R001B34D003

  Version dependency system list:

  V700R001B34D001

  V700R001B34D002

# 查看当前软件版本和cmw710-cfa-a7125.bin软件版本的兼容性信息。（独立运行模式下兼容版本显示信息举例）

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

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

  Version:

  V700R001B34D002

  Version compatibility list:

  V700R001B34D001

  V700R001B34D002

  Version dependency system list:

  V700R001B34D001

  V700R001B34D002

 

  Slot                        Upgrade Way

  0                           Service Upgrade

  0.1                         File Upgrade

  1                           Service Upgrade

  1.1                         File Upgrade

  4                           Service Upgrade

 

Influenced service according to following table on slot 0:

cfa0:/cmw710-cfa-a7125.bin

    CFA

 

Influenced service according to following table on slot 1:

cfa0:/cmw710-cfa-a7125.bin

    CFA

 

Influenced service according to following table on slot 4:

cfa0:/cmw710-cfa-a7125.bin

    CFA

 

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

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

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

  Version:

  V700R001B34D002

  Version compatibility list:

  V700R001B34D001

  V700R001B34D002

  Version dependency system list:

  V700R001B34D001

  V700R001B34D002

 

  Chassis   Slot              Upgrade Way

  1         1                 Service Upgrade

  1         1.1               File Upgrade

  1         7                 Service Upgrade

  1         9                 Service Upgrade

  2         1                 Service Upgrade

  2         1.1               File Upgrade

  2         4                 Service Upgrade

  2         6                 Service Upgrade

 

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

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 2 slot 1:

cfa0:/cmw710-cfa-a7122.bin

    CFA

 

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

cfa0:/cmw710-cfa-a7122.bin

    CFA

 

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

cfa0:/cmw710-cfa-a7122.bin

    CFA

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

字段	描述
Boot image	Boot包当前运行的软件版本
System image	System包当前运行的软件版本
Feature image	Feature包当前运行的版本
Version	软件包的版本
Version compatibility list	软件包兼容的版本信息列表
Version dependency boot list	软件包依赖的Boot包版本
Version dependency system list	软件包依赖的System包的软件版本
Influenced service according to following table	如果升级，将受影响的功能模块。只有版本兼容时，才会显示该信息
Incompatible upgrade	如果升级指定的软件包，则升级的方式为不兼容升级
Chassis	设备在IRF中的成员编号。只有版本兼容时，才会显示该信息（IRF模式）
Slot	单板所在的槽位号。只有版本兼容时，才会显示该信息
Upgrade Way	兼容升级策略。只有版本兼容时，才会显示该信息。取值可能为： ·       Service Upgrade：表示服务级增量升级，该方式下，仅对本业务模块有影响，对系统以及其他业务模块没有影响 ·       File Upgrade：表示文件级增量升级。该方式下，仅对系统内的、用户不可见的程序文件进行升级，对系统以及业务模块没有影响 ·       ISSU Reboot：表示通过软重启方式升级 ·       Reboot：表示通过重启方式升级 ·       Sequence Reboot：表示逐次重启方式。只有交换网板支持该升级方式，当交换网板需要重启升级时，为了避免重启升级过程中流量中断，系统会自动升级完毕一块交换网板后，再自动升级下一块交换网板，直到所有交换网板升级完毕后，再自动升级主控板。

 

【相关命令】

·              issu load

1.1.4  issu accept

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

【命令】

issu accept

【视图】

用户视图

【缺省用户角色】

network-admin

【使用指导】

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

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

ISSU不兼容升级时，不需要执行该命令，执行该命令会提示失败。

【举例】

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

<Sysname> issu accept

【相关命令】

·              issu load

·              issu run switchover

1.1.5  issu commit

(1)      独立运行模式

issu commit命令用来对原主用主控板进行兼容版本升级，升级完成后ISSU回到初始状态。执行此命令后，不能再通过ISSU回退命令或者回退定时器进行回退操作。

(2)      IRF模式

对于单成员设备双主控的情况，issu commit命令用来对原主用主控板进行兼容版本升级，升级完成后ISSU回到初始状态。执行此命令后，不能再通过ISSU回退命令或者回退定时器进行回退操作。

对于多成员设备的情况，issu commit命令用来对原Master及未升级的Standby进行兼容版本升级。所有成员设备完成升级后，本次升级结束，ISSU回到初始状态。执行此命令后不能再通过ISSU回退命令或者回退定时器进行回退操作。如果有多个成员设备需要通过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：待升级的原Master以及其它Standby的成员编号。（IRF模式多成员设备）

【举例】

# 在双主控板，版本兼容情况下，升级原主用主控板。（独立运行模式）

<Sysname> issu commit slot 0

Upgrade summary according to following table:

 

cfa0:/feature.bin

  Running Version             New Version

  Alpha 7122                  Alpha 7123

 

  Slot                        Upgrade Way

  0                           Service Upgrade

  0.1                         File Upgrade

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

# 在单主控板，版本兼容情况下，确认原主用主控板的升级。（独立运行模式）

<Sysname> issu commit slot 0

# 在多成员设备，版本兼容情况下，升级剩余待升级的成员设备。（IRF模式）

<Sysname> issu commit chassis 3

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         0.1               File Upgrade

  3         1                 Service Upgrade

  3         1.1               File Upgrade

  3         2                 Service Upgrade

  3         3                 Service Upgrade

  3         4                 Service Upgrade

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

<Sysname> issu commit chassis 4

Upgrade summary according to following table:

 

cfa0:/feature.bin

  Running Version             New Version

  Alpha 7122                  Alpha 7123

 

  Chassis   Slot              Upgrade Way

  4         0                 Service Upgrade

  4         0.1               File Upgrade

  4         1                 Service Upgrade

  4         1.1               File Upgrade

  4         2                 Service Upgrade

  4         3                 Service Upgrade

  4         4                 Service Upgrade

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

<Sysname> issu commit chassis 1

Upgrade summary according to following table:

 

cfa0:/feature.bin

  Running Version             New Version

  Alpha 7122                  Alpha 7123

 

  Chassis   Slot              Upgrade Way

  1         0                 Service Upgrade

  1         0.1               File Upgrade

  1         1                 Service Upgrade

  1         1.1               File Upgrade

  1         2                 Service Upgrade

  1         3                 Service Upgrade

  1         4                 Service Upgrade

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

# 在单成员设备双主控板，版本兼容情况下，升级原主用主控板。（IRF模式）

<Sysname> issu commit chassis 1 slot 0

Upgrade summary according to following table:

 

  cfa0:/feature.bin

  Running Version             New Version

  Alpha 7122                  Alpha 7123

 

  Chassis   Slot              Upgrade Way

  1         0                 Service Upgrade

  1         0.1               File Upgrade

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

# 在单成员设备单主控板，版本兼容情况下，确认升级。（IRF模式）

<Sysname> issu commit chassis 1 slot 0

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

【相关命令】

·              issu load

·              issu run switchover

·              issu accept

1.1.6  issu load

issu load命令用来升级备用主控板的启动软件包并将备用主控板的主用下次启动软件包设置为指定的软件包。（独立运行模式）

issu load命令用来升级全局备用主控板的启动软件包并将全局备用主控板的主用下次启动软件包设置为指定的软件包。（IRF模式单成员设备）

issu load命令用来升级Standby的启动软件包并将Standby的主用下次启动软件包设置为指定的软件包。（IRF模式多成员设备）

【命令】

独立运行模式：

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

issu load file ipe ipe-filename slot slot-number

IRF模式单成员设备：

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

issu load file ipe ipe-filename chassis chassis-number slot slot-number

IRF模式多成员设备：

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>

【视图】

用户视图

【缺省用户角色】

network-admin

【参数】

boot：表示Boot包。

system：表示System包。

feature：表示Feature包。

filename：表示软件包的文件名，为1～63个字符的字符串。该文件必须是主用主控板存储介质根目录下，后缀名为.bin的文件，且文件名中必须包含存储介质的名称，且不能包含slot信息，形如flash:/a.bin。filename&<1-30>表示前面的参数最多可以输入30次。（独立运行模式）

filename：表示软件包的文件名，为1～63个字符的字符串。该文件必须是全局主用主控板存储介质根目录下，后缀名为.bin的文件，且文件名中必须包含存储介质的名称，且不能包含chassis和slot信息，形如flash:/a.bin。filename&<1-30>表示前面的参数最多可以输入30次。（IRF模式）

ipe ipe-filename：IPE文件名，以.ipe作为后缀名，为1～63个字符的字符串。该文件必须是主用主控板存储介质根目录下，后缀名为.ipe的文件，且文件名中必须包含存储介质的名称，形如flash:/a.ipe。（独立运行模式）

ipe ipe-filename：IPE文件名，以.ipe作为后缀名，为1～63个字符的字符串。该文件必须是全局主用主控板存储介质根目录下，后缀名为.ipe的文件，且文件名中必须包含存储介质的名称，形如flash:/a.ipe。（IRF模式）

slot slot-number：表示备用主控板的槽位号。如果设备只有一块主控板，则输入主用主控板的槽位号，用来完成整个设备的升级。（独立运行模式）

chassis chassis-number slot slot-number：如果IRF中只有一块主控板，则输入主用主控板所在设备的成员编号以及该主控板所在的槽位号，用来完成整个IRF的升级。如果设备上有两块主控板，则输入备用主控板所在设备的成员编号以及备用主控板所在的槽位号。（IRF模式单成员设备）

chassis chassis-number：表示Standby在IRF中的成员编号。chassis-number&<1-3>表示前面的参数最多可以输入3次。当要升级的软件包的版本和设备当前运行的软件包的版本兼容时，只允许输入一个chassis-number；当要升级的软件包的版本和设备当前运行的软件包的版本不兼容时，可以输入多个chassis-number，一次升级多个成员设备。（IRF模式多成员设备）

【使用指导】

(1)      独立运行模式

当设备上有两块主控板时，slot slot-number请指定为备用主控板的槽位号。输入该命令后，系统将自动执行以下操作：

·              进行版本兼容性检查。分为兼容版本的升级和不兼容版本的升级。

·              确定升级策略。兼容升级的策略包括增量、软重启和重启升级。不兼容升级的策略只有重启升级。其中，增量升级会升级对应的进程；软重启升级会对CPU进行重启升级；重启升级会自动重启指定主控板。

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

当设备上只有一块主控板时，slot slot-number指定为主用主控板的槽位号。输入该命令后，系统将自动执行以下操作：

·              进行版本兼容性检查，分为兼容版本的升级和不兼容版本的升级。

·              确定升级策略。兼容升级的策略包括增量、软重启和重启升级。不兼容升级的策略只有重启升级。其中，增量升级会升级对应的进程；软重启升级会对CPU进行重启升级；重启升级会以指定的软件包为下次启动软件包自动重启设备。

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

(2)      IRF模式

当IRF中只有一个成员设备且只有一块主控板时，chassis chassis-number slot slot-number请指定为主用主控板所在的槽位号。输入该命令后，系统将自动执行以下操作：

·              进行版本兼容性检查，分为兼容版本的升级和不兼容版本的升级。

·              确定升级策略。兼容升级的策略包括增量、软重启和重启升级。不兼容升级的策略只有重启升级。其中，增量升级会升级对应的进程；软重启升级对CPU进行重启升级；重启升级会自动重启主用主控板。

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

当IRF中只有一个成员设备且有两块主控板时，chassis chassis-number slot slot-number请指定为备用主控板所在的槽位号。输入该命令后，系统将自动执行以下操作：

·              进行版本兼容性检查，分为兼容版本的升级和不兼容版本的升级。

·              确定升级策略。兼容升级的策略包括增量、软重启和重启升级。不兼容升级的策略只有重启升级。其中，增量升级会升级对应的进程；软重启升级对CPU进行重启升级；重启升级会自动重启备用主控板。

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

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

·              进行版本兼容性检查，分为兼容版本的升级和不兼容版本的升级。

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

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

【举例】

# 版本兼容情况下，使用cfa0:/feature.bin升级slot1上的Feature包。（独立运行模式双主控）

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

Upgrade summary according to following table:

 

cfa0:/feature.bin

  Running Version             New Version

  Alpha 7122                  Alpha 7123

 

  Slot                        Upgrade Way

  1                           Service Upgrade

  1.1                         File Upgrade

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

# 版本不兼容情况下，使用cfa0:/feature.bin升级slot1上的Feature包。（独立运行模式双主控）

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

Upgrade summary according to following table:

 

cfa0:/feature.bin

  Running Version             New Version

  Alpha 7122                  Alpha 7123

 

  Slot                        Upgrade Way

  1                           Reboot

  1.1                         Reboot

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

# 版本兼容情况下，使用cfa0:/feature.bin升级slot0上的Feature包。（独立运行模式单主控）

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

Upgrade summary according to following table:

 

cfa0:/feature.bin

  Running Version             New Version

  Alpha 7122                  Alpha 7123

 

  Slot                        Upgrade Way

  0                           Service Upgrade

  0.1                         File Upgrade

  2                           Service Upgrade

  3                           Service Upgrade

  4                           Service Upgrade

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

# 版本不兼容情况下，使用cfa0:/feature.bin升级slot0上的Feature包。（独立运行模式单主控）

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

Upgrade summary according to following table:

 

cfa0:/feature.bin

  Running Version             New Version

  Alpha 7122                  Alpha 7123

 

  Slot                        Upgrade Way

  0                           Reboot

  0.1                         Reboot

  2                           Reboot

  3                           Reboot

  4                           Reboot

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

# 版本兼容情况下，使用cfa0:/feature.bin升级成员2上的Feature包。（IRF模式多成员设备）

<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

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         0.1               File Upgrade

  2         1                 Service Upgrade

  2         1.1               File Upgrade

  2         2                 Service Upgrade

  2         3                 Service Upgrade

  2         4                 Service Upgrade

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

# 版本不兼容情况下，使用cfa0:/feature.bin升级成员设备3和成员设备4上的Feature包。（IRF模式多成员设备）

<Sysname>issu load file feature cfa0:/feature.bin chassis 3 4

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:

 

cfa0:/feature.bin

  Running Version             New Version

  Alpha 7122                  Alpha 7123

 

  Chassis   Slot              Upgrade Way 

  3         0                 Reboot

  3         0.1               Reboot

  3         1                 Reboot

  3         1.1               Reboot

  3         2                 Reboot

  3         3                 Reboot

  3         4                 Reboot

  4         0                 Reboot

  4         0.1               Reboot

  4         1                 Reboot

  4         1.1               Reboot

  4         2                 Reboot

  4         3                 Reboot

  4         4                 Reboot

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

# 版本兼容情况下，使用cfa0:/feature.bin升级成员设备1的备用主控板slot 1上的Feature包。（IRF模式单成员设备双主控）

<Sysname>issu load file feature cfa0:/feature.bin chassis 1 slot 1

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:

 

cfa0:/feature.bin

  Running Version             New Version

  Alpha 7122                  Alpha 7123

 

  Chassis   Slot              Upgrade Way 

  1         1                 Service Upgrade

  1         1.1               File Upgrade

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

# 版本不兼容情况下，使用cfa0:/feature.bin升级成员设备1的备用主控板slot 1上的Feature包。（IRF模式单成员设备双主控）

<Sysname>issu load file feature cfa0:/feature.bin chassis 1 slot 1

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:

 

cfa0:/feature.bin

  Running Version             New Version

  Alpha 7122                  Alpha 7123

 

  Chassis   Slot              Upgrade Way 

  1         1                 Reboot

  1         1.1               Reboot

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

# 版本兼容情况下，使用cfa0:/feature.bin升级成员设备1的主用主控板slot0上的Feature包。（IRF模式单成员设备单主控）

<Sysname>issu load file feature cfa0:/feature.bin chassis 1 slot 0

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:

 

cfa0:/feature.bin

  Running Version             New Version

  Alpha 7122                  Alpha 7123

 

  Chassis   Slot              Upgrade Way

  1         0                 Service Upgrade

  1         0.1               File Upgrade

  1         2                 Service Upgrade

  1         3                 Service Upgrade

  1         4                 Service Upgrade

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

# 版本不兼容情况下，使用cfa0:/feature.bin升级成员设备1的主用主控板slot0上的Feature包。（IRF模式单成员设备单主控）

<Sysname>issu load file feature cfa0:/feature.bin chassis 1 slot 0

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:

 

cfa0:/feature.bin

  Running Version             New Version

  Alpha 7122                  Alpha 7123

 

  Chassis   Slot              Upgrade Way

  1         0                 Reboot

  1         0.1               Reboot

  1         2                 Reboot

  1         3                 Reboot

  1         4                 Reboot

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

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

字段	描述
This operation will delete the rollback point information for the previous upgrade and maybe get unsaved configuration lost. Continue? [Y/N]	当前操作会删除上一次ISSU升级的日志信息和回滚点，并且未保存的配置可能会丢失，询问用户是否继续执行升级操作
Upgrade summary according to following table	升级信息摘要
Running Version	设备当前运行的相同类型软件包的产品版本号
New Version	将要升级的软件包的产品版本号
Chassis	设备在IRF中的成员编号（IRF模式）
Slot	单板所在的槽位号
Upgrade Way	升级策略，取值可能为： ·       Service Upgrade：表示服务级增量升级，该方式下，仅对本业务模块有影响，对系统以及其他业务模块没有影响 ·       File Upgrade：表示文件级增量升级。该方式下，仅对系统内的、用户不可见的程序文件进行升级，对系统以及业务模块没有影响 ·       ISSU Reboot：表示通过软重启方式升级 ·       Reboot：表示通过重启方式升级 ·       Sequence Reboot：表示逐次重启方式。只有网板支持该升级方式，当网板需要重启升级时，为了避免重启升级过程中流量中断，系统会自动升级完毕一块网板后，再自动升级下一块网板，直到所有网板升级完毕后，再自动升级主控板。
Upgrading software images to compatible versions. Continue? [Y/N]	询问用户是否执行兼容升级操作
Upgrading software images to incompatible versions. Continue? [Y/N]	询问用户是否执行不兼容升级操作

 

1.1.7  issu rollback

issu rollback命令用来回退到升级前的版本。如果当前有多块单板或者成员设备已经升级，系统进行回滚操作时自动将所有已经升级单板或设备回退到升级前的版本。

【命令】

issu rollback

【视图】

用户视图

【缺省用户角色】

network-admin

【使用指导】

设备支持自动回滚和手动回滚，自动回滚定时器的时长由issu rollback-timer命令配置；手工回滚由issu rollback命令触发。

·              不兼容版本升级时，不会启动回滚定时器，即不支持自动回滚。兼容版本只有执行issu run switchover命令时才会创建回滚定时器，因此，自动回滚只有在兼容版本ISSU升级状态为Swtiching后才生效。

·              单主控兼容升级不支持自动回滚。

·              当ISSU升级状态为Loading时进行手工回滚，则直接退出本次升级，并且不会进行回滚操作。

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

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

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

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

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

【举例】

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

<Sysname> issu rollback

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

【相关命令】

·              issu load

·              issu run switchover

·              issu accept

·              issu commit

1.1.8  issu rollback-timer

issu rollback-timer命令用来设置回滚定时器时长。

undo issu rollback-timer命令用来恢复缺省情况。

【命令】

issu rollback-timer minutes

undo issu rollback-timer

【缺省情况】

回滚定时器的时长为45分钟。

【视图】

系统视图

【缺省用户角色】

network-admin

【参数】

minutes：回滚定时器的时长，取值范围为0～120，单位为分钟。如果时长设置为0，则表示关闭自动回滚功能。

【使用指导】

兼容版本升级的情况下，执行issu run switchover命令后系统会自动启动回滚定时器。如果在指定的时间内（回滚定时器超时前）未执行issu accept或者issu commit命令，则系统会自动回退到升级前的版本。

不兼容升级不会启动回滚定时器。

只有一个主控板的设备进行升级不会启动回滚定时器。

新设置的时长会在下次ISSU升级中生效。

【举例】

# 设置回滚定时器时长为50分钟。

<Sysname> system-view

[Sysname] issu rollback-timer 50

【相关命令】

·              issu rollback

1.1.9  issu run switchover

独立运行模式：

issu run switchover命令在升级兼容软件包的情况下，用来进行ISSU倒换，并且升级接口板。升级不兼容软件包的情况下，用来进行ISSU倒换，并且将剩余待升级的所有板进行升级。

IRF模式单成员设备：

issu run switchover命令在升级兼容软件包的情况下，用来进行ISSU倒换，并且升级接口板。升级不兼容软件包的情况下，用来进行ISSU倒换，并且将剩余待升级的所有板进行升级。

IRF模式多成员设备：

issu run switchover命令在升级兼容软件包的情况下，用来进行ISSU倒换。升级不兼容软件包的情况下，用来进行ISSU倒换，并且将剩余待升级的框进行升级。

【命令】

issu run switchover

【视图】

用户视图

【缺省用户角色】

network-admin

【使用指导】

(1)      独立运行模式

当设备上有两块主控板时，输入该命令后，系统将自动执行以下操作：

·              兼容升级：增量升级时系统会将升级的进程进行进程级主备倒换；软重启或者重启升级时系统会将当前主用主控板使用原版本重新启动，将刚使用issu load命令升级的备用主控板上倒换成主用主控板。同时升级接口板。

·              不兼容升级：当前主用主控板和接口板以新版本重新启动，刚使用issu load命令升级的备用主控板倒换成主用主控板，原有主用主控板和接口板重启完成后即完成升级过程。

当设备上只有一块主控板并需要升级时，不需要使用此命令。

(2)      IRF模式

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

·              兼容升级：增量升级时系统会将升级的进程进行进程级主备倒换；软重启或者重启升级时系统会将当前主用主控板使用原版本重新启动，将刚使用issu load命令升级的备用主控板上倒换成主用主控板，同时升级接口板。

·              不兼容升级：当前主用主控板和接口板以新版本重新启动，刚使用issu load命令升级的备用主控板倒换成主用主控板，原有主用主控板和接口板重启完成后即完成升级过程。

当设备上只有一个成员并且只有一个主控板且需要升级时，不需要使用此命令。

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

·              兼容版本升级：增量升级时系统会对升级的进程进行了进程级主备倒换；软重启或者重启升级时系统会将当前Master的主控板使用原版本重新启动，将刚使用issu load命令升级完成的Standby选举为IRF的Master。

·              不兼容版本升级：执行issu load后IRF分裂，生成两个的IRF。执行issu run switchover重启并升级原IRF，原IRF重启后加入新的IRF即完成升级过程，系统选择新IRF的Master为合并后IRF的Master。

需要注意的是：

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

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

·              不兼容版本升级执行issu run switchover之后，即完成升级过程。

【举例】

# 版本兼容情况下，进行主备倒换，同时升级接口板。（独立运行模式双主控）

<Sysname> issu run switchover

Upgrade summary according to following table:

 

cfa0:/feature.bin

  Running Version             New Version

  Alpha 7122                  Alpha 7123

 

  Slot                        Switchover Way

  0                           Active standby process switchover

  0.1                         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]:

# 版本不兼容情况下，进行主备倒换，同时升级原主板和接口板。（独立运行模式双主控）

<Sysname> issu run switchover

Upgrade summary according to following table:

 

cfa0:/feature.bin

  Running Version             New Version

  Alpha 7122                  Alpha 7123

  

  Slot                        Upgrade Way

  0                           Reboot

  0.1                         Reboot

  2                           Reboot

  3                           Reboot

  4                           Reboot

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

# 版本兼容情况下，进行主备倒换。（IRF模式多成员设备）

<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

  1         0.1               Active standby process switchover

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

# 版本不兼容情况下，进行主备倒换，同时升级成员设备1和成员设备2。（IRF模式多成员设备）

<Sysname> issu run switchover

Upgrade summary according to following table:

 

cfa0:/feature.bin

  Running Version             New Version

  Alpha 7122                  Alpha 7123

 

  Chassis   Slot              Upgrade Way

  1         0                 Reboot

  1         0.1               Reboot

  1         1                 Reboot

  1         1.1               Reboot

  1         2                 Reboot

  1         3                 Reboot

  1         4                 Reboot

  2         0                 Reboot

  2         0.1               Reboot

  2         1                 Reboot

  2         1.1               Reboot

  2         2                 Reboot

  2         3                 Reboot

  2         4                 Reboot

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

# 版本兼容情况下，进行主备倒换，同时升级接口板。（IRF模式单成员设备双主控）

<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

  1         0.1               Active standby process switchover

 

  Chassis   Slot              Upgrade Way

  1         2                 Service Upgrade

  1         3                 Service Upgrade

  1         4                 Service Upgrade

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

# 版本不兼容情况下，进行主备倒换，同时升级原主控板和接口板。（IRF模式单成员设备双主控）

<Sysname> issu run switchover

Upgrade summary according to following table:

 

cfa0:/feature.bin

  Running Version             New Version

  Alpha 7122                  Alpha 7123

 

  Chassis   Slot              Upgrade Way

  1         0                 Reboot

  1         0.1               Reboot

  1         2                 Reboot

  1         3                 Reboot

  1         4                 Reboot

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

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

字段	描述
Switchover Way	倒换方式，取值可能为： ·       Active standby process switchover：表示主备进程的倒换。 ·       Active standby MPU switchover：表示主备主控板之间的倒换（独立运行模式） ·       Global active standby MPU switchover：表示全局主备主控板之间的倒换（IRF模式）
其它字段	请参见表1-2

 

【相关命令】

·              issu load

1.2  通过install命令升级配置命令

1.2.1  display install active

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

mdc-admin

mdc-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:/ssh-feature.bin

Active packages on slot 1.1:

  flash:/boot.bin

  flash:/system.bin

  flash:/ssh-feature.bin

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

<Sysname> display install active

Active packages on chassis 1 slot 1:

  flash:/boot.bin

  flash:/system.bin

  flash:/ssh-feature.bin

Active packages on chassis 1 slot 1.1:

  flash:/boot.bin

  flash:/system.bin

  flash:/ssh-feature.bin

# 显示设备上处于激活状态的软件包的详细信息。（独立运行模式）

<Sysname>display install active verbose

Active packages on slot 1:

flash:/boot.bin

 [Package]

 Vendor: H3C

 Product: xxxx

 Service name: boot

 Platform version: 7.1.025

 Product version: Beta 1330

 Supported board: mr, lc, sfc

 [Component]

 Component: boot

 Description: boot package

 

flash:/system.bin

 [Package]

 Vendor: H3C

 Product: xxxx

 Service name: system

 Platform version: 7.1.025

 Product version: Beta 1330

 Supported board: mr, lc, sfc

 [Component]

 Component: system

 Description: system package

 

flash:/ssh-feature.bin

 [Package]

 Vendor: H3C

 Product: xxxx

 Service name: ssh

 Platform version: 7.1.025

 Product version: Beta 1330

 Supported board: mr, lc, sfc

 [Component]

 Component: ssh

 Description: ssh package

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

<Sysname>display install active verbose

Active packages on chassis 1 slot 1:

flash:/boot.bin

 [Package]

 Vendor: H3C

 Product: xxxx

 Service name: boot

 Platform version: 7.1.025

 Product version: Beta 1330

 Supported board: mr, lc, sfc

 [Component]

 Component: boot

 Description: boot package

 

flash:/system.bin

 [Package]

 Vendor: H3C

 Product: xxxx

 Service name: system

 Platform version: 7.1.025

 Product version: Beta 1330

 Supported board: mr, lc, sfc

 [Component]

 Component: system

 Description: system package

 

flash:/ssh-feature.bin

 [Package]

 Vendor: H3C

 Product: xxxx

 Service name: ssh

 Platform version: 7.1.025

 Product version: Beta 1330

 Supported board: mr, lc, sfc

 [Component]

 Component: ssh

 Description: ssh package

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

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

 

【相关命令】

·              install active

1.2.2  display install backup

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

mdc-admin

mdc-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-r7122.bin

  flash:/system-r7122.bin

Backup startup software images on slot 1.1:

  flash:/boot-r7122.bin

  flash:/system-r7122.bin

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

<Sysname> display install backup

Backup startup software images on chassis 1 slot 1:

  flash:/boot-r7122.bin

  flash:/system-r7122.bin

Backup startup software images on chassis 1 slot 1.1:

  flash:/boot-r7122.bin

  flash:/system-r7122.bin

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

<Sysname> display install backup verbose

Backup startup software images on slot 1:

 flash:/boot-r7122.bin

 [Package]

 Vendor: H3C

 Product: xxxx

 Service name: boot

 Platform version: 7.1.025

 Product version: Beta 1330

 Supported board: mr, lc, sfc

 [Component]

 Component: boot

 Description: boot package

 

 flash:/system-r7122.bin

 [Package]

 Vendor: H3C

 Product: xxxx

 Service name: system

 Platform version: 7.1.025

 Product version: Beta 1330

 Supported board: mr, lc, sfc

 [Component]

 Component: system

 Description: system package

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

【相关命令】

·              display install committed

·              boot-loader file（基础配置指导/软件升级）

1.2.3  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

mdc-admin

mdc-operator

【参数】

slot slot-number：表示主控板所在的槽位号。不指定该参数时，表示设备上的所有主控板。（独立运行模式）

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

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

【使用指导】

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

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

【举例】

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

<Sysname> display install committed

Committed packages on slot 1:

 flash:/boot-r7122.bin

 flash:/system-r7122.bin

 flash:/feature.bin

Committed packages on slot 1.1:

 flash:/boot-r7122.bin

 flash:/system-r7122.bin

 flash:/feature.bin

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

<Sysname> display install committed verbose

Committed packages on slot 1:

 flash:/boot-r7122.bin

 [Package]

 Vendor: H3C

 Product: xxxx

 Service name: boot

 Platform version: 7.1.025

 Product version: Beta 1330

 Supported board: mr, lc, sfc

 [Component]

 Component: boot

 Description: boot package

 

 flash:/system-r7122.bin

 [Package]

 Vendor: H3C

 Product: xxxx

 Service name: system

 Platform version: 7.1.025

 Product version: Beta 1330

 Supported board: mr, lc, sfc

 [Component]

 Component: system

 Description: system package

 

flash:/ssh-feature.bin

 [Package]

 Vendor: H3C

 Product: xxxx

 Service name: ssh

 Platform version: 7.1.025

 Product version: Beta 1330

 Supported board: mr, lc, sfc

 [Component]

 Component: ssh

 Description: ssh package

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

【相关命令】

·              display install backup

·              install commit

·              boot-loader file（基础配置指导/软件升级）

1.2.4  display install inactive

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

mdc-admin

mdc-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:/ssh-feature.bin

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

<Sysname> display install inactive verbose

Inactive packages on slot 1:

flash:/ssh-feature.bin

 [Package]

 Vendor: H3C

 Product: XXXX

 Service name: ssh

 Platform version: 7.1.025

 Product version: Beta 1330

 Supported board: mr, lc, sfc

 [Component]

 Component: ssh

 Description: ssh package

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

【相关命令】

·              install deactivate

1.2.5  display install ipe-info

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

【命令】

display install ipe-info ipe-file

【视图】

任意视图

【缺省用户角色】

network-admin

network-operator

mdc-admin

mdc-operator

【参数】

ipe-file：表示IPE文件名，以.ipe作为后缀名，为1～63个字符的字符串，必须指定存储介质的名称，比如flash。如果该IPE文件不存在，命令执行失败。

【使用指导】

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

【举例】

# 显示12500-ssh.ipe的IPE信息。

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

Images in IPE:

  ssh.bin

以上显示信息表明：IPE文件flash:/12500-ssh.ipe中只包含了一个SSH特性包ssh.bin。

【相关命令】

·              display install package

1.2.6  display install job

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

【命令】

display install job

【视图】

任意视图

【缺省用户角色】

network-admin

network-operator

mdc-admin

mdc-operator

【举例】

# 显示系统中正在执行的激活、卸载、回滚三种ISSU操作。（独立运行模式）

<Sysname> display install job

 JobID:5

  Action:install activate flash:/ssh-feature.bin on slot 1

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

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

<Sysname> display install job

 JobID:5

  Action:install activate flash:/ssh-feature.bin on chassis 1 slot 1

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

1.2.7  display install log

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

【命令】

display install log [ log-id ] [ verbose ]

【视图】

任意视图

【缺省用户角色】

network-admin

network-operator

mdc-admin

mdc-operator

【参数】

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

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

【使用指导】

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

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

【举例】

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

<Sysname> display install log

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

Job 1 completed successfully at 04/28/2010 08:39:29.

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

    Install activate flash:/ssh.bin on slot 1

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

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

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

Job 2 completed successfully at 04/28/2010 08:40:29.

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/2010 08:40:30.

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

<Sysname> display install log 1 verbose

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

Job 1 completed successfully at 04/28/2010 08:39:29.

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

    Install activate flash:/ssh.bin on slot 1

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

 

Detail of activating packages on slot 1.

    Got upgrade policy successfully.

 

Detail of activating packages on slot 1.

    Uncompressed package to system successfully.

    Removed files from system successfully.

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

字段	描述
Got upgrade policy successfully	表示升级决策处理成功
Uncompressed package to system successfully	解压软件包文件到系统成功
Removed files from system successfully	从系统中删除文件成功

 

【相关命令】

·              reset install log-history oldest

1.2.8  display install package

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

【命令】

display install package { filename | all } [ verbose ]

【视图】

任意视图

【缺省用户角色】

network-admin

network-operator

mdc-admin

mdc-operator

【参数】

filename：表示软件包的文件名，为1～63个字符的字符串，不区分大小写。该文件必须是存储介质根目录下，后缀名为.bin的文件。如果是主用主控板上的文件，则形式为flash:/纯文件名；如果是备用主控板上的文件，则形式为slotn#flash:/纯文件名，n为备用主控板所在的槽位号。（独立运行模式）

filename：表示软件包的文件名，为1～63个字符的字符串，不区分大小写。该文件必须是存储介质根目录下，后缀名为.bin的文件。如果是全局主用主控板上的文件，则形式为flash:/纯文件名；如果是全局备用主控板上的文件，则形式为chassism#slotn#flash:/纯文件名，m为设备的成员编号，n为成员设备上主控板所在的槽位号。（IRF模式）

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

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

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

【举例】

# 显示软件包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: mr, lc, sfc

# 显示软件包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: mr, lc, sfc

  [Component]

  Component: system

  Description: system package

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

1.2.9  display install rollback

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

【命令】

display install rollback [ point-id ]

【视图】

任意视图

【缺省用户角色】

network-admin

network-operator

mdc-admin

mdc-operator

【参数】

point-id：回滚点的编号。

【使用指导】

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

【举例】

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

<Sysname> display install rollback

Install rollback information 1 on slot 0:

  Updating from flash:/route-1.bin

         to flash:/route-2.bin.

 

Install rollback information 2 on slot 0:

   Deactivating flash:/route-2.bin

以上显示信息表明：设备上共有两个回滚点，回滚点1是将flash:/route-1.bin升级到了flash:/route-2.bin，回滚点2是将flash:/route-2.bin卸载了。

【相关命令】

·              install rollback

·              reset install rollback oldest

1.2.10  display install which

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

mdc-admin

mdc-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文件运行错误的时候，可以根据组件/文件的名字使用该命令查找它属于哪个软件包，从而可以进一步定位是否是软件包本身有缺陷。

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

【举例】

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

<Sysname> display install which file sshc.cli

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

  flash:/ssh-feature.bin

  [Package]

  Vendor: H3C

  Product: xxxx

  Service name: ssh

  Platform version: 7.1.022

  Product version: Beta 1330

  Supported board: mr, lc, sfc

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

1.2.11  install abort

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

【命令】

install abort

【视图】

用户视图

【缺省用户角色】

network-admin

mdc-admin

【使用指导】

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

【举例】

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

<Sysname> install abort

【相关命令】

·              display install job

1.2.12  install activate

install activate命令用来激活软件包或者补丁包。

【命令】

独立运行模式：

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

install activate patch filename 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 chassis chassis-number slot slot-number

【视图】

用户视图

【缺省用户角色】

network-admin

mdc-admin

【参数】

boot：表示Boot包。Boot包用于引导设备，是设备运行的基础，本身不提供业务能力。

system：表示System包。System包是设备基本业务能力的提供者，需要和Boot包配合使用。

feature：表示Feature包。Feature包是定制业务能力的提供者，运行在Boot包和System包的基础上。比如HTTP特性包，可提供HTTP业务。filename &<1-30>表示前面的参数最多可以输入30次。

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

filename：表示软件包的文件名，为1～63个字符的字符串，不区分大小写。该文件必须是主用主控板存储介质根目录下，后缀名为.bin的文件，且文件名中必须包含存储介质的名称，且不能包含slot信息，形如flash:/a.bin。（独立运行模式）

filename：表示软件包的文件名，为1～63个字符的字符串，不区分大小写。该文件必须是全局主用主控板存储介质根目录下，后缀名为.bin的文件，且文件名中必须包含存储介质的名称，且不能包含chassis和slot信息，形如flash:/a.bin。（IRF模式）

slot slot-number：表示主控板所在的槽位号。（独立运行模式）

chassis chassis-number slot slot-number：chassis-number表示设备在IRF中的成员编号，slot-number表示主控板所在的槽位号。（IRF模式）

test：表示对升级进行预测，并不真正升级。升级预测能预测指定软件包所需要的升级策略：增量升级、软重启升级或重启升级，同时给出相应的提示信息以方便用户操作。不带该参数时，表示直接执行升级操作。

【使用指导】

设备提供三种升级方式：增量升级、软重启和重启。这三种方式都能实现升级过程中业务不中断，但升级过程有差异。进行ISSU升级时，设备会根据新、旧软件版本差异自动选择一种升级方式。

·              增量升级，其原理为通过分析升级前后版本间的差异，仅对差异部分的进程实施升级，该升级方式对系统影响最小、升级速度最快，为ISSU升级的最佳方式。

·              软重启升级实质为将系统运行瞬间的数据（运行数据、配置数据、硬件数据）全部保存在系统中，再使用新软件重启CPU，重启期间硬件继续提供转发能力。CPU重启后使用上次保存的数据、状态继续运行。相比增量升级而言，软重启影响了所有模块，升级时间较长且需要一半的内存。软重启升级一般用于某些关键程序（如内核）的升级，或者新旧版本软件无法做到完全兼容时实施。

·              重启升级方式是通过重启本主控板（包括CPU和转发芯片）加载新软件的方式完成升级。如果该设备有备用主控板，请先升级备用主控板，然后升级主用主控板，同时让备用主控板来接替原主用主控板的工作，最终实现整台设备的ISSU升级。如果设备没有备用主控板，则该方式无法保证在升级过程中业务不中断。

需要注意的是，

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

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

【举例】

# 预测升级主控板1上的Feature包ssh2.bin。（独立运行模式）

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

Upgrade summary according to following table:

 

flash:/ssh2.bin

  Running Version             New Version

  Beta 1330                   Beta 1331

 

  Slot                        Upgrade Way

  1                           Service Upgrade

  1.1                         File Upgrade

 

Influenced service according to following table:

flash:/ssh2.bin

     SSH       IFMGR     CFA       LAGG

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

# 预测升级成员设备1的0号主控板上的feature包ssh2.bin。（IRF模式）

<Sysname>install activate feature flash:/ssh2.bin chassis 1 slot 0 test

Upgrade summary according to following table:

 

flash:/ssh2.bin

  Running Version             New Version

  Beta 1330                   Beta 1331

 

  Chassis   Slot              Upgrade Way

  1         0                 Service Upgrade

  1         0.1               File Upgrade

  1         4                 Service Upgrade

 

Influenced service according to following table:

flash:/ssh2.bin

     SSH       IFMGR     CFA       LAGG

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

# 激活主控板1上的System包system.bin和Feature包feature.bin。（独立运行模式）

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

Upgrade summary according to following table:

 

flash:/system.bin

  Running Version             New Version

  Beta 1330                   Beta 1331

 

flash:/feature.bin

  Running Version             New Version

  None                        Beta 1330

 

  Slot                        Upgrade Way

  1                           Service Upgrade

  1.1                         File Upgrade

  2                           Service Upgrade

  3                           ISSU Reboot

  4                           Reboot

  5                           Sequence Reboot

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

# 激活升级成员设备1的0号主控板上的Feature包route-feature.bin。（IRF模式）

<Sysname> install activate feature flash:/route-feature.bin chassis 1 slot 0

Upgrade summary according to following table:

 

flash:/route-feature.bin

  Running Version             New Version

  None                        Beta 1330

 

  Chassis   Slot              Upgrade Way

  1         0                 Service Upgrade

  1         0.1               File Upgrade

  1         4                 Service Upgrade

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

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

字段	描述
Upgrade summary according to following table	升级摘要信息
Running Version	设备当前运行的相同类型软件包的产品版本号
New Version	目标软件包的产品版本号
Chassis	设备在IRF中的成员编号（IRF模式）
Slot	单板所在的槽位号
Upgrade Way	升级策略，取值可能为： ·       Service Upgrade：表示服务级增量升级，该方式下，仅对本业务模块有影响，对系统以及其他业务模块没有影响 ·       File Upgrade：表示文件级增量升级。该方式下，仅对系统内的、用户不可见的程序文件进行升级，对系统以及业务模块没有影响 ·       ISSU Reboot：表示通过软重启方式升级 ·       Reboot：表示通过重启方式升级 ·       Sequence Reboot：表示逐次重启方式。只有网板支持该升级方式，当网板需要重启升级时，为了避免重启升级过程中流量中断，系统会自动升级完毕一块网板后，再自动升级下一块网板，直到所有网板升级完毕后，再自动升级主控板。
Influenced service according to following table	将受影响的功能模块
Upgrading software images to compatible versions. Continue? [Y/N]	询问用户是否执行兼容升级操作
Upgrading software images to incompatible versions. Continue? [Y/N]	询问用户是否执行不兼容升级操作

 

【相关命令】

·              install commit

·              install deactivate

·              display install active

1.2.13  install add

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

【命令】

install add ipe-file medium-name:

【视图】

用户视图

【缺省用户角色】

network-admin

mdc-admin

【参数】

ipe-file：IPE文件名，以.ipe作为后缀名，为1～63个字符的字符串，必须指定存储介质的名称，比如flash:/new.ipe，否则，命令执行失败。

medium-name：存储介质的名称。如果是解压缩到主用主控板上，则为flash或cfa0；如果是解压缩到备用主控板上，则为slotn#flash或slotn#cfa0，n为备用主控板所在的槽位号。（独立运行模式）

medium-name：存储介质的名称。如果是解压缩到全局主用主控板上，则为flash或cfa0；如果是解压缩到全局备用主控板上，则为chassism#slotn#flash或chassism#slotn#cfa0，m为设备的成员编号，n为成员设备上主控板所在的槽位号。（IRF模式）

【使用指导】

IPE文件是多个软件包的集合。将多个软件包整合成一个IPE文件对外发布，以便减少BIN包之间的版本管理问题。用户获取IPE文件后，可以使用display install ipe-info命令查看该IPE文件中包含了哪些软件包，可以通过install add命令将IPE文件解压生成软件包，再利用软件包更新设备软件。

【举例】

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

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

1.2.14  install commit

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

【命令】

install commit

【视图】

用户视图

【缺省用户角色】

network-admin

mdc-admin

【使用指导】

执行install activate、install deactivate、install rollback命令会修改设备当前运行的软件包列表，使得只有符合用户需求的软件运行，不符合要求的不运行。但是这些修改只在设备的本次运行过程有效，要使这个修改结果在设备下次重启后继续生效，需要执行install commit命令进行确认。确认后的软件包会列入设备主用下次启动软件包列表。

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

【举例】

# 确认软件包更改。

<Sysname> install commit

【相关命令】

·              install activate

·              install deactivate

·              install rollback

1.2.15  install deactivate

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

【命令】

独立运行模式：

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

install deactivate patch filename slot slot-number

IRF模式：

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

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

【视图】

用户视图

【缺省用户角色】

network-admin

mdc-admin

【参数】

filename：表示需要卸载Feature包或补丁包的文件名，为1～63个字符的字符串，不区分大小写。该文件必须是后缀名为.bin的文件，且文件名中必须包含存储介质的名称，形如flash:/a.bin。filename &<1-30>表示前面的参数最多可以输入30次。

slot slot-number：表示主控板所在的槽位号。（独立运行模式）

chassis chassis-number slot slot-number：chassis-number表示设备在IRF中的成员编号，slot-number表示主控板所在的槽位号。（IRF模式）

【使用指导】

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

【举例】

# 卸载0号主控板上的patch包route-patch.bin。（独立运行模式）

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

# 卸载成员设备1的0号槽位的主控板上的feature包route-feature.bin。（IRF模式）

<Sysname> install deactivate feature flash:/route-feature.bin chassis 1 slot 0

【相关命令】

·              display install active

·              display install inactive

1.2.16  install remove

install remove命令用来删除指定的软件包。

【命令】

独立运行模式：

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

IRF模式：

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

【视图】

用户视图

【缺省用户角色】

network-admin

mdc-admin

【参数】

slot slot-number：表示主控板所在的槽位号。不指定该参数时，表示设备上的所有主控板。（独立运行模式）

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

filename：表示软件包的文件名，为1～63个字符的字符串，不区分大小写。该文件必须是主用主控板存储介质根目录下，后缀名为.bin的文件，且文件名中必须包含存储介质的名称，形如flash:/a.bin。（独立运行模式）

filename：表示软件包的文件名，为1～63个字符的字符串，不区分大小写。该文件必须是全局主用主控板存储介质根目录下，后缀名为.bin的文件，且文件名中必须包含存储介质的名称，形如flash:/a.bin。（IRF模式）

inactive：表示将删除指定存储介质根目录下、没有被激活的所有软件包。

【使用指导】

·              该命令只能删除存储介质根目录下、没有被激活的软件包。

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

【举例】

# 删除软件包flash:/ssh-feature.bin。

<Sysname> install remove flash:/ssh-feature.bin

1.2.17  install rollback to

install rollback to命令用来回滚到指定的回滚点，即按回滚点上记录的信息，进行回滚操作。

【命令】

install rollback to { point-id | original }

【视图】

用户视图

【缺省用户角色】

network-admin

mdc-admin

【参数】

point-id：回滚点的编号，可以用display install rollback命令查看系统中存在的回滚点。

original：回滚到ISSU升级初始状态。

【使用指导】

当升级方式为增量升级时，每次激活或者卸载软件包之后，系统中将运行新的软件特性集（即不同于升级前的软件包集合），系统将这些变化记录为回滚点，并提供回滚功能。通过回滚功能，可将系统回滚到某个历史状态，或者恢复上一次确认的软件特性集。

当升级方式为增量升级时，软件包回滚只在设备本次运行过程中生效，用户只有通过install commit命令确认软件包的更改后，才能使此次的回滚操作在系统重启后生效；当设备进行软重启升级或重启升级时，用户不需要执行install commit命令，此次的回滚操作在系统重启后也会生效。

当升级方式为增量升级时，系统最多支持50个回滚点，当回滚点超过最大值时，旧的回滚点会被删除，新的回滚点会被保存。

当升级方式为软重启或重启升级时，旧的回滚点会被删除，系统只支持一次回滚点，即只支持回滚到系统升级初始状态。

【举例】

# 回滚到回滚点1。

<Sysname>install rollback to 1

# 回滚到original回滚点。可通过观察active列表和回滚点的变化看出执行的结果。

<Sysname> display install active

Active packages on slot 0:

  flash:/boot-r7122.bin

  flash:/system-r7122.bin

  flash:/ssh-feature-r7122.bin

Active packages on slot 0.1:

  flash:/boot-r7122.bin

  flash:/system-r7122.bin

  flash:/ssh-feature-r7122.bin

<Sysname> display install rollback

Install rollback information 1 on slot 0:

  Updating from flash:/ssh-feature-r7122.bin

         to flash:/ssh-feature-r7122.bin.

以上显示信息表明，当前激活的包有三个，但是确认的只有两个，回滚点1是激活了flash:/ssh-feature-r7122.bin。

<Sysname> install rollback to original

<Sysname> display install active

Active packages on slot 0:

  flash:/boot-r7122.bin

  flash:/system-r7122.bin

Active packages on slot 0.1:

  flash:/boot-r7122.bin

  flash:/system-r7122.bin

<Sysname> display install committed

Committed packages on slot 0:

  flash:/boot-r7122.bin

  flash:/system-r7122.bin

Committed packages on slot 0.1:

  flash:/boot-r7122.bin

  flash:/system-r7122.bin

执行install rollback to original命令后，设备运行的软件集恢复到ISSU升级初始状态，flash:/ssh-feature-r7122.bin被卸载。

【相关命令】

·              display install rollback

1.2.18  install verify

install verify命令用来执行软件包检验。

【命令】

install verify

【视图】

用户视图

【缺省用户角色】

network-admin

mdc-admin

【使用指导】

正常情况下，设备上各主控板运行的软件必须完整并且版本应该一致，各主控板上处于激活状态的软件包应该和已确认的软件包一致，否则，会影响设备的主备倒换，以及导致主控板重启前后运行的软件版本不一致甚至不能正常启动。（独立运行模式）

正常情况下，IRF中上各成员设备运行的软件必须完整并且版本应该一致，各成员设备上处于激活状态的软件包应该和已确认的软件包一致，否则，会影响Master和Standby的倒换，以及导致成员设备重启前后运行的软件版本不一致甚至不能正常启动。（IRF模式）

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

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

·              当系统提示您软件包有不一致的地方时，请使用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.

    flash:/boot-a0101.bin verification successful.

    flash:/system-a0101.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.

    flash:/boot-a0101.bin verification successful.

    flash:/system-a0101.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 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 0:

  Start to check active package completeness.

    flash:/boot-a0101.bin verification successful.

    flash:/system-a0101.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 1 slot 1:

  Start to check active package completeness.

    flash:/boot-a0101.bin verification successful.

    flash:/system-a0101.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.

1.2.19  reset install log-history oldest

reset install log-history oldest命令用来清除ISSU相关的日志信息。

【命令】

reset install log-history oldest log-number

【视图】

用户视图

【缺省用户角色】

network-admin

mdc-admin

【参数】

log-number：ISSU日志的数量。

【使用指导】

使用该命令，系统将清除指定数量的时间最老的与ISSU升级相关的日志。

【举例】

# 清除2条最老的ISSU日志。

<Sysname> reset install log-history oldest 2

【相关命令】

·              display install log

1.2.20  reset install rollback oldest

reset install rollback oldest命令用来清除ISSU回滚点。

【命令】

reset install rollback oldest point-id

【视图】

用户视图

【缺省用户角色】

network-admin

mdc-admin

【参数】

point-id：系统存储的回滚点。

【使用指导】

使用该命令，系统将清除指定回滚点以及比该回滚点更老的回滚点。

【举例】

# 清除编号为2以及比2号回滚点更老的回滚点。

<Sysname> reset install rollback oldest 2

【相关命令】

·              display install rollback