华为交换机U盘开局详细教程

1、U盘开局简介

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

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

2、U盘开局流程

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

U盘开局流程如上图1所示。

3、U盘开局文件分类

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

1、必选文件

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

2、可选文件

系统软件：后缀名为.cc；配置文件：后缀名为.cfg或.zip；补丁文件：后缀名为.pat；Web网页文件：后缀名为.web.7z；License文件：后缀名为.dat；用户自定义文件。

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

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

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

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、根据获取的文件或者指定的激活方式，设备自动判断是否需要重启激活。

如果不需要重启，则在线激活相应文件，进入步骤9。如果需要重启，设备会将相应文件设置为下次启动文件，自动重启成功后，进入步骤9。

9、U盘开局成功，流程结束。将U盘从设备中拔出。

在U盘开局过程中，任意阶段出错都会在U盘根目录中生成文件名为usbload_error.txt的错误报告，用户可根据此报告定位出错原因。如果开局成功，系统将生成文件名为usbload_verify.txt的开局成功报告。

5、U盘开局注意事项

1、U盘规格

文件系统格式是FAT32，硬件接口是标准的USB2.0。U盘开局支持经华为认证的指定型号的U盘，以保证U盘和设备的良好兼容性。交换机支持的U盘如下表1所示（截至2016.1）。

4GB	朗科	U208	可从华为购买或从其他渠道自行购买
	SanDisk	Cruzer Blade	华为不销售，可从其他渠道自行购买
	惠普	v218G	华为不销售，可从其他渠道自行购买
	PNY	M1	华为不销售，可从其他渠道自行购买
8GB	朗科	U208	华为不销售，可从其他渠道自行购买
	惠普	v225w	华为不销售，可从其他渠道自行购买
	STEC	SLUFD8GU2TUI	华为不销售，可从其他渠道自行购买

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

3、U盘必须插入设备的主用主控板中，如果插入备用主控板，U盘开局流程不响应。集群环境下，必须插入主用设备的主用主控板中。

3、U盘开局流程与EasyDeploy流程互斥，即当设备已经在执行U盘开局流程时，EasyDeploy流程不响应；当设备已经在执行EasyDeploy流程时，U盘开局流程不响应。

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

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

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

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

6、U盘开局索引文件制作

制作索引文件是U盘开局的前提。用户可以在PC机上编辑U盘开局索引文件，具体步骤如下：

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

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

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

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

索引文件中的字段名不区分大小写，字段值除了密码区分大小写外，其他都不区分。对于smart_config.ini类型的索引文件，每一行的内容不能超过512个字符，否则索引文件无效。索引文件中加载文件的字段均为可选，但至少要指定一种文件类型的字段。系统软件名、配置文件名及补丁文件名支持的最大长度为48个字节，其他类型文件名支持的最大长度为64个字节。

U盘开局索引文件格式：

BEGIN LSW

[GLOBAL CONFIG]

TIMESN=

AUTODELFILE=

ACTIVEMODE=

USB-DEPLOYMENT PASSWORD=

[DEVICEn DESCRIPTION]

OPTION=

ESN=

MAC=

AUTODELFILE=

ACTIVEMODE=

DEVICETYPE=

DIRECTORY=

SYSTEM-SOFTWARE=

SYSTEM-CONFIG=

SYSTEM-LICENSE=

SYSTEM-PAT=

SYSTEM-WEB=

SYSTEM-USERDEF1=

SYSTEM-USERDEF2=

SYSTEM-USERDEF3=

END LSW

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

