一、U 盘开局简介

1、定义

U盘开局是指设备在开局部署时，用户预先将开局文件存储在U盘中，然后将U盘插入设备，通过从U盘下载开局文件来对设备实现目标版本以及相关业务的部署。

2、目的

随着网络规模的扩大，网络中需要部署的设备数量越来越多，开局部署也日渐增多。相比传统的通过专业工程师逐台的去给设备开局的模式，U盘开局功能只需要让专业工程师把所有开局文件存储到U盘中即可，具体开局任务可以通过开局现场非专业人员来进行。这样即简化了开局部署流程，又降低了开局部署成本。

二、U 盘开局原理描述

1、U盘开局流程

U盘开局之前，需要先制作U盘开局索引文件并将索引文件保存至U盘根目录下。把需要加载的开局文件保存至U盘指定目录（根据索引文件的要求保存至相应目录）。将U盘插入设备中，设备会根据开局文件自动完成文件的加载。

U盘开局流程如图1-1所示:

2、开局文件分类

可以通过U盘中的索引文件实现对设备所需文件的自动加载。

● 必选文件

– 索引文件：名称必须为smart_config.ini

● 可选文件

– 系统软件：后缀名为.cc

– 配置文件：后缀名为.cfg或.zip

– 补丁文件：后缀名为.pat

– Web网页文件：后缀名为.web.7z

– 用户自定义文件

– 脚本文件：后缀名为.bat

可通过脚本文件，在U盘开局的同时，导入堆叠的相关配置。

用户可以根据需要选择其中的一种或多种可选文件进行U盘开局。

3、U 盘开局设备运行流程

U盘插入设备后的开局流程如图4-2所示：

图 1-2 U 盘开局设备运行流程图

其中对配置文件进行密码检查和HMAC校验流程如图4-3所示：

图 1-3 U 盘开局时对配置文件进行密码检查和 HMAC 校验流程图

1). U盘插入需要升级的设备，设备检测到U盘在位。

2). 设备是否开启了U盘开局功能：

– 如果是空配置设备，则U盘开局功能一直是开启的，则进入步骤3。

– 如果是非空配置设备开启了U盘开局功能，则进入步骤3。

– 如果是非空配置设备未开启U盘开局功能，则不进行U盘开局。

3). 设备检测U盘中是否存在U盘开局索引文件：

– 如果文件存在，进入步骤4。

– 如果文件不存在，则不进行U盘开局。

4). 设备检测U盘开局索引文件格式的合法性：

– 如果合法，进入步骤5。

– 如果文件非法，开局失败，流程结束，在U盘中生成错误报告。

5). 设备将索引文件中指定的数据变更时间标志与设备中记录的上次U盘开局的时间标志进行比较：

– 如果不相同，进入步骤6。

– 如果相同，开局失败，流程结束，在U盘中生成错误报告。

6). 判断设备上是否配置U盘开局的密码：

– 如果配置了密码，会再次判断索引文件中指定的密码是否与设备中配置的一致，如果一致，进入步骤7。如果不一致，开局失败，流程结束，在U盘中生成错误报告。

– 如果没有配置密码，进入步骤7。

7). 系统按照索引文件中的描述信息从U盘中获取开局文件，并将其保存至指定的存储介质中：

– 如果获取文件成功，进入步骤8。

– 如果获取文件失败，开局失败，流程结束，在U盘中生成错误报告。

8). 进行配置文件密码检查和HMAC校验：

– 如果升级文件中不包含配置文件，则进入步骤9。

– 如果升级文件中包含配置文件，未设置配置文件加密密码，则进入步骤9。

– 如果升级文件中包含配置文件，设置了配置文件加密密码，但未使能HMAC

校验功能，则对配置文件进行解密，解密成功，则进入步骤9；不成功，则开局失败，流程结束，在U盘中生成错误报告。

– 如果升级文件中包含配置文件，设置了配置文件加密密码，并且使能了

HMAC校验功能，则首先对配置文件进行HMAC校验，再对配置文件进行解密。HMAC校验通过并且配置文件解密成功，则进入步骤9；否则开局失败，流程结束，在U盘中生成错误报告。

