目  录

1 ISSU

1.1 ISSU升级策略

1.2 ISSU升级方式

2 ISSU硬件要求及升级准备

2.1 ISSU升级对硬件的要求

2.2 ISSU升级准备

3 通过issu命令升级

3.1 升级指导

3.2 通过issu命令升级

3.2.1 多个成员设备升级配置步骤

3.2.2 单个成员设备配置步骤

3.3 通过issu命令升级显示和维护

3.4 通过issu命令升级配置举例

3.4.1 软件包兼容升级配置举例

3.4.2 软件包不兼容升级配置举例

3.4.3 软件包升级过程中回滚到升级前的版本配置举例

4 通过install命令升级

4.1 升级指导

4.2 通过IPE文件获得软件包

4.3 激活软件包

4.3.1 配置限制和指导

4.3.2 激活Boot包/System包/Feature包

4.3.3 激活补丁包

4.4 卸载Feature包/补丁包

4.5 软件包回滚

4.6 取消软件包操作

4.7 校验Boot包/System包/Feature包

4.8 删除软件包

4.9 通过install命令升级显示和维护

4.10 通过install命令升级配置举例

4.10.1 软件包升级配置举例

4.10.2 将软件包回滚到升级前的版本

4.10.3 通过补丁包升级启动软件配置举例

 

1 ISSU

ISSU（In-Service Software Upgrade，不中断业务升级）是一种可靠性高的升级设备启动软件的方式。它主要通过以下几个方面来确保在升级过程中业务不中断或者中断时间较短。

·     引入软件包概念，便于软件的管理和维护。将启动软件按功能划分成Boot软件包、System软件包、Feature软件包和补丁包，将系统软件中比较稳定的基础进程和相对比较活跃的业务进程分离。通常情况下，不需要升级基础进程，只需升级部分业务进程。而且，业务进程之间互相独立，当某业务需要版本更新时，只需升级该业务对应的软件包即可，不用升级所有模块，从而不会对设备运行甚至其它业务造成影响。关于软件包的详细介绍请参见“基础配置指导”中的“软件升级”。

·     支持热补丁。使用补丁包在不重启设备的情况下快速修复系统缺陷。

·     根据不同的应用场景，提供不同的升级策略，尽量避免升级影响到当前业务的正常进行。升级方式的详细描述请参见“1.1  ISSU升级策略”。

·     需要硬件的配合，比如部署至少两个成员设备。当主设备需要重启升级时，从设备能接替主设备的工作，保证升级过程业务尽量不中断。

另外，ISSU还提供了软件包回滚功能以便用户快速的进行版本回滚，以及丰富的display命令帮助用户了解升级状态和软件包的信息。

1.1  ISSU升级策略

进行ISSU方式前，请先将要升级的目标软件包下载到设备存储介质的根目录下，然后通过display version comp-matrix file命令查看设备将采用的ISSU升级策略。ISSU升级策略不同对当前业务的影响不同，采用的升级步骤也会有差异。

表1-1 ISSU升级策略描述表

升级策略		描述	对应display version comp-matrix file命令中的显示信息
兼容升级	增量升级	采用该方式升级时，系统会先分析升级前后软件版本间的差异，然后仅对差异部分的进程实施升级。该升级方式对系统影响最小、升级速度最快，为ISSU升级的最佳方式	Upgrade Way字段显示为Service Upgrade或者File Upgrade时，表示采用的是增量升级方式。其中： ·     Service Upgrade：表示服务级增量升级，该方式仅对本业务模块有影响，对系统以及其他业务模块没有影响 ·     File Upgrade：表示文件级增量升级。该方式仅对系统内的、用户不可见的程序文件进行升级，对系统以及业务模块没有影响
	软重启升级	采用该方式升级时，系统会先将系统运行瞬间的数据（运行数据、配置数据、硬件数据）和状态全部保存在内存中，再使用新软件重启CPU。重启期间数据转发平面继续提供转发能力，CPU重启后使用上次保存的数据、状态继续运行。对于需要实时和对端交互协议报文来保持连接的协议，则通过协议代理进程来确保软重启升级过程中连接和协议状态不受影响 与增量升级相比，软重启影响了本CPU上运行的所有模块，升级时间较长	Upgrade Way字段显示为ISSU Reboot时，表示采用的是软重启升级方式
	重启升级	采用该方式时，系统会自动重启本成员设备，并在重启过程中加载新软件来完成本设备的软件升级 ·     如果主设备和从设备都需要重启升级，请先升级从设备，再升级主设备。主设备升级前，可通过配置提高某从设备的优先级，然后再升级该从设备。从设备升级完成后再升级主设备，升级后的从设备会自动接替主设备的工作，从而最终实现整个IRF的ISSU升级 ·     如果IRF中只有主设备没有从设备，则该方式无法保证在升级过程中业务不中断	Upgrade Way字段显示为Reboot时，表示采用的是重启升级方式
不兼容升级		表示设备当前运行的软件版本和要升级的目标软件版本不兼容时的升级 该方式下需要硬件主备备份来保证升级过程中业务不中断	Incompatible upgrade

 

1.2  ISSU升级方式

