目  录

1 软件升级

1.1 软件升级配置命令

1.1.1 boot-loader file

1.1.2 boot-loader update

1.1.3 bootrom update

1.1.4 display boot-loader

1.1.5 display install active

1.1.6 display install backup

1.1.7 display install committed

1.1.8 display install inactive

1.1.9 display install ipe-info

1.1.10 display install job

1.1.11 display install log

1.1.12 display install package

1.1.13 display install rollback

1.1.14 display install which

1.1.15 display version comp-matrix

1.1.16 firmware update

1.1.17 install abort

1.1.18 install activate

1.1.19 install add

1.1.20 install commit

1.1.21 install deactivate

1.1.22 install remove

1.1.23 install rollback to

1.1.24 install verify

1.1.25 reset install log-history oldest

1.1.26 reset install rollback oldest

1.1.27 version auto-update enable

1.1.28 version check ignore

 

1 软件升级

 

如果将U盘内的软件包指定为设备下次启动时使用的软件包，重启设备时不要将U盘从设备上拔出，否则可能导致设备无法正常启动。建议将Flash中的软件包指定为设备下次启动时使用的软件包。

1.1  软件升级配置命令

1.1.1  boot-loader file

boot-loader file命令用来指定设备下次启动时使用的软件包/IPE文件（以下简称下次启动软件包/IPE文件）。

【命令】

集中式设备－独立运行模式：

boot-loader file boot boot-package system system-package [ feature feature-package&<1-30> ] { backup | main }

boot-loader file ipe-filename { backup | main }

分布式设备－独立运行模式/集中式设备－IRF模式：

boot-loader file boot boot-package system system-package [ feature feature-package&<1-30> ] { all | slot slot-number } { backup | main }

boot-loader file ipe-filename { all | slot slot-number } { backup | main }

分布式设备－IRF模式：

boot-loader file boot boot-package system system-package [ feature feature-package&<1-30> ] { all | chassis chassis-number slot slot-number } { backup | main }

boot-loader file ipe-filename { all | chassis chassis-number slot slot-number } { backup | main }

【视图】

用户视图

【缺省用户角色】

network-admin

【参数】

boot boot-package：Boot包的名称，以.bin作为后缀名，从存储介质名开始最多可输入63个字符，不区分大小写。

system system-package：System包的名称，以.bin作为后缀名，从存储介质名开始最多可输入63个字符，不区分大小写。

feature feature-package：Feature包的名称，以.bin作为后缀名，从存储介质名开始最多可输入63个字符，不区分大小写。feature-package&<1-30>表示前面的参数最多可以输入30次。

ipe-filename：表示IPE（Image Package Envelope，复合软件包套件）文件的名称，以.ipe作为后缀名，从存储介质名开始最多可输入63个字符，不区分大小写。

all：用来升级整个系统。当用户获取的IPE包中包含IRF系统升级需要的所有软件包时，使用这样的IPE包，并指定all参数，执行一次boot-loader file命令，就能指定系统中所有硬件下次启动时使用的软件包/IPE文件。

slot slot-number：表示待升级的主控板所在的槽位号。（分布式设备－独立运行模式）

slot slot-number：表示待升级的成员设备的编号。（集中式设备－IRF模式）

chassis chassis-number slot slot-number：表示待升级的成员设备上的指定主控板。（分布式设备－IRF模式）

backup：指定该软件包为备用启动软件包，并将该软件包的名称添加到备用启动软件包列表。备用启动软件包用于主用启动软件包不可用或异常情况时，引导设备启动。

main：指定该软件包为主用启动软件包，并将该软件包的名称添加到主用启动软件包列表。主用启动软件包用于引导设备启动。

【使用指导】

请不要通过多个用户同时执行该命令，以免配置失败。

(1)     集中式设备－独立运行模式

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

·     对于boot-loader file boot boot-package system system-package [ feature feature-package&<1-30> ] { backup | main }命令，只要指定某个的软件包当前没有有效的License，就会导致整条命令配置失败。

·     对于boot-loader file ipe-filename { backup | main }命令，只有当前没有有效的License的软件包配置失败，其它软件包会配置成功。

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

成功执行该命令后，系统会用命令中指定的软件包替换现有的软件包列表。如果命令行中没有指定Feature包，则更新后的软件包列表中不会有Feature包。

(2)     分布式设备－独立运行模式/集中式设备－IRF模式/分布式设备－IRF模式

请先查看软件包版本发布说明书，如果软件包需要License才能运行，且设备当前没有对应的有效的License时，需安装对应的License，再执行该命令。否则，当使用软件包配置该命令时，只要指定的某个软件包当前没有有效的License，则会导致整条命令配置失败；当使用IPE文件配置该命令时，只有当前没有有效的License的软件包配置失败，其它软件包会配置成功。

当配置该命令时，命令中指定的软件包/IPE文件必须放在存储介质主分区的根目录下，文件名中必须包含存储介质的名称。

系统会自动检查指定单板上对应路径下是否存在同名文件，如果不存在，则直接从指定路径拷贝一份并设置为下次启动软件包；如果存在，则提示用户是否从指定路径拷贝一份并设置为下次启动软件包。

成功执行该命令后，系统会用命令中指定的软件包替换现有的软件包列表。如果命令行中没有指定Feature包，则更新后的软件包列表中不会有Feature包。

执行本命令时，请不要对任何成员设备进行重启操作，否则可能导致设备不能正常启动。（集中式IRF设备）

执行本命令时，请不要对任何单板进行重启操作，否则可能导致单板不能正常启动。（分布式设备－独立运行模式/分布式设备－IRF模式）

【举例】

# 指定设备下次启动时所用的主用启动文件为flash:/all.ipe。（集中式设备—独立运行模式）

<Sysname> boot-loader file flash:/all.ipe main

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

H3C ICG2000D images in IPE:

  boot.bin

  system.bin

This command will set the main startup software images. Continue? [Y/N]:Y

Add images to the device.

File flash:/boot.bin already exists on the device.

File flash:/system.bin already exists on the device.

Overwrite the existing files? [Y/N]:Y

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

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

The images that have passed all examinations will be used as the main startup software images at the next reboot on the device..

# 指定设备下次启动时所用的主用启动文件为flash:/boot.bin和flash:/system.bin。（集中式设备—独立运行模式）

<Sysname> boot-loader file boot flash:/boot.bin system flash:/system.bin main

This command will set the main startup software images. Continue? [Y/N]:y

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

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

The images that have passed all examinations will be used as the main startup software images at the next reboot on the device.

# 指定0号板下次启动时所用的主用启动文件为flash:/all.ipe。（分布式设备－独立运行模式）

<Sysname> boot-loader file flash:/all.ipe slot 0 main

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

H3C ICG 6000 Switch images in IPE:

  boot.bin

  system.bin

This command will set the main startup software images. Continue? [Y/N]:Y

Add images to slot 0.

File flash:/boot.bin already exists on slot 0.

File flash:/system.bin already exists on slot 0.

Overwrite the existing files? [Y/N]:Y

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

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

The images that have passed all examinations will be used as the main startup software images at the next reboot on slot 0.

# 指定成员设备1下次启动时所用的主用启动文件为flash:/all.ipe。（集中式设备—IRF模式）

