目  录

1 软件升级

1.1 软件升级配置命令

1.1.1 boot-loader file

1.1.2 boot-loader update

1.1.3 bootrom backup

1.1.4 bootrom restore

1.1.5 bootrom update

1.1.6 bootrom-update security-check enable

1.1.7 display boot-loader

1.1.8 display install active

1.1.9 display install inactive

1.1.10 display install job

1.1.11 display install log

1.1.12 display install package

1.1.13 install activate

1.1.14 install commit

1.1.15 install deactivate

1.1.16 install remove

1.1.17 reset install log-history oldest

1.1.18 version auto-update enable

1.1.19 version check ignore

 

1 软件升级

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

1.1  软件升级配置命令

1.1.1  boot-loader file

boot-loader file命令用来配置设备下次启动时使用的软件包。

【命令】

（独立运行模式）

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

boot-loader file ipe-filename [ patch filename&<1-16> ] { all | slot slot-number } { backup | main }

（IRF模式）

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

boot-loader file ipe-filename [ patch filename&<1-16> ] { all | chassis chassis-number slot slot-number } { backup | main }

【视图】

用户视图

【缺省用户角色】

network-admin

【参数】

boot：Boot包。

system：System包。

feature：Feature包。

patch：Patch包。

filename&<1-30>：软件包的名称，形如filesystemname/filename.bin。该文件必须保存在设备任一文件系统的根目录下，该参数中必须包含文件系统的名称，从存储介质名称开始最多可输入63个字符。&<1-30>表示前面的参数最多可以输入30次。有关指定文件夹和文件详细介绍请参见“基础配置指导”中的“文件系统管理”。

ipe-filename：IPE（Image Package Envelope，复合软件包套件）文件的名称，形如filesystemname/filename.ipe。该文件必须保存在设备任一文件系统的根目录下，该参数中必须包含文件系统的名称，从存储介质名称开始最多可输入63个字符。有关指定文件夹和文件详细介绍请参见“基础配置指导”中的“文件系统管理”。

all：指定系统中软件包适用的所有的硬件。

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

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

backup：指定该软件包为备用启动软件包。备用启动软件包用于主用启动软件包不可用或异常情况时，引导设备启动。

main：指定该软件包为主用启动软件包。主用启动软件包用于引导设备启动。

【使用指导】

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

需要重启系统来完成指定下次启动软件包的加载。

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

【举例】

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

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

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

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

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

The images that have passed all examinations will be used as the main startup so

ftware images at the next reboot on slot 1.

【相关命令】

·              display boot-loader

1.1.2  boot-loader update

boot-loader update命令用来实现当前软件版本的自动同步。

【命令】

（独立运行模式）

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

（IRF模式）

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

【视图】

用户视图

【缺省用户角色】

network-admin

【参数】

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

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

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

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

【使用指导】

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

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

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

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

【举例】

# 同步升级所有备用主控板。（独立运行模式）

<Sysname> boot-loader update all

This command will update all the 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.                                                              

Successfully updated the startup software images of all the standby MPU.

【相关命令】

·              display boot-loader

1.1.3  bootrom backup

bootrom backup命令用来将BootWare程序从BootWare的Normal区备份到Backup区。

【命令】

（独立运行模式）

bootrom backup slot slot-number-list [ subslot subslot-number-list ]

（IRF模式）

bootrom backup chassis chassis-number slot slot-number-list [ subslot subslot-number-list ]

【视图】

用户视图

【缺省用户角色】

network-admin

【参数】

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

chassis chassis-number：表示需要备份BootWare程序的设备在IRF中的成员编号。（IRF模式）

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

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

【使用指导】

BootWare分为Normal区和Backup区：

·              Normal区用于存放BootWare程序。设备启动时，会自动读取Normal区的BootWare程序。如果Normal区的BootWare程序不可用，再自动读取Backup区的BootWare程序。

·              Backup区用于存放BootWare程序的副本。如果在设备运行过程中，Normal区的BootWare程序被损坏或者需要版本回退，可以使用bootrom restore命令将BootWare程序从Backup区恢复到Normal区。

【举例】

