策略文件修改說(shuō)明文檔

1、策略文件說(shuō)明升級(jí)策略文件定義了終端升級(jí)范圍，以及升級(jí)策略機(jī)制。終端設(shè)備升級(jí)前需要先根據(jù)預(yù)先配置或者通過(guò)注冊(cè)服務(wù)器獲取的升級(jí)文件服務(wù)器URL，從升級(jí)文件服務(wù)器獲取升級(jí)策略文件。升級(jí)策略文件為XML格式，遵循XML1.0規(guī)范。策略文件主要有兩個(gè)內(nèi)容，、指定需升級(jí)終端的條件以及別的限定。終端會(huì)根據(jù)該條件來(lái)判斷自身是否符合升級(jí)要求，是則進(jìn)行升級(jí)，否則不升級(jí)。2、指定待升級(jí)目標(biāo)。包括目標(biāo)文件的路徑、升級(jí)后的版本號(hào)等。1升級(jí)策略文件（UPF）規(guī)范升級(jí)策略文件定義了終端升級(jí)范圍，以及升級(jí)策略機(jī)制。終端設(shè)備升級(jí)前需要先根據(jù)預(yù)先配置或者通過(guò)DHCPOPTION獲取的升級(jí)UPF文件URL,從升級(jí)文件服務(wù)器獲取升級(jí)

2、策略文件。規(guī)則5.1:升級(jí)策略文件名為終端出廠配置，必須固定為“UPF-產(chǎn)品型號(hào).xml”。說(shuō)明：文件服務(wù)器上的策略文件名也必須與終端的出廠配置一致。例如：UPF-eSpace7910.xml。相應(yīng)的UPF文件的URL就變成：http:/*.*.*.*/directory/UPF-eSpace7910.xml規(guī)則5.2:升級(jí)策略文件為XML格式，遵循XML1.0規(guī)范。規(guī)則5.3：終端必須支持下述升級(jí)策略條件，不同條件間為“與”的關(guān)系。每個(gè)條件必須支持通配符“*”。說(shuō)明通配的定義分解到各個(gè)條件中去說(shuō)明?。?）升級(jí)指定“硬件版本”的終端。硬件版本可以是多個(gè)，它們?yōu)椤盎颉钡年P(guān)系，并以符號(hào)“|”連接升

3、級(jí)指定“軟件版本”的終端。軟件版本可以是多個(gè)，它們?yōu)椤盎颉钡年P(guān)系，并以符號(hào)“|”連接。升級(jí)指定“IP地址”的終端。IP地址可以是多個(gè)確定的地址或是多個(gè)地址段，它們?yōu)椤盎颉钡年P(guān)系，并以符號(hào)“|”連接。地址段以符號(hào)“:”連接。增加說(shuō)明xxx升級(jí)指定“序列號(hào)”的終端。該序列號(hào)就是設(shè)備標(biāo)識(shí)（OUI-SN）中的SN,具體定義遵循終端出廠規(guī)范。序列號(hào)可以是多個(gè)，它們?yōu)椤盎颉钡年P(guān)系，并以符號(hào)“|”連接。例如：需要將所有軟件版本為“R001B01D010”或者“R001B01D020”的STBEC628升 TOC o 1-5 h z 級(jí)到“R001B01D030”版本，則升級(jí)策略條件可以描述為（具體書(shū)寫(xiě)格式見(jiàn)

4、策略文件定義）：軟件版本=“R001B01D010|R001B01D020”規(guī)則5.4：升級(jí)策略文件中支持指定多個(gè)策略，待升級(jí)終端選擇第一個(gè)匹配的策略，按照指定的條件升級(jí)，升級(jí)策略文件正確性保證參見(jiàn)建議5.1。例如：需要將所有軟件版本為“R001B01D010”或者“R001B01D020”的STBEC628升級(jí)到“R001B01D030”版本。同時(shí)還需要將所有軟件版本為“R001B01D030”的升級(jí)到“R001B01D050”版本，則升級(jí)策略文件中包含兩個(gè)策略，內(nèi)容可以描述為（具體書(shū)寫(xiě)格式見(jiàn)策略文件定義）：軟件版本=“R001B01D010|R001B01D020”軟件版本=“R001B0

5、1D030”規(guī)則5.5:升級(jí)策略文件必須包含待升級(jí)終端產(chǎn)品的廠商標(biāo)識(shí)。固定采用“OUI”來(lái)標(biāo)識(shí)廠商。說(shuō)明：具體OUI的定義遵循終端出廠規(guī)范。規(guī)則5.6：升級(jí)策略文件必須包括待升級(jí)新文件的文件名和URL。說(shuō)明：待升級(jí)文件可以與策略文件在不同的文件服務(wù)器上。規(guī)則5.7：升級(jí)策略文件必須包括待升級(jí)新文件的版本信息。URL 。規(guī)則5.8：升級(jí)策略文件必須包括升級(jí)結(jié)果日志上載的2策略文件編寫(xiě)策略文件格式一般的UPF格式如下：.標(biāo)志紅色部分必須與終端實(shí)際內(nèi)容相符。其中ManufacturerOUI、ModelName相對(duì)MC850終端是固定不變的，必須和終端內(nèi)部的標(biāo)識(shí)一致，eSpace7900白Manuf