ISSU有两种升级方式，一种是install命令升级方式，另一种是issu命令升级方式。

比较项	issu命令升级方式	install命令升级方式
是否要求新、旧软件版本兼容	不要求	要求
是否支持安装和卸载补丁	不支持	支持
对系统的影响范围	大	小
对操作者的技术要求	低，适合大多数操作者	高，需要操作者对系统有较深入的了解，对升级每个动作所产生的影响有着准确的判断
是否推荐操作者使用	推荐	不推荐

 

2 ISSU硬件要求及升级准备

2.1  ISSU升级对硬件的要求

·     建议通过Console口对设备实施ISSU升级。如果通过Telnet或SSH登录设备实施ISSU升级，在升级过程中可能会因Telnet或SSH连接中断，导致ISSU升级无法继续。

·     IRF中有多个成员设备并且都正常工作时，建议组网时采用环行连接来保证升级过程中业务不中断或者中断较少时间。如果只有一个成员，并且升级方式为重启升级时，不能保证业务不中断。

·     硬件升级或故障期间，请不要进行ISSU升级。否则可能会导致升级失败或者系统异常。

2.2  ISSU升级准备

1. 查看版本说明书

(1)     请仔细阅读软件版本说明书。了解是否可以使用ISSU功能升级设备。

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

用户在安装License时，系统会自动搜索存储介质上是否存在该License对应的软件包，如果存在一个，则直接自动安装该软件包；如果存在多个，则直接自动安装最先搜索到的软件包。

用户在卸载License时，系统会自动搜索该License对应的软件包是否在运行，如果正在运行，则会直接自动卸载该软件包。

2. 查看设备状态

请通过display device命令了解设备的当前状态。请确保此时所有设备均为正常状态，对于故障设备请先行排除故障后，再进行ISSU升级。

3. 准备软件包

(1)     请确保各成员设备上有足够的磁盘空间以保存启动软件包。

(2)     使用save命令保存当前配置。

(3)     通过FTP或TFTP将软件包下载到主设备的存储介质的根目录。用户在安装/升级从设备的软件时，系统会提示用户，是否需要将主设备上的该文件拷贝到从设备后再安装/升级。

4. 协议准备

特性	要求
GR或NSR	建议使能LDP、RSVP、OSPF、ISIS、BGP和FSPF等协议的GR或NSR功能，否则ISSU升级期间可能会出现业务中断的现象
BFD	建议去使能LDP、RSVP、OSPF、ISIS、RIP、BGP、VRRP、NQA等协议的BFD功能，否则ISSU升级期间可能会出现业务中断的现象
以太网链路聚合	所有动态聚合组的所有成员端口下LACP超时时间为长超时，即这些成员端口下都没有配置lacp period short命令
IRF	·     如果需要对整个IRF进行兼容版本重启升级，请配置IRF桥MAC地址的保留时间为6分钟或永久保留 ·     如果需要对整个IRF进行不兼容升级，并且IRF桥MAC地址为将执行issu load设备中的某台设备的MAC地址时，请在执行issu load命令前配置桥IRF桥MAC地址的保留时间为永久保留

 

只有一台成员设备，采用软重启的升级策略时，另有如下限制：

特性	要求
MSTP	关闭MSTP功能。否则，升级期间可能引发网络的拓扑变化，导致网络流量中断
以太网链路聚合	关闭以太网链路聚合功能。因为，软重启过程中仅支持静态聚合，动态聚合口上的流量可能中断
CFD	关闭CFD功能。因为，在软重启过程中，CFD的连续性检测功能将失效，导致网络流量异常
DLDP	关闭DLDP功能。否则，软重启过程中对端设备会因收不到检测报文而误认为出现单通现象，进而关闭端口，导致流量异常
环路检测	关闭环路检测功能。否则，软重启过程中对端设备会错误地激活先前检测到的环回端口，导致流量异常
组播协议（PIM、IGMP/MLD、IGMP-Snooping/MLD-Snooping）、路由协议（OSPF、ISIS、BGP）、FCoE（FIP、FSPF）	在软重启后可能由于对端设备超时而重新计算，导致相关业务流程中断

 

5. 其它准备

·     如果升级的目标版本与设备当前运行版本有功能删减，请务必确保手工将目标版本不支持的配置全部删除。

·     软件包和设备支持的特性/命令行是对应的。请在卸载软件包之前，删除该软件包对应的命令行并保存配置，以便保证已卸载的软件包对应的命令行不会出现在下次启动配置中。否则，设备重启后，即便配置文件中有该软件包对应的命令行，但是因为该软件包已经卸载，这些命令行也不会生效。需要安装该软件包后，重新执行这些命令使其生效。

3 通过issu命令升级

3.1  升级指导

在ISSU升级过程中，请遵循以下指导：

·     请确保网络拓扑稳定，禁止手工重启成员设备。

·     请确保系统中除了当前执行ISSU升级命令的用户外无其他用户登录。

·     请不要执行ISSU之外的命令，以免影响配置效果。

·     禁止对启动软件包进行修改、删除以及重命名等操作。

·     ISSU升级过程中issu和install命令互斥，只能选择其中的一种方式进行升级。但issu命令升级显示和维护命令在install命令升级过程中也可以使用。

