策略文件修改说明文档

1、策略文件说明升级策略文件定义了终端升级范围，以及升级策略机制。终端设备升级前需要先根据预先配置或者通过注册服务器获取的升级文件服务器URL，从升级文件服务器获取升级策略文件。升级策略文件为XML格式，遵循XML1.0规范。策略文件主要有两个内容，、指定需升级终端的条件以及别的限定。终端会根据该条件来判断自身是否符合升级要求，是则进行升级，否则不升级。2、指定待升级目标。包括目标文件的路径、升级后的版本号等。1升级策略文件（UPF）规范升级策略文件定义了终端升级范围，以及升级策略机制。终端设备升级前需要先根据预先配置或者通过DHCPOPTION获取的升级UPF文件URL,从升级文件服务器获取升级

2、策略文件。规则5.1:升级策略文件名为终端出厂配置，必须固定为“UPF-产品型号.xml”。说明：文件服务器上的策略文件名也必须与终端的出厂配置一致。例如：UPF-eSpace7910.xml。相应的UPF文件的URL就变成：http:/*.*.*.*/directory/UPF-eSpace7910.xml规则5.2:升级策略文件为XML格式，遵循XML1.0规范。规则5.3：终端必须支持下述升级策略条件，不同条件间为“与”的关系。每个条件必须支持通配符“*”。说明通配的定义分解到各个条件中去说明！（1）升级指定“硬件版本”的终端。硬件版本可以是多个，它们为“或”的关系，并以符号“|”连接升

3、级指定“软件版本”的终端。软件版本可以是多个，它们为“或”的关系，并以符号“|”连接。升级指定“IP地址”的终端。IP地址可以是多个确定的地址或是多个地址段，它们为“或”的关系，并以符号“|”连接。地址段以符号“:”连接。增加说明xxx升级指定“序列号”的终端。该序列号就是设备标识（OUI-SN）中的SN,具体定义遵循终端出厂规范。序列号可以是多个，它们为“或”的关系，并以符号“|”连接。例如：需要将所有软件版本为“R001B01D010”或者“R001B01D020”的STBEC628升 TOC o 1-5 h z 级到“R001B01D030”版本，则升级策略条件可以描述为（具体书写格式见

4、策略文件定义）：软件版本=“R001B01D010|R001B01D020”规则5.4：升级策略文件中支持指定多个策略，待升级终端选择第一个匹配的策略，按照指定的条件升级，升级策略文件正确性保证参见建议5.1。例如：需要将所有软件版本为“R001B01D010”或者“R001B01D020”的STBEC628升级到“R001B01D030”版本。同时还需要将所有软件版本为“R001B01D030”的升级到“R001B01D050”版本，则升级策略文件中包含两个策略，内容可以描述为（具体书写格式见策略文件定义）：软件版本=“R001B01D010|R001B01D020”软件版本=“R001B0

5、1D030”规则5.5:升级策略文件必须包含待升级终端产品的厂商标识。固定采用“OUI”来标识厂商。说明：具体OUI的定义遵循终端出厂规范。规则5.6：升级策略文件必须包括待升级新文件的文件名和URL。说明：待升级文件可以与策略文件在不同的文件服务器上。规则5.7：升级策略文件必须包括待升级新文件的版本信息。URL 。规则5.8：升级策略文件必须包括升级结果日志上载的2策略文件编写策略文件格式一般的UPF格式如下：.标志红色部分必须与终端实际内容相符。其中ManufacturerOUI、ModelName相对MC850终端是固定不变的，必须和终端内部的标识一致，eSpace7900白Manuf

6、acturerOUI是huawei,ModelName是MediaPhone。其中Software_Version、IPAddress、SerialNumber、HardwareVersion、PhoneNumber是可变的，对每台终端都可能是不一致的。注：具体初始内容请参见附录1。.标志绿色部分必须与升级包中内容相同。FileVersion即软件包版本。格式为VxxxRxxxCxxBxxx,该版本号对应发布包的版本号。FileType指当前文件的类型包括1FirmwareUpgradeImageConfigFile”signalvoicefile”languagepackage”CAlett

7、erfile”根据所需升级的文件类型来决定。如果选择1系统文件，则UTC节点无效，即该节点可以留空，但FileVersion必须填写；如果选择2至5资源文件，则FileVersion节点无效，即该节点可以留空。必须填写UTC,格式为标准时间格式，例如1970-01-01T08:00:04,根据UTC来决定该文件会不会被升级注：关于UPF的具体定义及详细内容，请参考终端自动升级规范（UPF规范）.doc由于该文件结构复杂，建议直接在升级策略文件样板上修改终端自动升级规范（UP规范）.doc在升级策略的匹配条件中，SoftwareVersion项不推荐使用通配符*,建议该项使用当前要升级的终端版本

8、号。例如，某局点N台终端需要升级，这N台终端的当前版本是C05B019,准备升级到C05B01C,那么升级策略的匹配条件中，SoftwareVersio硼应I亥是C05B019。待升级配置项文件中，各配置项的值可能存在相互约束的情况，因此在修改配置项文件时建议根据各自约束关系来设置。说明：升级策略文件的设计，严禁循环升级，比如根据过滤条件，A版本升级B版本，同时又设置B版本升级A版本。升级策略文件一定要注意配置树c_tree.xml文件和系统升级文件eSpace7910.bin勺关系。严禁由于配置树c_tree.xml中配置项的变化（比如网络接入方式的变化）导致eSpace7910.binfr

