01-基础配置指导

08-ISSU配置

1.4.2 确认ISSU支持情况和License要求

1.6.1 通过issu命令进行多个成员设备组成的IRF的兼容版本升级

1.6.2 通过issu命令进行多个成员设备组成的IRF的不兼容版本升级

1.6.3 通过issu命令进行单个成员设备组成的IRF的兼容版本增量升级

1.6.4 通过issu命令进行单个成员设备组成的IRF的兼容版本重启以及不兼容升级

1.7 通过install命令升级

1.7.1 通过install命令升级配置任务简介

1.7.7 校验Boot包/System包/Feature包

1.10 通过issu命令升级典型配置举例

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

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

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

1.11 通过install命令升级典型配置举例

1.11.1 软件包升级配置举例

1.11.2 将软件包回滚到升级前的版本配置举例

1 ISSU

1.1 ISSU简介

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

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

1.1.1 ISSU的优点

Comware将系统中比较稳定的基础进程和相对比较活跃的业务进程分离。划分为Boot包、System包和Feature包。ISSU可以单独升级这些软件包，无需一起升级。

Feature包之间互相独立，当某业务需要版本更新时，只需升级该业务对应的Feature包即可，不用升级所有模块，从而不会对设备运行甚至其它业务造成影响。

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

1.1.2 ISSU升级策略

1. ISSU升级策略分类

软件在发布的时候，开发会根据当前版本和历史版本是否兼容以及兼容的程度，制定升级策略。ISSU升级策略包括如下几种：

· 兼容升级

¡ 增量升级（服务级/文件级）

¡ 重启升级

· 不兼容升级

当前版本和历史版本是否兼容请参考产品版本说明书的“ISSU版本兼容列表”。

ISSU升级策略不同对当前业务的影响不同，采用的升级步骤也会有差异。可参见“1.4.4 确定升级策略”确定升级策略。

2. 兼容升级

· 增量升级

本策略用于只有用户态进程需要更新时。使用该策略升级时，系统会仅对有差异的用户态进程实施升级，并通过进程的备份和倒换来保证升级过程中业务不中断。该策略对系统影响最小、升级速度最快，为ISSU升级的最佳方式。

增量升级又分为如下两种升级方式：

¡ 服务级增量升级（Service Upgrade）：仅对本业务模块有影响，对系统以及其他业务模块没有影响。

¡ 文件级增量升级（File Upgrade）：仅对系统内的、用户不可见的程序文件进行升级，对系统以及业务模块没有影响。

· 重启升级（Reboot）

本策略用于版本间的差异仍属于兼容范围内，但无法进行增量升级时。采用该方式时，系统会自动重启本成员设备，并在重启过程中加载新软件来完成本设备的软件升级。

重启升级过程中，除了正在重启的成员设备，其它成员设备均处于工作状态，从而保证了升级过程中业务不中断。

3. 不兼容升级（Incompatible upgrade）

表示设备当前运行的软件版本和要升级的目标软件版本不兼容时的升级。

不兼容版本因为版本差异较大，所以，在同一个系统中，两个版本不能同时运行。因此，不兼容升级过程中：

· 请先将一台或多台从设备升级到新版本，从设备升级完成后，系统会将它处于隔离状态，不能转发报文，主设备和其它没有升级的从设备处于工作状态。

· 然后执行主备倒换操作，此时，从设备变成主设备，自动接替原主设备工作，原主设备和其它没有升级的从设备逐个重启完成升级。

1.1.3 ISSU升级方式

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

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

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

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

1.1.4 ISSU工作机制

1. 单设备兼容版本增量升级

单设备是指单个成员设备组成的IRF。

如图1-1所示，单设备兼容版本增量升级时，升级过程如下：

(1) 未升级前，设备处于Init状态。

(2) 执行issu load命令升级设备，此时设备处于Loading状态，操作完成后设备将处于Loaded状态。

(3) 执行issu accept命令确认ISSU兼容升级，并停止自动回滚定时器，操作完成后设备将处于Accepted状态。

(4) 执行issu commit命令完成升级，此时设备处于Committing状态，操作完成后设备最后处于Init状态。

系统升级过程中，若进行回滚，则会回滚到升级前的版本。

图1-1 单设备兼容版本增量升级

2. 单设备兼容版本软重启、兼容版本重启以及不兼容升级

单设备是指单个成员设备组成的IRF。

如图1-2所示，单设备兼容版本软重启、兼容版本重启以及不兼容升级时，升级过程如下：

(1) 未升级前，设备处于Init状态。

(2) 执行issu load命令升级设备，此时设备处于Loading状态，操作完成后设备将处于Init状态。