·     ISSU升级需要经过一系列的操作步骤，升级过程中有严格的步骤要求。请完成一个步骤后再执行下一个步骤。

·     执行issu load、issu run switchover、issu commit、install activate或install deactivate命令前，请使用：

¡     display device命令查看到所有成员设备处于normal状态。

¡     display system internal ha service-group命令查看所有服务的action显示为0。

ISSU升级完成后，如需配置设备，请重新登录。

3.2  通过issu命令升级

升级前，请了解IRF的组成。

·     如果有多个成员设备，升级步骤请参见“3.2.1  多个成员设备升级配置步骤”。

·     如果只有一个成员设备，升级步骤请参见“3.2.2  单个成员设备配置步骤”。

3.2.1  多个成员设备升级配置步骤

·     如果当前软件包版本在显示信息的“Version compatibility list”中，则说明本次升级为兼容版本升级。请使用表3-1所示的步骤进行升级。

·     如果当前软件包版本不在显示信息的“Version compatibility list”中，则说明本次升级为不兼容版本升级。请使用表3-2所示的步骤进行升级。

1. 多个成员设备兼容版本升级

多个成员设备兼容版本升级的基本原则是以成员设备为单位升级，且先升级某个从设备，然后再升级包括主设备在内的其它成员设备。

表3-1 多个成员设备兼容版本升级步骤

操作		命令	说明
升级从设备的启动软件包并将从设备的主用下次启动软件包设置为指定的软件包		issu load file { boot filename | system filename | feature filename&<1-30> } * slot slot-number&<1-9>	二者选其一 slot slot-number请输入一个从设备的成员编号 该命令在用户视图下执行
		issu load file ipe ipe-filename slot slot-number&<1-9>
进行ISSU倒换		issu run switchover	该命令在用户视图下执行
（可选）确认ISSU兼容升级，接受指定成员设备的运行版本，并删除回滚定时器		issu accept	该命令在用户视图下执行
完成升级或者版本回滚	对原主设备及未升级的从设备进行兼容版本升级。所有成员设备完成升级后，本次升级结束，ISSU回到初始状态	issu commit slot slot-number	slot-number请输入待升级的原主设备以及其它从设备的成员编号，但要求一个成员设备升级完成后，再升级下一个 该命令在用户视图下执行
	手工版本回滚：回滚到升级前的版本	issu rollback	该命令在用户视图下执行
	自动版本回滚：设置回滚定时器的时长	system-view	缺省情况下，回滚定时器的时长为45分钟 用户执行issu run switchover命令后，系统会自动创建回滚定时器，如果直到定时器超时，用户仍没有执行issu accept或者issu commit命令，则系统会自动回滚到升级前的版本
		issu rollback-timer minutes

 

2. 多个成员设备不兼容版本升级

多个成员设备不兼容版本升级的基本原则是以成员设备为单位升级，且先升级一个或多个从设备（建议一次升级一半数量的从设备），然后再升级包括主设备在内的其它成员设备。

表3-2 多个成员设备不兼容版本升级步骤

操作		命令	说明
升级从设备的启动软件包并将从设备的主用下次启动软件包设置为指定的软件包		issu load file { boot filename | system filename | feature filename&<1-30> } * slot slot-number&<1-9>	二者选其一 slot slot-number&<1-9>请输入1个或多个从设备的成员编号。如果IRF为环形连接，建议一次升级一半数量的物理上邻接的成员设备（也称为对半升级），以便尽量减少升级对整个IRF业务的影响 该命令在用户视图下执行
		issu load file ipe ipe-filename slot slot-number&<1-9>
完成升级或者版本回滚	进行ISSU倒换，并且升级剩余的待升级的成员设备	issu run switchover	该命令在用户视图下执行
	手工版本回滚：回滚到升级前的版本	issu rollback	多个成员设备不兼容版本升级时，不支持自动版本回滚，但用户可使用该命令立即将软件回滚到升级前的版本 该命令在用户视图下执行

 

3.2.2  单个成员设备配置步骤

·     如果当前软件包版本在显示信息的“Version compatibility list”中，并且“Upgrade Way”显示为“Service Upgrade”或者“File Upgrade”时，说明本次升级为兼容版本的增量升级。请使用表3-3所示的步骤进行升级。

·     其它情况，请使用表3-4所示的步骤进行升级。

表3-3 单个成员设备兼容版本增量升级的步骤

操作		命令	说明
升级主设备的启动软件包并将主设备的主用下次启动软件包设置为指定的软件包		issu load file { boot filename | system filename | feature filename&<1-30> } * slot slot-number	二者选其一 slot slot-number请输入主设备的成员编号 该命令在用户视图下执行
		issu load file ipe ipe-filename slot slot-number
完成升级或者版本回滚	完成升级，ISSU回到初始状态	issu commit slot slot-number	slot slot-number请输入主设备的成员号 该命令在用户视图下执行
	手工版本回滚：回滚到升级前的版本	issu rollback	单个成员设备兼容版本增量升级时，不支持自动版本回滚，但用户可使用该命令立即将软件回滚到升级前的版本 该命令在用户视图下执行

 