9、级无法继续的情况发生。建议策略文件中eSpace7910.bin：件的顺序在配置树c_tree.xml之前，或者二者分开升级。3附录表1策略文件配置项定义配置项名称是否必须描述UpgradePolicyFile.DeviceInfo.RObject该对象包括通用的设备信息ManufacturerOUIRstring(6)）商标识ModelNameRstring(64)产品型号。比如EC668、HG550、IAD104UpgradePolicyFile.UpgradeInfo.i.OObject该对象包括升级策略信息，允许多个实例对象。即允许多个策略。UpgradePolicyFile.Upgr

10、adeInfo.i.UpgradePolicy.OObject该对象包括升级策略条件HardwareVersionOstring彳寺升级终端的硬件版本。可以是通配格式：ABCD*可以是多个版本以“|”分隔：“ABCDE|PSTNG”配置项名称是否必须描述SoftwareversionOstring彳寺升级终端的软件版本。可以是通配格式：“V100R002B01*”可以是多个版本以“|”分隔：“V200R002B01D010|V200R002B01D020”IPAddressOstring彳寺升级终端的IP地址。可以是通配格式：“10.71.23.*”可以是多个地址以“|”分隔：“0|5”可以是

11、地址段以“：”连接：“0:5”SerialNumberOstring彳寺升级终端的序列号PhoneNumberOstring不支持UpgradePolicyFile.UpgradeInfo.i.UpgradeFile.RObject该对象包括待升级文件信息。FileTypeRstring(64)文件类型：1FirmwareUpgradeImageConfigFile”signalvoicefile”languagepackage”CAletterfile”FileNameRstring(256)彳寺升级新文件的文件名FileVersionRstring(256)彳寺升级新文件的版本，终端设备使

12、用该内容与包义件中的版本FileURLRstring(256)彳寺升级新文件的URLUsernameOstring(256)升级文件服务器的认证用户名。没有该配置项表K/、认证，或是认证用户名与UPF文件服务器的用户名一样。PasswordOstring(256)升级文件服务器的认证密码。没有该配置项表K/、认证，或是认证密码与UPF文件服务器的密码一样。配置项名称是否必须描述DelaySecondsRunsignedInt升级启动最大延迟时间，单位（秒）。0时表示立即启动升级。非零时间为终端可以启动升级前的最大延迟时间。UpgradePolicyFile.UpgradeInfo.i.Upgr

13、adeResult.RObject该对象包括升级结果信息。ResultURLRstring(256)升级结果日志上载服务器的URL。不包含文件名。终端使用该路径上传升级结果文件。UsernameOstring(256)升级结果上载服务器的认证用户名。没有该配置项表K/、认证，或是认证用户名与UPF文件服务器的用户名一样。PasswordOstring(256)升级结果上载服务器的认证密码。没有该配置项表K/、认证，或是认证密码与UPF文件服务器的密码一样。UpgradePolicyFile.UpgradeInfo.i.UpgradeControlRObject升级是否需要用户决策UserDec

14、isionOstring(256)升级是不是需要询问用户需要询问为YES”不需要询问SourceO备注：表中列“是否必须”中“R”表示必须参数，“O”表示可选参数出师表两汉：诸葛亮先帝创业未半而中道崩殂，今天下三分，益州疲弊，此诚危急存亡之秋也。然侍卫之臣不懈于内，忠志之士忘身于外者，盖追先帝之殊遇，欲报之于陛下也。诚宜开张圣听，以光先帝遗德，恢弘志士之气，不宜妄自菲薄，引喻失义，以塞忠谏之路也。宫中府中，俱为一体；陟罚臧否，不宜异同。若有作奸犯科及为忠善者，宜付有司论其刑赏，以昭陛下平明之理；不宜偏私，使内外异法也。侍中、侍郎郭攸之、费祎、董允等，此皆良实，志虑思纯，是以先帝简拔以遗陛下：愚以为宫中之事，事无大小，悉以咨之，然后施行，必能裨补阙漏，有所广益。将军向宠，性行淑均，晓畅军事，试用于昔日，先帝称之日能”，是以众议举宠为督:愚以为营中之事，悉以咨之，必能使行阵和睦，优劣得所。亲贤臣，远小人，此先汉所以兴隆也；亲小人，远贤臣，此后汉所以倾颓也。先帝在时,每与臣论此事，未尝不叹息痛恨于桓、灵也。侍中、尚书、长史、参军，此悉贞良死节之臣，愿陛下亲之、信之，则汉室之隆，可计日而待也上。臣本布衣，躬耕于南阳，苟全性命于乱世，不求闻达于诸侯。先帝不以臣卑鄙，猥自枉屈，三顾臣于草庐之中，咨臣以当世之事，由是感激，遂许先帝以驱驰。后值倾覆，受任于败军之际，奉命于危难之间，尔来二十有一