目  录

1 软件升级配置

1.1 设备软件简介

1.2 升级方法简介

1.3 通过整机重启方式升级Bootrom

1.4 通过整机重启方式升级启动文件

1.5 同步升级备用主控板的启动文件

1.6 通过热补丁方式升级启动文件

1.6.1 热补丁简介

1.6.2 热补丁基本概念

1.6.3 补丁状态

1.6.4 配置准备

1.6.5 一步式安装补丁

1.6.6 分步安装补丁

1.6.7 分步卸载补丁

1.7 软件升级显示和维护

1.8 立即升级配置举例（分布式设备）

1.9 立即升级配置举例（分布式IRF设备）

1.10 热补丁典型配置举例

1 软件升级配置

1.1  设备软件简介

设备软件主要包括Bootrom程序和系统启动文件。设备上电后，先运行Bootrom程序，初始化硬件并显示设备的硬件参数，然后运行系统启动文件；启动文件一方面提供对硬件的驱动和适配功能，另一方面实现了业务特性。Bootrom程序与系统启动文件是设备启动、运行的必备软件，为整个设备提供支撑、管理、业务等功能，它们的关系如图1-1所示。

图1-1 Bootrom程序与系统启动文件关系示意图

1.2  升级方法简介

Bootrom程序和系统启动文件都可以通过Bootrom菜单和命令行两种方式来升级，本文只介绍命令行升级方式，通过Bootrom菜单升级的具体操作请参见设备的安装手册。

通过命令行升级设备软件分为以下几种方式：

表1-1 通过命令行升级设备软件方式

1.3  通过整机重启方式升级Bootrom

请按以下步骤升级Bootrom：

(1)        使用FTP或者TFTP，将Bootrom程序拷贝到设备存储介质的根目录下。

(2)        使用命令行指定下次启动时使用的Bootrom程序。

(3)        重启设备，使新的Bootrom程序生效。

表1-2 升级Bootrom

1.4  通过整机重启方式升级启动文件

l              分布式设备

采用本特性升级启动文件时，请按以下步骤进行：

(1)        使用FTP、TFTP或者其它方式将启动文件下载保存到主用主控板存储介质的根目录下。

(2)        将新的启动文件拷贝到备用主控板存储介质的根目录下。

(3)        使用命令行分别指定主用主控板和备用主控板下次启动时使用的启动文件（以下简称为下次启动文件）。

(4)        重启设备，使新的启动文件生效。

表1-3 指定下次启动文件

l              分布式IRF设备

采用本特性升级启动文件时，请按以下步骤进行：

(1)        使用FTP、TFTP或者其它方式将启动文件下载保存到全局主用主控板（Master设备主用主控板）存储介质的根目录下。

(2)        将新的启动文件拷贝到IRF中其它主控板（包括Master设备的备用主控板、Slave设备的主用主控板和Slave设备的备用主控板）存储介质的根目录下。

(3)        使用命令行指定IRF中所有主控板下次启动时使用的启动文件（以下简称为下次启动文件）。

(4)        重启设备，使新的启动文件生效。

当存储介质中有多个启动文件时，用户可以通过以下命令来指定设备下次启动文件。其中，主用启动文件用于引导、启动设备；备用启动文件只用于异常情况下（主用启动文件不可用时），引导、启动设备。

表1-4 指定下次启动文件（分布式IRF设备）

1.5  同步升级备用主控板的启动文件

在分布式设备中，当设备上已经存在一块主用主控板，再插入一块不同版本的主控板作为备用主控板时，主用主控板和备用主控板会因为版本不一致，而导致备用主控板不能正常工作以及主备倒换失败。此时，如果备用主控板的状态为Slave（请使用display device命令查看），则可以使用本特性快速升级备用主控板，使得备用主控板和主用主控板的版本保持一致；如果备用主控板的状态为Fault，则需要把备用主控板拔出后单独进行升级。

使用本功能相当于分步执行了以下操作来完成备用主控板的升级：