图1-2 单设备兼容版本软重启、兼容版本重启以及不兼容升级

3. 多个成员设备组成的IRF兼容版本升级

如图1-3所示，多个成员设备组成的IRF兼容版本升级时，升级过程如下：

(1) 未升级前，设备处于Init状态。

(2) 执行issu load命令升级IRF内的一个从设备，此时设备处于Loading状态，操作完成后设备将处于Loaded状态。

(3) 执行issu run switchover命令进行主备倒换，设备处于Switching状态，操作完成后设备将处于Switchover状态。

(4) 执行issu accept命令确认ISSU兼容升级，并停止自动回滚定时器，操作完成后设备将处于Accepted状态。

(5) 执行issu commit命令升级其他未升级的成员设备，此时设备处于Committing状态，操作完成后设备最后处于Init状态。

系统升级过程中，若进行回滚，则会回滚到升级前的版本。

图1-3 多个成员设备组成的IRF兼容版本升级

4. 多个成员设备组成的IRF不兼容版本升级

如图1-4所示，多个成员设备组成的IRF不兼容版本升级时，升级过程如下：

(1) 未升级前，设备处于Init状态。

(2) 执行issu load命令升级IRF内的一个从设备，此时设备处于Loading状态，操作完成后设备将处于Loaded状态。

(3) 执行issu run switchover命令进行主备倒换，此时将升级其他所有成员设备，设备处于Switching状态，操作完成后设备处于Init状态。

系统升级过程中，若进行回滚，则会回滚到升级前的版本。

图1-4 多个成员设备组成的IRF不兼容版本升级

1.1.5 ISSU应用场景

在设备的运行过程中，当前软件不能满足现网运行或用户业务需求时，传统的软件升级需要对设备进行重启升级，将影响系统的业务，不利于提高通信服务质量。这时可选择ISSU方式进行升级软件，确保在升级过程中业务不中断或者中断时间较短。

通过给设备的软件加载补丁，可以在不中断设备运行的情况下实现对设备软件的动态在线升级，从而避免影响系统业务，有利于提高通信服务质量。

1.2 ISSU升级限制和指导

· 为确保升级成功，请核对产品的版本说明书，充分了解设备当前版本和目标版本之间的特性变更，务必将目标版本中不支持的命令行删除并保存配置后，再执行升级操作。

· 如果要卸载特性软件包，在卸载特性软件包之前，请务必将该软件包特性对应的命令行全部删除，并保存配置。

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

· 在当前的升级动作未结束前，不允许再执行其他升级动作。升级动作包括执行install、issu、boot-loader命令。

· 请不要执行以下操作：

¡ 手工重启成员设备。

¡ 执行ISSU之外的操作，包括配置修改及信息查询等。

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

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

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

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

· 首次执行issu load命令前，请使用display issu state命令查看ISSU是否Init的初始状态。只有ISSU处于Init的初始状态，才能开始进行ISSU升级。

· 执行issu load、issu run switchover、issu commit、install activate、install deactivate或issu one-step命令进行ISSU升级前，需保证设备处于稳定状态，否则无法执行操作。可以使用display system stable state命令查看系统状态，当System State字段为Stable时，设备处于稳定状态。关于display system stable state命令的详细介绍请参见“基础配置命令参考”中的“设备管理”。

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

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

· 补丁包分为叠加补丁和非叠加补丁。叠加补丁最多可以同时安装30个；由于每个Boot、System和Feature包只能安装一个非叠加补丁，所以非叠加补丁最多只能在设备上安装16个。有关叠加补丁和非叠加补丁的详细介绍请参见，“基础配置指导”的“软件升级”。

升级完成后请重新登录设备，否则将无法执行新版本与旧版本之间变更的命令。

升级完成后请使用display boot-loader命令查看设备的启动软件包列表，注意该列表中的.bin文件必须始终保存在设备的flash上，不可随意删除，否则会导致设备断电后无法再次启动。

1.3 ISSU升级前的检查项

1.3.1 查看设备运行状态

请确保此时所有设备均为正常状态，对于故障设备请先行排除故障后，再进行ISSU升级。

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

(2) 通过display irf命令检查IRF所有成员设备当前状态是否正常。

(3) 通过display cpu-usage命令检查设备CPU利用率是否低于门限值，建议所有设备的CPU利用率不要超过CPU利用率恢复门限值。

(4) 通过display memory和display memory-threshold命令检查设备内存剩余是否低于告警阈值，建议所有设备的内存剩余不要超过内存剩余恢复到正常状态的阈值。

(5) 通过display fan命令检查风扇状态是否均为Normal，所有设备的风扇状态必须为Normal。

(6) 通过display power命令检查电源状态是否均为Normal，所有设备的电源状态必须为Normal。

