选择区域语言: EN CN HK

01-基础配置命令参考

08-ISSU命令

本章节下载  (192.53 KB)

docurl=/cn/Service/Document_Software/Document_Center/Routers/Catalog/LA_wireless/H3C_LA3616/Command/Command_Manual/H3C_LA_CR(V7)-R0304-6W101/01/201803/1073460_30005_0.htm

08-ISSU命令


1 ISSU

1.1  ISSU配置命令

1.1.1  display install active

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

【命令】

display install active [ verbose ]

【视图】

任意视图

【缺省用户角色】

network-admin

network-operator

【参数】

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

【举例】

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

<Sysname> display install active

Active packages on the device:

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

 [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: xxxx

 [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: xxxx

 [Component]

 Component: test

 Description: test package

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

字段

描述

Active packages on the device

设备上处于激活状态的软件包的相关信息

flash:/boot.bin

软件包的名称

[Package]

软件包的信息

Vendor

生产厂商

Product

产品名称

Service name

软件包所包含的服务名称:

·     如果显示为boot,表示该软件包为Boot包

·     如果显示为system,表示该软件包为System包

·     如果显示为patch,表示该软件包为补丁包

·     如果显示为其它值,则表示该软件包为提供某项功能的Feature包

Platform version

平台软件版本号

Product version

产品软件版本号

Supported board

软件包支持的板卡类型:

如LA3616S,LA3616E等表示集中式设备

[Component]

组件信息,表示软件包的组成部分

Component

组件的名称

Description

组件的描述信息

 

【相关命令】

·     install active

1.1.2  display install backup

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

【命令】

display install backup [ verbose ]

【视图】

任意视图

【缺省用户角色】

network-admin

network-operator

【参数】

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

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

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

【相关命令】

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

·     display install committed

1.1.3  display install committed

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

【命令】

display install committed [ verbose ]

【视图】

任意视图

【缺省用户角色】

network-admin

network-operator

【参数】

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

【使用指导】

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

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

【举例】

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

<Sysname> display install committed

Committed packages on slot 1:

 flash:/boot-a0201.bin

 flash:/system-a0201.bin

 flash:/feature.bin

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

<Sysname> display install committed verbose

Committed packages 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: 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-1

【相关命令】

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

·     display install backup

·     install commit

1.1.4  display install inactive

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

【命令】

display install inactive [ verbose ]

【视图】

任意视图

【缺省用户角色】

network-admin

network-operator

【参数】

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

 Product version: Beta 1330

 Supported board: mr, lc, sfc

 [Component]

 Component: ssh

 Description: ssh package

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

【相关命令】

·     install deactivate

1.1.5  display install ipe-info

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

【命令】

display install ipe-info ipe-filename

【视图】

任意视图

【缺省用户角色】

network-admin

network-operator

【参数】

ipe-filename:表示IPE文件名,以.ipe作为后缀名,从存储介质名开始为1~63个字符的字符串(包括存储介质名在内),不区分大小写。如果该IPE文件不存在,命令执行失败。

【使用指导】

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

当配置该命令时,命令中指定的IPE文件必须放在存储介质的根目录下,文件名中必须包含存储介质的名称,形如flash:/xx.ipe。

【举例】

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

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

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

H3C Device images in IPE:

  boot.bin

  system.bin

【相关命令】

·     display install package

1.1.6  display install job

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

【命令】

display install job

【视图】

任意视图

【缺省用户角色】

network-admin

network-operator

【举例】

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

<Sysname> display install job

 JobID:5

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

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

1.1.7  display install log

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

【命令】

display install log [ log-id ] [ verbose ]

【视图】

任意视图

【缺省用户角色】

network-admin

network-operator

【参数】

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

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

【使用指导】

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

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

【举例】

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

<Sysname> display install log

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

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

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

    Install activate 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-2 display install log命令显示信息描述

字段

描述

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

ISSU动作的执行者和执行时间

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

ISSU动作的完成时间

Install activate flash:/ssh.bin on slot 1

执行的ISSU动作

Detail of activating packages on slot 1.

激活包动作的详细信息

Get upgrade policy successfully

表示升级决策处理成功

Uncompress package to system successfully

解压软件包文件到系统成功

Remove files from system successfully

从系统中删除文件成功

 

【相关命令】

·     reset install log-history oldest

1.1.8  display install package

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

【命令】

display install package { filename | all } [ verbose ]

【视图】

任意视图

【缺省用户角色】

network-admin

network-operator

【参数】

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

all:表示设备上存储介质根目录下的所有软件包。

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

【使用指导】

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

【举例】

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

1.1.9  display install rollback

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

【命令】

display install rollback [ point-id ]

【视图】

任意视图

【缺省用户角色】

network-admin

network-operator

【参数】

point-id:回滚点的编号。

【使用指导】

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

【举例】

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

<Sysname> display install rollback

Install rollback information 1 on slot 1:

  Updating from flash:/route-1.bin

         to flash:/route-2.bin.

 

Install rollback information 2 on slot 1:

   Deactivating flash:/route-2.bin

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

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

字段

描述

Install rollback information n

回滚点信息,n为回滚点编号

Updating from A to B

从软件包A升级到软件包BAB为软件包的名称

Deactivating A

卸载软件包AA为软件包的名称

 

【相关命令】

·     install rollback

·     reset install rollback oldest

1.1.10  display install which

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

【命令】

display install which { component name | file filename }

【视图】

任意视图

【缺省用户角色】

network-admin

network-operator

【参数】

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

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

【使用指导】

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

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

【举例】

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

<Sysname> display install which file sshc.cli

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

  flash:/system.bin

  [Package]

  Vendor: xxx

  Product: xxxx

  Service name: ssh

  Platform version: 7.1.022

  Product version: Beta 1330

  Supported board: mr, lc, sfc

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

1.1.11  display version comp-matrix

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

【命令】

display version comp-matrix

display version comp-matrix file { boot filename | system filename | feature filename&<1-30> } *

display version comp-matrix file ipe ipe-filename

【视图】

任意视图

【缺省用户角色】

network-admin

network-operator

【参数】

boot:表示Boot包。

system:表示System包。

feature:表示Feature包。

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

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

【使用指导】

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

【举例】

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

<Sysname> display version comp-matrix

Boot image: flash:/msr26-cmw710-boot-a030107.bin

  Version:

  7.1.059P02

 

System image: flash:/msr26-cmw710-system-a030107.bin

  Version:

  7.1.059-Alpha 030107

  Version compatibility list:

  7.1.059-Alpha 030107

  7.1.059-Alpha 030105

  7.1.057-Alpha 030103

  7.1.060-Alpha 040101

  Version dependency boot list:

  7.1.059P02

 

Feature image: flash:/msr26-cmw710-packet-capture-a030107.bin

  Version:

  7.1.059-Alpha 030107

  Version compatibility list:

  7.1.059-Alpha 030107

  7.1.059-Alpha 030105

  7.1.057-Alpha 030103

  7.1.056-Alpha 030102

  7.1.060-Alpha 040101

  7.1.058-Alpha 030104

  Version dependency system list:

  7.1.059-Alpha 030107

# 显示文件flash:/msr26-cmw710-boot-a030107.bin、flash:/msr26-cmw710-system-a030107.bin和flash:/msr26-cmw710-packet-capture-a030107.bin和当前运行软件包的兼容信息。(不兼容版本显示信息举例)

<Sysname> display version comp-matrix file boot flash:/msr26-cmw710-boot-a030107.bin system flash:/msr26-cmw710-system-a030107.bin feature flash:/msr26-cmw710-packet-capture-a030107.bin

Verifying the file flash:/msr26-cmw710-packet-capture-a030107.bin on the device.

...Done.

Verifying the file flash:/msr26-cmw710-boot-a030107.bin on the device...Done.

Verifying the file flash:/msr26-cmw710-system-a030107.bin on the device.........

..Done.

Boot image: flash:/msr26-cmw710-boot-a030107.bin

  Version:

  7.1.059P02

 

System image: flash:/msr26-cmw710-system-a030107.bin

  Version:

  7.1.059-Alpha 030107

  Version compatibility list:

  7.1.059-Alpha 030107

  7.1.059-Alpha 030105

  7.1.057-Alpha 030103

  7.1.060-Alpha 040101

  Version dependency boot list:

  7.1.059P02

 

Feature image: flash:/msr26-cmw710-packet-capture-a030107.bin

  Version:

  7.1.059-Alpha 030107

  Version compatibility list:

  7.1.059-Alpha 030107

  7.1.059-Alpha 030105

  7.1.057-Alpha 030103

  7.1.056-Alpha 030102

  7.1.060-Alpha 040101

  7.1.058-Alpha 030104

  Version dependency system list:

  7.1.059-Alpha 030107

 

Upgrade Way: File Upgrade

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

字段

描述

Verifying the file flash:/msr26-cmw710-packet-capture-a030107.bin on the device.

...Done.

验证文件是否合法

Boot image: flash:/msr26-cmw710-boot-a030107.bin

  Version:

要显示的Boot包的相关信息,包括:

·     Boot包的名称

·     Version:Boot包的版本

System image: flash:/msr26-cmw710-system-a030107.bin

  Version:

  7.1.059-Alpha 030107

  Version compatibility list:

  7.1.059-Alpha 030107

  7.1.059-Alpha 030105

  7.1.057-Alpha 030103

  7.1.060-Alpha 040101

  Version dependency boot list:

  7.1.059P02

要显示的System包的相关信息,包括:

·     System包的名称

·     Version:System包的版本

·     Version compatibility list:和该System包兼容的System包版本列表

·     Version dependency boot list:依赖的Boot包版本列表,即安装该System包前,必须先安装如下版本的Boot包中的任意一个

Feature image: flash:/msr26-cmw710-packet-capture-a030107.bin

  Version:

  7.1.059-Alpha 030107

  Version compatibility list:

  7.1.059-Alpha 030107

  7.1.059-Alpha 030105

  7.1.057-Alpha 030103

  7.1.056-Alpha 030102

  7.1.060-Alpha 040101

  7.1.058-Alpha 030104

  Version dependency system list:

  7.1.059-Alpha 030107

要显示的Feature包的相关信息,包括:

·     Feature包的名称

·     Version:Feature包的版本

·     Version compatibility list:和该Feature包兼容的Feature包版本列表

·     Version dependency system list:依赖的System包版本列表,即安装该Feature包前,必须先安装如下版本的System包中的任意一个

Influenced service according to following table

如果升级,受影响的功能模块。只有版本兼容时,才会显示该信息

Incompatible upgrade

如果升级指定的软件包,则升级的方式为不兼容升级

Upgrade Way

兼容升级策略。只有版本兼容时,才会显示该信息。取值可能为:

·     Service Upgrade:表示服务级增量升级,该方式下,仅对本业务模块有影响,对系统以及其他业务模块没有影响

·     File Upgrade:表示文件级增量升级。该方式下,仅对系统内的、用户不可见的程序文件进行升级,对系统以及业务模块没有影响

·     ISSU Reboot:表示通过软重启方式升级

·     Reboot:表示通过重启方式升级

 

1.1.12  install abort

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

【命令】

install abort [ job-id ]

【视图】

用户视图

【缺省用户角色】

network-admin

【参数】

job-id:任务ID。不指定该参数时,则取消正在执行中的操作。

【使用指导】

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

【举例】

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

<Sysname> install abort

【相关命令】

·     display install job

1.1.13  install activate

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

【命令】

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

install activate patch filename

【视图】

用户视图

【缺省用户角色】

network-admin

【参数】

boot:表示Boot包。

system:表示System包。

feature:表示Feature包。

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

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

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

【使用指导】

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

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

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

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

【举例】

# 显示Feature包ssh2.bin的升级策略。

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

Verifying the file flash:/ssh2.bin on the device.....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。

# 激活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 maybe take several minutes, please wait.......................................................................Done.

【相关命令】

·     display install active

·     install commit

·     install deactivate

1.1.14  install add

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

【命令】

install add ipe-filename medium-name:

【视图】

用户视图

【缺省用户角色】

network-admin

【参数】

ipe-filename:IPE文件名,以.ipe作为后缀名,从存储介质名开始为1~63个字符的字符串(包括存储介质名在内),不区分大小写。

medium-name:存储介质的名称,形如flash。

【使用指导】

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

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

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

【举例】

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

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

Verifying image file..........................Done.

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

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

1.1.15  install commit

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

【命令】

install commit

【视图】

用户视图

【缺省用户角色】

network-admin

【使用指导】

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

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

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

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

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

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

【举例】

# 确认软件包更改。

<Sysname> install commit

【相关命令】

·     install activate

·     install deactivate

·     install rollback

1.1.16  install deactivate

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

【命令】

install deactivate feature filename&<1-30>

install deactivate patch filename

【视图】

用户视图

【缺省用户角色】

network-admin

【参数】

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

slot slot-numberslot-number取值为0,无特殊意义。

【使用指导】

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

当配置该命令时,文件名中必须包含存储介质的名称,形如flash:/xx.bin

【举例】

# 卸载设备上的patch包route-patch.bin。

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

【相关命令】

·     display install active

·     display install inactive

1.1.17  install remove

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

【命令】

install remove { filename | inactive }

【视图】

用户视图

【缺省用户角色】

network-admin

【参数】

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

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

【使用指导】

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

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

【举例】

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

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

1.1.18  install rollback to

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

【命令】

install rollback to { point-id | original }

【视图】

用户视图

【缺省用户角色】

network-admin

【参数】

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

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

【使用指导】

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

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

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

补丁包不支持回滚操作。

【举例】

# 回滚到回滚点1。

<Sysname> install rollback to 1

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

<Sysname> display install active

Active packages on slot 1:

  flash:/boot-a0201.bin

  flash:/system-a0201.bin

  flash:/ssh-feature-a0201.bin

<Sysname> display install rollback

Install rollback information 1 on slot 1:

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

  flash:/boot-a0201.bin

  flash:/system-a0201.bin

<Sysname> display install committed

Committed packages on slot 1:

  flash:/boot-a0201.bin

  flash:/system-a0201.bin

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

【相关命令】

·     display install rollback

1.1.19  install verify

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

【命令】

install verify

【视图】

用户视图

【缺省用户角色】

network-admin

【使用指导】

正常情况下,设备上运行的软件必须完整并且处于激活状态的软件包应该和已确认的软件包一致,否则,会导致设备重启前后运行的软件版本不一致,甚至不能正常启动。

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

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

·     当系统提示软件包不一致时,请使用install activateinstall 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.

1.1.20  reset install log-history oldest

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

【命令】

reset install log-history oldest log-number

【视图】

用户视图

【缺省用户角色】

network-admin

【参数】

log-numberISSU日志的数量。

【使用指导】

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

【举例】

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

<Sysname> reset install log-history oldest 2

【相关命令】

·     display install log

1.1.21  reset install rollback oldest

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

【命令】

reset install rollback oldest point-id

【视图】

用户视图

【缺省用户角色】

network-admin

【参数】

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

【使用指导】

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

【举例】

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

<Sysname> reset install rollback oldest 2

【相关命令】

·     display install rollback

不同款型规格的资料略有差异, 详细信息请向具体销售和400咨询。H3C保留在没有任何通知或提示的情况下对资料内容进行修改的权利!