(1)        将主用主控板当前使用的启动文件拷贝到备用主控板；

(2)        将拷贝后的启动文件指定为备用主控板的主用下次启动文件；

(3)        重启备用主控板，备用主控板升级完成，备用主控板和主用主控板的版本一致。

表1-5 同步升级备用主控板的启动文件

1.6  通过热补丁方式升级启动文件

1.6.1  热补丁简介

热补丁是一种快速、低成本修复产品软件版本缺陷的方式。和升级软件版本相比，热补丁的主要优势是不会使设备当前正在运行的业务中断，即在不重启设备的情况下，可以对设备当前软件版本的缺陷进行修复。

1.6.2  热补丁基本概念

1. 补丁和补丁文件

补丁（又被称为补丁单元）是用来修复某个缺陷的程序包，通常以补丁文件的形式发布，一个补丁文件可能包含一个或多个补丁，不同的补丁具有不同的功能。当补丁文件被用户从存储介质加载到内存补丁区中时，补丁文件中的补丁将被分配一个在此内存补丁区中唯一的单元序号，用于标志、管理、操作各补丁，补丁的单元序号从1开始顺序编号，如某补丁文件中有3个补丁单元，那合法的补丁单元号为1、2和3。

2. 增量补丁

增量补丁是指各补丁单元对于在其前面的补丁单元有依赖性。比如，补丁文件中有3个补丁单元，则3号补丁必须在1号和2号补丁生效之后才能运行，而不能直接单独运行3号补丁。

H3C补丁文件中的补丁均为增量补丁。

1.6.3  补丁状态

每个补丁都有自身的状态，只有在用户命令行的干预下才能发生切换。补丁状态切换与命令操作关系如图1-2所示，其中：

l              IDLE、DEACTIVE、ACTIVE和RUNNING表示补丁的不同状态；

l              加载、临时运行、确认运行、停止运行、删除、安装、卸载表示补丁操作，分别对应命令patch load、patch active、patch run、patch deactive、patch delete、patch install和undo patch install；

l              箭头方向表示状态的转变方向。

比如对DEACTIVE状态的补丁执行patch active操作，补丁的状态就会变为ACTIVE。

图1-2 补丁状态切换与命令操作关系图

1. 初始状态（IDLE）

表示尚未加载补丁，无法进行安装、运行等补丁操作，如图1-3所示（假设系统补丁区中最多可以加载8个补丁）。

图1-3 补丁未加载

2. 未激活状态（DEACTIVE）

表示补丁已经被加载到内存补丁区，但尚未运行。假设用户将加载的补丁文件包含7个补丁，则这7个补丁将在经过版本校验及CRC校验之后被加载到内存补丁区，加载成功的补丁处于DEACTIVE状态，此时系统中补丁状态如图1-4所示。

图1-4 补丁文件被加载

3. 激活状态（ACTIVE）

表示补丁已经被临时运行，即该补丁在设备重启之后不再生效。对于图1-4中7个处于DEACTIVE状态的补丁，用户如果激活前5个补丁，则前5个补丁的状态将由DEACTIVE状态变成ACTIVE状态，此时系统中补丁状态如图1-5所示。

系统重启后，所有处于ACTIVE状态的补丁将变成DEACTIVE状态。

图1-5 补丁被激活

4. 确认运行状态（RUNNING）

表示补丁已经被永久运行，即该补丁在设备重启之后会继续生效。对于图1-5中5个处于ACTIVE状态的补丁，用户确认运行前3个补丁后，前3个补丁的状态将由ACTIVE状态变成RUNNING状态，此时系统中补丁状态如图1-6所示。

图1-6 补丁被确认运行

系统重启后，所有处于RUNNING状态的补丁仍保持为RUNNING状态。

1.6.4  配置准备

补丁文件是根据安装补丁的设备或单板类型按需发布。在进行补丁操作前，需要通过FTP/TFTP等方式将补丁文件保存到设备的存储介质上，保存时请注意：

l              补丁版本必须与设备型号、设备的软件版本相匹配。如果不匹配，则会造成补丁操作失败。