(7) 通过display environment命令检查设备上各硬件的当前温度是否均低于Warning值，所有硬件的当前温度必须低于Warning值。

(8) 通过display counters rate inbound interface命令检查各端口是否都正常转发流量，保证升级前各端口流量转发正常。

(9) 通过display interface | include CRC命令检查各端口是否都正常转发流量，保证升级前各端口流量转发正常。

1.3.2 检查设备配置

对于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

关于系统工作模式和硬件资源的运行模式的配置，请参见“基础配置指导”中的“设备管理配置”。关于前缀大于64位的IPv6路由功能和IPv4等价路由增强模式的配置，请参见“三层技术-IP路由配置指导”中的“IP路由基础配置”。

1.3.3 确认相关协议状态

为确保ISSU升级期间的业务连续性，请确保如下协议或特性的配置符合如下要求。

特性	要求
GR或NSR	开启LDP、RSVP、OSPF、ISIS、BGP和FSPF等协议的GR或NSR功能，否则ISSU升级期间可能会出现业务中断的现象请通过display命令确认协议的GR或NSR功能开启后系统是否处于稳定状态，以OSPF协议为例： · 开启GR功能后，请通过display ospf graceful-restart命令确认 · 开启NSR功能后，请通过display ospf non-stop-routing status命令确认
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地址的保留时间为永久保留 · 如果需要对整个IRF进行不兼容升级，请先关闭IRF MAD 检测功能，完成ISSU升级后再重新配置

1.4 ISSU升级前的准备项

为保证ISSU升级成功，请确保升级前所有的升级准备要求均已完成。

1.4.1 通过Console口登录设备

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

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

1.4.2 确认ISSU支持情况和License要求

请仔细阅读软件包版本发布说明书，了解如下信息：

(1) 当前版本与新软件版本之间是否支持ISSU升级。

(2) 新的软件是否需要License才能运行。如果设备当前没有对应的有效的License时，请先安装对应的License，再进行ISSU升级。否则，会导致软件包安装失败。

1.4.3 准备软件包

(3) 通过dir命令查看每个文件系统是否有足够的存储空间保存启动软件包。如果文件系统的存储空间不足，请通过delete /unreserved file-url命令删除多余的软件包。

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

1.4.4 确定升级策略

(5) 执行带文件名参数的display version comp-matrix file命令显示设备将采用的ISSU升级策略。

(6) 确认ISSU升级方式：

· 对于兼容版本升级，查看显示信息中的“Upgrade Way”字段。

· 对于非兼容版本升级，查看显示信息末尾部分，会显示“Incompatible upgrade”。

有关升级策略的具体介绍，参见“1.1.2 ISSU升级策略”。

1.4.5 选择升级步骤

(1) 根据确定的升级策略，选择升级方式（参见“1.1.3 ISSU升级方式”）。

(2) 确认设备的硬件冗余情况。

ISSU只有在下列情况下才能保证业务连续性：

¡ IRF中有多个正常工作的成员设备，采用环形组网。如果只有一个成员，并且升级方式为重启升级或不兼容升级时，不能保证业务不中断。

(3) 选择升级流程：根据硬件冗余情况及ISSU升级策略在“1.5 通过issu命令进行一键式升级”、“1.6 通过issu命令进行分步式升级”和“1.7 通过install命令升级”选择相应的升级流程。

1.4.6 调整并保存当前的配置

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

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

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

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

1. 升级限制和指导

一键式升级过程中不能执行回滚及其他任何操作。

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

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

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

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

2. 升级步骤

进行ISSU一键式升级。

· 指定.bin文件。

issu one-step file { boot filename | system filename | feature filename&<1-30> | patch filename&<1-30> } * [ slot slot-number&<1-9> ] [ reboot ]

· 指定.ipe文件。

issu one-step file ipe ipe-filename [ patch filename&<1-30> ] slot slot-number&<1-9> [ reboot ]

系统在一步完成ISSU升级前会对软件包进行数字签名校验，如果软件包通过校验则进行升级；如果软件包未通过校验则不会升级，并返回错误提示信息。

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

1.6.1 通过issu命令进行多个成员设备组成的IRF的兼容版本升级

1. 升级限制和指导

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

2. 配置步骤

(1) （可选）配置自动版本回滚。

a. 进入系统视图。

system-view

b. 设置回滚定时器的时长。

issu rollback-timer minutes

缺省情况下，回滚定时器的时长为45分钟。回滚定时器在执行issu run switchover时创建并开始计时。

c. 退回用户视图。

quit

(2) 确定系统处于稳定状态。

display system stable state