# 将BootWare程序从BootWare的Normal区备份到Backup区。（独立运行模式）

<Sysname> bootrom backup slot 1

Now backing up the Boot ROM, please wait...

......Done.

【相关命令】

·              bootrom restore

1.1.4  bootrom restore

bootrom restore命令用来将BootWare程序从BootWare的Backup区恢复到Normal区。

【命令】

（独立运行模式）

bootrom restore slot slot-number-list [ subslot subslot-number-list ]

（IRF模式）

bootrom restore chassis chassis-number slot slot-number-list [ subslot subslot-number-list ]

【视图】

用户视图

【缺省用户角色】

network-admin

【参数】

slot slot-number-list：槽位号列表，表示同时恢复多个单板的BootWare程序。表示方式为slot-number-list = { slot-number [ to slot-number ] }&<1-7>。其中，slot-number表示需要恢复的单板所在的槽位号。&<1-7>表示前面的参数最多可以输入7次。（独立运行模式）

chassis chassis-number：表示需要恢复BootWare程序的设备在IRF中的成员编号。（IRF模式）

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

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

【举例】

# 恢复BootWare程序。（独立运行模式）

<Sysname> bootrom restore slot 1

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

  Now restoring the Boot ROM, please wait...

......Done.

【相关命令】

·              bootrom backup

1.1.5  bootrom update

bootrom update命令用来将文件系统中的BootWare程序加载到BootWare的Normal区。

【命令】

（独立运行模式）

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

（IRF模式）

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

【视图】

用户视图

【缺省用户角色】

network-admin

【参数】

file file：文件系统中包含BootWare程序的文件，file表示用于BootWare程序升级的文件的名称，为1～63个字符的字符串。

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

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

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

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

【使用指导】

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

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

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

【举例】

# 使用Flash文件系统根目录下的a.bin文件升级设备的BootWare程序。（独立运行模式）

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

   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.6  bootrom-update security-check enable

bootrom-update security-check enable命令用来开启BootWare程序合法性检查功能。

undo bootrom-update security-check enable命令用来关闭BootWare程序合法性检查功能。

【命令】

bootrom-update security-check enable

undo bootrom-update security-check enable

【缺省情况】

BootWare程序合法性检查功能处于开启状态。

【视图】

系统视图

【缺省用户角色】

network-admin

【使用指导】

如果开启了本功能，则在升级BootWare程序时，设备会先检查BootWare文件的合法性：包括BootWare文件是否有效以及是否和硬件匹配等。检查通过后，才会升级。

【举例】

# 启动BootWare升级时的合法性检查功能。

<Sysname> system-view

[Sysname] bootrom-update security-check enable

1.1.7  display boot-loader

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

【命令】

（独立运行模式）

display boot-loader [ slot slot-number ]

（IRF模式）

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

【视图】

任意视图

【缺省用户角色】

network-admin

network-operator

【参数】

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

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

【举例】

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

<Sysname> display boot-loader

Software images on 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	启动软件包的相关信息
Current software images	最近一次启动使用的启动软件包列表
Main startup software images	主用下次启动软件包列表
Backup startup software images	备用下次启动软件包列表

 

【相关命令】

·              boot-loader file

1.1.8  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

【参数】

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

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

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

【举例】

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

<Sysname> display install active

Active packages on slot 1:

  flash:/patch.bin

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

<Sysname> display install active verbose

Active packages on slot 1:

flash:/patch.bin

 [Package]

 Vendor: H3C

 Product: SR8800

 Service name: system patch

 Platform version: 7.1.075

 Product version: Beta 7605

 Supported board: mpu lpu

 [Component]

 Component: system

 Description: system package

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

字段	描述
Active packages on the device	处于激活状态的软件包的相关信息
flash:/patch.bin	软件包的名称
[Package]	软件包的信息
Vendor	生产厂商
Product	产品名称
Service name	软件包所包含的服务名称： ·       如果显示为boot，表示该软件包为Boot包 ·       如果显示为system，表示该软件包为System包 ·       如果显示为boot patch，表示该软件包为Boot包的补丁包；如果显示为system patch，表示该软件包为System包的补丁包 ·       如果显示为其它值，则表示该软件包为提供某项功能的Feature包
Platform version	平台软件版本号
Product version	产品软件版本号
Supported board	软件包支持的硬件类型： 补丁支持的硬件类型： ·       mpu表示主控板 ·       lpu表示业务板
[Component]	组件信息，表示软件包的组成部分
Component	组件的名称
Description	组件的描述信息

 

