ini格式的中间文件
ini文件是中间文件格式中的一种，用来保存设备及其版本文件信息。
ini文件的文件名必须以“.ini”作为后缀名，格式如下:
下列文件中的SHA256校验码只是举例，配置时以实际计算的值为准。
#sha256sum="88298f97c634cb04b1eb4fe9ad2255abffc0a246112e1960cb6402f6b799f8b6" ;BEGIN ROUTER [GLOBAL CONFIG] FILESERVER=ftp://username:password@hostname/path [DEVICEn DESCRIPTION] ESN=2102351931P0C3000154 MAC=e468-a356-0cb0 DEVICETYPE=DEFAULT SYSTEM-SOFTWARE=V800R012C00B140_0424_new.cc SYSTEM-CONFIG=vrpcfg.cfg SYSTEM-PAT=NE20EV800R012C00.PAT ;END ROUTER
字段 |
是否可选 |
描述 |
|---|---|---|
#sha256sum |
必选 |
ini文件的SHA256校验码。 说明：
SHA256校验码是由“;BEGIN ROUTER”到“;END ROUTER”中的内容计算而来。 实际使用过程中，需将上述文件中的第一行删除，并将“;BEGIN ROUTER”提至第一行，然后开始计算SHA256校验码，最后将生成的SHA256校验码“#sha256sum=”写入文件开头。 文件同时支持使用MD5和SHA256两种算法进行完整性校验，出于安全性考虑，推荐使用SHA256算法。 用户可以使用以下两种方法生成脚本文件的SHA256校验码：
|
;BEGIN ROUTER |
必选 |
起始标志，此字段不能修改。 |
[GLOBAL CONFIG] |
必选 |
全局配置起始标志，此字段不能修改。 |
FILESERVER |
必选 |
此字段为版本文件服务器的地址。可以使用tftp/ftp/sftp方式获取文件，格式如下：
其中username、password、port参数为可选项。path参数指定文件服务器存放版本文件的目录。hostname参数为服务器地址，可以是IPv4地址或域名，也可以是IPv6地址。port参数的取值范围为0～65535，超出范围按照默认端口22处理，仅在SFTP服务器地址为IPv4情况下支持配置端口号。 |
[DEVICEn DESCRIPTION] |
必选 |
文件信息描述起始标志，n表示设备的编号。整数形式，从0开始。 |
ESN |
可选 |
设备序列号。如果ESN=DEFAULT，表示不需要匹配ESN序列号，否则需要和设备匹配ESN。 缺省情况下，ESN为DEFAULT。如果该标志不存在或为空，则表示为缺省情况。 |
MAC |
可选 |
设备MAC地址，格式为：XXXX-XXXX-XXXX，X为十六进制数。如果MAC=DEFAULT，表示不需要匹配MAC地址，否则需要和设备匹配MAC地址。 优先匹配ESN，再匹配MAC。 缺省情况下，MAC为DEFAULT。如果该标志不存在或为空，则表示为缺省情况。 说明：
设备的MAC地址和ESN号可以通过设备出厂时外包装上的名牌信息获取。 |
DEVICETYPE |
可选 |
匹配的设备类型。如果DEVICETYPE=DEFAULT，表示不匹配设备类型，否则需要匹配设备类型。 缺省情况下，DEVICETYPE为DEFAULT。如果该标志不存在或为空，则表示为缺省情况。 说明：
具体的设备类型请参见“描述》硬件描述》机框”章节。 |
SYSTEM-SOFTWARE |
可选 |
系统软件名称，后缀名为“.cc”。 |
SYSTEM-CONFIG |
必选 |
配置文件名称，后缀名为“.cfg”、“.zip”或“.dat”。 说明：
配置文件名称不要使用设备缺省的名称vrpcfg.zip。 |
SYSTEM-PAT |
可选 |
补丁文件名称，后缀名为“.pat”。 |
;END ROUTER |
必选 |
文件结束标志，此字段不能修改。 |
设备按照[DEVICEn DESCRIPTION]配置在ini文件中从前到后的顺序进行匹配。
- 如果DEVICETYPE为DEFAULT，或者该字段不存在或为空时，则无需匹配DEVICETYPE字段，只需匹配ESN或MAC，其中有一个匹配成功，则认为该条DESCRIPTION配置有效，否则认为该条DESCRIPTION配置无效。
- 如果DEVICETYPE有值，且不为DEFAULT时，需先匹配DEVICETYPE字段，匹配不成功，则认为该DESCRIPTION配置无效，继续匹配下一个；匹配成功时，需继续匹配ESN或MAC，其中有一个匹配成功，则认为该条DESCRIPTION配置有效，否则认为该条DESCRIPTION配置无效。
- 如果ESN和MAC全部为DEFAULT时，则无需对这两个字段进行匹配。