使用本命令显示的system state字段为Stable，则表示设备处于稳定状态。ISSU升级前使用本命令查看设备的状态，需要等待设备进入稳定状态，才可以进行ISSU升级。

(3) 升级从设备的启动软件包并将从设备的主用下次启动软件包设置为指定的软件包。

¡ 指定.bin文件。

issu load file { boot filename | system filename | feature filename&<1-30> | patch filename&<1-30> } * slot slot-number&<1-9> [ reboot ]

¡ 指定IPE文件。

issu load file ipe ipe-filename [ patch filename&<1-30> ] slot slot-number&<1-9> [ reboot ]

系统在升级设备的启动软件包并将设备的主用下次启动软件包设置为指定的软件包前会对软件包进行数字签名校验，如果软件包通过校验则升级设备的启动软件包并将设备的主用下次启动软件包设置为指定的软件包；如果软件包未通过校验则不会升级设备的启动软件包并将设备的主用下次启动软件包设置为指定的软件包，并返回错误提示信息。

(4) 确定系统处于稳定状态。

display system stable state

执行issu load命令后须等待设备稳定之后才能进行下一步操作。若在此阶段升级出错，也可以等待设备稳定之后使用issu rollback命令手动将版本回滚到升级前的状态。

(5) 进行ISSU倒换。

issu run switchover

若回滚定时器超时，则系统会自动回滚到升级前的版本。

(6) （可选）确认ISSU兼容升级，接受指定成员设备的运行版本，并删除回滚定时器。

issu accept

请在回滚定时器超时前配置本命令。

(7) 确定系统处于稳定状态。

display system stable state

执行issu commit命令前须保证设备处于稳定状态。若在此阶段升级出错，也可以等待设备稳定之后使用issu rollback命令手动将版本回滚到升级前的状态。

(8) 对原主设备及未升级的从设备进行兼容版本升级。所有成员设备完成升级后，本次升级结束，ISSU回到初始状态。

issu commit slot slot-number

所有成员设备完成升级后，本次升级结束，ISSU回到初始状态。执行此命令后，不能再通过ISSU回滚命令或者回滚定时器进行回滚操作。多个从设备的情况下应该在一个从设备启动完成并重新加入IRF后再对下一个从设备执行该命令，否则可能引起升级错误。

请在回滚定时器超时前配置本命令。

(9) 确定ISSU升级完成

display issu state

完成以上配置后，当本命令显示的ISSU state字段为Init，则表示ISSU升级完成。

1.6.2 通过issu命令进行多个成员设备组成的IRF的不兼容版本升级

1. 升级限制和指导

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

2. 配置步骤

请在用户视图下执行以下操作。

(10) 确定系统处于稳定状态。

display system stable state

(11) 升级从设备的启动软件包并将从设备的主用下次启动软件包设置为指定的软件包。

¡ 指定.bin文件。

issu load file { boot filename | system filename | feature filename&<1-30> | patch filename&<1-30> } * slot slot-number&<1-9> [ reboot ]

¡ 指定IPE文件。

issu load file ipe ipe-filename [ patch filename&<1-30> ] slot slot-number&<1-9> [ reboot ]

如果IRF为环形连接，建议一次升级一半数量的物理上邻接的成员设备，以便尽量减少升级对整个IRF业务的影响。

(12) 确定系统处于稳定状态。

display system stable state

(13) 进行ISSU倒换，并且升级剩余的待升级的成员设备。

issu run switchover

(14) 确定ISSU升级完成。

display issu state

完成以上配置后，当本命令显示的ISSU state字段为Init，则表示ISSU升级完成。

1.6.3 通过issu命令进行单个成员设备组成的IRF的兼容版本增量升级

请在用户视图下执行以下操作。

(15) 确定系统处于稳定状态。

display system stable state

(16) 升级主设备的启动软件包并将主设备的主用下次启动软件包设置为指定的软件包。

¡ 指定.bin文件。

issu load file { boot filename | system filename | feature filename&<1-30> | patch filename&<1-30> } * slot slot-number [ reboot ]

¡ 指定IPE文件。

issu load file ipe ipe-filename [ patch filename&<1-30> ] slot slot-number [ reboot ]

(17) 确定系统处于稳定状态。

display system stable state

(18) 完成升级，ISSU回到初始状态。

issu commit slot slot-number

升级完成后ISSU回到初始状态。执行此命令后，不能再通过ISSU回滚命令或者回滚定时器进行回滚操作。

(19) 确定ISSU升级完成。

display issu state

完成以上配置后，当本命令显示的ISSU state字段为Init，则表示ISSU升级完成。

1.6.4 通过issu命令进行单个成员设备组成的IRF的兼容版本重启以及不兼容升级

(20) 确定系统处于稳定状态。