表3-4 单个成员设备兼容版本软重启、兼容版本重启以及不兼容升级的步骤

操作	命令	说明
升级主设备的启动软件包并将主设备的主用下次启动软件包设置为指定的软件包，升级完成后ISSU回到初始状态	issu load file { boot filename | system filename | feature filename&<1-30> } * slot slot-number	二者选其一 slot slot-number请输入主设备的成员号 该命令在用户视图下执行
	issu load file ipe ipe-filename slot slot-number

 

3.3  通过issu命令升级显示和维护

完成上述配置后，在任意视图下执行display命令可以显示配置后软件包的运行情况，通过查看显示信息验证配置的效果。

本节所列display和reset命令，和升级方式无关，不管是采用issu命令升级还是采用install命令升级，均可使用。

表3-5 ISSU显示和维护

操作	命令
显示软件包兼容信息	display version comp-matrix
显示当前ISSU升级的状态，以及ISSU升级的相关信息（该命令只显示issu命令升级过程中设备所处的状态，不能显示install命令升级过程中设备所处的状态）	display issu state
显示回滚定时器的相关信息	display issu rollback-timer
显示当前系统中已激活的软件包的相关信息	display install active [ slot slot-number ] [ verbose ]
显示存储介质根目录下、没有被激活的所有软件包的相关信息	display install inactive [ slot slot-number ] [ verbose ]
显示设备下次启动时使用的主用软件包的相关信息	display install committed [ slot slot-number ] [ verbose ]
显示设备下次启动时使用的备用软件包的相关信息	display install backup [ slot slot-number ] [ verbose ]
显示系统中正在执行的激活、卸载、回滚三种ISSU操作	display install job
显示与ISSU升级相关的日志	display install log [ verbose ]
显示软件包信息	display install package { filename | all } [ verbose ]
显示IPE文件信息	display install ipe-info ipe-filename
显示回滚点信息	display install rollback
显示一个组件或文件所属的软件包	display install which { component name | file filename } [ slot slot-number ]
清除ISSU日志	reset install log-history oldest log-number
清除回滚点	reset install rollback oldest point-id

 

3.4  通过issu命令升级配置举例

3.4.1  软件包兼容升级配置举例

1. 配置需求

·     IRF由两个成员设备组成：主设备的成员编号为1，从设备的成员编号为2。

·     将feature1特性从R0201版本升级到兼容版本R0202。

2. 组网图

图3-1 feature1软件包升级组网图

 

3. 配置步骤

# 保存设备当前配置。

<Sysname> save

# 从TFTP server下载包含新版本feature1软件包的BIN文件。

<Sysname> tftp 2.2.2.2 get feature1-r0202.bin

  % Total    % Received % Xferd  Average Speed   Time    Time     Time  Current

                                 Dload  Upload   Total   Spent    Left  Speed

100   256  100  256     0     0    764      0 --:--:-- --:--:-- --:--:--   810

# 查看升级前激活的软件包。

<Sysname> display install active

Active packages on slot 1:

  flash:/boot-r0201.bin

  flash:/system-r0201.bin

  flash:/feature1-r0201.bin

Active packages on slot 2:

  flash:/boot-r0201.bin

  flash:/system-r0201.bin

  flash:/feature1-r0201.bin

# 预测feature1软件包的升级效果。

<Sysname> display version comp-matrix file feature flash:/feature1-r0202.bin

Feature image: flash:/feature1-r0202.bin

  Version:

  V700R001B31D002

  Version Compatibility List:

  V700R001B31D001

  V700R001B31D002

  Version Dependency System List:

  V700R001B31D001

  V700R001B31D002

                                                

  Slot                        Upgrade Way

  1                           Service Upgrade

  2                           Service Upgrade

 

Influenced service according to following table on slot 1:

  flash:/feature1-r0202.bin

         feature1

Influenced service according to following table on slot 2:

  flash:/feature1-r0202.bin

         feature1

以上显示信息表明，feature1-r0202.bin的升级方式是增量升级，升级过程中feature1模块会重启。

# 升级从设备的feature1软件包。

<Sysname> issu load file feature flash:/feature1-r0202.bin slot 2

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

Upgrade summary according to following table:

Copying file flash:/feature1-r0202.bin to slot2#flash:/feature1-r0202.bin......Done.

flash:/feature1-r0202.bin

  Running Version             New Version

  Alpha 0201                  Alpha 0202

 

  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.

# 对feature1进程进行主备倒换。

<Sysname> issu run switchover

Upgrade summary according to following table:

 

flash:/feature1-r0202.bin

  Running Version             New Version

  Alpha 0201                  Alpha 0202

 

  Slot                        Switchover Way

  1                           Active standby process switchover

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

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

# 升级主设备的软件包。

<Sysname> issu commit slot 1

Upgrade summary according to following table:

 

flash:/feature1-r0202.bin

  Running Version             New Version

  Alpha 0201                  Alpha 0202

 

  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.

# 查看升级后激活的软件包。

<Sysname> display install active

Active packages on slot 1:

  flash:/boot-r0201.bin

  flash:/system-r0201.bin

  flash:/feature1-r0202.bin