【相关命令】

·              install active

1.1.9  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

【参数】

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:

 cfa0:/SYSTEM-B7605H01.bin

# 显示文件系统根目录下没有被激活的所有补丁的详细信息。（独立运行模式）

<Sysname> display install inactive verbose

Inactive packages on slot 1:

cfa0:/SYSTEM-B7605H01.bin

 [Package]

 Vendor: H3C

 Product: SR8800

 Service name: system patch

 Platform version: 7.1.075

 Product version: Beta 7605

 Supported board: mpu lpu

 [Component]

 Component: system

 Description: system package

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

【相关命令】

·              install deactivate

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 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命令用来显示与补丁包操作相关的日志。

【命令】

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 root at 04/28/2001 08:39:29.

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

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

    Install activate flash:/ssh.bin on slot 1

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

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

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

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

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

Job 2 completed successfully at 04/28/2001 08:40:30.

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

    Install activate flash:/route.bin on slot 1

Job 2 completed successfully at 04/28/2001 08:40:30.

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

Job 2 completed successfully at 04/28/2001 08:40:30.

# 显示系统中编号为1的软件包操作日志的详细信息。（独立运行模式）

<Sysname> display install log 1 verbose

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

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

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

    Install activate flash:/ssh.bin on slot 1

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

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

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

 

Detail of activating packages on slot 1.

    Get upgrade policy successfully.

 

Detail of activating packages on slot 1.

    Uncompress package to system successfully.

    Remove files from system successfully.

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

字段	描述
Install job 1 started by user root at 04/28/2001 08:39:29.	升级动作的执行者和执行时间
Job 1 completed successfully at 04/28/2001 08:39:30.	升级动作的完成时间
Install activate flash:/ssh.bin	执行的升级动作
Detail of activating packages	激活包动作的详细信息
Get upgrade policy successfully	表示升级决策处理成功
Uncompress package to system successfully	解压软件包文件到系统成功
Remove files from system 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：软件包的名称，形如filesystemname/filename.bin。该文件必须保存在设备任一文件系统的根目录下，该参数中必须包含文件系统的名称，从存储介质名称开始最多可输入63个字符。有关指定文件夹和文件详细介绍请参见“基础配置指导”中的“文件系统管理”。

all：表示主用主控板上各文件系统根目录下的所有软件包。（独立运行模式）

all：表示全局主用主控板上各文件系统根目录下的所有软件包。（IRF模式）

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

【举例】

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

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

  flash:/system.bin

  [Package]

 Vendor: H3C

 Product: SR8800

 Service name: system patch

 Platform version: 7.1.075

 Product version: Beta 7605

 Supported board: mpu lpu

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

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

  flash:/system.bin

  [Package]

 Vendor: H3C

 Product: SR8800

 Service name: system patch

 Platform version: 7.1.075

 Product version: Beta 7605

 Supported board: mpu lpu

 [Component]

 Component: system

 Description: system package

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

1.1.13  install activate

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

【命令】

（独立运行模式）

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

（IRF模式）

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

【视图】

用户视图

【缺省用户角色】

network-admin

【参数】

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

filename：补丁的名称，形如filesystemname/filename.bin。该文件必须保存在设备任一文件系统的根目录下，该参数中必须包含文件系统的名称，从存储介质名称开始最多可输入63个字符。有关指定文件夹和文件详细介绍请参见“基础配置指导”中的“文件系统管理”。

all：升级补丁包对应的所有单板。

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

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

【使用指导】

使用本命令激活指定硬件上的补丁包后，被激活的补丁包只在本次运行的系统中生效。要使被激活的补丁包在设备重启后继续生效，还需要执行install commit命令。若使用install activate patch filename all命令同时激活所有硬件上的补丁包，则无需执行install commit命令，所有补丁包在设备重启后继续生效。

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

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

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

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