display system stable state

(21) 升级主设备的启动软件包并将主设备的主用下次启动软件包设置为指定的软件包，升级完成后ISSU回到初始状态。

¡ 指定.bin文件。

issu load file { boot filename | system filename | feature filename&<1-30> | patch filename&<1-30> } * slot slot-number [ reboot ]

¡ 指定IPE文件。

issu load file ipe ipe-filename [ patch filename&<1-30> ] slot slot-number [ reboot ]

(22) 确定ISSU升级完成。

display issu state

完成以上配置后，当本命令显示的ISSU state字段为Init，则表示ISSU升级完成。

1.7 通过install命令升级

1.7.1 通过install命令升级配置任务简介

通过install命令升级配置任务如下：

(1) （可选）通过IPE文件获得软件包

(2) 安装/升级软件包

(3) （可选）卸载软件包

(4) （可选）软件包回滚

(5) （可选）取消软件包操作

(6) （可选）校验Boot包/System包/Feature包

(7) 确认软件包更改

(8) （可选）删除软件包

1.7.2 通过IPE文件获得软件包

(1) （可选）查看该IPE文件中包含的软件包。

display install ipe-info

(2) 解压缩IPE文件。

install add ipe-filename filesystem

该命令在用户视图下执行。

1.7.3 安装/升级软件包

1. 功能简介

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

通常情况下，设备上必定存在一个Boot包和一个System包，所以Boot包和System包通常为升级；而补丁包只能修复启动软件包的缺陷，不涉及功能的添加和删除，所以补丁包只有安装而没有升级的说法。

使用install命令安装/升级软件包分为激活和确认更改两个步骤。

2. 软件包安装/升级方法介绍

当需要安装/升级两个或两个以上软件包时，请选择以下任意一种方法来安装/升级软件包：

· 使用一条命令激活完一个slot的所有软件包后再激活另一个slot的所有软件包，最后确认激活。

· 先激活完所有slot的某种类型的包之后，再激活所有slot的另一种类型的包，最后确认激活。若使用该方法进行安装/升级，则需要查看软件版本说明书，确保升级软件包和设备当前软件包之间版本的兼容性，否则可能导致安装/升级失败。

3. 限制和指导

· 安装新Feature包/补丁包时，必须先激活主设备；升级已有Boot包/System包/Feature包时，必须先激活从设备，再激活主设备。否则，安装/升级过程可能出错。

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

4. 安装/升级Boot包/System包/Feature包

请在用户视图下执行以下操作。

(3) 确定系统处于稳定状态。

display system stable state

(4) （可选）显示Boot包/System包/Feature包的升级策略。

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

(5) 激活Boot包/System包/Feature包。

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

激活软件包前，系统会对软件包进行数字签名校验，如果软件包通过校验则激活软件包；如果软件包未通过校验则不激活软件包，并返回错误提示信息。

5. 安装补丁包

请在用户视图下执行以下操作。

(1) 确定系统处于稳定状态。

display system stable state

(2) 激活补丁包。

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

本命令一次只能激活一个补丁包，但是可以通过多次执行此命令为设备激活多个补丁包。

指定all参数表示同时激活所有硬件上的补丁包，此时无需执行install commit命令，所有补丁包在设备重启后继续生效。

1.7.4 卸载软件包

1. 功能简介

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

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

2. 卸载Feature包

请在用户视图下执行以下操作。

(1) 确定系统处于稳定状态。

display system stable state

使用本命令显示的system state字段为Stable，则表示设备处于稳定状态。卸载前使用本命令查看设备的状态，需要等待设备进入稳定状态，才可以进行卸载。

(2) 卸载Feature包。

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

3. 卸载补丁包

请在用户视图下执行以下操作。

(1) 确定系统处于稳定状态。

display system stable state

(2) 卸载补丁包。

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

本命令一次只能卸载一个补丁包，若要卸载多个补丁包，则需要多次执行此命令。

指定all参数表示同时卸载所有硬件上的补丁包，此时无需执行install commit命令，所有补丁包在设备重启后不再生效。

1.7.5 软件包回滚

1. 功能简介

通过回滚功能，用户可将系统回滚到某个历史状态。

系统对增量升级的激活或卸载操作会创建回滚点，记录每次的软件变化。系统最多支持50个回滚点，当回滚点超过最大值时，旧的回滚点会被删除，新的回滚点会被保存。

系统会保存回滚点直到用户进行了如下操作：

· Reboot升级。

· 执行install commit命令。

进行了Reboot升级之后，用户只能将当前运行软件回滚到Reboot之前的状态。

进行了Commit操作之后，用户将无法进行回滚。