Active packages on slot 2:

  flash:/boot-r0201.bin

  flash:/system-r0201.bin

  flash:/feature1-r0202.bin

3.4.2  软件包不兼容升级配置举例

1. 配置需求

·     IRF由两个成员设备组成：主设备的成员编号为1，从设备的成员编号为2。

·     将feature1特性从R0201版本升级到不兼容版本R0202。

2. 组网图

图3-2 软件包升级组网图

 

3. 配置步骤

# 保存设备当前配置。

<Sysname> save

# 从TFTP server下载包含新版本feature1软件包的BIN文件。

<Sysname> tftp 2.2.2.2 get feature1-r0202.bin

  % Total    % Received % Xferd  Average Speed   Time    Time     Time  Current

                                 Dload  Upload   Total   Spent    Left  Speed

100   256  100  256     0     0    764      0 --:--:-- --:--:-- --:--:--   810

# 查看升级前激活的软件包。

<Sysname> display install active

Active packages on slot 1:

  flash:/boot-r0201.bin

  flash:/system-r0201.bin

  flash:/feature1-r0201.bin

Active packages on slot 2:

  flash:/boot-r0201.bin

  flash:/system-r0201.bin

  flash:/feature1-r0201.bin

# 预测feature1软件包的升级效果。

<Sysname> display version comp-matrix file feature flash:/feature1-r0202.bin

Feature image: flash:/feature1-r0202.bin

  Version:

  V700R001B31D002

  Version Compatibility List:

  V700R001B31D002

  Version Dependency System List:

  V700R001B31D001

  V700R001B31D002

Incompatilbe upgrade.

以上显示信息表明，feature1-r0202.bin的升级方式是不兼容升级，升级过程中对应的板会重启。

# 升级从设备的feature1软件包。

<Sysname> issu load file feature flash:/feature1-r0202.bin slot 2

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

Copying file flash:/feature1-r0202.bin to slot2#flash:/feature1-r0202.bin......Done.

Upgrade summary according to following table:

 

flash:/feature1-r0202.bin

  Running Version             New Version

  Alpha 0201                  Alpha 0202

 

  Slot                        Upgrade Way

  2                           Reboot

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

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

# 升级主设备的feature1软件包。

<Sysname> issu run switchover

Upgrade summary according to following table:

 

flash:/feature1-r0202.bin

  Running Version             New Version

  Alpha 0201                  Alpha 0202

 

  Slot                        Upgrade Way

  1                           Reboot

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

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

# 查看升级后激活的软件包。

<Sysname> display install active

Active packages on slot 1:

  flash:/boot-r0201.bin

  flash:/system-r0201.bin

  flash:/feature1-r0202.bin

Active packages on slot2:

  flash:/boot-r0201.bin

  flash:/system-r0201.bin

  flash:/feature1-r0202.bin

3.4.3  软件包升级过程中回滚到升级前的版本配置举例

1. 配置需求

·     IRF由两个成员设备组成：主设备的成员编号为1，从设备的成员编号为2。

·     将feature1特性从R0201版本升级到兼容版本R0202后，再手工回退到R0201版本。

2. 组网图

图3-3 软件包升级组网图

 

3. 配置步骤

# 保存设备当前配置。

<Sysname> save

# 从TFTP server下载包含新版本feature1软件包的BIN文件。

<Sysname> tftp 2.2.2.2 get feature1-r0202.bin

  % Total    % Received % Xferd  Average Speed   Time    Time     Time  Current

                                 Dload  Upload   Total   Spent    Left  Speed

100  256k  100  256k    0     0   764k      0 --:--:-- --:--:-- --:--:--  810k

# 查看升级前激活的软件包。

<Sysname> display install active

Active packages on slot 1:

  flash:/boot-r0201.bin

  flash:/system-r0201.bin

  flash:/feature1-r0201.bin

Active packages on slot 2:

  flash:/boot-r0201.bin

  flash:/system-r0201.bin

  flash:/feature1-r0201.bin

# 预测feature1软件包的升级效果。

<Sysname> display version comp-matrix file feature flash:/feature1-r0202.bin

Feature image: flash:/feature1-r0202.bin

  Version:

  V700R001B31D002

  Version Compatibility List:

  V700R001B31D001

  V700R001B31D002

  Version Dependency System List:

  V700R001B31D001

  V700R001B31D002

                                               

  Slot                        Upgrade Way

  1                           Service Upgrade

  2                           Service Upgrade

 

Influenced service according to following table on slot 1:

  flash:/feature1-r0202.bin

         feature1

Influenced service according to following table on slot 2:

  flash:/feature1-r0202.bin

         feature1

以上显示信息表明，feature1-r0202.bin的升级方式是增量升级，升级过程中feature1模块会重启。

# 升级从设备的feature1软件包。

<Sysname> issu load file feature flash:/feature1-r0202.bin slot 2

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

Copying file flash:/feature1-r0202.bin to slot2#flash:/feature1-r0202.bin......Done.

Upgrade summary according to following table:

 

flash:/feature1-r0202.bin

  Running Version             New Version

  Alpha 0201                  Alpha 0202

 

  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.

# 对feature1进程进行主备倒换。