<Sysname> boot-loader file flash:/all.ipe slot 1 main

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

H3C ICG 5000G images in IPE:

  boot.bin

  system.bin

This command will set the main startup software images. Continue? [Y/N]:Y

Add images to slot 1.

File flash:/boot.bin already exists on slot 1.

File flash:/system.bin already exists on slot 1.

Overwrite the existing files? [Y/N]:Y

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

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

The images that have passed all examinations will be used as the main startup software images at the next reboot on slot 1.

# 指定成员设备1的0号单板下次启动时所用的主用启动文件为flash:/all.ipe。（分布式设备－IRF模式）

<Sysname> boot-loader file flash:/all.ipe chassis 1 slot 0 main

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

H3C ICG 6000 images in IPE:

  boot.bin

  system.bin

This command will set the main startup software images. Continue? [Y/N]:Y

Add images to chassis 1 slot 0.

File flash:/boot.bin already exists on chassis 1 slot 0.

File flash:/system.bin already exists on chassis 1 slot 0.

Overwrite the existing files? [Y/N]:Y

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

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

The images that have passed all examinations will be used as the main startup software images at the next reboot on chassis 1 slot 0.

【相关命令】

·     display boot-loader

1.1.2  boot-loader update

boot-loader update命令用来将备用主控板的软件版本与主用主控板的当前软件版本进行同步。（分布式设备－独立运行模式）

boot-loader update命令用来将从设备的软件版本与主设备的当前软件版本进行同步。（集中式设备—IRF模式）

boot-loader update命令用来将全局备用主控板的软件版本与全局主用主控板的当前软件版本进行同步。（分布式设备－IRF模式）

【命令】

分布式设备－独立运行模式/集中式设备—IRF模式：

boot-loader update { all | slot slot-number }

分布式设备－IRF模式：

boot-loader update { all | chassis chassis-number slot slot-number }

设备各款型对于本节所描述的命令支持情况有所不同，详细差异信息如下：

型号	命令	描述
ICG2000D	boot-loader update	不支持
ICG 3000S		支持
ICG3000F/3000F-DP		支持
ICG 5000G/5000T		支持
ICG 6000		支持

 

【视图】

用户视图

【缺省用户角色】

network-admin

【参数】

all：表示同步升级所有备用主控板。（分布式设备－独立运行模式）

all：表示同步升级所有备设备。（集中式设备—IRF模式）

all：表示同步升级所有全局备用主控板。（分布式设备－IRF模式）

slot slot-number：表示待升级的备用主控板所在的槽位号。（分布式设备－独立运行模式）

slot slot-number：表示待升级的成员设备的编号。（集中式设备—IRF模式）

chassis chassis-number slot slot-number：表示待升级的全局备用主控板所在位置。chassis-number表示设备的成员编号，slot-number表示全局备用主控板所在的槽位号。（分布式设备－IRF模式）

【使用指导】

本命令用于备用主控板和主用主控板软件版本不一致时，刷新备用主控板的软件版本，使其和主用主控板的软件版本相同。

(1)     分布式设备－独立运行模式

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

通过该命令指定备用主控板的下次启动软件包时，系统会进行如下处理：

·     如果主用主控板当前是使用主用启动软件包列表启动的，则将其主用下次启动软件包列表中的软件包拷贝到备用主控板的对应目录下，并设置为备用主控板的主用下次启动软件包。如果这些软件包中有任一软件包不存在或者不可用，则命令执行失败。

·     如果主用主控板当前是使用备用启动软件包列表启动的，则将其备用下次启动软件包列表中的软件包拷贝到备用主控板的对应目录下，并设置为备用主控板的主用下次启动软件包。如果这些软件包中有任一软件包不存在或者不可用，则命令执行失败。

如果主用主控板刚安装了补丁或者通过install命令进行了升级，在执行boot-loader update命令前，请执行install commit命令刷新主用主控板的下次启动软件包列表。否则，可能导致备用主控板升级后与主用主控板的版本不一致。

(2)     集中式设备—IRF模式

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

通过该命令指定从设备的下次启动软件包时，系统会进行如下处理：

·     如果主设备当前是使用主用启动软件包列表启动的，则将其主用下次启动软件包列表中的软件包拷贝到从设备的对应目录下，并设置为从设备的主用下次启动软件包。如果这些软件包中有任一软件包不存在或者不可用，则命令执行失败。

·     如果主设备当前是使用备用启动软件包列表启动的，则将其备用下次启动软件包列表中的软件包拷贝到从设备的对应目录下，并设置为从设备的主用下次启动软件包。如果这些软件包中有任一软件包不存在或者不可用，则命令执行失败。

如果主用主控板刚安装了补丁或者通过install命令进行了升级，在执行boot-loader update命令前，请执行install commit命令刷新主用主控板的下次启动软件包列表。否则，可能导致备用主控板升级后与主用主控板的版本不一致。

执行本命令时，请不要对任何成员设备进行重启操作，否则可能导致设备不能正常启动。

(3)     分布式设备－IRF模式

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

通过该命令指定全局备用主控板的下次启动软件包时，系统会进行如下处理：

·     如果全局主用主控板当前是使用主用启动软件包列表启动的，则将其主用下次启动软件包列表中的软件包拷贝到全局备用主控板的对应目录下，并设置为全局备用主控板的主用下次启动软件包。如果这些软件包中有任一软件包不存在或者不可用，则命令执行失败。

·     如果全局主用主控板当前是使用备用启动软件包列表启动的，则将其备用下次启动软件包列表中的软件包拷贝到全局备用主控板的对应目录下，并设置为全局备用主控板的主用下次启动软件包。如果这些软件包中有任一软件包不存在或者不可用，则命令执行失败。

如果主用主控板刚安装了补丁或者通过install命令进行了升级，在执行boot-loader update命令前，请执行install commit命令刷新主用主控板的下次启动软件包列表。否则，可能导致备用主控板升级后与主用主控板的版本不一致。

执行本命令时，请不要对任何单板进行重启操作，否则可能导致单板不能正常启动。

【举例】

# 将1号槽位的备用主控板上的软件版本与主用主控板的软件版本同步。（分布式设备－独立运行模式）

<Sysname> boot-loader update slot 1

This command will update the specified standby MPU. Continue? [Y/N]:y

Updating. Please wait...

Verifying the file flash:/ boot.bin on slot 0...Done.

Verifying the file flash:/ system.bin on slot 0....Done.

Copying main startup software images to slot 1. Please wait...

Done.

Setting copied images as main startup software images for slot 1...

Done.

The images that have passed all examinations will be used as the main startup software images at the next reboot on slot 1.

Done.

Successfully updated the startup software images of slot 1.

# 将成员设备2上的软件版本与主设备的软件版本同步。（集中式设备—IRF模式）

<Sysname> boot-loader update slot 2

This command will update the specified standby MPU. Continue? [Y/N]:y

Updating. Please wait...

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

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

Copying main startup software images to slot 2. Please wait...

Done.

Setting copied images as main startup software images for slot 2...

Done.

The images that have passed all examinations will be used as the main startup software images at the next reboot on slot 2.

Successfully updated the startup software images of slot 2.