9). 根据获取的文件或者指定的激活方式，设备自动判断是否需要重启激活。

– 如果不需要重启，则在线激活相应文件，进入步骤10。

– 如果需要重启，设备会将相应文件设置为下次启动文件，自动重启成功后，进入步骤10。

10). U盘开局成功，流程结束。将U盘从设备中拔出。

说明

● 如果开局成功，系统会在U盘根目录中生成文件名为usbload_verify.txt的开局成功报告。

● 如果开局失败，系统会在U盘根目录中生成文件名为usbload_error.txt的开局失败报告，用户可根据此报告定位出错原因。

三、 U 盘开局配置注意事项

涉及网元

无需其他网元配合。

License 支持

本特性是交换机的基本特性，无需获得License许可即可应用此功能。

V200R020C10 版本特性支持情况

仅如下款型支持U盘开局：

S5720-LI、S5720S-LI（支持USB接口的款型）、S5720I-SI、S5735S-H、S5736-S、

S5731-H、S5731-H-K、S5731-S、S5731S-S、S5731S-H、S5732-H、S5732-H-K、

S5735-L1、S5735-L、S5735S-L1、S5735S-L、S5735S-L-M、S500（支持USB接口的

款型）、S5735-S、S5735S-S、S5735-S-I（支持USB接口的款型）、S6720-EI、

S6720S-EI、S6730-H、S6730-H-K、S6730S-H、S6730-S、S6730S-S

说明

如需了解交换机软件配套详细信息，请点击Info-Finder。

特性依赖和限制

使用U盘开局前

● U盘规格：文件系统格式是FAT32，硬件接口是标准的USB2.0（S5700-LI提供USB1.1接口）。因不同厂商U盘型号的兼容性和驱动存在差异，如果出现U盘不能使用，请尝试更换主流厂商的U盘，交换机支持不大于128GB容量的U盘。

● U盘开局功能与SVF、EasyDeploy、WEB初始化模式功能互斥。

● U盘开局前，保证开局设备可以正常启动，并且保证设备有足够的内存空间保存开局文件。

● 由于设备为空配置设备，还没有相应的安全保证措施。因此当具体开局任务由开

局现场非专业人员来进行时，请保证该人员不会对设备、U盘及开局文件进行非法操作。

● 不支持同时插入2个U盘进行开局。

● 不支持通过命令行读取U盘中的内容，不支持通过dir命令查看U盘中的文件和目录信息，不支持U盘和设备存储器Flash中的内容互相拷贝。

● 索引文件需要与当前设备的版本配套使用。例如，从低版本升级至高版本，如果索引文件中有低版本不支持的字段时，升级过程中该字段不生效。

● smart_config.ini格式的索引文件支持对配置文件进行加密和HMAC校验功能，smart_config.ini格式的索引文件不支持。因此，当升级文件中包含配置文件时，建议使用smart_config.ini格式的索引文件，设置配置文件加密密码并使能HMAC校验功能，以提高安全性。从V200R013C00版本开始，设备仅支持smart_config.ini格式索引文件进行U盘开局。

● 从V200R005C00版本开始，设备支持smart_config.ini格式索引文件进行U盘开局，此格式索引文件支持堆叠场景，U盘必须插入堆叠主交换机中。如果插入备交换机或从交换机，U盘开局流程不响应。

● S5700S-28P-PWR-LI-AC、S5700S-28X-LI-AC、S5700S-52X-LI-AC、S5700S-LI、S5710-X-LI、S5720-EI、S5720-HI、S5720I-SI、S5720-LI、S2730S-S、S5735-L1、S300、S5735-L、S5735S-L1、S5735S-L、S5735S-L-M、S5720S-LI、S5720S-SI、S5720-SI、S500、S5735-S、S5735S-S、S5735-S-I、S5730-HI、S5731-H、S5731-H-K、S5731-S、S5731S-H、S5731S-S、S5732-H、S5732-H?K、S6720-EI、S6720-HI、S6720-LI、S6720S-EI、S6720S-LI、S6720S-SI、S6720-SI、S6730-H、S6730-H-K、S6730S-H、S6730-S、S6730S-S系列设备仅支持smart_config.ini格式索引文件。