l              补丁文件的名称必须符合要求，否则系统无法找到补丁文件，造成补丁操作失败。单板补丁文件缺省名称如表1-6所示。

表1-6 产品缺省补丁文件命名参照表

1.6.5  一步式安装补丁

用户可以使用多条命令完成热补丁的安装，也可以通过patch install命令来一步式安装补丁。在执行patch install命令时，系统会提示“Do you want to continue running patches after reboot? [Y/N]:”：

l              如果输入<Y>或者<y>，则会安装指定路径下的所有补丁，设备或单板重启后这些补丁继续生效，补丁状态从IDLE转换到RUNNING，相当于依次执行了patch location、patch load、patch active和patch run命令。

l              如果输入<N>或者<n>，则会安装指定路径下的所有补丁，设备或单板重启后这些补丁不再继续生效，补丁状态从IDLE转换到ACTIVE，相当于依次执行了patch location、patch load和patch active命令。

表1-7 一步式安装补丁

1.6.6  分步安装补丁

1. 配置任务简介

表1-8 分步安装补丁配置任务简介

2. 设置补丁文件的加载路径

当设备支持多个存储介质时，用户可以将补丁文件保存到Flash外的其它存储介质。此时，需要使用该命令告知系统补丁文件的位置，执行补丁加载操作时，系统会将该路径下指定后缀的补丁加载到对应的单板。因此，在执行补丁加载之前，请确保补丁文件存放位置与设置好的路径一致。如果设备上只有一个存储介质，则不用设置该参数。

表1-9 设置补丁文件的加载路径

3. 加载补丁文件

只有正确加载补丁文件后才能进行补丁状态的管理。系统默认从Flash中读取补丁文件。

表1-10 加载补丁文件（分布式设备）

表1-11 加载补丁文件（分布式IRF设备）

4. 激活补丁

激活补丁后，补丁会立即生效，处于试运行阶段。设备复位或重启后，该补丁不再生效，需要重新激活。

补丁的激活状态主要是提供一个缓冲带，如果补丁本身有问题，可以重启设备，以消除该补丁的作用，从而防止因为补丁错误而导致系统连续运行故障。

表1-12 激活补丁（分布式设备）

表1-13 激活补丁（分布式IRF设备）

5. 确认运行补丁

确认运行补丁后，补丁的状态将变为RUNNING，处于正式运行阶段。设备复位或重启后，该补丁会继续生效。

表1-14 确认运行补丁（分布式设备）

表1-15 确认运行补丁（分布式IRF设备）

1.6.7  分步卸载补丁

1. 配置任务简介

表1-16 分步卸载补丁配置任务简介

2. 停止运行补丁

停止运行补丁后，补丁将进入未激活状态（DEACTIVE）。系统按打补丁前的特性运行。

表1-17 停止运行补丁（分布式设备）

表1-18 停止运行补丁（分布式IRF设备）

3. 删除补丁

执行该操作，只是将补丁从内存补丁区中删除，并不会将补丁从存储介质中删除，补丁回到初始状态（IDLE）。补丁删除后，系统按打补丁前的特性运行。

表1-19 删除补丁（分布式设备）

表1-20 删除补丁（分布式IRF设备）

1.7  软件升级显示和维护

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

表1-21 启动文件显示和维护

1.8  立即升级配置举例（分布式设备）

1. 组网需求

l              Device当前的软件版本为soft-version1、Bootrom版本为bootrom-version1，通过远程操作，立即将设备的软件版本升级到soft-version2、Bootrom版本升级到bootrom-version2。

l              最新版本的应用程序soft-version2.app和Bootrom程序bootrom-version2.btm都保存在FTP Server的aaa目录下；

l              Device的IP地址为1.1.1.1/24，FTP Server的IP地址为2.2.2.2/24，Device与FTP Server之间路由可达；

l              User通过Telnet远程登录到Device，User与Device之间路由可达。

2. 组网图

图1-7 配置远程升级组网图

3. 配置步骤