# 将成员设备1的1号单板上的软件版本与全局主用主控板同步。（分布式设备－IRF模式）

<Sysname> boot-loader update chassis 1 slot 1

This command will update the specified standby MPU. Continue? [Y/N]:y

Updating. Please wait...

Verifying the file flash:/ boot.bin on chassis 1 slot 0...Done.

Verifying the file flash:/ system.bin on chassis 1 slot 0....Done.

Copying main startup software images to chassis 1 slot 1. Please wait...

Done.

Setting copied images as main startup software images for chassis 1 slot 1...

Done.

The images that have passed all examinations will be used as the main startup software images at the next reboot on chassis 1 slot 1.

Successfully updated the startup software images of chassis 1 slot 1.

【相关命令】

·     display boot-loader

·     install commit

1.1.3  bootrom update

bootrom update命令用来加载Boot ROM程序。

【命令】

集中式设备—独立运行模式：

bootrom update file file-url slot slot-number-list

分布式设备－独立运行模式/集中式设备—IRF模式：

bootrom update file file-url slot slot-number-list [ subslot subslot-number-list ]

分布式设备－IRF模式：

bootrom update file file-url chassis chassis-number slot slot-number-list [ subslot subslot-number-list ]

【视图】

用户视图

【缺省用户角色】

network-admin

【参数】

file file-url：Flash中包含Boot ROM程序的文件，file-url表示用于Boot ROM程序升级的文件的名称，为1～63个字符的字符串。

slot slot-number-list：槽位号列表，表示同时升级多个单板的Boot ROM程序。表示方式为slot-number-list = { slot-number [ to slot-number ] }&<1-7>。其中，slot-number表示需要升级的单板所在的槽位号。&<1-7>表示前面的参数最多可以输入7次。（集中式设备—独立运行模式/分布式设备－独立运行模式）

slot slot-number-list：成员编号列表，表示同时升级多个成员设备的Boot ROM程序。表示方式为slot-number-list = { slot-number [ to slot-number ] }&<1-7>。其中，slot-number表示需要升级的设备在IRF中的成员编号。（集中式设备—IRF模式）

chassis chassis-number：表示需要升级Boot ROM程序的设备在IRF中的成员编号。（分布式设备－IRF模式）

slot slot-number-list：槽位号列表，表示同时升级多个单板的Boot ROM程序。表示方式为slot-number-list = { slot-number [ to slot-number ] }&<1-7>。其中，slot-number表示需要升级的单板所在的槽位号。&<1-7>表示前面的参数最多可以输入7次。（分布式设备－IRF模式）

subslot subslot-number-list：子槽位号列表，表示同时升级多个子卡的Boot ROM程序。表示方式为subslot-number-list = { subslot-number [ to subslot-number ] }&<1-7>。其中，subslot-number表示需要升级的子卡所在的子槽位号。&<1-7>表示前面的参数最多可以输入7次。不使用该参数时，表示不升级子卡。

【使用指导】

Boot ROM程序通过Boot包（*.bin）发布，产品会将需要升级的单板的Boot ROM程序集成到Boot包中。此时，可是使用bootrom update命令，将升级文件指定为Boot包，系统会根据单板的型号自动将相应的Boot ROM程序加载到Boot ROM中；也可以在升级Boot包的同时完成Boot ROM程序的加载。

执行该命令后，设备会将缺省存储介质中的Boot ROM程序加载到Boot ROM的Normal区。设备启动时，会直接使用Normal区的Boot ROM程序。因此，如果缺省存储介质空间不足，Boot ROM程序加载完成之后，Boot ROM文件可以删除。

加载后，要使新的Boot ROM程序生效，需要重启设备。

【举例】

# 使用Flash根目录下的a.bin文件升级设备的Boot ROM程序。

<Sysname> bootrom update file flash:/a.bin

   This command will update the Boot ROM file on the specified board(s), Continue? [Y/N]:y

   Now updating the Boot ROM, please wait...

.............Done.

【相关命令】

·     boot-loader file

1.1.4  display boot-loader

display boot-loader命令用来显示本次启动和下次启动所采用的启动软件包的名称。

【命令】

集中式设备—独立运行模式：

display boot-loader

分布式设备－独立运行模式/集中式设备—IRF模式：

display boot-loader [ slot slot-number ]

分布式设备－IRF模式：

display boot-loader [ chassis chassis-number [ slot slot-number ] ]

【视图】

任意视图

【缺省用户角色】

network-admin

network-operator

【参数】

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

slot slot-number：表示成员设备的编号。不指定该参数时，表示IRF中的所有成员设备。（集中式设备—IRF模式）

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

【举例】

# 显示本次启动和下次启动所采用的启动软件包的名称。（集中式设备—独立运行模式）

<Sysname> display boot-loader

Software images on the device:

Current software images:

  flash:/boot.bin

  flash:/system.bin

Main startup software images:

  flash:/boot.bin

  flash:/system.bin

Backup startup software images:

  flash:/boot.bin

  flash:/system.bin

# 显示本次启动和下次启动所采用的启动软件包的名称。（分布式设备－独立运行模式/集中式设备—IRF模式）

<Sysname> display boot-loader

Software images on slot 0:

Current software images:

  flash:/boot.bin

  flash:/system.bin

Main startup software images:

  flash:/boot.bin

  flash:/system.bin

Backup startup software images:

  flash:/boot.bin

  flash:/system.bin

# 显示本次启动和下次启动所采用的启动软件包的名称。（分布式设备－IRF模式）

<Sysname> display boot-loader

Software images on chassis 0 slot 1:

Current software images:

  flash:/boot.bin

  flash:/system.bin

Main startup software images:

  flash:/boot.bin

  flash:/system.bin

Backup startup software images:

  flash:/boot.bin

  flash:/system.bin

表1-1 display boot-loader命令显示信息描述表

字段	描述
Software images on the device	启动软件包的相关信息（集中式设备—独立运行模式）
Software images on slot n	位于槽位n上的某主控板的启动软件包的相关信息（分布式设备－独立运行模式） 成员编号为n的某成员设备的启动软件包的相关信息（集中式设备—IRF模式）
Software images on chassis m slot n	某主控板的启动软件包的相关信息，该主控板位于成员设备m的n号槽位上（分布式设备－IRF模式）
Current software images	最近一次启动使用的启动软件包列表
Main startup software images	主用下次启动软件包列表
Backup startup software images	备用下次启动软件包列表

 

【相关命令】

·     boot-loader file

1.1.5  display install active

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

【命令】

集中式设备—独立运行模式：

display install active [ verbose ]

分布式设备－独立运行模式/集中式设备—IRF模式：

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

分布式设备－IRF模式：

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

【视图】

任意视图

【缺省用户角色】

network-admin

network-operator

【参数】

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

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

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

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

【举例】

# 显示设备上处于激活状态的软件包的简要信息。（集中式设备—独立运行模式）

<Sysname> display install active

Active packages on the device:

  flash:/boot.bin

  flash:/system.bin

  flash:/feature.bin

# 显示设备上处于激活状态的软件包的简要信息。（分布式设备－独立运行模式/集中式设备—IRF模式）

<Sysname> display install active

Active packages on slot 1:

  flash:/boot.bin

  flash:/system.bin

  flash:/feature.bin

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