● 当使用usbload_config.txt格式索引文件进行U盘开局时，只支持单台设备的场景，不支持多台设备堆叠的场景。在多台设备堆叠场景下，U盘如果插入备交换机或者从交换机，则开局流程不响应；如果插入主交换机，则开局失败，主交换机的U盘开局指示灯红色快闪，并记录错误报告，报告内容为“The usbload_config.txt index file can not be used for USB deployment of a multi-member stack”。

● 在V200R013C00版本，当设备在云模式零配置状态时，U盘开局支持下发堆叠口基本配置，包括如下命令：

a. interface stack-port

b. port interface enable

c. shutdown interface

d. stack slot priority

e. stack slot renumber

● 从V200R019C00版本开始，当设备在NETCONF模式零配置状态时，U盘开局支持下发堆叠口基本配置，包括如下命令：

a. interface stack-port

b. port interface enable

c. shutdown interface

d. stack slot priority

e. stack slot renumber

● 对于S5720-HI，如果设备启动U盘开局后需要重启，并且重启后设备将升级到V200R009C00或之后的版本，则重启前，系统将对下次启动生效的配置文件进行检查，检查配置文件中是否包含与下次运行版本相冲突的WLAN特性的配置。如果包含冲突配置，则无法重启，开局失败，同时在U盘根目录下生成错误报告usbload_error.txt文件，并记录失败原因。此时，需要用户将配置文件经eDeskpro工具进行转换后再设置为下次启动配置文件。

使用U盘开局时

● 使用U盘进行写操作时，请务必保证关闭U盘写保护功能。

● U盘开局过程中设备不能断电，否则会造成升级失败甚至会造成设备无法启动。

● U盘开局结束之前不能将U盘拔出，否则可能会造成U盘内的数据损坏。

● 当使用U盘对S5720-EI、S5720-HI、S5720I-SI、S5720-LI、S2730S-S、S5735-L1、SS300、S5735-L、S5735S-L1、S5735S-L、S5735S-L-M、S5720S-LI、S5720S-SI、S5720-SI、S500、S5735-S、S5735S-S、S5735-S-I、S5730-HI、S5731-H、S5731-H-K、S5731-S、S5731S-H、S5731S-S、S5732-H、S5732-H?K、S6720-EI、S6720-HI、S6720-LI、S6720S-EI、S6720S-LI、S6720S-SI、S6720-SI、S6730-H、S6730-H-K、S6730S-H、S6730-S、S6730S-S进行开局时，不能使用已分区的U盘，否则设备可能无法找到U盘上的文件，导致U盘开局失败。

● 如果是非空配置设备进行U盘开局，必须通过命令set device usb-deployment config-file password配置加密和解密的密码。

● S5700-LI支持smart_config.ini和usbload_config.txt两种格式的索引文件。如果U盘中两种索引文件都存在，则优先使用?m?àì?c?nēa?2n2文件。U盘开局时，建议U盘中不要同时存放两种格式的索引文件。通过U盘降级到V200R003及以前版本S300, S500, S2700, S5700, S6700 系列以太网交换机时，建议使用usbload_config.txt作为索引文件，因为V200R003及以前版本不支持smart_cfg.ini作为索引文件。

● 在堆叠系统中，只要有一台设备不支持U盘开局，整个堆叠系统开局失败。

● 设备带U盘重启开局，可能会由于设备配置未恢复造成开局失败，则可通过拔插U盘解决。

四、制作索引文件

U 盘开局索引文件的制作方法

用户可以在PC机上编辑U盘开局索引文件，具体步骤如下：

1. 新建一个空的文本文档。

2. 按照U盘开局索引文件格式编辑文件内容。

3. 将此文本文档另存为“smart_config.ini”。

4. 将索引文件smart_config.ini拷贝至U盘，此文件必须保存至U盘根目录下。

U 盘开局索引文件格式

说明

● smart_config.ini类型的索引文件，每一行的内容不能超过512个字符，否则索引文件无效。

● smart_config.ini索引文件中的字段名不区分大小写。

● 索引文件中加载文件的字段均为可选，但至少要指定一种文件类型的字段。系统软件名、配

置文件名及补丁文件名支持的最大长度为48个字节，其他类型文件名支持的最大长度为64个字节。