对于增量升级，用户必须执行install commit命令确认软件包的更改后，回滚操作才能在重启后生效。

2. 配置步骤

请在用户视图下执行以下操作。

(1) （可选）查看设备的回滚点。

display install rollback

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

(2) 软件包回滚。

install rollback to { point-id | original }

补丁包不支持回滚操作。

1.7.6 取消软件包操作

1. 功能简介

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

2. 配置步骤

请选择一种方式取消正在执行的ISSU操作：

· 在用户视图下执行install abort [ job-id ]命令。

· 请按组合键Ctrl+C。

1.7.7 校验Boot包/System包/Feature包

1. 功能简介

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

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

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

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

2. 配置步骤

请在用户视图下执行以下操作。

(1) Boot包/System包/Feature包校验。

install verify

(2) 如发现不一致的软件包，更新激活的软件包列表。

install { activate | deactivate }

1.7.8 确认软件包更改

install commit

1.7.9 删除软件包

1. 功能简介

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

2. 配置限制和指导

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

3. 配置步骤

请在用户视图下执行本命令，删除软件包。

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

1.8 强制结束ISSU升级流程

当ISSU升级异常且不能再次进行升级操作时，可以强制结束ISSU升级流程。

(1) 进入系统视图。

system-view

(2) 强制结束ISSU升级流程。

issu quit

执行install activate、issu load命令的ISSU升级流程中可以执行此操作。

1.9 ISSU显示和维护

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

在用户视图下执行reset命令可以清除ISSU统计信息。

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

执行reset install rollback oldest命令后，将清除指定回滚点以及在此回滚点之前创建的所有回滚点，请谨慎使用。

表1-2 ISSU显示和维护

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

‌

1.10 通过issu命令升级典型配置举例

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

1. 配置需求

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

· 将Boot、System和Feature系统软件包从T0001015版本升级到兼容版本T0001016。

2. 组网图

图1-5 系统软件包升级组网图

3. 配置步骤

(1) 升级准备。

# 从TFTP server下载新版本Boot、System和Feature软件包。

<Sysname> tftp 2.2.2.2 get boot-t0001016.bin

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

Dload Upload Total Spent Left Speed

100 6078464 100 6078464 0 0 764 0 --:--:-- --:--:-- --:--:-- 810

Writing file...Done.

<Sysname> tftp 2.2.2.2 get system-t0001016.bin

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

Dload Upload Total Spent Left Speed

100 97750016 100 97750016 0 0 764 0 --:--:-- --:--:-- --:--:-- 810

Writing file...Done.

<Sysname> tftp 2.2.2.2 get feature-t0001016.bin

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

Dload Upload Total Spent Left Speed

100 1008640 100 1008640 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:/feature-t0001015.bin

Active packages on slot 2:

flash:/boot-t0001015.bin

flash:/system-t0001015.bin

flash:/feature-t0001015.bin

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

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

Verifying digital signature of the file flash:/boot-t0001016.bin on slot 1.......................Done.

Verifying digital signature of the file flash:/system-t0001016.bin on slot 1................. .................Done.

Verifying digital signature of the file flash:/feature-t0001016.bin on slot 1.................Done.

Identifying the upgrade methods....Done.

Slot Upgrade Way

1 Reboot

2 Reboot

以上显示信息表明，新版本软件包的升级方式是重启升级。

# 保存配置。

<Sysname> save

(2) 软件包升级。

# 升级从设备的软件包。

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

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

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

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

Verifying digital signature of the file flash:/boot-t0001016.bin on slot 2...Done.

Verifying digital signature of the file flash:/system-t0001016.bin on slot 2............Done.

Verifying digital signature of the file flash:/feature-t0001016.bin on slot 2...Done.

Identifying the upgrade methods….Done.

Upgrade summary according to following table:

flash:/boot-t0001016.bin

Running Version New Version

Test 0001015 Test 0001016

flash:/system-t0001016.bin

Running Version New Version

Test 0001015 Test 0001016

flash:/feature-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> display issu state

ISSU state: Loaded

Compatibility: Compatible

Work state: Normal

Upgrade method: Card by card

Upgraded slot:

slot 2

Current upgrading slot: None

Previous version list:

boot: 7.1.070, Test 0001015

system: 7.1.070, Test 0001015

feature: 7.1.070, Test 0001015

Previous software images:

flash:/boot-t0001015.bin

flash:/system-t0001015.bin

flash:/feature-t0001015.bin

Upgrade version list:

boot: 7.1.070, Test 0001016

system: 7.1.070, Test 0001016

feature: 7.1.070, Test 0001016

Upgrade software images:

flash:/boot-t0001016.bin

flash:/system-t0001016.bin

flash:/feature-t0001016.bin