<Sysname> display install active

Active packages on chassis 1 slot 1:

  flash:/boot.bin

  flash:/system.bin

  flash:/feature.bin

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

<Sysname> display install active verbose

Active packages on the device:

  flash:/boot.bin

 [Package]

 Vendor: XXX

 Product: xxxx

 Service name: boot

 Platform version: 7.1.022

 Product version: Test 2201

 Supported board: cen

 [Component]

 Component: boot

 Description: boot package

 

flash:/system.bin

 [Package]

 Vendor: XXX

 Product: xxxx

 Service name: system

 Platform version: 7.1.022

 Product version: Test 2201

 Supported board: cen

 [Component]

 Component: system

 Description: system package

 

flash:/feature.bin

 [Package]

 Vendor: XXX

 Product: xxxx

 Service name: test

 Platform version: 7.1.022

 Product version: Test 2201

 Supported board: cen

 [Component]

 Component: test

 Description: test package

# 显示设备上处于激活状态的软件包的详细信息。（分布式设备－独立运行模式/集中式设备—IRF模式）

<Sysname> display install active verbose

Active packages on slot 1:

flash:/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

 

flash:/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

 

flash:/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

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

<Sysname> display install active verbose

Active packages on chassis 1 slot 1:

flash:/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

 

flash:/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

 

flash:/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-2 display install active命令显示信息描述表

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

 

【相关命令】

·     install active

1.1.6  display install backup

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

【命令】

集中式设备—独立运行模式：

display install backup [ verbose ]

分布式设备－独立运行模式/集中式设备—IRF模式：

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

分布式设备－IRF模式：

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

【视图】

任意视图

【缺省用户角色】

network-admin

network-operator

【参数】

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

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

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 the device:

  flash:/boot-a0201.bin

  flash:/system-a0201.bin

# 显示设备下次启动时使用的备用软件包的相关信息。（分布式设备－独立运行模式/集中式设备—IRF模式）

<Sysname> display install backup

Backup startup software images on slot 1:

  flash:/boot-a0201.bin

  flash:/system-a0201.bin

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

<Sysname> display install backup

Backup startup software images on chassis 1 slot 1:

  flash:/boot-a0201.bin

  flash:/system-a0201.bin

# 显示设备下次启动时使用的备用软件包的详细信息。（分布式设备－独立运行模式/集中式设备—IRF模式）

<Sysname> display install backup verbose

Backup startup software images on slot 1:

 flash:/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

 

 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

 [Component]

 Component: system

 Description: system package

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

【相关命令】

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

·     display install committed

1.1.7  display install committed

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

【命令】

集中式设备—独立运行模式：

display install committed [ verbose ]

分布式设备－独立运行模式/集中式设备—IRF模式：

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

分布式设备－IRF模式：

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

【视图】

任意视图

【缺省用户角色】

network-admin

network-operator

【参数】

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

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

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 the device:

 flash:/boot-a0201.bin

 flash:/system-a0201.bin

 flash:/feature.bin

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

<Sysname> display install committed verbose

Committed packages on the device:

 flash:/boot-a0201.bin

 [Package]

 Vendor: 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

 

 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

 [Component]

 Component: system

 Description: system package

 

flash:/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-2。

【相关命令】

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

·     display install backup

·     install commit

1.1.8  display install inactive

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

【命令】

集中式设备—独立运行模式：

display install inactive [ verbose ]

分布式设备－独立运行模式/集中式设备—IRF模式：

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

分布式设备－IRF模式：

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

【视图】

任意视图

【缺省用户角色】

network-admin

network-operator

【参数】

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

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

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

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

【举例】

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

<Sysname> display install inactive

Inactive packages on the device:

 flash:/ssh-feature.bin

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

<Sysname> display install inactive verbose

Inactive packages on the device:

flash:/ssh-feature.bin

 [Package]

 Vendor: 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-2。

【相关命令】

·     install deactivate

1.1.9  display install ipe-info

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

【命令】

display install ipe-info ipe-filename

【视图】

任意视图

【缺省用户角色】

network-admin

network-operator

【参数】

ipe-filename：表示IPE文件名，以.ipe作为后缀名。该文件必须存放在文件系统的根目录下，最大为63个字符的字符串（包括存储介质名称在内）。

【使用指导】

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

【举例】

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

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

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

H3C ICG 5000G images in IPE:

  boot.bin

  system.bin

【相关命令】

·     display install package

1.1.10  display install job

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

【命令】

display install job

【视图】

任意视图

【缺省用户角色】

network-admin

network-operator

【举例】

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

<Sysname> display install job

 JobID:5

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

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

# 显示系统中正在执行的激活、卸载、回滚操作。（分布式设备－独立运行模式/集中式设备—IRF模式）

<Sysname> display install job

 JobID:5

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

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

# 显示系统中正在执行的激活、卸载、回滚操作。（分布式设备－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.1.11  display install log

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

【命令】

display install log [ log-id ] [ verbose ]

【视图】

任意视图

【缺省用户角色】

network-admin

network-operator

【参数】

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

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

【使用指导】

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

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

【举例】

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

<Sysname> display install log

Install job 1 started by user ** at 01/01/2011 20:57:50.

 Job 1 completed successfully at 01/01/2011 20:57:50.

 Install job 1 started by user ** at 01/01/2011 20:57:50.

 Job 1 completed successfully at 01/01/2011 20:57:50.

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

<Sysname> display install log 1 verbose

Install job 1 started by user ** at 01/01/2011 20:57:50.

 Job 1 completed successfully at 01/01/2011 20:57:50.

 Install job 1 started by user ** at 01/01/2011 20:57:50.

 Job 1 completed successfully at 01/01/2011 20:57:50.

    Obtained the Upgrade Way successfully.

 

    Got upgrade policy successfully.

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

字段	描述
Install job 1 started by user ** at 01/01/2011 20:57:50.	install命令升级动作的执行者和执行时间
Job 1 completed successfully at 01/01/2011 20:57:50.	install命令升级动作的完成时间
Obtained the Upgrade Way successfully.	表示升级方式获取成功
Get upgrade policy successfully	表示升级决策处理成功

 

【相关命令】

·     reset install log-history oldest

1.1.12  display install package

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

【命令】

display install package { filename | all } [ verbose ]

【视图】

任意视图

【缺省用户角色】

network-admin

network-operator

【参数】

filename：表示软件包的文件名，以.bin作为后缀名，最大为63个字符的字符串。

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

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

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

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

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

【使用指导】

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

当配置该命令时，命令中指定的软件包必须放在存储介质的根目录下，文件名中必须包含存储介质的名称，形如flash:/xx.bin或者slotn#flash:/xx.bin，n为备用主控板所在的槽位号。（分布式设备－独立运行模式）

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

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

【举例】

# 显示软件包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

# 显示软件包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

  [Component]

  Component: system

  Description: system package

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

1.1.13  display install rollback

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

【命令】

display install rollback [ point-id ]

【视图】

任意视图

【缺省用户角色】

network-admin

network-operator

【参数】

point-id：回滚点的编号。如果未指定point-id，则显示所有回滚点的相关信息。

【使用指导】

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

【举例】

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

<Sysname> display install rollback

