策略文件修改说明文档

策略文件说明

1. 升级策略文件定义了终端升级范围，以及升级策略机制。终端设备升级前需要先根据预

先配置或者通过注册服务器获取的升级文件服务器URL，从升级文件服务器获取升级策略文件。

2. 升级策略文件为XML格式，遵循XML 1.0规范。

3. 策略文件主要有两个内容，

1、指定需升级终端的条件以及别的限定。终端会根据该条件来判断自身是否符合升级

要求，是则进行升级，否则不升级。

2、指定待升级目标。包括目标文件的路径、升级后的版本号等。

1 升级策略文件(UPF)规范

升级策略文件定义了终端升级范围，以及升级策略机制。终端设备升级前需要先根据预先配置或者通过DHCP OPTION获取的升级UPF文件URL，从升级文件服务器获取升级策略文件。

规则5.1：升级策略文件名为终端出厂配置，必须固定为“UPF-产品型号.xml”。

说明：文件服务器上的策略文件名也必须与终端的出厂配置一致。

例如：UPF-eSpace7910.xml。相应的UPF文件的URL就变成：

http://**.**.**.*/directory/UPF-eSpace7910.xml

规则5.2：升级策略文件为XML格式，遵循XML 1.0规范。

规则5.3：终端必须支持下述升级策略条件，不同条件间为“与”的关系。每个条件必须支持通配符“*”。说明通配的定义分解到各个条件中去说明！！！

（1）升级指定“硬件版本”的终端。硬件版本可以是多个，它们为“或”的关系，并以符号“|”连接

（2）升级指定“软件版本”的终端。软件版本可以是多个，它们为“或”的关系，并以符号“|”连接。

（3）升级指定“IP地址”的终端。IP地址可以是多个确定的地址或是多个地址段，它们为“或”的关系，并以符号“|”连接。地址段以符号“:”连接。增加说明

xxx

（4）升级指定“序列号”的终端。该序列号就是设备标识(OUI-SN)中的SN，具体定义遵循《终端出厂规范》。序列号可以是多个，它们为“或”的关系，并以符

号“|”连接。

例如：

需要将所有软件版本为“R001B01D010”或者“R001B01D020”的STB EC628升级到“R001B01D030”版本，则升级策略条件可以描述为（具体书写格式见策略文件定义）：软件版本=“R001B01D010|R001B01D020”

规则5.4：升级策略文件中支持指定多个策略，待升级终端选择第一个匹配的策略，按照指定的条件升级，升级策略文件正确性保证参见建议5.1。

例如：

需要将所有软件版本为“R001B01D010”或者“R001B01D020”的STB EC628升级到“R001B01D030”版本。同时还需要将所有软件版本为“R001B01D030”的升级到“R001B01D050”版本，则升级策略文件中包含两个策略，内容可以描述为（具体书写格式见策略文件定义）：

软件版本=“R001B01D010|R001B01D020”

软件版本=“R001B01D030”

规则5.5：升级策略文件必须包含待升级终端产品的厂商标识。固定采用“OUI”来标识厂商。

说明：具体OUI的定义遵循《终端出厂规范》。

规则5.6：升级策略文件必须包括待升级新文件的文件名和URL。

说明：待升级文件可以与策略文件在不同的文件服务器上。

规则5.7：升级策略文件必须包括待升级新文件的版本信息。

规则5.8：升级策略文件必须包括升级结果日志上载的URL。

2 策略文件编写

2.1 策略文件格式

一般的UPF格式如下：

IPAddress="192.168.0.0:192.168.255.255|10.11.28.0:10.11.29.254" SerialNumber="09" PhoneNumber="*">

FileVersion="V100R001C02B022" FileURL=".139/upgrade/package_two_B021_21.bin"

UTC="" Username="" Password=""/>

2.2 文件说明

1.标志红色部分必须与终端实际内容相符。

其中ManufacturerOUI、ModelName相对MC850终端是固定不变的，必须和终端内部的标识一致，eSpace7900的ManufacturerOUI是huawei，ModelName是MediaPhone。

其中Software_Version、IPAddress、SerialNumber 、HardwareVersion、PhoneNumber是可变的，对每台终端都可能是不一致的。

注：具体初始内容请参见附录1。

2.标志绿色部分必须与升级包中内容相同。

1.FileVersion即软件包版本。格式为VxxxRxxxCxxBxxx，该版本号对应发布包的版本号。

2. FileType指当前文件的类型

包括