6、acturerOUI是huawei,ModelName是MediaPhone。其中Software_Version、IPAddress、SerialNumber、HardwareVersion、PhoneNumber是可變的，對(duì)每臺(tái)終端都可能是不一致的。注：具體初始內(nèi)容請(qǐng)參見(jiàn)附錄1。.標(biāo)志綠色部分必須與升級(jí)包中內(nèi)容相同。FileVersion即軟件包版本。格式為VxxxRxxxCxxBxxx,該版本號(hào)對(duì)應(yīng)發(fā)布包的版本號(hào)。FileType指當(dāng)前文件的類(lèi)型包括1FirmwareUpgradeImageConfigFile”signalvoicefile”languagepackage”CAlett

7、erfile”根據(jù)所需升級(jí)的文件類(lèi)型來(lái)決定。如果選擇1系統(tǒng)文件，則UTC節(jié)點(diǎn)無(wú)效，即該節(jié)點(diǎn)可以留空，但FileVersion必須填寫(xiě)；如果選擇2至5資源文件，則FileVersion節(jié)點(diǎn)無(wú)效，即該節(jié)點(diǎn)可以留空。必須填寫(xiě)UTC,格式為標(biāo)準(zhǔn)時(shí)間格式，例如1970-01-01T08:00:04,根據(jù)UTC來(lái)決定該文件會(huì)不會(huì)被升級(jí)注：關(guān)于UPF的具體定義及詳細(xì)內(nèi)容，請(qǐng)參考終端自動(dòng)升級(jí)規(guī)范（UPF規(guī)范）.doc由于該文件結(jié)構(gòu)復(fù)雜，建議直接在升級(jí)策略文件樣板上修改終端自動(dòng)升級(jí)規(guī)范（UP規(guī)范）.doc在升級(jí)策略的匹配條件中，SoftwareVersion項(xiàng)不推薦使用通配符*,建議該項(xiàng)使用當(dāng)前要升級(jí)的終端版本

8、號(hào)。例如，某局點(diǎn)N臺(tái)終端需要升級(jí)，這N臺(tái)終端的當(dāng)前版本是C05B019,準(zhǔn)備升級(jí)到C05B01C,那么升級(jí)策略的匹配條件中，SoftwareVersio硼應(yīng)I亥是C05B019。待升級(jí)配置項(xiàng)文件中，各配置項(xiàng)的值可能存在相互約束的情況，因此在修改配置項(xiàng)文件時(shí)建議根據(jù)各自約束關(guān)系來(lái)設(shè)置。說(shuō)明：升級(jí)策略文件的設(shè)計(jì)，嚴(yán)禁循環(huán)升級(jí)，比如根據(jù)過(guò)濾條件，A版本升級(jí)B版本，同時(shí)又設(shè)置B版本升級(jí)A版本。升級(jí)策略文件一定要注意配置樹(shù)c_tree.xml文件和系統(tǒng)升級(jí)文件eSpace7910.bin勺關(guān)系。嚴(yán)禁由于配置樹(shù)c_tree.xml中配置項(xiàng)的變化（比如網(wǎng)絡(luò)接入方式的變化）導(dǎo)致eSpace7910.binfr

9、級(jí)無(wú)法繼續(xù)的情況發(fā)生。建議策略文件中eSpace7910.bin：件的順序在配置樹(shù)c_tree.xml之前，或者二者分開(kāi)升級(jí)。3附錄表1策略文件配置項(xiàng)定義配置項(xiàng)名稱(chēng)是否必須描述UpgradePolicyFile.DeviceInfo.RObject該對(duì)象包括通用的設(shè)備信息ManufacturerOUIRstring(6)）商標(biāo)識(shí)ModelNameRstring(64)產(chǎn)品型號(hào)。比如EC668、HG550、IAD104UpgradePolicyFile.UpgradeInfo.i.OObject該對(duì)象包括升級(jí)策略信息，允許多個(gè)實(shí)例對(duì)象。即允許多個(gè)策略。UpgradePolicyFile.Upgr

10、adeInfo.i.UpgradePolicy.OObject該對(duì)象包括升級(jí)策略條件HardwareVersionOstring彳寺升級(jí)終端的硬件版本?？梢允峭ㄅ涓袷剑篈BCD*可以是多個(gè)版本以“|”分隔：“ABCDE|PSTNG”配置項(xiàng)名稱(chēng)是否必須描述SoftwareversionOstring彳寺升級(jí)終端的軟件版本?？梢允峭ㄅ涓袷剑骸癡100R002B01*”可以是多個(gè)版本以“|”分隔：“V200R002B01D010|V200R002B01D020”IPAddressOstring彳寺升級(jí)終端的IP地址。可以是通配格式：“10.71.23.*”可以是多個(gè)地址以“|”分隔：“0|5”可以是