Install rollback information 1 on the device:

  Updating from flash:/route-1.bin

         to flash:/route-2.bin.

 

Install rollback information 2 on the device:

   Deactivating flash:/route-2.bin

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

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

字段	描述
Install rollback information n	回滚点信息，n为回滚点编号
Updating from A to B	从软件包A升级到软件包B，A和B为软件包的名称
Deactivating A	卸载软件包A，A为软件包的名称

 

【相关命令】

·     install rollback

·     reset install rollback oldest

1.1.14  display install which

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

【命令】

集中式设备—独立运行模式：

display install which { component name | file filename }

分布式设备－独立运行模式/集中式设备—IRF模式：

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

分布式设备－IRF模式：

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

【视图】

任意视图

【缺省用户角色】

network-admin

network-operator

【参数】

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

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

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

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

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

【使用指导】

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

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

【举例】

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

<Sysname> display install which file pkg_ctr

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

Found pkg_ctr in flash:/system-d2601006.bin on the device.

  flash:/system-d2601006.bin

  [Package]

  Vendor: H3C

  Product: RT-ICG2000D

  Service name: system

  Platform version: 7.1.060

  Product version: Demo 2601006

  Supported board: mpu

 

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

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

字段	描述
Verifying the file flash:/xx.bin on the device.....Done.	验证文件是否合法
Found pkg_ctr in flash:/system-d2601007.bin on the device.	找到文件
flash:/system-d2601006.bin	软件包的名称
[Package]	软件包的信息
Vendor	生产厂商
Product	产品名称
Service name	软件包所包含的服务名称： ·     如果显示为boot，表示该软件包为Boot包 ·     如果显示为system，表示该软件包为System包 ·     如果显示为patch，表示该软件包为补丁包 ·     如果显示为其它值，则表示该软件包为提供某项功能的Feature包
Platform version	平台软件版本号
Product version	产品软件版本号
Supported board	软件包支持的单板类型： ·     cen表示集中式设备 ·     mpu表示主控板 ·     lc表示业务板
File xxx was not found in the image packages under the root directory of the storage medium in slot 1.	在slot 1根目录下的所有包中都没有找到指定文件

 

1.1.15  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：表示软件包的文件名，以.bin作为后缀名，最大为63个字符的字符串。&<1-30>表示前面的参数最多可以输入30次。

ipe ipe-filename：IPE文件名，以.ipe作为后缀名，最大为63个字符的字符串。

【使用指导】

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

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

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

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

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

【举例】

# 显示设备将采用的升级策略。（不兼容版本显示信息举例）（集中式设备—独立运行模式）

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

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

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

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

Incompatible upgrade.

# 显示设备将采用的升级策略。（兼容版本显示信息举例）（集中式设备—IRF模式）

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

Verifying the file flash:/dhcp-e2205.incom.bin on slot 2.....Done.

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

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

 

  Slot     Upgrade Way

  2        File Upgrade

# 显示设备将采用的升级策略。（兼容版本显示信息举例）（分布式设备－独立运行模式）

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

Verifying the file flash:/cmw710-cfa-a7125.bin on slot 0.....Done.

 

  Slot                        Upgrade Way

  0                           Service Upgrade

  1                           Service Upgrade

  1.1                         Service Upgrade

  4                           Service Upgrade

 

Influenced service according to following table on slot 0:

flash:/cmw710-cfa-a7125.bin

    CFA

 

Influenced service according to following table on slot 4:

flash:/cmw710-cfa-a7125.bin

    CFA

 

Influenced service according to following table on slot 1:

flash:/cmw710-cfa-a7125.bin

    CFA

 

Influenced service according to following table on slot 1.1:

flash:/cmw710-cfa-a7125.bin

CFA

# 显示设备将采用的升级策略。（兼容版本显示信息举例）（分布式设备－IRF模式）

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

Verifying the file flash:/cmw710-cfa-a7122.bin on chassis 1 slot 0.....Done.

Identifying the upgrade methods...Done.

 

  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:

flash:/cmw710-cfa-a7122.bin

    CFA

 

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

flash:/cmw710-cfa-a7122.bin

    CFA

 

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

flash:/cmw710-cfa-a7122.bin

    CFA

 

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

flash:/cmw710-cfa-a7122.bin

    CFA

 

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

flash:/cmw710-cfa-a7122.bin

    CFA

 

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

flash:/cmw710-cfa-a7122.bin

    CFA

 

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

flash:/cmw710-cfa-a7122.bin

    CFA

 

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

flash:/cmw710-cfa-a7122.bin

    CFA

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

字段	描述
Verifying the file flash:/xx.bin on chassis 1 slot 0.....Done.	验证文件是否合法
Influenced service according to following table	如果升级，受影响的功能模块。只有版本兼容时，才会显示该信息
Incompatible upgrade	如果升级指定的软件包，则升级的方式为不兼容升级
Chassis	设备在IRF中的成员编号。只有版本兼容时，才会显示该信息（分布式设备－IRF模式）
Slot	单板所在的槽位号。只有版本兼容时，才会显示该信息（分布式设备－独立运行模式/分布式设备－IRF模式） 设备在IRF中的成员编号。只有版本兼容时，才会显示该信息（集中式设备—IRF模式）
Upgrade Way	兼容升级策略。只有版本兼容时，才会显示该信息。取值可能为： ·     Service Upgrade：表示服务级增量升级，该方式下，仅对本业务模块有影响，对系统以及其他业务模块没有影响 ·     File Upgrade：表示文件级增量升级。该方式下，仅对系统内的、用户不可见的程序文件进行升级，对系统以及业务模块没有影响 ·     Reboot：表示通过重启方式升级

 

1.1.16  firmware update

firmware update命令用来升级CPLD、FPGA等固件。

【命令】

集中式设备—独立运行模式：

firmware update slot slot-number { cpld cpld-number | cpu cpu-number | fpga fpga-number | module module-number } file filename

分布式设备－独立运行模式/集中式设备—IRF模式：

firmware update slot slot-number subslot subslot-number { cpld cpld-number | cpu cpu-number | fpga fpga-number | module module-number } file filename

分布式设备－IRF模式：

firmware update chassis chass-number slot slot-number subslot subslot-number { cpld cpld-number | cpu cpu-number | fpga fpga-number | module module-number } file filename

【视图】

用户视图

【缺省用户角色】

network-admin

【参数】

chassis chass-number slot slot-number：chassis-number表示设备在IRF中的成员编号，slot-number表示单板所在的槽位号。（分布式设备－IRF模式）

slot slot-number：表示单板所在的槽位号。（分布式设备－独立运行模式）

slot slot-number：表示设备在IRF中的成员编号。（集中式设备—IRF模式）

subslot subslot-number：子卡所在的子槽位号。

cpld cpld-number：表示需要升级CPLD（Complex Programmable Logical Device复杂可编程逻辑器件），cpld-number表示固件的编号。fpga fpga-number：表示需要升级FPGA（Field Programmable Gate Array现场可编程门阵列），fpga-number表示固件的编号。cpu cpu-number：表示需要升级CPU，cpu-number表示CPU的编号。module module-number：表示需要升级指定模块，module-number表示模块的编号。