<Sysname> issu run switchover

Upgrade summary according to following table:

 

flash:/feature1-r0202.bin

  Running Version             New Version

  Alpha 0201                  Alpha 0202

 

  Slot                        Switchover Way

  1                           Active standby process switchover

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

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

# 查看激活的软件包。

<Sysname> display install active

Active packages on slot 1:

  flash:/boot-r0201.bin

  flash:/system-r0201.bin

  flash:/feature1-r0201.bin

Active packages on slot 2:

  flash:/boot-r0201.bin

  flash:/system-r0201.bin

  flash:/feature1-r0202.bin

# 将feature1软件包回滚到R0201版本。

<Sysname> issu rollback

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

# 查看激活的软件包。

<Sysname> display install active

Active packages on slot 1:

  flash:/boot-r0201.bin

  flash:/system-r0201.bin

  flash:/feature1-r0201.bin

Active packages on slot 2:

  flash:/boot-r0201.bin

  flash:/system-r0201.bin

  flash:/feature1-r0201.bin

4 通过install命令升级

4.1  升级指导

在ISSU升级过程中，请遵循以下指导：

·     请确保网络拓扑稳定，禁止手工重启成员设备。

·     请确保系统中除了当前执行ISSU升级命令的用户外无其他用户登录。

·     请不要执行ISSU之外的命令，以免影响配置效果。

·     禁止对启动软件包进行修改、删除以及重命名等操作。

·     ISSU升级过程中issu和install命令互斥，只能选择其中的一种方式进行升级。

·     执行install activate或install deactivate命令前，请使用：

¡     display device命令查看到所有成员设备处于normal状态。

¡     display system internal ha service-group命令查看所有服务的action显示为0。

ISSU升级完成后，如需配置设备，请重新登录。

4.2  通过IPE文件获得软件包

如果用户要升级的软件包是以IPE文件的形式发布的，请在执行其它install命令前，先按以下步骤将IPE包解压缩：

(1)     通过FTP或TFTP将IPE文件下载到主设备存储介质的根目录。

(2)     通过display install ipe-info命令查看该IPE文件中包含的软件包。

(3)     解压缩IPE文件：将IPE文件解压缩，生成软件包。

表4-1 解压缩IPE文件

操作	命令	说明
解压缩IPE文件	install add ipe-filename medium-name:	该命令在用户视图下执行

 

4.3  激活软件包

执行install activate命令可以安装/升级软件包。如果当前系统没有运行相同类型的软件包，则该过程称为安装软件包；如果当前系统有相同类型的软件包在运行，则该过程称为升级软件包。

4.3.1  配置限制和指导

在执行激活软件包前，请注意以下事项：

(1)     当需要升级两个或两个以上软件包时，请选择以下任意一种方法来激活软件包：

·     方法一：使用一条命令激活完一个slot的所有软件包后再激活另一个slot的所有软件包。

·     方法二：先升级完所有slot的某种类型的包（比如Boot包）之后，再升级所有slot的另外一种类型的包（比如System包）。

(2)     第一次激活Feature包/补丁包，即安装新Feature包/补丁包时，必须先激活主设备；升级已有软件包时，必须对激活从设备，再激活主设备。否则，安装/升级过程可能出错。

(3)     对于增量升级方式，软件包激活只在设备本次运行过程中生效，用户只有通过install commit命令确认软件包的更改后，才能使此次激活的软件包在系统重启后仍处于激活状态；对于软重启和重启升级方式，该步骤可选，因为用户在执行install activate命令时，系统已经修改了下次启动软件列表，升级软件包会在系统重启后继续生效。

(4)     设备上可安装的软件包（包括Boot包、System包、Feature包和补丁包）共为32个，其中Boot包和System包只能安装一个，Feature包和补丁包总共可安装30个。Feature包一次可以激活/卸载多个，补丁包一次只能激活/卸载一个。

4.3.2  激活Boot包/System包/Feature包

表4-2 激活Boot包/System包/Feature包

操作	命令	说明
（可选）显示Boot包/System包/Feature包的升级策略	install activate { boot filename | system filename | feature filename&<1-30> } * slot slot-number test	该命令在用户视图下执行
激活Boot包/System包/Feature包	install activate { boot filename | system filename | feature filename&<1-30> } * slot slot-number	该命令在用户视图下执行
确认软件包更改	install commit	该命令在用户视图下执行

 

4.3.3  激活补丁包

安装补丁包前，需进行如下判断：

·     如果当前设备上未安装补丁包，那么直接安装补丁包。

·     如果当前设备上已安装补丁包，则需查看版本说明书，对比新旧补丁包之间的功能差异：

¡     若新版本的补丁包中包含旧版本补丁包中的所有功能，且在安装完新版本的补丁后旧版本的补丁还存在，为了清理存储空间，可以手工卸载并删除旧版本的补丁包，不会影响设备的运行。

¡     若新版本的补丁包中不包含或不完全包含旧版本补丁包中的所有功能，请不要对旧版本的补丁包进行卸载和删除操作。

表4-3 激活补丁包