从显示信息中可以看出，目前系统处于ISSU分步式升级过程中的Loaded状态，该状态是一个稳定状态，等待进行下一步主备倒换操作；当前只有slot2完成了从T0001015到T0001016版本的升级，slot1还未升级。

# 进行ISSU主备倒换。

<Sysname> issu run switchover

Upgrade summary according to following table:

flash:/boot-t0001016.bin

Running Version New Version

Test 0001015 Test 0001016

flash:/system-t0001016.bin

Running Version New Version

Test 0001015 Test 0001016

flash:/feature-t0001016.bin

Running Version New Version

Test 0001015 Test 0001016

Slot Switchover Way

1 Master subordinate switchover

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

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

# 确定系统处于稳定状态。

<Sysname> display issu state

ISSU state: Switchover

Compatibility: Compatible

Work state: Normal

Upgrade method: Card by card

Upgraded slot:

slot 2

Current upgrading slot: None

Previous version list:

boot: 7.1.070, Test 0001015

system: 7.1.070, Test 0001015

feature: 7.1.070, Test 0001015

Previous software images:

flash:/boot-t0001015.bin

flash:/system-t0001015.bin

flash:/feature-t0001015.bin

Upgrade version list:

boot: 7.1.070, Test 0001016

system: 7.1.070, Test 0001016

feature: 7.1.070, Test 0001016

Upgrade software images:

flash:/boot-t0001016.bin

flash:/system-t0001016.bin

flash:/feature-t0001016.bin

从显示信息中可以看出，目前系统处于ISSU分步式升级过程中的Switchover状态，该状态也是一个稳定状态，表示已经完成了ISSU主备倒换的操作，等待进行下一步Commit操作；当前只有slot2完成了从T0001015到T0001016版本的升级，slot1还未升级。

# 升级主设备。

<Sysname> issu commit slot 1

Upgrade summary according to following table:

flash:/boot-t0001016.bin

Running Version New Version

Test 0001015 Test 0001016

flash:/system-t0001016.bin

Running Version New Version

Test 0001015 Test 0001016

flash:/feature-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) 确定ISSU升级完成。

# 查看ISSU状态。

<Sysname> display issu state

ISSU state: Init

Compatibility: Unknown

Work state: Normal

Upgrade method: Card by card

Upgraded slot: None

Current upgrading slot: None

Current version list:

boot: 7.1.070, Test 0001016

system: 7.1.070, Test 0001016

feature: 7.1.070, Test 0001016

Current software images:

flash:/boot-t0001016.bin

flash:/system-t0001016.bin

flash:/feature-t0001016.bin

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

<Sysname> display install active

Active packages on slot 1:

flash:/boot-t0001016.bin

flash:/system-t0001016.bin

flash:/feature-t0001016.bin

Active packages on slot 2:

flash:/boot-t0001016.bin

flash:/system-t0001016.bin

flash:/feature-t0001016.bin

从显示信息中可以看出，目前系统处于ISSU分步式升级过程中的Init状态，表示ISSU升级完成，且所有激活的软件包版本均为T0001016，升级成功。

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

1. 配置需求

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

· 将Boot、System和Feature系统软件包从T0001015版本升级到不兼容版本T0001017。

2. 组网图

图1-6 系统软件包升级组网图

3. 配置步骤

(1) 升级准备。

# 从TFTP server下载新版本Boot、System和Feature系统软件包软件包。

<Sysname> tftp 2.2.2.2 get boot-t0001017.bin

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

Dload Upload Total Spent Left Speed

100 6078464 100 6078464 0 0 764 0 --:--:-- --:--:-- --:--:-- 810

Writing file...Done.

<Sysname> tftp 2.2.2.2 get system-t0001017.bin

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

Dload Upload Total Spent Left Speed

100 97750016 100 97750016 0 0 764 0 --:--:-- --:--:-- --:--:-- 810

Writing file...Done.

<Sysname> tftp 2.2.2.2 get feature-t0001017.bin

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

Dload Upload Total Spent Left Speed

100 1008640 100 1008640 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:/feature-t0001015.bin

Active packages on slot 2:

flash:/boot-t0001015.bin

flash:/system-t0001015.bin

flash:/feature-t0001015.bin

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

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

Verifying digital signature of the file flash:/boot-t0001017.bin on slot 1.......................Done.

Verifying digital signature of the file flash:/system-t0001017.bin on slot 1................. .................Done.

Verifying digital signature of the file flash:/feature-t0001017.bin on slot 1.................Done.

Identifying the upgrade methods....Done.

Incompatible upgrade.

以上显示信息表明，新版本软件包的升级方式是不兼容升级。

# 保存配置。

<Sysname> save

