策略文件修改說明文檔.docx

文檔名稱文檔密級策略文件說明1. 升級策略文件定義了終端升級范圍，以及升級策略機制。終端設(shè)備升級前需要先根據(jù)預(yù)先配置或者通過注冊服務(wù)器獲取的升級文件服務(wù)器URL，從升級文件服務(wù)器獲取升級策略文件。2. 升級策略文件為XML格式，遵循XML 1.0規(guī)范。3. 策略文件主要有兩個內(nèi)容，1、指定需升級終端的條件以及別的限定。終端會根據(jù)該條件來判斷自身是否符合升級要求，是則進行升級，否則不升級。2、指定待升級目標(biāo)。包括目標(biāo)文件的路徑、升級后的版本號等。1 升級策略文件(UPF)規(guī)范升級策略文件定義了終端升級范圍，以及升級策略機制。終端設(shè)備升級前需要先根據(jù)預(yù)先配置或者通過DHCP OPTION獲取的升級UPF文件URL，從升級文件服務(wù)器獲取升級策略文件。規(guī)則5.1：升級策略文件名為終端出廠配置，必須固定為“UPF-產(chǎn)品型號.xml”。說明：文件服務(wù)器上的策略文件名也必須與終端的出廠配置一致。例如：UPF-eSpace7910.xml。相應(yīng)的UPF文件的URL就變成：http:/*.*.*.*/directory/UPF-eSpace7910.xml規(guī)則5.2：升級策略文件為XML格式，遵循XML 1.0規(guī)范。規(guī)則5.3：終端必須支持下述升級策略條件，不同條件間為“與”的關(guān)系。每個條件必須支持通配符“*”。說明通配的定義分解到各個條件中去說明！（1） 升級指定“硬件版本”的終端。硬件版本可以是多個，它們?yōu)椤盎颉钡年P(guān)系，并以符號“|”連接（2） 升級指定“軟件版本”的終端。軟件版本可以是多個，它們?yōu)椤盎颉钡年P(guān)系，并以符號“|”連接。（3） 升級指定“IP地址”的終端。IP地址可以是多個確定的地址或是多個地址段，它們?yōu)椤盎颉钡年P(guān)系，并以符號“|”連接。地址段以符號“:”連接。增加說明xxx（4） 升級指定“序列號”的終端。該序列號就是設(shè)備標(biāo)識(OUI-SN)中的SN，具體定義遵循終端出廠規(guī)范。序列號可以是多個，它們?yōu)椤盎颉钡年P(guān)系，并以符號“|”連接。例如：需要將所有軟件版本為“R001B01D010”或者“R001B01D020”的STB EC628升級到“R001B01D030”版本，則升級策略條件可以描述為（具體書寫格式見策略文件定義）：軟件版本=“R001B01D010|R001B01D020”規(guī)則5.4：升級策略文件中支持指定多個策略，待升級終端選擇第一個匹配的策略，按照指定的條件升級，升級策略文件正確性保證參見建議5.1。例如：需要將所有軟件版本為“R001B01D010”或者“R001B01D020”的STB EC628升級到“R001B01D030”版本。同時還需要將所有軟件版本為“R001B01D030”的升級到“R001B01D050”版本，則升級策略文件中包含兩個策略，內(nèi)容可以描述為（具體書寫格式見策略文件定義）：軟件版本=“R001B01D010|R001B01D020”軟件版本=“R001B01D030”規(guī)則5.5：升級策略文件必須包含待升級終端產(chǎn)品的廠商標(biāo)識。固定采用“OUI”來標(biāo)識廠商。說明：具體OUI的定義遵循終端出廠規(guī)范。規(guī)則5.6：升級策略文件必須包括待升級新文件的文件名和URL。說明：待升級文件可以與策略文件在不同的文件服務(wù)器上。規(guī)則5.7：升級策略文件必須包括待升級新文件的版本信息。規(guī)則5.8：升級策略文件必須包括升級結(jié)果日志上載的URL。2 策略文件編寫2.1 策略文件格式一般的UPF格式如下：2.2 文件說明1. 標(biāo)志紅色部分必須與終端實際內(nèi)容相符。其中ManufacturerOUI、 ModelName相對MC850終端是固定不變的，必須和終端內(nèi)部的標(biāo)識一致，eSpace7900的ManufacturerOUI是huawei，ModelName是MediaPhone。其中Software_Version、IPAddress、SerialNumber 、HardwareVersion、PhoneNumber是可變的，對每臺終端都可能是不一致的。注：具體初始內(nèi)容請參見附錄1。2. 標(biāo)志綠色部分必須與升級包中內(nèi)容相同。1. FileVersion即軟件包版本。格式為VxxxRxxxCxxBxxx，該版本號對應(yīng)發(fā)布包的版本號。2. FileType指當(dāng)前文件的類型包括l 1 Firmware Upgrade Imagel “2 Config File”l “3 signal voice file”l “4 language package”l “5 CA letter file”根據(jù)所需升級的文件類型來決定。如果選擇1系統(tǒng)文件，則UTC節(jié)點無效，即該節(jié)點可以留空，但FileVersion必須填寫；如果選擇2至5資源文件，則FileVersion節(jié)點無效，即該節(jié)點可以留空。必須填寫UTC，格式為標(biāo)準(zhǔn)時間格式，例如1970-01-01T08:00:04,根據(jù)UTC來決定該文件會不會被升級注：關(guān)于UPF的具體定義及詳細內(nèi)容，請參考終端自動升級規(guī)范(UPF規(guī)范).doc 由于該文件結(jié)構(gòu)復(fù)雜，建議直接在升級策略文件樣板上修改2.3 升級策略說明在升級策略的匹配條件中，SoftwareVersion項不推薦使用通配符*，建議該項使用當(dāng)前要升級的終端版本號。例如，某局點N臺終端需要升級，這N臺終端的當(dāng)前版本是C05B019，準(zhǔn)備升級到C05B01c，那么升級策略的匹配條件中，SoftwareVersion就應(yīng)該是C05B019。待升級配置項文件中，各配置項的值可能存在相互約束的情況，因此在修改配置項文件時建議根據(jù)各自約束關(guān)系來設(shè)置。說明：升級策略文件的設(shè)計，嚴(yán)禁循環(huán)升級，比如根據(jù)過濾條件，A版本升級B版本，同時又設(shè)置B版本升級A版本。升級策略文件一定要注意配置樹c_tree.xml文件和系統(tǒng)升級文件eSpace7910.bin的關(guān)系。嚴(yán)禁由于配置樹c_tree.xml中配置項的變化（比如網(wǎng)絡(luò)接入方式的變化）導(dǎo)致eSpace7910.bin升級無法繼續(xù)的情況發(fā)生。建議策略文件中eSpace7910.bin文件的順序在配置樹c_tree.xml之前，或者二者分開升級。3 附錄表1 策略文件配置項定義配置項名稱是否必須類型描述UpgradePolicyFile.DeviceInfo.RObject該對象包括通用的設(shè)備信息ManufacturerOUIRstring(6)廠商標(biāo)識ModelNameRstring(64)產(chǎn)品型號。比如EC668、HG550、IAD104UpgradePolicyFile.UpgradeInfo.i.OObject該對象包括升級策略信息，允許多個實例對象。即允許多個策略。UpgradePolicyFile.UpgradeInfo.i.UpgradePolicy.OObject該對象包括升級策略條件HardwareVersionOstring待升級終端的硬件版本。可以是通配格式：“ABCD*”可以是多個版本以“|”分隔：“ABCDE | PSTNG”SoftwareVersionOstring待升級終端的軟件版本。可以是通配格式：“V100R002B01*”可以是多個版本以“|”分隔：“V200R002B01D010 | V200R002B01D020”IPAddressOstring待升級終端的IP地址。可以是通配格式：“10.71.23.*”可以是多個地址以“|”分隔：“0 | 5”可以是地址段以“:”連接：“0:5”SerialNumberOstring待升級終端的序列號PhoneNumberOstring不支持UpgradePolicyFile.UpgradeInfo.i.UpgradeFile.RObject該對象包括待升級文件信息。FileTypeRstring(64)文件類型：1 Firmware Upgrade Image“2 Config File”“3 signal voice file”“4 language package”“5 CA letter file”FileNameRstring(256)待升級新文件的文件名FileVersionRstring(256)待升級新文件的版本，終端設(shè)備使用該內(nèi)容與包文件中的版本FileURLRstring(256)待升級新文件的URLUsernameOstring(256)升級文件服務(wù)器的認(rèn)證用戶名。沒有該配置項表示不認(rèn)證，或是認(rèn)證用戶名與UPF文件服務(wù)器的用戶名一樣。PasswordOstring(256)升級文件服務(wù)器的認(rèn)證密碼。沒有該配置項表示不認(rèn)證，或是認(rèn)證密碼與UPF文件服務(wù)器的密碼一樣。DelaySecondsRunsignedInt升級啟動最大延遲時間，單位(秒)。0時表示立即啟動升級。非零時間為終端可以啟動升級前的最大延遲時間。UpgradePolicyFile.UpgradeInfo.i.UpgradeResult.RObject該對象包括升級結(jié)果信息。ResultURLRstring(256)升級結(jié)果日志上載服務(wù)器的URL。不包含文件名。終端使用該路徑上傳升級結(jié)果文件。UsernameOstring(256)升級結(jié)果上載服務(wù)器的認(rèn)證用戶名。沒有該配置項表示不認(rèn)證，或是認(rèn)證用戶名與UPF文件服務(wù)器的用戶名一樣。PasswordOstring(256)升級結(jié)果上載服務(wù)器的認(rèn)證密碼。沒有該配置項表示不認(rèn)