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

文檔名稱(chēng)文檔密級(jí)策略文件說(shuō)明1. 升級(jí)策略文件定義了終端升級(jí)范圍，以及升級(jí)策略機(jī)制。終端設(shè)備升級(jí)前需要先根據(jù)預(yù)先配置或者通過(guò)注冊(cè)服務(wù)器獲取的升級(jí)文件服務(wù)器URL，從升級(jí)文件服務(wù)器獲取升級(jí)策略文件。2. 升級(jí)策略文件為XML格式，遵循XML 1.0規(guī)范。3. 策略文件主要有兩個(gè)內(nèi)容，1、指定需升級(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ò)DHCP OPTION獲取的升級(jí)UPF文件URL，從升級(jí)文件服務(wù)器獲取升級(jí)策略文件。規(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格式，遵循XML 1.0規(guī)范。規(guī)則5.3：終端必須支持下述升級(jí)策略條件，不同條件間為“與”的關(guān)系。每個(gè)條件必須支持通配符“*”。說(shuō)明通配的定義分解到各個(gè)條件中去說(shuō)明?。?） 升級(jí)指定“硬件版本”的終端。硬件版本可以是多個(gè)，它們?yōu)椤盎颉钡年P(guān)系，并以符號(hào)“|”連接（2） 升級(jí)指定“軟件版本”的終端。軟件版本可以是多個(gè)，它們?yōu)椤盎颉钡年P(guān)系，并以符號(hào)“|”連接。（3） 升級(jí)指定“IP地址”的終端。IP地址可以是多個(gè)確定的地址或是多個(gè)地址段，它們?yōu)椤盎颉钡年P(guān)系，并以符號(hào)“|”連接。地址段以符號(hào)“:”連接。增加說(shuō)明xxx（4） 升級(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”的STB EC628升級(jí)到“R001B01D030”版本，則升級(jí)策略條件可以描述為（具體書(shū)寫(xiě)格式見(jiàn)策略文件定義）：軟件版本=“R001B01D010|R001B01D020”規(guī)則5.4：升級(jí)策略文件中支持指定多個(gè)策略，待升級(jí)終端選擇第一個(gè)匹配的策略，按照指定的條件升級(jí)，升級(jí)策略文件正確性保證參見(jiàn)建議5.1。例如：需要將所有軟件版本為“R001B01D010”或者“R001B01D020”的STB EC628升級(jí)到“R001B01D030”版本。同時(shí)還需要將所有軟件版本為“R001B01D030”的升級(jí)到“R001B01D050”版本，則升級(jí)策略文件中包含兩個(gè)策略，內(nèi)容可以描述為（具體書(shū)寫(xiě)格式見(jiàn)策略文件定義）：軟件版本=“R001B01D010|R001B01D020”軟件版本=“R001B01D030”規(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í)新文件的版本信息。規(guī)則5.8：升級(jí)策略文件必須包括升級(jí)結(jié)果日志上載的URL。2 策略文件編寫(xiě)2.1 策略文件格式一般的UPF格式如下：2.2 文件說(shuō)明1. 標(biāo)志紅色部分必須與終端實(shí)際內(nèi)容相符。其中ManufacturerOUI、 ModelName相對(duì)MC850終端是固定不變的，必須和終端內(nèi)部的標(biāo)識(shí)一致，eSpace7900的ManufacturerOUI是huawei，ModelName是MediaPhone。其中Software_Version、IPAddress、SerialNumber 、HardwareVersion、PhoneNumber是可變的，對(duì)每臺(tái)終端都可能是不一致的。注：具體初始內(nèi)容請(qǐng)參見(jiàn)附錄1。2. 標(biāo)志綠色部分必須與升級(jí)包中內(nèi)容相同。1. FileVersion即軟件包版本。格式為VxxxRxxxCxxBxxx，該版本號(hào)對(duì)應(yīng)發(fā)布包的版本號(hào)。2. FileType指當(dāng)前文件的類(lèi)型包括l 1 Firmware Upgrade Imagel “2 Config File”l “3 signal voice file”l “4 language package”l “5 CA letter file”根據(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í)策略文件樣板上修改2.3 升級(jí)策略說(shuō)明在升級(jí)策略的匹配條件中，SoftwareVersion項(xiàng)不推薦使用通配符*，建議該項(xiàng)使用當(dāng)前要升級(jí)的終端版本號(hào)。例如，某局點(diǎn)N臺(tái)終端需要升級(jí)，這N臺(tái)終端的當(dāng)前版本是C05B019，準(zhǔn)備升級(jí)到C05B01c，那么升級(jí)策略的匹配條件中，SoftwareVersion就應(yīng)該是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.bin升級(jí)無(wú)法繼續(xù)的情況發(fā)生。建議策略文件中eSpace7910.bin文件的順序在配置樹(shù)c_tree.xml之前，或者二者分開(kāi)升級(jí)。3 附錄表1 策略文件配置項(xiàng)定義配置項(xiàng)名稱(chēng)是否必須類(lèi)型描述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.UpgradeInfo.i.UpgradePolicy.OObject該對(duì)象包括升級(jí)策略條件HardwareVersionOstring待升級(jí)終端的硬件版本?？梢允峭ㄅ涓袷剑骸癆BCD*”可以是多個(gè)版本以“|”分隔：“ABCDE | PSTNG”SoftwareVersionOstring待升級(jí)終端的軟件版本?？梢允峭ㄅ涓袷剑骸癡100R002B01*”可以是多個(gè)版本以“|”分隔：“V200R002B01D010 | V200R002B01D020”IPAddressOstring待升級(jí)終端的IP地址?？梢允峭ㄅ涓袷剑骸?0.71.23.*”可以是多個(gè)地址以“|”分隔：“0 | 5”可以是地址段以“:”連接：“0:5”SerialNumberOstring待升級(jí)終端的序列號(hào)PhoneNumberOstring不支持UpgradePolicyFile.UpgradeInfo.i.UpgradeFile.RObject該對(duì)象包括待升級(jí)文件信息。FileTypeRstring(64)文件類(lèi)型：1 Firmware Upgrade Image“2 Config File”“3 signal voice file”“4 language package”“5 CA letter file”FileNameRstring(256)待升級(jí)新文件的文件名FileVersionRstring(256)待升級(jí)新文件的版本，終端設(shè)備使用該內(nèi)容與包文件中的版本FileURLRstring(256)待升級(jí)新文件的URLUsernameOstring(256)升級(jí)文件服務(wù)器的認(rèn)證用戶(hù)名。沒(méi)有該配置項(xiàng)表示不認(rèn)證，或是認(rèn)證用戶(hù)名與UPF文件服務(wù)器的用戶(hù)名一樣。PasswordOstring(256)升級(jí)文件服務(wù)器的認(rèn)證密碼。沒(méi)有該配置項(xiàng)表示不認(rèn)證，或是認(rèn)證密碼與UPF文件服務(wù)器的密碼一樣。DelaySecondsRunsignedInt升級(jí)啟動(dòng)最大延遲時(shí)間，單位(秒)。0時(shí)表示立即啟動(dòng)升級(jí)。非零時(shí)間為終端可以啟動(dòng)升級(jí)前的最大延遲時(shí)間。UpgradePolicyFile.UpgradeInfo.i.UpgradeResult.RObject該對(duì)象包括升級(jí)結(jié)果信息。ResultURLRstring(256)升級(jí)結(jié)果日志上載服務(wù)器的URL。不包含文件名。終端使用該路徑上傳升級(jí)結(jié)果文件。UsernameOstring(256)升級(jí)結(jié)果上載服務(wù)器的認(rèn)證用戶(hù)名。沒(méi)有該配置項(xiàng)表示不認(rèn)證，或是認(rèn)證用戶(hù)名與UPF文件服務(wù)器的用戶(hù)名一樣。PasswordOstring(256)升級(jí)結(jié)果上載服務(wù)器的認(rèn)證密碼。沒(méi)有該配置項(xiàng)表示不認(rèn)