file filename：升级文件的名称。不同固件升级文件的后缀可能不同，文件名从存储介质名开始最多可输入63个字符，不区分大小写。

【使用指导】

固件升级后需要对其所在的板卡进行下电后重新上电才能生效，对板卡下电的方式有：切断外部电源、插拔板卡、使用power-supply off和power-supply on命令等方式，请根据板卡的实际支持情况，选择下电方式。

【举例】

# 升级1号CPLD。（集中式设备—独立运行模式）

<Sysname> firmware update slot 0 cpld 1 file package.bin

Updating firmware for CPLD on the specified card or subcard. Continue?[Y/N]:y

Updating the firmware…

Please power cycle the card or subcard to activate the firmware.

# 升级位于1号槽位的1号CPLD。（分布式设备－独立运行模式）

<Sysname> firmware update slot 1 cpld 1 file package.bin

Updating firmware for CPLD on the specified card or subcard. Continue?[Y/N]:y

Updating the firmware…

Please power cycle the card or subcard to activate the firmware.

# 升级位于成员设备1上的1号CPLD。（集中式设备—IRF模式）

<Sysname> firmware update slot 1 cpld 1 file package.bin

Updating firmware for CPLD on the specified card or subcard. Continue?[Y/N]:y

Updating the firmware…

Please power cycle the card or subcard to activate the firmware.

# 升级位于成员设备1上1号槽位的1号CPLD。（分布式设备－IRF模式）

<Sysname> firmware update chassis 1 slot 1 cpld 1 file package.bin

Updating firmware for CPLD on the specified card or subcard. Continue?[Y/N]:y

Updating the firmware…

Please power cycle the card or subcard to activate the firmware.

1.1.17  install abort

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

【命令】

install abort [ job-id ]

【视图】

用户视图

【缺省用户角色】

network-admin

【参数】

job-id：任务ID。不指定该参数时，则取消正在执行中的所有激活和卸载操作。

【使用指导】

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

【举例】

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

<Sysname> install abort

【相关命令】

·     display install job

1.1.18  install activate

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

【命令】

集中式设备—独立运行模式：

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

install activate patch filename

分布式设备－独立运行模式/集中式设备—IRF模式：

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

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

分布式设备－IRF模式：

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

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

【视图】

用户视图

【缺省用户角色】

network-admin

【参数】

boot：表示Boot包。

system：表示System包。

feature：表示Feature包。

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

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

all：升级补丁包对应的所有单板。（分布式设备－独立运行模式）

all：升级补丁包对应的所有成员设备。（集中式设备—IRF模式）

all：升级补丁包对应的所有单板。（分布式设备－IRF模式）

slot slot-number：表示单板所在的槽位号。（分布式设备－独立运行模式）

slot slot-number：表示设备在IRF中的成员编号。（集中式设备—IRF模式）

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

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

【使用指导】

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

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

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

设备上可安装的软件包（包括Boot包、System包、Feature包和补丁包）共为32个，其中Boot包和System包只能安装一个，Feature包和补丁包总共可安装30个。

(1)     集中式设备—独立运行模式

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

(2)     分布式设备－独立运行模式

命令中指定的Boot、System、Feature软件包必须放在存储介质主分区的根目录下，Patch包必须放在主用主控板存储介质主分区的根目录下，文件名中必须包含存储介质的名称，形如flash:/xx.bin或slot1#flash:/xx.bin。

执行命令行时，如果filename不是存放在待升级主控板上的文件，则系统会先将该文件拷贝到待升级主控板上，再执行升级动作。

如果指定的slot参数为主用主控板所在的槽位号，则执行该命令，会同时升级主用主控板和业务板；如果指定的slot参数为备用主控板所在的槽位号，则执行该命令，只会升级备用主控板。

(3)     集中式设备—IRF模式

命令中指定的Boot、System、Feature软件包必须放在存储介质主分区的根目录下，Patch包必须放在主设备存储介质主分区的根目录下，文件名中必须包含存储介质的名称，形如flash:/xx.bin或slot2#flash:/xx.bin。

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

从设备重启后，会自动批量备份主设备的配置和状态数据。请使用display system stable state命令查看设备是否处于稳定状态。只有System State处于Stable状态，才能执行该命令。否则，命令执行失败。关于display system stable state命令的详细介绍请参见“基础配置命令参考”中的“设备管理”。

(4)     分布式设备－IRF模式

命令中指定的Boot、System、Feature软件包必须放在存储介质主分区的根目录下，Patch包必须放在全局主用主控板存储介质主分区的根目录下，文件名中必须包含存储介质的名称，形如flash:/xx.bin或chassis1#slot1#flash:/xx.bin。

执行命令行时，如果filename不是存放在待升级主控板上的文件，则系统会先将该文件拷贝到待升级主控板上，再执行升级动作。

如果指定的chassis chassis-number slot slot-number参数为全局主用主控板所在的槽位号，则执行该命令，会同时升级该主控板和所有业务板。如果指定的chassis chassis-number slot slot-number参数为全局备用主控板所在的槽位号，则执行该命令，只会升级该主控板。

从设备重启后，会自动批量备份主设备的配置和状态数据。请使用display system stable state命令查看设备是否处于稳定状态。只有System State处于Stable状态，才能执行该命令。否则，命令执行失败。关于display system stable state命令的详细介绍请参见“基础配置命令参考”中的“设备管理”。

【举例】

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

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

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

Identifying the upgrade methods...Done.

Upgrade summary according to following table:

 

flash:/ssh2.bin

  Running Version             New Version

  Beta 1330                   Beta 1331

 

Upgrade Way: Service Upgrade

 

Influenced service according to following table:

flash:/ssh2.bin

     SSH       IFMGR     CFA       LAGG

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

# 显示备用主控板1上的Feature包ssh2.bin的升级策略。（分布式设备－独立运行模式）

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

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

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

Identifying the upgrade methods...Done.

Upgrade summary according to following table:

 

flash:/ssh2.bin

  Running Version             New Version

  Beta 1330                   Beta 1331

 

  Slot                        Upgrade Way

  1                           Service Upgrade

 

Influenced service according to following table:

flash:/ssh2.bin

     SSH       IFMGR     CFA       LAGG

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

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

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

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

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

Identifying the upgrade methods...Done.

Upgrade summary according to following table:

 

flash:/ssh2.bin

  Running Version             New Version

  Beta 1330                   Beta 1331

 

  Slot                        Upgrade Way

  2                           Service Upgrade

 

Influenced service according to following table:

flash:/ssh2.bin

     SSH       IFMGR     CFA       LAGG

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

# 显示成员设备1的1号单板（全局备用主控板）上的feature包ssh2.bin的升级策略。（分布式设备－IRF模式）

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

Copying file flash:/ssh2.bin to chassis1#slot1#flash:/ssh2.bin......Done.

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

Identifying the upgrade methods...Done.

Upgrade summary according to following table:

 

flash:/ssh2.bin

  Running Version             New Version

  Beta 1330                   Beta 1331

 

  Chassis   Slot              Upgrade Way

  1         1                 Service Upgrade

 

Influenced service according to following table:

flash:/ssh2.bin

     SSH       IFMGR     CFA       LAGG

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

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

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

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

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