(1)        FTP Server的配置（注意：不同的服务器类型配置可能不同）

# 启动FTP Server功能。

<FTP-Server> system-view

[FTP-Server] ftp server enable

# 配置一个FTP用户名为aaa，密码为hello。

[FTP-Server] local-user aaa

[FTP-Server-luser-aaa] password cipher hello

# 配置该用户对aaa目录具有读写权限。

[FTP-Server-luser-aaa] service-type ftp

[FTP-Server-luser-aaa] authorization-attribute work-directory flash:/aaa

(2)        Device的配置

# 开始升级前，执行save命令保存当前配置（配置步骤略）。

# 登录FTP Server（注意：不同的服务器类型显示信息可能不同）。

<Device> ftp 2.2.2.2

Trying 2.2.2.2 ...

Press CTRL+K to abort

Connected to 2.2.2.2.

220 WFTPD 2.0 service (by Texas Imperial Software) ready for new user

User(2.2.2.2:(none)):aaa

331 Give me your password, please

Password:

230 Logged in successfully

[ftp]

# 下载FTP Server上的文件soft-version2.app和bootrom-version2.btm。

[ftp] binary

[ftp] get soft-version2.app

[ftp] get bootrom-version2.btm

[ftp] bye

<Device>

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

<Device> system-view

[Device] bootrom-update security-check enable

[Device] quit

# 升级主用主控板的Bootrom（主用主控板的槽位号为0）。

<Device> bootrom update file bootrom-version2.btm slot 0

# 升级备用主控板的Bootrom（备用主控板的槽位号为1）。

<Device> copy bootrom-version2.btm slot1#flash:/bootrom-version2.btm

<Device> bootrom update file slot1#flash:/bootrom-version2.btm slot 1

# 指定主用主控板下次启动时的应用程序。

<Device> boot-loader file soft-version2.app slot 0 main

# 指定备用主控板下次启动时的应用程序。

<Device> copy soft-version2.app slot1#flash:/soft-version2.app

<Device> boot-loader file slot1#flash:/soft-version2.app slot 1 main

# 重启设备，实现软件版本的升级。

<Device> reboot

设备重启后可以使用display version命令验证升级是否成功。

1.9  立即升级配置举例（分布式IRF设备）

1. 组网需求

l              IRF由Master和Slave两台成员设备组成。Master的成员编号为1，主用主控板所在的槽位号为0，备用主控板所在的槽位号为1；Slave的成员编号为2，主用主控板所在的槽位号为0，备用主控板所在的槽位号为1。

l              IRF当前的软件版本为soft-version1，通过远程操作，将IRF系统的软件版本升级到soft-version2，配置文件升级到new-config；

l              最新版本的应用程序soft-version2.app和最新配置文件new-config.cfg都保存在TFTP server上；

l              IRF的IP地址为1.1.1.1/24，TFTP server的IP地址为2.2.2.2/24。IRF与TFTP server之间路由可达。

2. 组网图

图1-8 配置远程定时自动升级组网图

3. 配置步骤

(1)        TFTP server的配置（注意：不同的服务器类型配置可能不同）

通过合法渠道（比如H3C官方网站或者代理商、技术支援人员）获取正确版本的启动文件和配置文件，并将该文件存储到TFTP server的工作路径，以便TFTP client可以访问。

(2)        IRF的配置

# 将new-config.cfg下载到Master设备的主控板上（注意：不同的服务器类型显示信息可能不同）。

<IRF> tftp 2.2.2.2 get new-config.cfg

  ..

  File will be transferred in binary mode

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

  TFTP:      917 bytes received in 1 second(s)

  File downloaded successfully.

<IRF> tftp 2.2.2.2 get new-config.cfg chassis1#slot1#flash:/new-config.cfg

# 将new-config.cfg下载到Slave设备的主控板上。

<IRF> tftp 2.2.2.2 get new-config.cfg chassis2#slot0#flash:/new-config.cfg

<IRF> tftp 2.2.2.2 get new-config.cfg chassis2#slot1#flash:/new-config.cfg