11、地址段以“：”連接：“0:5”SerialNumberOstring彳寺升級(jí)終端的序列號(hào)PhoneNumberOstring不支持UpgradePolicyFile.UpgradeInfo.i.UpgradeFile.RObject該對(duì)象包括待升級(jí)文件信息。FileTypeRstring(64)文件類(lèi)型：1FirmwareUpgradeImageConfigFile”signalvoicefile”languagepackage”CAletterfile”FileNameRstring(256)彳寺升級(jí)新文件的文件名FileVersionRstring(256)彳寺升級(jí)新文件的版本，終端設(shè)備使

12、用該內(nèi)容與包義件中的版本FileURLRstring(256)彳寺升級(jí)新文件的URLUsernameOstring(256)升級(jí)文件服務(wù)器的認(rèn)證用戶(hù)名。沒(méi)有該配置項(xiàng)表K/、認(rèn)證，或是認(rèn)證用戶(hù)名與UPF文件服務(wù)器的用戶(hù)名一樣。PasswordOstring(256)升級(jí)文件服務(wù)器的認(rèn)證密碼。沒(méi)有該配置項(xiàng)表K/、認(rèn)證，或是認(rèn)證密碼與UPF文件服務(wù)器的密碼一樣。配置項(xiàng)名稱(chēng)是否必須描述DelaySecondsRunsignedInt升級(jí)啟動(dòng)最大延遲時(shí)間，單位（秒）。0時(shí)表示立即啟動(dòng)升級(jí)。非零時(shí)間為終端可以啟動(dòng)升級(jí)前的最大延遲時(shí)間。UpgradePolicyFile.UpgradeInfo.i.Upgr

13、adeResult.RObject該對(duì)象包括升級(jí)結(jié)果信息。ResultURLRstring(256)升級(jí)結(jié)果日志上載服務(wù)器的URL。不包含文件名。終端使用該路徑上傳升級(jí)結(jié)果文件。UsernameOstring(256)升級(jí)結(jié)果上載服務(wù)器的認(rèn)證用戶(hù)名。沒(méi)有該配置項(xiàng)表K/、認(rèn)證，或是認(rèn)證用戶(hù)名與UPF文件服務(wù)器的用戶(hù)名一樣。PasswordOstring(256)升級(jí)結(jié)果上載服務(wù)器的認(rèn)證密碼。沒(méi)有該配置項(xiàng)表K/、認(rèn)證，或是認(rèn)證密碼與UPF文件服務(wù)器的密碼一樣。UpgradePolicyFile.UpgradeInfo.i.UpgradeControlRObject升級(jí)是否需要用戶(hù)決策UserDec

14、isionOstring(256)升級(jí)是不是需要詢(xún)問(wèn)用戶(hù)需要詢(xún)問(wèn)為YES”不需要詢(xún)問(wèn)SourceO備注：表中列“是否必須”中“R”表示必須參數(shù)，“O”表示可選參數(shù)出師表兩漢：諸葛亮先帝創(chuàng)業(yè)未半而中道崩殂，今天下三分，益州疲弊，此誠(chéng)危急存亡之秋也。然侍衛(wèi)之臣不懈于內(nèi)，忠志之士忘身于外者，蓋追先帝之殊遇，欲報(bào)之于陛下也。誠(chéng)宜開(kāi)張圣聽(tīng)，以光先帝遺德，恢弘志士之氣，不宜妄自菲薄，引喻失義，以塞忠諫之路也。宮中府中，俱為一體；陟罰臧否，不宜異同。若有作奸犯科及為忠善者，宜付有司論其刑賞，以昭陛下平明之理；不宜偏私，使內(nèi)外異法也。侍中、侍郎郭攸之、費(fèi)祎、董允等，此皆良實(shí)，志慮思純，是以先帝簡(jiǎn)拔以遺陛下：愚以為宮中之事，事無(wú)大小，悉以咨之，然后施行，必能裨補(bǔ)闕漏，有所廣益。將軍向?qū)?，性行淑均，曉暢軍事，試用于昔日，先帝稱(chēng)之日能”，是以眾議舉寵為督:愚以為營(yíng)中之事，悉以咨之，必能使行陣和睦，優(yōu)劣得所。親賢臣，遠(yuǎn)小人，此先漢所以興隆也；親小人，遠(yuǎn)賢臣，此后漢所以?xún)A頹也。先帝在時(shí),每與臣論此事，未嘗不嘆息痛恨于桓、靈也。侍中、尚書(shū)、長(zhǎng)史、參軍，此悉貞良死節(jié)之臣，愿陛下親之、信之，則漢室之隆，可計(jì)日而待也上。臣本布衣，躬耕于南陽(yáng)，茍全性命于亂世，不求聞達(dá)于諸侯。先帝不以臣卑鄙，猥自枉屈，三顧臣于草廬之中，咨臣以當(dāng)世之事，由是感激，遂許先帝以驅(qū)馳。后值傾覆，受任于敗軍之際，奉命于危難之間，爾來(lái)二十有一