目  录

1 ISSU简介

1.1 ISSU升级策略

1.2 ISSU升级方式

1.3 ISSU升级限制和指导

2 ISSU硬件要求及升级准备

2.1 ISSU升级对硬件的要求

2.2 ISSU升级准备

3 通过issu命令升级

3.1 issu命令升级简介

3.2 升级指导

3.3 通过issu命令进行一键式升级

3.4 通过issu命令进行分步式升级

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

3.4.2 单个成员设备配置步骤

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

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

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

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

3.6.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 将软件包回滚到升级前的版本

1 ISSU简介

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

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

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

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

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

本文中的升级指的是广义上升级，即升级前后，运行两个不同版本的软件。它包括狭义上的升级和降级。

1.1  ISSU升级策略

软件在发布的时候，产品会根据当前版本和历史版本是否兼容以及兼容的程度，制定升级策略。

进行ISSU方式前，请通过display version comp-matrix file命令显示目标软件包在当前设备将采用的ISSU升级策略。ISSU升级策略不同对当前业务的影响不同，采用的升级步骤也会有差异。

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

1.2  ISSU升级方式

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

表1-2 issu命令升级方式和install命令升级方式比较表

1.3  ISSU升级限制和指导

·     如果设备处于IRF连接中，请使用irf link-delay命令配置IRF链路中断的延迟上报时间为0。关于irf link-delay 命令的详细介绍请参见“虚拟化技术命令参考”中的“IRF”。

·     升级设备软件时，如果同时升级CPLD，会耗时较长，升级过程中，请保证设备不断电，否则可能会导致设备无法启动。

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. 检查设备配置

对于ISSU重启升级和不兼容升级，部分功能需要保证当前配置和重启后的配置的一致性，否则ISSU在执行从设备重启之后将由于主从设备的配置不一致导致IRF分裂，继而无法继续进行ISSU升级。功能如下：

·     系统工作模式（通过system-working-mode命令配置、display system-working-mode命令查看）。

·     表项容量（通过hardware-resource switch-mode命令配置、display hardware-resource switch-mode命令查看）。

·     最大等价路由条数（通过max-ecmp-num命令配置、display max-ecmp-num命令查看）。

·     IPv4等价路由增强模式（通过ecmp mode enhanced命令配置、display ecmp mode命令查看）。

·     前缀大于64位的IPv6路由功能（通过hardware-resource routing-mode ipv6-128命令配置、display hardware-resource routing-mode命令查看）。

·     OpenFlow的无丢包模式开启状态（通过openflow lossless enable命令配置、display current-configuration命令查看是否存在该配置）。

·     VXLAN的硬件资源模式（通过hardware-resource vxlan命令配置、display hardware-resource vxlan命令查看）。产品代码为LS-6800-32Q、LS-6800-2C、LS-6800-4C、LS-6800-54QF或LS-6800-54QT的机型不支持此命令。

4. 准备软件包

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

(2)     如果升级的目标版本与设备当前运行版本有特性变更，请务必将目标版本不支持的命令行删除。

(3)     如果要卸载特性软件包，在卸载该软件包之前，请务必删除该软件包特性对应的命令行。

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

(5)     通过FTP或TFTP将软件包下载到主设备任一文件系统的根目录。

5. 协议准备

6. 其它准备

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

3 通过issu命令升级

3.1  issu命令升级简介

issu命令升级支持一键式和分步式升级。一键式升级是指ISSU升级只需要进行一步操作即可完成整个系统的软件升级；分步式升级是指将ISSU升级分为多步操作，升级过程中可以看到设备每一步的状态，并可以在升级中途停止升级回滚到升级前的版本。

3.2  升级指导

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

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

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

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

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

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

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

·     执行issu load、issu run switchover或issu commit命令或进行ISSU一键式升级前，请使用display system stable state命令查看设备是否处于稳定状态。只有System State处于Stable状态，才能进行ISSU升级。关于display system stable state命令的详细介绍请参见“基础配置命令参考”中的“设备管理”。

·     当issu命令指定的软件包不能全部覆盖设备当前启动软件包时，除issu命令指定的软件包之外的其他软件包会被沿用，例如设备当前启动软件包中含有Feature包并且该Feature包有效，issu命令指定新的软件包中不包含新的Feature包，那么当前版本的Feature包会被沿用。若沿用的软件包与issu命令指定的软件包不兼容，会导致设备升级失败。

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

3.3  通过issu命令进行一键式升级