# 将启动文件soft-version2.app下载到Master和Slave上。

<IRF> tftp 2.2.2.2 get soft-version2.app

  ...

  File will be transferred in binary mode

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

  TFTP: 10058752 bytes received in 141 second(s)

  File downloaded successfully.

<IRF> tftp 2.2.2.2 get soft-version2.app chassis1#slot1#flash:/soft-version2.app

<IRF> tftp 2.2.2.2 get soft-version2.app chassis2#slot0#flash:/soft-version2.app

<IRF> tftp 2.2.2.2 get soft-version2.app chassis2#slot1#flash:/soft-version2.app

# 将所有成员设备的下次启动配置文件指定为new-config.cfg。

<IRF> startup saved-configuration new-config.cfg main

Please wait ...

Setting the master board ...

... Done!

Setting the slave board ...

Chassis 1 Slot 1:

 Set next configuration file successfully.

Chassis 2 Slot 0:

 Set next configuration file successfully.

Chassis 2 Slot 1:

 Set next configuration file successfully.

# 将所有主控板的下次启动文件指定为soft-version2.app。

<IRF> boot-loader file soft-version2.app chassis 1 slot 0 main

  This command will set the boot file of the specified board. Continue? [Y/N]:y

  The specified file will be used as the main boot file at the next reboot on chassis 1 slot 0!

<IRF> boot-loader file chassis1#slot1#flash:/soft-version2.app chassis 1 slot 1 main

  This command will set the boot file of the specified board. Continue? [Y/N]:y

  The specified file will be used as the main boot file at the next reboot on chassis 1 slot 1!

<IRF> boot-loader file chassis2#slot0#flash:/soft-version2.app chassis 2 slot 0 main

  This command will set the boot file of the specified board. Continue? [Y/N]:y

  The specified file will be used as the main boot file at the next reboot on chassis 2 slot 0!

<IRF> boot-loader file chassis2#slot1#flash:/soft-version2.app chassis 2 slot 1 main

  This command will set the boot file of the specified board. Continue? [Y/N]:y

  The specified file will be used as the main boot file at the next reboot on chassis 2 slot 1!

# 重启所有成员设备完成升级。

<IRF> reboot

设备重启后可以使用display version命令验证升级是否成功。

1.10  热补丁典型配置举例

1. 组网需求

l              Device当前的软件版本存在一些缺陷，请使用补丁文件进行修复。

l              最新补丁文件patch_mpu.bin（主控板的补丁文件）和patch_lpu.bin、patch_lpo.bin（业务板的补丁文件）都保存在TFTP server上。

l              Device的IP地址为1.1.1.1/24，TFTP server的IP地址为2.2.2.2/24，Device与TFTP server之间路由可达。

2. 组网图

图1-9 热补丁升级组网图

3. 配置步骤

(1)        TFTP server的配置（不同应用程序的配置方式不同，具体步骤略）

l              启动TFTP server功能。

l              将patch_mpu.bin、patch_lpu.bin和patch_lpo.bin文件放到TFTP server的工作路径。

(2)        Device的配置

# 开始升级前，执行save命令保存当前配置（配置步骤略）。

# 将TFTP server上的文件patch_mpu.bin、patch_lpu.bin和patch_lpo.bin下载到主用主控板上。

<Device> tftp 2.2.2.2 get patch_mpu.bin

<Device> tftp 2.2.2.2 get patch_lpu.bin

<Device> tftp 2.2.2.2 get patch_lpo.bin

# 将补丁文件拷贝到备用主控板的根目录下，备用主控板所在的槽位号为1。

<Device> copy patch_mpu.bin slot1#flash:/

<Device> copy patch_lpu.bin slot1#flash:/

<Device> copy patch_lpo.bin slot1#flash:/

# 安装补丁。

<Device> system-view

[Device] patch install flash:

Patches will be installed. Continue? [Y/N]:y

Do you want to continue running patches after reboot? [Y/N]:y

Installing patches........