操作	命令	说明
激活补丁包	install activate patch filename { all | slot slot-number }	该命令在用户视图下执行
（可选）确认软件包更改	install commit	该命令在用户视图下执行

 

4.4  卸载Feature包/补丁包

因为Boot包和System包是设备运行的基础软件，所以Boot包和System包不支持卸载，只能卸载Feature包和补丁包。当Feature包/补丁包被卸载后，该软件包将处于未激活状态，系统也将不再具备该软件包提供的功能。但是软件包仍然存在于存储介质上，可以通过install remove命令将卸载后的软件包从存储介质上彻底删除。

Feature包/补丁包卸载也只在设备本次运行过程中生效，如果用户希望系统重启后，Feature包/补丁包卸载依然生效，请用户使用install commit命令确认软件包的更改。

表4-4 卸载Feature包

操作	命令	说明
卸载Feature包	install deactivate feature filename&<1-30> slot slot-number	该命令在用户视图下执行
（可选）确认软件包更改	install commit	该命令在用户视图下执行

 

表4-5 卸载补丁包

操作	命令	说明
卸载软件包	install deactivate patch filename { all | slot slot-number }	该命令在用户视图下执行
（可选）确认软件包更改	install commit	该命令在用户视图下执行

 

4.5  软件包回滚

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

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

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

表4-6 软件包回滚

操作	命令	说明
软件包回滚	install rollback to { point-id | original }	执行该命令前，可通过display install rollback命令查看回滚点信息 补丁包不支持回滚操作 该命令在用户视图下执行
（可选）确认软件包更改	install commit	该命令在用户视图下执行

 

4.6  取消软件包操作

增量升级方式下，当系统正在执行软件包的激活或卸载操作时，用户可以通过install abort命令或者按Ctrl+C取消正在执行中的操作，从而使系统回退到操作前的状态。

表4-7 取消软件包操作

操作	命令	说明
取消正在执行的ISSU操作	install abort	该命令在用户视图下执行

 

4.7  校验Boot包/System包/Feature包

该功能可用于检查激活的校验Boot包/System包/Feature包的完整性、各成员设备上激活的软件包列表和确认的软件包列表之间的差异（以方便用户知道是否有未确认的软件包）、以及不同的成员设备之间激活的软件包列表的差异（以方便用户知道不同成员设备上的软件包版本是否一致）。当发现有不一致的软件包时，用户可使用install activate命令或install deactivate命令更新激活的软件包列表，使用install commit命令更新确认的软件包列表。

表4-8 校验Boot包/System包/Feature包

操作	命令	说明
Boot包/System包/Feature包校验	install verify	该命令在用户视图下执行

 

4.8  删除软件包

软件包升级成功后，可以通过以下步骤删除旧版本的软件包。

需要注意的是，执行删除操作后，软件包会从设备上彻底删除，用户将不能执行与该软件包相关的install rollback to或者install abort命令。请确认不需要使用该软件包之后，再执行删除操作。

表4-9 删除软件包

操作	命令	说明
删除软件包	install remove [ slot slot-number ] { package | inactive }	该命令在用户视图下执行

 

4.9  通过install命令升级显示和维护

请参见“3.3  通过issu命令升级显示和维护”。

4.10  通过install命令升级配置举例

4.10.1  软件包升级配置举例

1. 配置需求

·     IRF由两个成员设备组成：主设备的成员编号为1，从设备的成员编号为2。

·     将feature1特性从R0201版本升级到兼容版本R0202。

2. 组网图

图4-1 软件包升级组网图

 

3. 配置步骤

# 保存设备当前配置。

<Sysname> save

# 从TFTP server下载包含新版本feature1软件包。

<Sysname> tftp 2.2.2.2 get feature1-r0202.ipe

  % Total    % Received % Xferd  Average Speed   Time    Time     Time  Current

                                 Dload  Upload   Total   Spent    Left  Speed

100  256k  100  256k    0     0   764k      0 --:--:-- --:--:-- --:--:--  810k

# 将IPE文件解压。

<Sysname> install add flash:/feature1-r0202.ipe flash:

# 查看升级前激活的软件包。

<Sysname> display install active

Active packages on slot 1:

  flash:/boot-r0201.bin

  flash:/system-r0201.bin

  flash:/feature1-r0201.bin

Active packages on slot 2:

  flash:/boot-r0201.bin

  flash:/system-r0201.bin

  flash:/feature1-r0201.bin

# 预测feature1软件包的升级效果。

<Sysname> install activate feature flash:/feature1-r0202.bin slot 2 test

Copying file flash:/feature1-r0202.bin to slot2#flash:/feature1-r0202.bin......Done.

Upgrade summary according to following table:

 

flash:/feature1-r0202.bin

  Running Version             New Version

  Alpha 0201                  Alpha 0202

 

  Slot                        Upgrade Way

  2                           Service Upgrade

 

Influenced service according to following table on slot 2:

  flash:/feature1-r0202.bin

         feature1

<Sysname> install activate feature flash:/feature1-r0202.bin slot 1 test

Upgrade summary according to following table:

 

flash:/feature1-r0202.bin

  Running Version             New Version

  Alpha 0201                  Alpha 0202

 

  Slot                        Upgrade Way

  1                           Service Upgrade

 