执行本操作后，系统将自动完成ISSU升级，升级过程中将不能执行回滚及其他任何操作。

若IRF中只有一个成员设备，可直接进行升级；若IRF中有多个成员设备：

·     对于兼容升级，请最多指定一个将在IRF升级后成为新的主设备的成员编号。

·     对于不兼容升级，可以指定一个或多个从设备升级，指定多个从设备时，新的主设备由系统自动选择。环形连接时，建议一次升级一半数量的物理上邻接的成员设备（也称为对半升级）。

·     当前版本和目标版本都必须是支持ISSU一键式升级的软件版本。

表3-1 通过issu命令进行一键式升级步骤

3.4  通过issu命令进行分步式升级

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

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

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

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

升级前，请使用display version comp-matrix file { boot filename | system filename | feature filename&<1-30> } *或者display version comp-matrix file ipe ipe-filename命令查看软件包的升级方式。

·     如果本次升级为兼容版本升级。请使用表3-2所示的步骤进行升级。

·     如果本次升级为不兼容版本升级。请使用表3-3所示的步骤进行升级。

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

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

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

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

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

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

3.4.2  单个成员设备配置步骤

升级前，请使用display version comp-matrix file { boot filename | system filename | feature filename&<1-30> } *或者display version comp-matrix file ipe ipe-filename命令查看软件包的升级方式。

·     如果本次升级为兼容版本的增量升级。请使用表3-4所示的步骤进行升级。

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

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

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

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

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

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

表3-6 ISSU显示和维护

‌

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

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

1. 配置需求

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

·     将Feature1特性从T0001015版本升级到兼容版本T0001016。

2. 组网图

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

3. 配置步骤

(1)     升级准备

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

<Sysname> tftp 2.2.2.2 get feature1-t0001016.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

Writing file...Done.

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

<Sysname> display install active

Active packages on slot 1:

  flash:/boot-t0001015.bin

  flash:/system-t0001015.bin

  flash:/feature1-t0001015.bin

Active packages on slot 2:

  flash:/boot-t0001015.bin

  flash:/system-t0001015.bin

  flash:/feature1-t0001015.bin

# 显示设备将采用的ISSU升级策略。

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

Verifying the file flash:/feature1-t0001016.bin on slot 1...Done.

  Slot                        Upgrade Way

  1                           Reboot

  2                           Reboot

Influenced service according to following table on slot 1:

  flash:/feature1-t0001016.bin

         Feature1

Influenced service according to following table on slot 2:

  flash:/feature1-t0001016.bin

         Feature1

以上显示信息表明，feature1-t0001016.bin的升级方式是重启升级。

(2)     软件包升级

·     非强制重启方式下的Feature1软件包兼容性升级

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

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

Verifying the file flash:/feature1-t0001016.bin on slot 1...Done.

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

Verifying the file flash:/feature1-t0001016.bin on slot 2...Done.

Identifying the upgrade methods….Done.

Upgrade summary according to following table:

flash:/feature1-t0001016.bin

  Running Version             New Version

  Test 0001015                Test 0001016

  Slot                        Upgrade Way

  2                           Reboot

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-t0001016.bin

  Running Version             New Version

  Test 0001015                Test 0001016

  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-t0001016.bin

  Running Version             New Version

  Test 0001015                Test 0001016

  Slot                        Upgrade Way

  1                           Reboot

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

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

·     强制重启方式下的Feature1软件包兼容性升级

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

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

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

Verifying the file flash:/feature1-t0001016.bin on slot 1...Done.

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

Verifying the file flash:/feature1-t0001016.bin on slot 2...Done.

Identifying the upgrade methods….Done.

Upgrade summary according to following table:

flash:/feature1-t0001016.bin

  Running Version             New Version

  Test 0001015                Test 0001016

  Slot                        Upgrade Way

  2                           Reboot

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-t0001016.bin

  Running Version             New Version

  Test 0001015                Test 0001016

  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-t0001016.bin

  Running Version             New Version

  Test 0001015                Test 0001016

  Slot                        Upgrade Way

  1                           Reboot

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

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

(3)     查看升级后激活的软件包。

<Sysname> display install active

Active packages on slot 1:

  flash:/boot-t0001015.bin

  flash:/system-t0001015.bin

  flash:/feature1-t0001016.bin

Active packages on slot 2:

  flash:/boot-t0001015.bin

  flash:/system-t0001015.bin

  flash:/feature1-t0001016.bin

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