【举例】

# 激活所有单板上的SYSTEM-WEAK-TESTH01-01.bin补丁包。（独立运行模式）

<Sysname> install activate patch cfa0:/SYSTEM-WEAK-TESTH01-01.bin all

This Command will activate the patch for the following slots:                                                                      

slot 0                                                                                                                             

[Y/N]:y                                                                                                                             

Verifying the file cfa0:/SYSTEM-WEAK-TESTH01-01.bin on slot 0...Done.

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

【相关命令】

·              install commit

·              install deactivate

1.1.14  install commit

install commit命令用来确认补丁包更改。

【命令】

install commit

【视图】

用户视图

【缺省用户角色】

network-admin

【使用指导】

执行本命令将修改设备下次启动时主用的软件包列表，只有在进行如下情况的配置修改设备当前的软件包列表时才需要执行本命令用来确认补丁更改：

·              执行install activate命令时

·              执行install deactivate命令时

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

【举例】

# 确认补丁更改。

<Sysname> install commit

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

【相关命令】

·              install activate

·              install deactivate

1.1.15  install deactivate

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

【命令】

（独立运行模式）

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

（IRF模式）

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

【视图】

用户视图

【缺省用户角色】

network-admin

【参数】

patch：补丁包。

filename：补丁的名称，形如filesystemname/filename.bin。该参数中必须且只能包含文件系统的名称，不能包含文件系统位置信息，从存储介质名称开始最多可输入63个字符。有关指定文件夹和文件详细介绍请参见“基础配置指导”中的“文件系统管理”。

all：表示安装了该补丁包的所有单板。

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

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

【使用指导】

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

该命令只能对已经激活的补丁包进行卸载操作。使用本命令卸载指定slot上的补丁包后，卸载的补丁包的特性功能在本次系统运行中失效。如果要使卸载的补丁包在设备重启后继续失效，请执行install commit命令对卸载操作进行确认。若使用install deactivate patch filename all命令同时卸载所有slot上的补丁包，则无需执行install commit命令，所有补丁包在设备重启后继续失效。

【举例】

# 卸载所有单板上的SYSTEM-WEAK-TESTH01-01.bin补丁包。（独立运行模式）

<Sysname> install deactivate patch cfa0:/SYSTEM-WEAK-TESTH01-01.bin all

This Command will deactivate the patch for the following slots:                                                                    

slot 0                                                                                                                             

[Y/N]:y                                                                                                                             

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

【相关命令】

·              display install inactive

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

【参数】

filename：补丁的名称，形如filesystemname/filename.bin。该文件必须保存在设备任一文件系统的根目录下，该参数中必须且只能包含文件系统的名称，不能包含文件系统位置信息，从存储介质名称开始最多可输入63个字符。有关指定文件夹和文件详细介绍请参见“基础配置指导”中的“文件系统管理”。

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

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

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

【使用指导】

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

【举例】

# 删除补丁包cfa0:/SYSTEM-B7605H01.bin。

<Sysname> install remove cfa0:/SYSTEM-B7605H01.bin

1.1.17  reset install log-history oldest

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

【命令】

reset install log-history oldest log-number

【视图】

用户视图

【缺省用户角色】

network-admin

【参数】

log-number：补丁包升级日志的数量。

【使用指导】

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

【举例】

# 清除2条最早的补丁包升级日志。

<Sysname> reset install log-history oldest 2

【相关命令】

·              display install log

1.1.18  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命令后，在设备启动过程中，当备用主控板发现自己当前启动软件包版本和主用主控板的当前启动软件包版本不一致时，会自动拷贝主用主控板的当前启动软件包列表中的所有软件包，设置为自己的主用下次启动软件包，并自动重启。这样，能够使得备用主控板启动后，和主用主控板启动软件包的版本一致。

本命令仅支持在独立运行模式下配置。

【举例】

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

<Sysname> system-view

[Sysname] version auto-update enable

【相关命令】

·              version check ignore

1.1.19  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