BEGIN LSW

[GLOBAL CONFIG]

TIMESN=

AUTODELFILE=

ACTIVEMODE=

USB-DEPLOYMENT PASSWORD=

[DEVICEn DESCRIPTION]

OPTION=

ESN=

MAC=

AUTODELFILE=

ACTIVEMODE=

DEVICETYPE=

HMAC=

DIRECTORY=

SYSTEM-SOFTWARE=

SYSTEM-CONFIG=

SYSTEM-PAT=

SYSTEM-WEB=

SYSTEM-SCRIPT=

SYSTEM-USERDEF1=

SYSTEM-USERDEF2=

SYSTEM-USERDEF3=

END LSW

smart_config.txt索引文件支持注释信息，注释信息以英文半角的分号“;”开始。可以在字段的同一行后直接增加注释（字段内容与注释之间需要有空格隔开），也可以是单独的注释行。

表 1-1 smart_config.ini 索引文件字段含义

说明

● 编写索引文件时，按照固定格式输入一行后必须回车换行后再进行新内容的编写，编写完成请注意保存索引文件。

● 如果某项关键字没有匹配或者没有搜索到，则认为该项的参数内容为空。

五、配置 U 盘开局

前置任务

设备上电，运行正常。

操作步骤

U盘开局之前，需要先制作U盘开局索引文件，然后将索引文件和需要加载的开局文件保存到U盘中，最后将U盘插入设备中启动U盘开局流程。

1). 执行命令system-view，进入系统视图。

2). 执行命令undo set device usb-deployment disable，使能设备的U盘开局功能。缺省情况下，U盘开局功能是去使能的。建议U盘开局结束后，将此功能关闭。但是如果设备是空配置设备，则U盘开局功能一直是使能的。

3). （可选）执行命令set device usb-deployment config-file password password，配置U盘开局时用于对配置文件进行加密和解密的密码。

说明：当U盘开局升级文件中包含配置文件时，为提高安全性，建议通过此命令配置密码，并将配置文件通过此密码按照标准zip格式压缩加密后保存至U盘。如果需要对配置文件进行HMAC校验，则必须要通过此步骤配置密码。

如果是非空配置设备进行U盘开局，必须通过命令set device usb-deployment config-file password配置加密和解密的密码。

4). （可选）执行命令set device usb-deployment hmac-key，配置U盘开局时HMAC校验功能的HMAC密钥。

说明：U盘开局时，如果使能了HMAC校验功能，则使用set device usb-deployment hmac-key命令配置的HMAC密钥计算需要加载的配置文件的HMAC值，然后将该值与索引文件中的“HMAC”字段值进行比较。如果一致，则文件合法，可以进行U盘开局；如果不一致，则文件非法，不能进行U盘开局。

5). （可选）执行命令set device usb-deployment hmac，使能配置文件的HMAC校验功能。

说明：用户在进行U盘开局时，如果升级文件中包含配置文件，可以对加载的配置文件进行HMAC校验，以保证文件的合法性。

6）. 制作索引文件。

具体的制作方法请参见4.4 制作索引文件。

7）. 将制作好的索引文件保存到U盘根目录下。需要将此文件中定义的开局文件保存到指定目录，缺省为根目录。

8）. 将U盘插入设备中，启动开局流程。

须知：由于设备为空配置设备，还没有相应的安全保证措施。因此当具体开局任务由开局现场非专业人员来进行时，请保证该人员不会对设备、U盘及开局文件进行非法操作。

– 进入开局流程后，系统首先按照?m?àì?c?nēa?2n2索引文件中的描述信息从U盘中获取开局文件拷贝到设备缺省的存储介质中。如果是堆叠环境，在主交换机拷贝完成后，会将这些文件拷贝至所有成员交换机上。

– 文件拷贝完成后，设备会根据索引文件中ACTIVEMODE字段指定的方式激活文件。

– 如果此次升级需要设备重启生效，则在重启前会延时10秒，在此时间内，设备USB灯黄色常亮。

通过指示灯查看 U 盘开局状态

# S6720S-EI、S5720I-6X-PWH-SI-AC和S5720I-10X-PWH-SI-AC：通过SYS指示灯的状态，判断U盘开局进行的状态。