1. 配置需求

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

·     将Feature1特性从T0001015版本升级到不兼容版本T0001016。

2. 组网图

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

3. 配置步骤

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

<Sysname> tftp 2.2.2.2 get feature1-t0001016.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

Writing file...Done.

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

<Sysname> display install active

Active packages on slot 1:

  flash:/boot-t0001015.bin

  flash:/system-t0001015.bin

  flash:/feature1-t0001015.bin

Active packages on slot 2:

  flash:/boot-t0001015.bin

  flash:/system-t0001015.bin

  flash:/feature1-t0001015.bin

# 显示设备将采用的ISSU升级策略。

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

Verifying the file flash:/feature1-t0001016.bin on slot 1...Done.

Incompatilbe upgrade.

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

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

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

Verifying the file flash:/feature1-t0001016.bin on slot 1...Done.

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

Verifying the file flash:/feature1-t0001016.bin on slot 2...Done.

Identifying the upgrade methods….Done.

Upgrade summary according to following table:

flash:/feature1-t0001016.bin

  Running Version             New Version

  Test 0001015                Test 0001016

  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-t0001016.bin

  Running Version             New Version

  Test 0001015                Test 0001016

  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-t0001015.bin

  flash:/system-t0001015.bin

  flash:/feature1-t0001016.bin

Active packages on slot2:

  flash:/boot-t0001015.bin

  flash:/system-t0001015.bin

  flash:/feature1-t0001016.bin

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

1. 配置需求

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

·     将Feature1特性从T0001015版本升级到兼容版本T0001016后，再手工回退到T0001015版本。

2. 组网图

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

3. 配置步骤

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

<Sysname> tftp 2.2.2.2 get feature1-t0001016.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

Writing file...Done.

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

<Sysname> display install active

Active packages on slot 1:

  flash:/boot-t0001015.bin

  flash:/system-t0001015.bin

  flash:/feature1-t0001015.bin

Active packages on slot 2:

  flash:/boot-t0001015.bin

  flash:/system-t0001015.bin

  flash:/feature1-t0001015.bin

# 显示设备将采用的ISSU升级策略。

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

Verifying the file flash:/feature1-t0001016.bin on slot 1...Done.

  Slot                        Upgrade Way

  1                           Reboot

  2                           Reboot

Influenced service according to following table on slot 1:

  flash:/feature1-t0001016.bin

         Feature1

Influenced service according to following table on slot 2:

  flash:/feature1-t0001016.bin

         Feature1

以上显示信息表明，feature1-t0001016.bin的升级方式是重启升级。

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

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

Verifying the file flash:/feature1-t0001016.bin on slot 1...Done.

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

Verifying the file flash:/feature1-t0001016.bin on slot 2...Done.

Identifying the upgrade methods….Done.

Upgrade summary according to following table:

flash:/feature1-t0001016.bin

  Running Version             New Version

  Test 0001015                Test 0001016

  Slot                        Upgrade Way

  2                           Reboot

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-t0001016.bin

  Running Version             New Version

  Test 0001015                Test 0001016

  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-t0001015.bin

  flash:/system-t0001015.bin

  flash:/feature1-t0001015.bin

Active packages on slot 2:

  flash:/boot-t0001015.bin

  flash:/system-t0001015.bin

  flash:/feature1-t0001016.bin

# 将Feature1软件包回滚到T0001015版本。

<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-t0001015.bin

  flash:/system-t0001015.bin

  flash:/feature1-t0001015.bin

Active packages on slot 2:

  flash:/boot-t0001015.bin

  flash:/system-t0001015.bin

  flash:/feature1-t0001015.bin

4 通过install命令升级

4.1  升级指导

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

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

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

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

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

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

·     执行install activate或install deactivate命令前，请使用display system stable state命令查看设备是否处于稳定状态。只有System State处于Stable状态，才能进行ISSU升级。关于display system stable state命令的详细介绍请参见“基础配置命令参考”中的“设备管理”。

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

4.2  通过IPE文件获得软件包

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

(1)     通过FTP或TFTP将IPE文件下载到设备任一文件系统的根目录。

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

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

表4-1 解压缩IPE文件

4.3  激活软件包

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

4.3.1  配置限制和指导

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

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

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

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

(2)     安装新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包

4.3.3  激活补丁包

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

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

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

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

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

表4-3 激活补丁包

4.4  卸载Feature包/补丁包

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

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

表4-4 卸载Feature包