(2) 软件包升级。

# 升级从设备的软件包。

<Sysname> issu load file boot flash:/boot-t0001017.bin system flash:/system-t0001017.bin feature flash:/feature-t0001017.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:/boot-t0001017.bin to slot2#flash:/boot-t0001017.bin......Done.

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

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

Verifying digital signature of the file flash:/boot-t0001017.bin on slot 2...Done.

Verifying digital signature of the file flash:/system-t0001017.bin on slot 2............Done.

Verifying digital signature of the file flash:/feature-t0001017.bin on slot 2...Done.

Identifying the upgrade methods….Done.

Upgrade summary according to following table:

flash:/boot-t0001017.bin

Running Version New Version

Test 0001015 Test 0001017

flash:/system-t0001017.bin

Running Version New Version

Test 0001015 Test 0001017

flash:/feature-t0001017.bin

Running Version New Version

Test 0001015 Test 0001017

Slot Upgrade Way

2 Reboot

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

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

# 确定系统处于稳定状态。

<Sysname> display issu state

ISSU state: Loaded

Compatibility: Incompatible

Work state: Normal

Upgrade method: Card by card

Upgraded slot:

slot 2

Current upgrading slot: None

Previous version list:

boot: 7.1.070, Test 0001015

system: 7.1.070, Test 0001015

feature: 7.1.070, Test 0001015

Previous software images:

flash:/boot-t0001015.bin

flash:/system-t0001015.bin

flash:/feature-t0001015.bin

Upgrade version list:

boot: 7.1.070, Test 0001017

system: 7.1.070, Test 0001017

feature: 7.1.070, Test 0001017

Upgrade software images:

flash:/boot-t0001017.bin

flash:/system-t0001017.bin

flash:/feature-t0001017.bin

从显示信息中可以看出，目前系统处于ISSU分步式升级过程中的Loaded状态，该状态是一个稳定状态，等待进行下一步主备倒换操作；当前只有slot2完成了从T0001015到T0001017版本的升级，slot1还未升级。

# 进行ISSU主备倒换。

<Sysname> issu run switchover

Upgrade summary according to following table:

flash:/boot-t0001017.bin

Running Version New Version

Test 0001015 Test 0001017

flash:/system-t0001017.bin

Running Version New Version

Test 0001015 Test 0001017

flash:/feature-t0001017.bin

Running Version New Version

Test 0001015 Test 0001017

Slot Switchover Way

1 Master subordinate switchover

(3) 确定ISSU升级完成。

# 查看ISSU状态。

<Sysname> display issu state

ISSU state: Init

Compatibility: Unknown

Work state: Normal

Upgrade method: Card by card

Upgraded slot: None

Current upgrading slot: None

Current version list:

boot: 7.1.070, Test 0001017

system: 7.1.070, Test 0001017

feature: 7.1.070, Test 0001017

Current software images:

flash:/boot-t0001017.bin

flash:/system-t0001017.bin

flash:/feature-t0001017.bin

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

<Sysname> display install active

Active packages on slot 1:

flash:/boot-t0001017.bin

flash:/system-t0001017.bin

flash:/feature-t0001017.bin

Active packages on slot 2:

flash:/boot-t0001017.bin

flash:/system-t0001017.bin

flash:/feature-t0001017.bin

从显示信息中可以看出，目前系统处于ISSU分步式升级过程中的Init状态，表示ISSU升级完成，且所有激活的软件包版本均为T0001017，升级成功。

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

1. 配置需求

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

· 将Boot、System和Feature系统软件包从T0001015版本升级到兼容版本T0001016后，再手工回退到T0001015版本。

2. 组网图

图1-7 系统软件包升级组网图

3. 配置步骤

(1) 升级准备。

# 从TFTP server下载新版本Boot、System和Feature软件包。

<Sysname> tftp 2.2.2.2 get boot-t0001016.bin

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

Dload Upload Total Spent Left Speed

100 6078464 100 6078464 0 0 764 0 --:--:-- --:--:-- --:--:-- 810

Writing file...Done.

<Sysname> tftp 2.2.2.2 get system-t0001016.bin

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

Dload Upload Total Spent Left Speed

100 97750016 100 97750016 0 0 764 0 --:--:-- --:--:-- --:--:-- 810

Writing file...Done.

<Sysname> tftp 2.2.2.2 get feature-t0001016.bin

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

Dload Upload Total Spent Left Speed

100 1008640 100 1008640 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:/feature-t0001015.bin

Active packages on slot 2:

flash:/boot-t0001015.bin

flash:/system-t0001015.bin

flash:/feature-t0001015.bin

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

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

Verifying digital signature of the file flash:/all.ipe on slot 1................. .................Done.