BEGIN LSW	必选字段。起始标志，此字段不能修改。
GLOBAL CONFIG	必选字段。全局配置起始标志，此字段不能修改。
TIMESN	必选字段。数据变更时间标志，字符串格式，长度范围为1～16，不能包含空格。建议格式：年月日.时分秒。例如，2011年06月28日08时09分10秒，可设置为TIMESN=20110628.080910。每个TIMESN对应某台升级的设备。在U盘开局过程中，设备会在重启前记录此TIMESN（升级后不需要重启的则在升级完成后记录），下次升级不可使用此TIMESN。如果由于某些原因造成在设备重启后升级失败，则需要将TIMESN重新修改后再进行U盘开局。
AUTODELFILE	可选字段。表示是否允许升级后自动删除原有系统软件。AUTODELFILE=YES：删除AUTODELFILE=NO：不删除缺省情况下，AUTODELFILE为NO。如果该字段不存在、为空或是不合法值，均表示为缺省情况。说明：有两种AUTODELFILE字段：全局字段和单台设备字段。位于[GLOBAL CONFIG]字段内的是全局字段，位于[DEVICEn DESCRIPTION]内的是单台设备字段。如果单台设备设置了此字段的值为YES或NO，则以单台设备设置的生效。如果单台设备没有设置此字段或者此字段为空，则以全局设置的生效。
ACTIVEMODE	可选字段。表示文件拷贝完成后的文件激活方式。DEFAULT：按照各个文件的默认方式激活。系统软件、配置文件：默认激活方式是重启设备。补丁文件：默认激活方式是不重启设备，在线激活。License文件、Web网页文件、用户自定义文件：不做激活处理，下载成功后U盘开局即结束。RELOAD：采用重启设备的方式激活。缺省情况下，ACTIVEMODE为DEFAULT。如果该字段不存在、为空或是不合法值，均表示为缺省情况。说明：有两种ACTIVEMODE字段：全局字段和单台设备字段。位于[GLOBAL CONFIG]字段内的是全局字段，位于[DEVICEn DESCRIPTION]内的是单台设备字段。如果单台设备设置了此字段的值为DEFAULT或RELOAD，则以单台设备设置的生效。如果单台设备没有设置此字段或者此字段为空，则以全局设置的生效。
USB-DEPLOYMENT PASSWORD	可选字段。U盘开局的认证密码。如果待开局设备中通过set device usb-deployment password password命令配置了开局认证密码，则此字段中必须填入相应的密码，如果待开局设备中未配置密码，该字段为空或不存在即可。同一个索引文件只能使用同一个密码。如果一个索引文件需要对多个设备开局，则设备配置的开局认证的密码必须相同。说明：为了降低安全风险，在制作索引文件时，建议配置密文格式的开局认证密码。
DEVICEn DESCRIPTION	必选字段。单台设备文件信息描述起始标志，n表示设备的编号，从0开始，最大为65535。说明：DEVICEn DESCRIPTION字段下表示单台设备信息的每个字段不可以重复出现，否则将不匹配这个DEVICEn。DEVICE按照文件中定义的顺序从上到下进行匹配，匹配到一组之后不会再匹配其它DEVICEn。
OPTION	可选字段。单台设备文件信息有效标志，表示该设备文件信息是否有效。OPTION=OK：有效OPTION=NOK：无效，此单台设备的文件信息都无需判断缺省情况下，OPTION为OK。如果该字段不存在、为空或是不合法值，均表示为缺省情况。
ESN	可选字段。设备序列号。如果ESN=DEFAULT，表示不匹配ESN序列号，否则需要和设备匹配ESN。缺省情况下，ESN为DEFAULT。如果该字段不存在或为空，则表示为缺省情况。	待升级的设备将在索引文件中按DEVICE从上往下进行匹配，匹配的优先级为：MAC > ESN > DEVICETYPE > DEFAULT。一旦匹配上，则按匹配上的DEVICE信息进行加载文件，如果此过程出错，将不会再次进行匹配，只会输出错误报告。
MAC	可选字段。设备MAC地址，格式为：XXXX-XXXX-XXXX，X为十六进制数。如果MAC=DEFAULT，表示不匹配MAC地址，否则需要和设备匹配MAC地址。缺省情况下，MAC为DEFAULT。如果该字段不存在或为空，则表示为缺省情况。
DEVICETYPE	可选字段。表示与设备的类型匹配，如S9700。如果DEVICETYPE=DEFAULT，表示不匹配设备类型。否则需要和设备的类型匹配。缺省情况下，DEVICETYPE为DEFAULT。如果该字段不存在或为空，则表示为缺省情况。
DIRECTORY	可选字段。文件在U盘中存放的目录。DIRECTORY=DEFAULT，表示文件位于U盘根目录下。DIRECTORY=/abc，表示文件位于U盘的abc文件夹下。缺省情况下，DIRECTORY为DEFAULT。如果该标志不存在或为空，则表示为缺省情况。说明：索引文件中文件目录的格式必须与设备的文件系统一致：目录深度小于等于4级。目录必须以“/”开头，每一级目录以“/”隔开，但不能以“/”结束，例如/abc/test是合法目录，/abc/test/则是非法目录。每一级目录的字符串长度范围是1～15。目录名使用的字符不可以是空格、“~” 、“*” 、“/” 、“\” 、“:” 、“’” 、“”” 、“<” 、“>” 、“|” 、“?” 、“[” 、“]” 等字符，目录名称不区分大小写。
SYSTEM-SOFTWARE	可选字段。系统软件名称，后缀名为“.cc”。如果指定了此字段，则设备在拷贝系统软件前，会将此系统软件的版本号与设备正在运行的系统软件版本号比较，如果相同则不进行拷贝以及系统软件的升级。
SYSTEM-CONFIG	可选字段。配置文件名称，后缀名为“.cfg”或“.zip”。
SYSTEM-LICENSE	可选字段。License文件名称，后缀名为“.dat”。
SYSTEM-PAT	可选字段。补丁文件名称，后缀名为“.pat”。
SYSTEM-WEB	可选字段。Web网页文件名称，后缀名为“.web.7z”。
SYSTEM-USERDEF1SYSTEM-USERDEF2SYSTEM-USERDEF3	可选字段。用户自定义文件。
END LSW	必选字段。文件结束标志。

7、U盘开局配置步骤

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

1、使能设备的U盘开局功能

[HUAWEI] undo set device usb-deployment disable

缺省情况下，U盘开局功能是去使能的。建议U盘开局结束后，将此功能关闭。但是如果设备是空配置设备，则U盘开局功能一直是使能的。

2、配置U盘开局的认证密码

[HUAWEI] set device usb-deployment password wwru.cn

通过此命令配置的U盘开局认证密码需要与索引文件中“usb-deployment password”字段的内容保持一致。不配置U盘开局认证密码，则开局时不会进行密码校验，即无认证开局。无认证开局和配置明文密码认证开局无安全保证，因此建议U盘开局时配置认证密码，并且索引文件中密码采用密文形式。

3、制作索引文件。

具体的制作方法请参见前面U盘开局索引文件制作。

4、将制作好的索引文件保存到U盘根目录下，将索引文件中定义的开局文件保存到指定目录，缺省为根目录。

5、将U盘插入设备主用主控板中，启动开局流程。

进入开局流程后，系统首先按照索引文件中的描述信息从U盘中获取开局文件拷贝到设备缺省的存储介质中。拷贝完成后，这些文件会从设备的主用主控板拷贝至备用主控板。如果是集群环境，会拷贝至所有主控板。

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

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

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

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