Upgrade summary according to following table:

 

flash:/system.bin

  Running Version             New Version

  Beta 1330                   Beta 1331

 

flash:/feature.bin

  Running Version             New Version

  NONE                        Beta 1330

 

Upgrade Way: Service Upgrade

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

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

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

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

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

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

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

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

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

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

Upgrade summary according to following table:

 

flash:/system.bin

  Running Version             New Version

  Beta 1330                   Beta 1331

 

flash:/feature.bin

  Running Version             New Version

  None                        Beta 1330

 

  Slot                        Upgrade Way

  1                           Service Upgrade

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

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

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

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

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

Verifying the file flash:/system.bin on slot 2.....Done.

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

Verifying the file flash:/feature.bin on slot 2.....Done.

Upgrade summary according to following table:

 

flash:/system.bin

  Running Version             New Version

  Beta 1330                   Beta 1331

 

flash:/feature.bin

  Running Version             New Version

  None                        Beta 1330

 

  Slot                        Upgrade Way

  2                           Service Upgrade

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

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

# 激活成员设备1的1号单板（全局备用主控板）上的Feature包feature.bin。（分布式设备－IRF模式）

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

Copying file flash:/feature.bin to chassis1#slot1#flash:/feature.bin......Done.

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

Identifying the upgrade methods...Done.

Upgrade summary according to following table:

 

flash:/route-feature.bin

  Running Version             New Version

  None                        Beta 1330

 

  Chassis   Slot              Upgrade Way

  1         1                 Service Upgrade

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

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

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

字段	描述
Copying file A to B......Done.	将文件从位置A拷贝到位置B。当配置备用主控板时才有该提示信息（分布式设备－独立运行模式） 将文件从位置A拷贝到位置B。当配置从设备时才有该提示信息（集中式设备—IRF模式） 将文件从位置A拷贝到位置B。当配置全局备用主控板时才有该提示信息（分布式设备－IRF模式）
Verifying the file flash:/xx.bin on chassis 1 slot 0.....Done.	验证文件是否合法
Identifying the upgrade methods...Done.	决策升级方式是否完成
Upgrade summary according to following table	升级摘要信息
Running Version	设备当前运行的相同类型软件包的产品版本号
New Version	目标软件包的产品版本号
Chassis	设备在IRF中的成员编号（分布式设备－IRF模式）
Slot	单板所在的槽位号（分布式设备－独立运行模式/分布式设备－IRF模式） 设备在IRF中的成员编号（集中式设备—IRF模式）
Upgrade Way	兼容升级策略，取值可能为： ·     Service Upgrade：表示服务级增量升级，该方式下，仅对本业务模块有影响，对系统以及其他业务模块没有影响 ·     File Upgrade：表示文件级增量升级。该方式下，仅对系统内的、用户不可见的程序文件进行升级，对系统以及业务模块没有影响 ·     Reboot：表示通过重启方式升级
Influenced service according to following table	将受影响的功能模块
Upgrading software images to compatible versions. Continue? [Y/N]	询问用户是否执行兼容升级操作
This operation might take several minutes, please wait	升级操作需要花费一定时间，请等待
Done.	表示激活成功
Operation failed.	表示激活失败
Install command does not support incompatible upgrade.	不能使用install命令来升级不兼容版本

 

【相关命令】

·     display install active

·     install commit

·     install deactivate

1.1.19  install add

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

【命令】

install add ipe-filename filesystem:

【视图】

用户视图

【缺省用户角色】

network-admin

【参数】

ipe-filename：IPE文件名，以.ipe作为后缀名，最大为63个字符的字符串（包括存储介质名称在内）。

filesystem：文件系统的名称，形如flash:。（集中式设备—独立运行模式）

filesystem：文件系统的名称。如果是解压缩到主用主控板上，则为flash:；如果是解压缩到备用主控板上，则为slotn#flash:，n为备用主控板所在的槽位号。（分布式设备－独立运行模式）

filesystem：文件系统的名称。如果是解压缩到主设备上，则为flash:；如果是解压缩到从设备上，则为slotn#flash:，n为从设备的成员编号。（集中式设备—IRF模式）

filesystem：文件系统的名称。如果是解压缩到全局主用主控板上，则为flash:；如果是解压缩到全局备用主控板上，则为chassism#slotn#flash:，m为设备的成员编号，n为成员设备上主控板所在的槽位号。（分布式设备－IRF模式）

【使用指导】

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

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

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

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

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

【举例】

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

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

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

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

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

1.1.20  install commit

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

【命令】

install commit

【视图】

用户视图

【缺省用户角色】

network-admin

【使用指导】

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

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

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

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

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

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

【举例】

# 确认软件包更改。

<Sysname> install commit

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

【相关命令】

·     install activate

·     install deactivate

·     install rollback

1.1.21  install deactivate

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

【命令】

集中式设备—独立运行模式：

install deactivate feature filename&<1-30>

install deactivate patch filename

分布式设备－独立运行模式/集中式设备—IRF模式：

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

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

分布式设备－IRF模式：

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

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

【视图】

用户视图

【缺省用户角色】

network-admin

【参数】

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

all：表示安装了该补丁包的所有单板。（分布式设备－独立运行模式）

all：表示安装了该补丁包的所有成员设备。（集中式设备—IRF模式）

all：表示安装了该补丁包的所有单板。（分布式设备－独立运行模式）

slot slot-number：slot-number取值为0，无特殊意义。（集中式设备—独立运行模式）

slot slot-number：表示单板所在的槽位号。（分布式设备－独立运行模式）

slot slot-number：表示设备在IRF中的成员编号。（集中式设备—IRF模式）

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

【使用指导】

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

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

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

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

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

从设备重启后，会自动批量备份主设备的配置和状态数据。请使用display system stable state命令查看设备是否处于稳定状态。只有System State处于Stable状态，才能执行该命令。否则，命令执行失败。关于display system stable state命令的详细介绍请参见“基础配置命令参考”中的“设备管理”。

【举例】

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

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

# 卸载0号单板上的patch包route-patch.bin。（分布式设备－独立运行模式）

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

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

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

# 卸载成员设备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.1.22  install remove

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

【命令】

集中式设备—独立运行模式：

install remove { filename | inactive }

分布式设备－独立运行模式/集中式设备—IRF模式：

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

分布式设备－IRF模式：

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

【视图】

用户视图

【缺省用户角色】

network-admin

【参数】

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

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

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

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

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

【使用指导】

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

当配置该命令时，命令中指定的软件包必须放在存储介质的根目录下，文件名中必须且只能包含存储介质的名称，不能包含成员编号和槽位号的信息，形如flash:/xx.bin。（分布式设备－IRF模式）

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

【举例】

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

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

1.1.23  install rollback to

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

【命令】

install rollback to { point-id | original }

【视图】

用户视图

【缺省用户角色】

network-admin

【参数】

point-id：回滚点的编号，当系统中至少存在两个回滚点的时候，才能输入该参数。可以用display install rollback命令查看系统中存在的回滚点。

original：回滚到install命令升级初始状态。

【使用指导】

每次激活或者卸载软件包之后，系统中将运行着不同的软件包，系统将这些变化记录为回滚点。通过回滚功能，可将系统回滚到某个历史状态，或者恢复到install命令升级初始状态。

