策略文件修改说明文档
![策略文件修改说明文档](https://img.360docs.net/img86/1fnxkkxshdxvj4beqjzwm4c5tkj75gvc-61.webp)
![策略文件修改说明文档](https://img.360docs.net/img86/1fnxkkxshdxvj4beqjzwm4c5tkj75gvc-12.webp)
策略文件说明
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="0123456789" PhoneNumber="*"> FileVersion="V100R001C02B022" FileURL="http://10.11.28.139/upgrade/package_two_B021_21.bin" UTC="" Username="" Password=""/> Password="123456"/>
2.2 文件说明
1.标志红色部分必须与终端实际内容相符。
其中ManufacturerOUI、ModelName相对MC850终端是固定不变的,必须和终端内部的标识一致,eSpace7900的ManufacturerOUI是huawei,ModelName是MediaPhone。
其中Software_Version、IPAddress、SerialNumber 、HardwareVersion、PhoneNumber是可变的,对每台终端都可能是不一致的。
注:具体初始内容请参见附录1。
2.标志绿色部分必须与升级包中内容相同。
1.FileVersion即软件包版本。格式为VxxxRxxxCxxBxxx,该版本号对应发布包的版本号。
2. FileType指当前文件的类型
包括
●"1 Firmware Upgrade Image"
●“2 Config File”
●“3 signal voice file”
●“4 language package"”
●“5 CA letter file”
根据所需升级的文件类型来决定。
如果选择1系统文件,则UTC节点无效,即该节点可以留空,但FileVersion必须填写;
如果选择2至5资源文件,则FileVersion节点无效,即该节点可以留空。必须填写UTC,格式为标准时间格式,例如1970-01-01T08:00:04,根据UTC来决定该文件会不会被升级
注:关于UPF的具体定义及详细内容,请参考《终端自动升级规范(UPF规范).doc》
由于该文件结构复杂,建议直接在升级策略文件样板上修改
终端自动升级规范(
UPF规范).doc
2.3 升级策略说明
在升级策略的匹配条件中,SoftwareVersion项不推荐使用通配符*,建议该项使用当前要升级的终端版本号。例如,某局点N台终端需要升级,这N台终端的当前版本是C05B019,准备升级到C05B01c,那么升级策略的匹配条件中,SoftwareVersion就应该是C05B019。
待升级配置项文件中,各配置项的值可能存在相互约束的情况,因此在修改配置项文件时建议根据各自约束关系来设置。
说明:升级策略文件的设计,严禁循环升级,比如根据过滤条件,A版本升级B版本,同时又设置B版本升级A版本。
升级策略文件一定要注意配置树c_tree.xml文件和系统升级文件
eSpace7910.bin的关系。严禁由于配置树c_tree.xml中配置项的变化(比如网络接入方式的变化)导致eSpace7910.bin升级无法继续的情况发生。建议策略文件中eSpace7910.bin文件的顺序在配置树c_tree.xml之前,或者二者分开升级。
3 附录
表1策略文件配置项定义
备注:表中列“是否必须”中“R”表示必须参数,“O”表示可选参数
出师表
两汉:诸葛亮
先帝创业未半而中道崩殂,今天下三分,益州疲弊,此诚危急存亡之秋也。然侍卫之臣不懈于内,忠志之士忘身于外者,盖追先帝之殊遇,欲报之于陛下也。诚宜开张圣听,以光先帝遗德,恢弘志士之气,不宜妄自菲薄,引喻失义,以塞忠谏之路也。
宫中府中,俱为一体;陟罚臧否,不宜异同。若有作奸犯科及为忠善者,宜付有司论其刑赏,以昭陛下平明之理;不宜偏私,使内外异法也。
侍中、侍郎郭攸之、费祎、董允等,此皆良实,志虑忠纯,是以先帝简拔以遗陛下:愚以为宫中之事,事无大小,悉以咨之,然后施行,必能裨补阙漏,有所广益。
将军向宠,性行淑均,晓畅军事,试用于昔日,先帝称之曰“能”,是以众议举宠为督:愚以为营中之事,悉以咨之,必能使行阵和睦,优劣得所。
亲贤臣,远小人,此先汉所以兴隆也;亲小人,远贤臣,此后汉所以倾颓也。先帝在时,每与臣论此事,未尝不叹息痛恨于桓、灵也。侍中、尚书、长史、参军,此悉贞良死节之臣,愿陛下亲之、信之,则汉室之隆,可计日而待也。
臣本布衣,躬耕于南阳,苟全性命于乱世,不求闻达于诸侯。先帝不以臣卑鄙,猥自枉屈,三顾臣于草庐之中,咨臣以当世之事,由是感激,遂许先帝以驱驰。后值倾覆,受任于败军之际,奉命于危难之间,尔来二十有一年矣。
先帝知臣谨慎,故临崩寄臣以大事也。受命以来,夙夜忧叹,恐托付不效,以伤先帝之明;故五月渡泸,深入不毛。今南方已定,兵甲已足,当奖率三军,北定中原,庶竭驽钝,攘除奸凶,兴复汉室,还于旧都。此臣所以报先帝而忠陛下之职分也。至于斟酌损益,进尽忠言,则攸之、祎、允之任也。
愿陛下托臣以讨贼兴复之效,不效,则治臣之罪,以告先帝之灵。若无兴德之言,则责攸之、祎、允等之慢,以彰其咎;陛下亦宜自谋,以咨诹善道,察纳雅言,深追先帝遗诏。臣不胜受恩感激。
今当远离,临表涕零,不知所言。