● 黄色慢闪（每2秒闪一次）：U盘开局成功。

● 绿色快闪（每秒闪四次）：U盘数据读取中。

● 红色快闪（每秒闪四次）：U盘开局失败。

# 通过USB指示灯的状态，判断U盘开局进行的状态（S5720I-6X-PWH-SI-AC和S5720I-10X-PWH-SI-AC除外）。

● 绿色常亮：U盘开局成功。

● 绿色快闪（每秒闪四次）：U盘数据读取中。

● 红色快闪（每秒闪四次）：U盘开局失败。

● 黄色常亮：文件拷贝完成且校验成功，U盘可以拔出。

● 常灭：可能原因有U盘中无索引文件、未插U盘、USB接口损坏、指示灯坏、插入非开局U盘、重启过程中。

说明

● U盘开局成功后，系统会在U盘根目录下生成开局成功报告usbload_verify.txt文件。此时，可以拔出U盘，U盘开局结束。

● 如果U盘开局失败，系统也会在U盘根目录下生成错误报告usbload_error.txt文件，可以通过查看此文件定位失败原因。

● U盘开局结束后，建议执行set device usb-deployment disable命令，去使能设备的U盘开局功能，防止因U盘误插入而引起不必要的版本升级，导致业务中断。

六、U盘开局配置举例

组网需求

在设备部署过程中，为了降低人工成本、节省部署的时间，用户希望为两台新设备实现自动升级及配置。需求如下：

● 设备升级时间为2013年07月28日02时09分。

● 第一台设备S5732-H从V200R020C10版本升级至较高版本，MAC地址为xxxx-xxxx-xxxx，系统软件名称S5732-H-new.CC，用户自定义文件userfile.txt ，要求升级完成后，删除原有的系统软件。

● 第二台设备S5735-L从V200R020C10版本升级至较高版本，ESN号为020TEA10xxxxxxxx，系统软件名称为S5735-L-new.CC，需要加载的配置文件为vrpcfgnew.zip，补丁文件为patch.pat。

配置思路

采用如下思路配置：

1. 制作U盘开局索引文件smart_config.ini。

2. 将索引文件smart_config.ini和开局文件保存至U盘根目录下。

3. 将U盘插入设备的USB接口启动开局流程，实现设备自动完成软件升级。

操作步骤

步骤1 编辑U盘开局索引文件smart_config.ini。

# 新建一个索引文件，命名为“smart_config.ini”。索引文件的内容与格式如下：

BEGIN LSW

[GLOBAL CONFIG]

TIMESN=20130728.020900

[DEVICE0 DESCRIPTION]

MAC=xxxx-xxxx-xxxx

AUTODELFILE=YES

DEVICETYPE=S5732-H

SYSTEM-SOFTWARE=S5732-H-new.CC

SYSTEM-USERDEF1=userfile.txt

[DEVICE1 DESCRIPTION]

ESN=020TEA10xxxxxxxx

DEVICETYPE=S5735-L

SYSTEM-SOFTWARE=S5735-L-new.CC

SYSTEM-CONFIG=vrpcfgnew.zip

SYSTEM-PAT=patch.pat

END LSW

步骤2 将索引文件smart_config.ini及其他所有开局文件保存至U盘根目录下。

步骤3 将U盘插入S5732-H中启动开局流程，观察指示灯，监控U盘开局的状态。

设备重启后，系统检测开局状态：SYS指示灯黄色慢闪（每2秒闪一次），表示U盘开局成功；SYS指示灯红色闪烁，表示U盘开局失败，可查看U盘根目录下usbload_error.txt文件定位出错原因。

确认U盘开局成功后，拔出U盘，再插入另外一台待升级的设备中。

步骤4 将U盘插入S5735-L中启动开局流程，观察指示灯，监控U盘开局的状态。

设备重启后，系统检测开局状态：USB指示灯绿色常亮，表示U盘开局成功；USB指示灯红色快闪（每秒闪两次），表示U盘开局失败，可查看U盘根目录下usbload_error.txt文件定位出错原因。

确认U盘开局成功后，拔出U盘，U盘开局结束。