表4-5 卸载补丁包

4.5  软件包回滚

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

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

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

表4-6 软件包回滚

4.6  取消软件包操作

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

表4-7 取消软件包操作

4.7  校验Boot包/System包/Feature包

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

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

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

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

当发现有不一致的软件包时，用户可使用install activate命令或install deactivate命令更新激活的软件包列表，使用install commit命令更新确认的软件包列表。

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

4.8  删除软件包

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

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

表4-9 删除软件包

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

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

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

4.10.1  软件包升级配置举例

1. 配置需求

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

·     将Feature1特性从T0001015版本升级到兼容版本T0001016。

2. 组网图

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

3. 配置步骤

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

<Sysname> tftp 2.2.2.2 get feature1-t0001016.ipe

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

                                 Dload  Upload   Total   Spent    Left  Speed

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

Writing file...Done.

# 解压缩IPE文件。

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

Verifying the file flash:/feature1-t0001016.ipe on slot 1...Done.

Decompressing file feature1-t0001016.bin to flash:/feature1-t0001016.bin.......................Done.

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

<Sysname> display install active

Active packages on slot 1:

  flash:/boot-t0001015.bin

  flash:/system-t0001015.bin

  flash:/feature1-t0001015.bin

Active packages on slot 2:

  flash:/boot-t0001015.bin

  flash:/system-t0001015.bin

  flash:/feature1-t0001015.bin

# 显示Feature1软件包的升级效果。

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

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

Verifying the file flash:/feature1-t0001016.bin on slot 2...Done.

Upgrade summary according to following table:

flash:/feature1-t0001016.bin

  Running Version             New Version

  Test 0001015                Test 0001016

  Slot                        Upgrade Way

  2                           Reboot

Influenced service according to following table on slot 2:

  flash:/feature1-t0001016.bin

         Feature1

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

Verifying the file flash:/feature1-t0001016.bin on slot 1...Done.

Upgrade summary according to following table:

flash:/feature1-t0001016.bin

  Running Version             New Version

  Test 0001015                Test 0001016

  Slot                        Upgrade Way

  1                           Reboot

Influenced service according to following table on slot 1:

  flash:/feature1-t0001016.bin

         Feature1

以上显示信息表明，feature1-t0001016.bin的升级方式是重启升级。

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

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

Verifying the file flash:/feature1-t0001016.bin on slot 1...Done.

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

Overwrite it?[Y/N]:y

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

Verifying the file flash:/feature1-t0001016.bin on slot 2...Done.

Upgrade summary according to following table:

flash:/feature1-t0001016.bin

  Running Version             New Version

  Test 0001015                Test 0001016

  Slot                        Upgrade Way

  2                           Reboot

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-t0001016.bin slot 1

Verifying the file flash:/feature1-t0001016.bin on slot 1...Done.

Upgrade summary according to following table:

flash:/feature1-t0001016.bin

  Running Version             New Version

  Test 0001015                Test 0001016

  Slot                        Upgrade Way

  1                           Reboot

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-t0001015.bin

  flash:/system-t0001015.bin

  flash:/feature1-t0001016.bin

Active packages on slot 2:

  flash:/boot-t0001015.bin

  flash:/system-t0001015.bin

  flash:/feature1-t0001016.bin

# 确认软件包更改。

<Sysname> install commit

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

1. 配置需求

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

·     Feature1软件包从T0001016版本回滚到T0001015版本。

2. 配置步骤

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

<Sysname> display install active

Active packages on slot 1:

  flash:/boot-t0001015.bin

  flash:/system-t0001015.bin

  flash:/feature1-t0001016.bin

Active packages on slot2:

  flash:/boot-t0001015.bin

  flash:/system-t0001015.bin

  flash:/feature1-t0001016.bin

# 查看回滚点信息。

<Sysname> display install rollback

  Install rollback information 1 on slot 1:

    Updating from flash:/feature1-t0001015.bin

             to flash:/feature1-t0001016.bin.

  Install rollback information 2 on slot 2:

    Updating from flash:/feature1-t0001015.bin

             to flash:/feature1-t0001016.bin.

# 将Feature1软件包回滚到T0001015版本。

<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-t0001015.bin

  flash:/system-t0001015.bin

  flash:/feature1-t0001015.bin

Active packages on slot 2:

  flash:/boot-t0001015.bin

  flash:/system-t0001015.bin

  flash:/feature1-t0001015.bin

# 确认软件包更改。

<Sysname> install commit

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