Influenced service according to following table on slot 1:

  flash:/feature1-r0202.bin

         feature1

以上显示信息表明，feature1-r0202.bin的升级方式是增量升级，升级过程中feature1模块会重启。

# 激活新版本的feature1软件包，从而对feature1特性进行升级。

<Sysname> install activate feature flash:/feature1-r0202.bin slot 2

flash:/feature1-r0202.bin already exists on slot 2.

Overwrite it?[Y/N]:y

Copying file flash:/feature1-r0202.bin to slot2#flash:/feature1-r0202.bin......Done.

Upgrade summary according to following table:

 

flash:/feature1-r0202.bin

  Running Version             New Version

  Alpha 0201                  Alpha 0202

 

  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.

<Sysname> install activate feature flash:/feature1-r0202.bin slot 1

Upgrade summary according to following table:

 

flash:/feature1-r0202.bin

  Running Version             New Version

  Alpha 0201                  Alpha 0202

 

  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.

# 查看升级后激活的软件包。

<Sysname> display install active

Active packages on slot 1:

  flash:/boot-r0201.bin

  flash:/system-r0201.bin

  flash:/feature1-r0202.bin

Active packages on slot 2:

  flash:/boot-r0201.bin

  flash:/system-r0201.bin

  flash:/feature1-r0202.bin

# 确认软件包更改。

<Sysname> install commit

4.10.2  将软件包回滚到升级前的版本

1. 配置需求

·     IRF由两个成员设备组成：主设备的成员编号为1，从设备的成员编号为2。

·     Feature1软件包从R0202版本回滚到R0201版本。

2. 配置步骤

# 查看回滚前激活的软件包。

<Sysname> display install active

Active packages on slot 1:

  flash:/boot-r0201.bin

  flash:/system-r0201.bin

  flash:/feature1-r0202.bin

Active packages on slot2:

  flash:/boot-r0201.bin

  flash:/system-r0201.bin

  flash:/feature1-r0202.bin

# 查看回滚点信息。

<Sysname> display install rollback

  Install rollback information 1 on slot 1:

    Updating from flash:/feature1-r0201.bin

             to flash:/feature1-r0202.bin.

  Install rollback information 2 on slot 2:

    Updating from flash:/feature1-r0201.bin

             to flash:/feature1-r0202.bin.

# 将feature1软件包回滚到R0201版本。

<Sysname> install rollback to original

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

# 查看回滚后激活的软件包。

<Sysname> display install active

Active packages on slot 1:

  flash:/boot-r0201.bin

  flash:/system-r0201.bin

  flash:/feature1-r0201.bin

Active packages on slot 2:

  flash:/boot-r0201.bin

  flash:/system-r0201.bin

  flash:/feature1-r0201.bin

# 确认软件包更改。

<Sysname> install commit

4.10.3  通过补丁包升级启动软件配置举例

1. 配置需求

·     IRF系统由两个成员设备组成：主设备的成员编号为1，从设备的成员编号为2。

·     设备当前的软件版本存在缺陷，需要安装补丁包进行修复。

2. 组网图

图4-2 通过补丁包升级启动软件配置举例

 

3. 配置步骤

# 将补丁包boot-patch.bin和system-patch.bin从TFTP server下载到主设备的Flash根目录下。

<Sysname> tftp 2.2.2.2 get boot-patch.bin

 

  File will be transferred in binary mode

  Downloading file from remote TFTP server, please wait...|

  TFTP:     100752 bytes received in 11 second(s)

  File downloaded successfully.

<Sysname> tftp 2.2.2.2 get system-patch.bin

 

  File will be transferred in binary mode

  Downloading file from remote TFTP server, please wait...|

  TFTP:     100112 bytes received in 9 second(s)

  File downloaded successfully.

# 查看升级前激活的软件包（此时可看到补丁包未激活）。

<Sysname> display install active

Active packages on slot 1:

  flash:/boot.bin

  flash:/system.bin

Active packages on slot 2:

  flash:/boot.bin

  flash:/system.bin

# 逐一激活主设备和从设备上的补丁包boot-patch.bin和system-patch.bin。

<Sysname> install activate patch flash:/boot-patch.bin slot 1

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

<Sysname> install activate patch flash:/boot-patch.bin slot 2

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

# 查看已激活的软件包（此时可看到补丁包已激活）。

<Sysname> display install active

Active packages on slot 1:

  flash:/boot.bin

  flash:/system.bin

  flash:/boot-patch.bin

  flash:/system-patch.bin

Active packages on slot 2:

  flash:/boot.bin

  flash:/system.bin

  flash:/boot-patch.bin

  flash:/system-patch.bin

# 确认补丁包更改，以保证补丁包在设备下次重启后仍然有效。

<Sysname> install commit

# 查看已确认更改的软件包（此时可看到补丁包已确认更改）。

<Sysname> display install committed

Committed packages on slot 1:

  flash:/boot.bin

  flash:/system.bin

  flash:/boot-patch.bin

  flash:/system-patch.bin

Committed packages on slot 2：

  flash:/boot.bin

  flash:/system.bin

  flash:/boot-patch.bin

  flash:/system-patch.bin