制作索引文件
制作索引文件是U盘开局的前提。
U盘开局索引文件的制作方法
- 新建一个空的文本文档。
- 按照U盘开局索引文件格式编辑文件内容，索引文件中的字段名必须为大写。
- 将此文本文档另存为“smart_config.ini”。
- 将smart_config.ini文件拷贝至U盘，此文件必须保存至U盘根目录下。
U盘开局索引文件格式
U盘开局索引文件的格式如下：
BEGIN DC [GLOBAL CONFIG] TIMESN= EMS_ONLINE_STATE= UPGRADEMODE= [DEVICEn DESCRIPTION] OPTION= ESN= MAC= DIRECTORY= SYSTEM-SOFTWARE= SYSTEM-CONFIG= HMAC= SYSTEM-PAT= END DC
字段 |
是否可选 |
描述 |
|---|---|---|
BEGIN DC |
必选 |
起始标志，此字段不能修改。 |
[GLOBAL CONFIG] |
必选 |
全局配置起始标志，此字段不能修改。 |
TIMESN |
必选 |
数据变更时间标志，其格式为：年月日.时分秒。 例如，2011年06月28日08时09分10秒，则设置为TIMESN=20110628.080910。
说明：
TIMESN是U盘开局的一个标志。设备有一个默认的TIMESN号，当U盘上存在.ini文件时，就会对比设备原有的U盘开局TIMESN号和.ini文件中TIMESN号是否一致。如果不一致，则触发U盘开局，使用U盘指定的开局文件启动设备。开局成功后，设备的开局TIMESN号会更新为.ini文件中设置的TIMESN号。 |
EMS_ONLINE_STATE |
可选 |
网管在线标志，表示设备开局完成后是否向网管注册：
缺省情况下，EMS_ONLINE_STATE为NO。 说明：
如果该标志不存在或为空，则表示为缺省情况。 |
UPGRADEMODE |
可选 |
升级模式标志：
缺省情况下，UPGRADEMODE为AUTO。 说明：
如果该标志不存在或为空，则表示为缺省情况。 |
[DEVICEn DESCRIPTION] |
必选 |
文件信息描述起始标志，n表示设备的编号。整数形式，从0开始。 |
OPTION |
可选 |
文件信息有效标志，表示该文件信息是否有效：
缺省情况下，OPTION为OK。 说明：
如果该标志不存在或为空，则表示为缺省情况。 |
ESN |
可选 |
设备序列号。如果ESN=DEFAULT，表示不匹配ESN序列号，否则需要和设备匹配ESN。 缺省情况下，ESN为DEFAULT。 说明：
如果该标志不存在或为空，则表示为缺省情况。 如果SYSTEM-CONFIG标志不为空，则MAC和ESN字段不能均为空或DEFAULT。 |
MAC |
可选 |
设备MAC地址，格式为：XXXX-XXXX-XXXX，X为十六进制数。如果MAC=DEFAULT，表示不匹配MAC地址，否则需要和设备匹配MAC地址。 优先匹配ESN，再匹配MAC。 缺省情况下，MAC为DEFAULT。 说明：
如果该标志不存在或为空，则表示为缺省情况。 如果SYSTEM-CONFIG标志不为空，则MAC和ESN字段不能均为空或DEFAULT。 |
DIRECTORY |
可选 |
升级文件路径标识：
缺省情况下，DIRECTORY为DEFAULT。 说明：
如果该标志不存在或为空，则表示为缺省情况。 |
SYSTEM-SOFTWARE |
可选 |
系统软件名称，后缀名为“.cc”。 |
SYSTEM-CONFIG |
可选 |
配置文件名称，后缀名为“.cfg”、“.zip”或“.dat”。 说明：
如果该标志不为空，则MAC和ESN字段不能均为空或DEFAULT。 |
HMAC |
可选 |
配置文件的HMAC校验值，用于对加载的配置文件进行校验。该值为64位的字符串，是通过计算工具对U盘中的配置文件以HMAC-SHA256算法计算出的值。其中用作计算的密钥必须与在设备上通过set device usb-deployment password password命令设置的密码保持一致。 缺省情况下，不对配置文件进行校验。 说明：
如果该标志不存在或为空，则表示为缺省情况。 可通过HMAC-SHA256计算工具（如OpenSSL）生成配置文件的HMAC值。 |
SYSTEM-PAT |
可选 |
补丁文件名称，后缀名为“.pat”。 |
END DC |
必选 |
文件结束标志。 |
U盘开局索引文件示例
示例1
- 数据变更时间为2011年06月28日08时09分10秒
- 不向网管进行注册
- 设备MAC为0018-0303-1234
- 系统软件、配置文件和补丁文件位于U盘根目录下，名称分别为system-software.cc、system-config.zip和system-pat.pat
- 对加载的配置文件进行校验，HMAC校验值为c3caaee8f4f6bd1389f438801e40dad9af30f2fbbe7e8f55121b39c6c16ba488
对应的索引文件如下：
BEGIN DC
[GLOBAL CONFIG]
TIMESN=20110628.080910
EMS_ONLINE_STATE=NO
UPGRADEMODE=AUTO
[DEVICE0 DESCRIPTION]
OPTION=OK
ESN=DEFAULT
MAC=0018-0303-1234
DIRECTORY=DEFAULT
SYSTEM-SOFTWARE=system-software.cc
SYSTEM-CONFIG=system-config.zip
HMAC=c3caaee8f4f6bd1389f438801e40dad9af30f2fbbe7e8f55121b39c6c16ba488
SYSTEM-PAT=system-pat.pat
END DC
示例2
- 数据变更时间为2011年06月28日08时09分10秒
- 不向网管进行注册
- 系统软件位于U盘根目录下，名称为system-software.cc
对应的索引文件如下：
BEGIN DC [GLOBAL CONFIG] TIMESN=20110628.080910 EMS_ONLINE_STATE=NO UPGRADEMODE=AUTO [DEVICE0 DESCRIPTION] OPTION=OK ESN=DEFAULT MAC=DEFAULT DIRECTORY=DEFAULT SYSTEM-SOFTWARE=system-software.cc END DC
示例3
- 数据变更时间为2011年06月28日08时09分10秒
- 不向网管进行注册
- 第一台设备的MAC为0018-0303-1234
- 第二台设备的MAC为0018-0303-5678
- 系统软件和配置文件位于U盘根目录下，系统软件名称为system-software.cc;第一台设备不需要加载配置文件，第二台设备需要加载配置文件，需要加载的配置文件为system-config.zip
对应的索引文件如下：
BEGIN DC [GLOBAL CONFIG] TIMESN=20110628.080910 EMS_ONLINE_STATE=NO UPGRADEMODE=AUTO [DEVICE0 DESCRIPTION] OPTION=OK ESN=DEFAULT MAC=0018-0303-1234 DIRECTORY=DEFAULT SYSTEM-SOFTWARE=system-software.cc [DEVICE1 DESCRIPTION] OPTION=OK ESN=DEFAULT MAC=0018-0303-5678 DIRECTORY=DEFAULT SYSTEM-SOFTWARE=system-software.cc SYSTEM-CONFIG=system-config.zip END DC