当升级方式为增量升级时，软件包回滚只在设备本次运行过程中生效，用户只有通过install commit命令确认软件包的更改后，才能使此次的回滚操作在系统重启后生效。系统最多支持50个回滚点，当回滚点超过最大值时，旧的回滚点会被删除，新的回滚点会被保存。

当升级方式为软重启或重启升级时，系统不会保留任何回滚点，只支持回滚到系统升级初始状态。

补丁包不支持回滚操作。

【举例】

# 回滚到回滚点1。

<Sysname> install rollback to 1

# 回滚到install命令升级的初始状态。可通过观察active列表和回滚点的变化看出执行的结果。

<Sysname> display install active

Active packages on the device:

  flash:/boot-a0201.bin

  flash:/system-a0201.bin

  flash:/ssh-feature-a0201.bin

<Sysname> display install rollback

Install rollback information 1 on the device:

  Updating from no package

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

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

<Sysname> install rollback to original

<Sysname> display install active

Active packages on the device:

  flash:/boot-a0201.bin

  flash:/system-a0201.bin

<Sysname> display install committed

Committed packages on the device:

  flash:/boot-a0201.bin

  flash:/system-a0201.bin

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

【相关命令】

·     display install rollback

1.1.24  install verify

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

【命令】

install verify

【视图】

用户视图

【缺省用户角色】

network-admin

【使用指导】

为了保证设备进行install命令升级之后能够正常运行，需要执行本命令对软件包进行如下检验：

完整性：检验Boot包、System包和Feature包的完整性。

一致性：检验系统内各激活的软件包列表的差异，以方便用户知道系统内各软件包版本是否一致。

软件包状态：检查各设备上激活的软件包列表和确认的软件包列表之间的差异，以方便用户知道是否有未确认的软件包。

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

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

·     当系统提示软件包不一致时，请使用install activate、install deactivate以及install commit命令来确保它们的一致。

【举例】

# 检验软件包信息。（集中式设备—独立运行模式）

<Sysname> install verify

Active packages on the device are the reference packages.

Packages will be compared with the reference packages.

This operation will take several minutes, please wait...

  Verifying packages on the device:

  Start to check active package completeness.

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

   flash:/boot-a0101.bin verification successful.

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

   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.

# 检验设备各个单板上的软件包信息。（分布式设备－独立运行模式）

<Sysname> install verify

Active packages on slot 1 are the reference packages.

Packages will be compared with the reference packages.

This operation will take several minutes, please wait...

  Verifying packages on slot 0:

  Start to check active package completeness.

Verifying the file flash:/boot-a0101.bin on slot 0.....................Done.

    flash:/boot-a0101.bin verification successful.

Verifying the file flash:/system-a0101.bin on slot 0.....................Done.

    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.

Verifying the file flash:/boot-a0101.bin on slot 1.....................Done.

    flash:/boot-a0101.bin verification successful.

Verifying the file flash:/system-a0101.bin on slot 1.....................Done.

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

  Start to check active package completeness.

Verifying the file flash:/boot-a0101.bin on slot 1.....................Done.

    flash:/boot-a0101.bin verification successful.

Verifying the file flash:/system-a0101.bin on slot 1.....................Done.

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

  Start to check active package completeness.

Verifying the file flash:/boot-a0101.bin on slot 2.....................Done.

    flash:/boot-a0101.bin verification successful.

Verifying the file flash:/system-a0101.bin on slot 2.....................Done.

    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.

Verifying the file flash:/boot-a0101.bin on chassis 1 slot 0.....................Done.

    flash:/boot-a0101.bin verification successful.

Verifying the file flash:/system-a0101.bin on chassis 1 slot 0.....................Done.

    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.

Verifying the file flash:/boot-a0101.bin on chassis 1 slot 1.....................Done.

    flash:/boot-a0101.bin verification successful.

Verifying the file flash:/system-a0101.bin on chassis 1 slot 1.....................Done.

    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.1.25  reset install log-history oldest

reset install log-history oldest命令用来清除install命令升级日志。

【命令】

reset install log-history oldest log-number

【视图】

用户视图

【缺省用户角色】

network-admin

【参数】

log-number：install命令升级日志的数量。

【使用指导】

执行本命令后，系统将按创建时间由早到晚的顺序清除指定数量的install命令升级日志。

【举例】

# 清除2条最早的install命令升级日志。

<Sysname> reset install log-history oldest 2

【相关命令】

·     display install log

1.1.26  reset install rollback oldest

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

【命令】

reset install rollback oldest point-id

【视图】

用户视图

【缺省用户角色】

network-admin

【参数】

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

【使用指导】

使用本命令，清除指定回滚点以及在此回滚点之前创建的所有回滚点。

【举例】

# 清除编号为2以及在此回滚点之前创建的所有回滚点。

<Sysname> reset install rollback oldest 2

【相关命令】

·     display install rollback

1.1.27  version auto-update enable

 

version auto-update enable命令用来开启备用主控板自动加载启动软件包的功能。

undo version auto-update enable命令用来关闭备用主控板自动加载启动软件包的功能。

【命令】

version auto-update enable

undo version auto-update enable

【缺省情况】

备用主控板自动加载启动软件包的功能处于开启状态。当启动过程中，当备用主控板发现自己版本和主用主控板版本不一致时，会自动加载主用主控板的当前启动软件包。

【视图】

系统视图

【缺省用户角色】

network-admin

【使用指导】

备用主控板自动加载的是主用主控板当前的启动软件包。

配置undo version check ignore和version auto-update enable命令后，在设备启动过程中，当备用主控板发现自己当前启动软件包版本和主用主控板的当前启动软件包版本不一致时，会自动拷贝主用主控板的当前启动软件包列表中的所有软件包，设置为自己的主用下次启动软件包，并自动重启。这样，能够使得备用主控板启动后，和主用主控板启动软件包的版本一致。

【举例】

# 开启备用主控板自动加载启动软件包的功能。

<Sysname> system-view

[Sysname] version auto-update enable

【相关命令】

·     version check ignore

1.1.28  version check ignore

 

version check ignore命令用来关闭对备用主控板进行启动软件包版本一致性检查功能，即不检查备用主控板的版本是否与主用主控板的启动软件包版本一致。

undo version check ignore命令用来开启对备用主控板进行启动软件包版本一致性检查功能。

【命令】

version check ignore

undo version check ignore

【缺省情况】

对备用主控板启动软件包版本一致性检查功能处于开启状态。

【视图】

系统视图

【缺省用户角色】

network-admin

【使用指导】

如果关闭对备用主控板进行启动软件包版本一致性检查功能，当备用主控板和主用主控板启动软件包版本不一致时，备用主控板仍然使用不一致的版本启动，可能会造成设备功能问题。

如果开启对备用主控板进行启动软件包版本一致性检查功能，当备用主控板和主用主控板启动软件包版本不一致时，备用主控板会停留在启动阶段，不能正常启动。

建议用户不要关闭启动软件包版本一致性检查功能。

【举例】

# 开启对备用主控板进行版本一致性检查功能。

<Sysname> system-view

[Sysname] undo version check ignore

【相关命令】

·     version auto-update enable