OMC系統(tǒng)北向接口通用技術(shù)規(guī)范V100

1、中國移動通信企業(yè)標(biāo)準(zhǔn)QB-XX-XXX-XXXXOMC北向接口通用技術(shù)規(guī)范Northern Interface General Technology Specification for OMC版本號 1.0.02016-3-9發(fā)布2016-3-9實(shí)施中國移動通信集團(tuán)公司發(fā)布目錄1范圍52規(guī)范性引用文件53縮略語54接口架構(gòu)55通用技術(shù)約定65.1公共要求65.2FTP通用要求66資源數(shù)據(jù)接口86.1接口協(xié)議86.2接口數(shù)據(jù)96.3數(shù)據(jù)格式96.4技術(shù)指標(biāo)127性能數(shù)據(jù)接口137.1接口協(xié)議137.2接口數(shù)據(jù)137.3數(shù)據(jù)格式137.4技術(shù)指標(biāo)148告警數(shù)據(jù)接口148.1接口協(xié)議148.2通信過

2、程158.2.1消息方式的實(shí)時告警流水158.2.2文件方式的批量告警同步168.3消息數(shù)據(jù)188.3.1消息格式188.3.2登錄與登錄響應(yīng)198.3.3消息方式同步告警請求與響應(yīng)208.3.4文件方式同步告警請求與響應(yīng)218.3.5心跳請求與響應(yīng)228.3.6關(guān)閉連接通知228.3.7實(shí)時告警上報238.4文件數(shù)據(jù)238.5技術(shù)指標(biāo)249操作指令接口2410接口日志2511接口可靠性要求2512編制歷史25前 言本標(biāo)準(zhǔn)由中國移動通信集團(tuán)公司網(wǎng)絡(luò)部提出并歸口。本標(biāo)準(zhǔn)起草單位：中國移動通信集團(tuán)公司網(wǎng)絡(luò)部。本標(biāo)準(zhǔn)主要起草人：劉立衛(wèi)、劉云霞、李健、肖捷、陳丹、高建軍、張鳳橋。本標(biāo)準(zhǔn)解釋單位：中國移

3、動通信集團(tuán)公司網(wǎng)絡(luò)部。本標(biāo)準(zhǔn)由中國移動通信集團(tuán)公司XXX號文發(fā)布。1 范圍本規(guī)范給出了中國移動OMC系統(tǒng)北向接口的通用技術(shù)要求，適用于無線網(wǎng)、核心網(wǎng)、傳輸網(wǎng)和IP網(wǎng)四個專業(yè)，適用于新建OMC系統(tǒng)以及現(xiàn)網(wǎng)OMC系統(tǒng)改造。本規(guī)范適用于中國移動OMC系統(tǒng)北向接口的設(shè)計(jì)和實(shí)現(xiàn)，是中國移動OMC系統(tǒng)提供商必須遵循的指導(dǎo)性文件。本規(guī)范是中國移動各級運(yùn)營單位進(jìn)行OMC系統(tǒng)的招標(biāo)采購、工程設(shè)計(jì)、網(wǎng)絡(luò)運(yùn)營、管理、維護(hù)、檢查和驗(yàn)收等方面的技術(shù)依據(jù)。2 規(guī)范性引用文件下列文件中的條款通過本標(biāo)準(zhǔn)的引用而成為本標(biāo)準(zhǔn)的條款。凡注日期的引用文件，其隨后所有的修改單（不包括勘誤的內(nèi)容）或修訂版均不適用于本標(biāo)準(zhǔn)，然而，鼓勵根據(jù)

4、本標(biāo)準(zhǔn)達(dá)成協(xié)議的各方研究是否可使用這些文件的最新版本。凡不注日期的引用文件，其最新版本適用于本標(biāo)準(zhǔn)。序號文檔名稱文檔來源01OMC系統(tǒng)功能規(guī)范中國移動通信集團(tuán)公司02OMC系統(tǒng)通用技術(shù)規(guī)范中國移動通信集團(tuán)公司03OMC系統(tǒng)北向接口數(shù)據(jù)規(guī)范中國移動通信集團(tuán)公司3 縮略語英文縮寫英文全稱中文解釋OMCOperations &Maintenance Center操作維護(hù)中心NMSNetwork Management System網(wǎng)絡(luò)管理系統(tǒng)NENet Element網(wǎng)元UIDUniversal Identifier網(wǎng)元全網(wǎng)唯一標(biāo)識MTBFMean Time Between Failure平均

5、故障間隔時間MTTRMean Time To Repair平均修復(fù)時間4 接口架構(gòu)OMC北向接口是OMC系統(tǒng)與網(wǎng)絡(luò)管理系統(tǒng)（NMS）間的接口，分為上行接口和下行接口。上行接口指從OMC到NMS的接口，下行接口指從NMS到OMC的接口。接口總體架構(gòu)如下：接口說明：1、資源數(shù)據(jù)接口：數(shù)據(jù)量相對較小，周期性單向傳送，數(shù)據(jù)時延要求較低。2、性能數(shù)據(jù)接口：數(shù)據(jù)量相對較大，周期性單向傳送，數(shù)據(jù)時延要求一般。3、告警數(shù)據(jù)接口：單條信息數(shù)據(jù)量較小、總體數(shù)據(jù)量較大，要求數(shù)據(jù)實(shí)時傳送。4、操作指令接口：網(wǎng)絡(luò)設(shè)備的操作指令通道接口，為上層網(wǎng)管提供下行指令通道，并反饋操作指令返回結(jié)果，數(shù)據(jù)量相對較小，實(shí)時性要求較高。

6、5 通用技術(shù)約定5.1 公共要求1、 時間同步OMC北向接口服務(wù)器必須采用當(dāng)?shù)貥?biāo)準(zhǔn)時間，中國大陸地區(qū)采用UTC+8（北京標(biāo)準(zhǔn)時間）。接口服務(wù)器使用OMC系統(tǒng)的時間同步服務(wù)器或公共的時間同步服務(wù)器。2、 編碼方式所有消息和文件的數(shù)據(jù)編碼采用UTF-8（No BOM）編碼方式。3、 數(shù)據(jù)時間格式如無特殊說明，時間類字段數(shù)據(jù)格式均為：“YYYY-MM-DD HH24:mm:ss”。5.2 FTP通用要求1、 服務(wù)端與客戶端OMC提供可以獲取資源、告警和性能數(shù)據(jù)的FTP server，NMS為 FTP client。OMC系統(tǒng)將數(shù)據(jù)文件放到FTP server上，NMS自行采集數(shù)據(jù)文件。2、 安全性要

7、求通過授權(quán)的用戶名、密碼信息才能夠訪問FTP服務(wù)器。3、 目錄規(guī)則目錄結(jié)構(gòu)：/FTP根目錄/省簡稱/專業(yè)簡稱/廠家編碼/OMC名稱/數(shù)據(jù)類別/日期或時間/示例：資源目錄：/ftproot/GD/WX/HW/GZ_OMC2/CM/20150611/性能目錄：/ftproot/GD/WX/HW/GZ_OMC2/PM/2015061101/告警目錄：/ftproot/GD/WX/HW/GZ_OMC2/FM/20150611/1） FTP根目錄：OMC廠家自定義的ftp根目錄。2） 省份簡稱、專業(yè)簡稱、廠家編碼、數(shù)據(jù)類別：參見OMC北向接口數(shù)據(jù)規(guī)范-公共數(shù)據(jù)分冊。3） 日期或時間：資源、告警數(shù)據(jù)按天存

8、放，格式為YYYYMMDD；性能數(shù)據(jù)按小時存放，格式為YYYYMMDDHH24，小時數(shù)為性能數(shù)據(jù)統(tǒng)計(jì)起始時間。3、文件命名規(guī)則1) 文件名字符：全部大寫。2) 文件命名規(guī)則：<數(shù)據(jù)類別>-<網(wǎng)元類型>-網(wǎng)元子類-<主機(jī)編號>-<數(shù)據(jù)版本>-<數(shù)據(jù)時間>-登錄用戶名-Ri-統(tǒng)計(jì)周期-<序列號>.<后綴>3) 網(wǎng)元類型：資源、性能數(shù)據(jù)為網(wǎng)元類型，如MME、ENB等；告警數(shù)據(jù)為“OMC”。4) 網(wǎng)元子類：無線網(wǎng)、核心網(wǎng)的資源、性能數(shù)據(jù)的網(wǎng)元子類為資源數(shù)據(jù)、性能數(shù)據(jù)規(guī)范定義的空間粒度名稱，如：EutranCellTDD

9、、InventoryUnitRru、EthernetPort等。告警數(shù)據(jù)無此項(xiàng)。傳輸網(wǎng)、IP網(wǎng)數(shù)據(jù)無此項(xiàng)。5) 主機(jī)編號：兩位，每1位可用0-9、A-Z編碼。6) 數(shù)據(jù)版本：遵循接口數(shù)據(jù)規(guī)范規(guī)范版本，允許同一目錄下存放不同版本的數(shù)據(jù)文件。7) 數(shù)據(jù)時間：采用YYYYMMDDHH24MMSS格式，資源數(shù)據(jù)為資源數(shù)據(jù)采集時間，性能數(shù)據(jù)為統(tǒng)計(jì)周期的起始時間，告警數(shù)據(jù)為告警時間區(qū)間的起始時間。8) 登錄用戶名：僅在告警文件同步時使用。用以解決多個NMS同時對同一個OMC發(fā)起告警文件同步請求，生成的同步文件名沖突的問題。9) Ri：可選。當(dāng)接口數(shù)據(jù)文件內(nèi)容有誤（如數(shù)據(jù)缺失等）時，OMC重新生成文件提供給

10、NMS進(jìn)行數(shù)據(jù)補(bǔ)采，新文件在原文件名后增加”Ri”進(jìn)行標(biāo)識，i從1開始，每重新生成一次i加1。10) 周期：僅針對性能數(shù)據(jù)文件，統(tǒng)計(jì)周期的分鐘數(shù)，如5、15、60。資源、告警數(shù)據(jù)文件無此項(xiàng)。11) 序列號：當(dāng)文件總量小于100MB(允許上下浮動10%)時，應(yīng)只形成一個文件；當(dāng)文件總量大于100MB(允許上下浮動10%)時要求進(jìn)行文件分割，即分割后的文件大?。ǔ詈笠粋€）均應(yīng)介于（90MB,110MB）之間。分割后的文件增加序列號標(biāo)識，序列號為三位，取值為001-999。在文件切分過程中，不能把資源、性能或告警的一條完整的記錄切開放到兩個文件中。12) 后綴：每個文件都進(jìn)行壓縮，統(tǒng)一采用zip或

11、gzip壓縮，壓縮文件后綴是zip或gz。13) 文件名樣例資源文件：CM-ENB-EUTRANCELLTDD-A1-V1.1.0-20151227000000-001.xml.zip性能文件：PM-ENB-EUTRANCELLTDD-01 -V1.1.0-20151227000000-15-001.csv.zip告警文件：FM-OMC-1A-V1.1.0-20150611011603-001.txt.zip4、文件生成過程標(biāo)識文件生成過程中，文件名后綴增加“.tmp”標(biāo)識，該文件全部生成完成后，去掉“.tmp”標(biāo)識，以確保NMS獲取到的北向數(shù)據(jù)文件是完整的。對于在數(shù)據(jù)規(guī)范中定義的一個單一接口

12、文件，如果由于文件過大拆分或分布式處理，形成多個文件的，要求在該批次文件全部生成完成后，去掉“.tmp”標(biāo)識。6 資源數(shù)據(jù)接口6.1 接口協(xié)議接口協(xié)議：采用SFTP或者FTP協(xié)議。數(shù)據(jù)周期：每12小時生成一次，即每天0點(diǎn)和12點(diǎn)啟動，基于OMC配置數(shù)據(jù)庫中的數(shù)據(jù)信息生成一套最新的全量資源文件。6.2 接口數(shù)據(jù)接口數(shù)據(jù)含公共信息和業(yè)務(wù)數(shù)據(jù)。業(yè)務(wù)數(shù)據(jù)字段參見相關(guān)數(shù)據(jù)規(guī)范。公共信息如下：No字段名稱英文名稱數(shù)據(jù)類型取值或說明1.數(shù)據(jù)生成時間TimeStamp時間開始生成數(shù)據(jù)文件的時間戳。2.時區(qū)TimeZone字符串時區(qū)信息，如：北京時間為“UTC+8”。6.3 數(shù)據(jù)格式1、標(biāo)簽說明標(biāo)簽名稱要求說明

13、dataFile必須數(shù)據(jù)文件fileHeader必須文件頭FiledName必須網(wǎng)元對象的參數(shù)集合Object必須網(wǎng)元N必須網(wǎng)元對象參數(shù)集合中每個參數(shù)名稱V有條件網(wǎng)元的參數(shù)取值，值的個數(shù)要與參數(shù)的個數(shù)相同2、xml標(biāo)簽屬性屬性名稱解釋要求類型和取值說明version版本必須字符串，取值為："1.0"encoding字符集必須字符串，取值為："UTF-8"3、fileHeader標(biāo)簽屬性屬性名稱解釋要求類型和取值說明TimeStamp數(shù)據(jù)生成時間必選時間格式TimeZone時區(qū)必選時區(qū)信息，如：北京時間為“UTC+8”。4、object標(biāo)簽屬性屬性名稱解釋

14、要求類型和取值說明UID網(wǎng)元全網(wǎng)唯一標(biāo)識必須字符串Dn網(wǎng)元標(biāo)識可選的字符串5、v標(biāo)簽屬性屬性名稱解釋要求類型和取值說明i屬性序列號必須整型，網(wǎng)元參數(shù)名和參數(shù)值相對應(yīng)的序列號，從1開始編號6、Xml數(shù)據(jù)文件Schema定義<?xml version="1.0" encoding="UTF-8"?><xs:schema xmlns:xs="/2001/XMLSchema" xmlns:xsi="/2001/XMLSchema-instance&qu

15、ot; elementFormDefault="qualified" attributeFormDefault="unqualified"><xs:element name="DataFile"><xs:complexType><xs:sequence><xs:element name="FileHeader"><xs:complexType><xs:sequence><xs:element name="TimeStamp

16、" type="xs:dateTime"/><xs:element name="TimeZone" type="xs:string"/><xs:element name="VendorName" type="xs:string" minOccurs="0"/></xs:sequence></xs:complexType></xs:element><xs:element name="Ob

17、jects"><xs:complexType><xs:sequence><xs:element name="FieldName"><xs:complexType><xs:sequence maxOccurs="unbounded"><xs:element name="N"><xs:complexType><xs:simpleContent><xs:extension base="xs:string"

18、><xs:attribute name="i" type="xs:integer" use="required"/></xs:extension></xs:simpleContent></xs:complexType></xs:element></xs:sequence></xs:complexType></xs:element><xs:element name="FieldValue"><xs:

19、complexType><xs:sequence maxOccurs="unbounded"><xs:element name="Object"><xs:complexType><xs:sequence maxOccurs="unbounded"><xs:element name="V"><xs:complexType><xs:simpleContent><xs:extension base="xs:strin

20、g"><xs:attribute name="i" type="xs:integer" use="required"/></xs:extension></xs:simpleContent></xs:complexType></xs:element></xs:sequence><xs:attribute name="UID" type="xs:string" use="required"

21、;/><xs:attribute name="Dn" type="xs:string" use="optional"/></xs:complexType></xs:element></xs:sequence></xs:complexType></xs:element></xs:sequence></xs:complexType></xs:element></xs:sequence></xs:complex

22、Type></xs:element></xs:schema>7、數(shù)據(jù)樣例<?xml version="1.0" encoding="UTF-8"?><DataFile xmlns:xsi=/2001/XMLSchema-instance xsi:noNamespaceSchemaLocation="file:/C:/Users/Administrator/Desktop/schema.xsd"> <FileHeader><TimeS

23、tamp>2015-01-12T04:01:06</TimeStamp><TimeZone>UTC+8</TimeZone> </FileHeader> <Objects> <FieldName> <N i="1">nativeName</N> <N i="2">vendor</N> <N i="3">equipmemtDomain</N> </FieldName> <

24、FieldValue> <Object UID="1301FHCS1"> <V i="1">MAS-U2000-1-P</V> <V i="2">FH</V> <V i="2">PTN</V> </Object> <Object UID="1301FHCS1"> <V i="1">MAS-U2000-2-P</V> <V i=&quo

25、t;2">FH</V> <V i="2">PTN</V> </Object> </FieldValue> </Objects></DataFile>6.4 技術(shù)指標(biāo)No指標(biāo)名稱指標(biāo)含義指標(biāo)值1.必選字段完整性接口必選字段個數(shù)/OMC系統(tǒng)內(nèi)必選字段總個數(shù)*100%=100%2.記錄完整性接口記錄數(shù)/OMC系統(tǒng)內(nèi)記錄數(shù)*100%99%3.數(shù)據(jù)時延全量資源文件生成時延=文件完成生成的時間-文件開始生成的時間（文件開始生成的時間，這里指0點(diǎn)或12點(diǎn)）1小時4.數(shù)據(jù)一致性性能數(shù)據(jù)、告警

26、數(shù)據(jù)中資源對象的UID必須與資源數(shù)據(jù)的UID保持一致。數(shù)據(jù)一致的記錄數(shù)量/總記錄數(shù)量*100%99%5.數(shù)據(jù)存儲時長資源接口數(shù)據(jù)文件保存時長7天6.并發(fā)連接數(shù)支持ftp客戶端多連接的數(shù)量10個7 性能數(shù)據(jù)接口7.1 接口協(xié)議接口協(xié)議：采用SFTP或者FTP協(xié)議。數(shù)據(jù)周期：性能測量周期分為5分鐘、15分鐘、60分鐘、24小時等。各專業(yè)各類設(shè)備性能測量周期的具體要求參見OMC北向接口數(shù)據(jù)規(guī)范-性能數(shù)據(jù)分冊。7.2 接口數(shù)據(jù)接口數(shù)據(jù)含公共信息和業(yè)務(wù)數(shù)據(jù)。業(yè)務(wù)數(shù)據(jù)字段參見相關(guān)數(shù)據(jù)規(guī)范。公共信息如下：No字段名稱英文名稱數(shù)據(jù)類型取值或說明1.數(shù)據(jù)生成時間TimeStamp時間開始生成數(shù)據(jù)文件的時間戳。2

27、.時區(qū)TimeZone字符串時區(qū)信息，如：北京時間為“UTC+8”。3.統(tǒng)計(jì)周期Period數(shù)字測量統(tǒng)計(jì)周期的分鐘數(shù)，如5、15、60等7.3 數(shù)據(jù)格式傳輸、IP專業(yè)OMC性能測量文件必須采用CSV格式（豎線分隔）。無線、核心網(wǎng)OMC性能測量文件優(yōu)先采用CSV格式（豎線分隔），可以采用XML格式。要求同一個空間粒度的測量項(xiàng)必須在同一數(shù)據(jù)文件中。CSV格式（豎線分隔）要求：1、第一行數(shù)據(jù)是公共信息。2、第二行數(shù)據(jù)是字段名稱信息，每個字段用ASCII字符豎線“|”進(jìn)行分隔。3、第三行開始是具體數(shù)據(jù)，每條記錄一行，每個數(shù)據(jù)項(xiàng)用ASCII字符豎線“|”分隔。4、在每行的行尾不加分隔符“|”數(shù)據(jù)樣例：T

28、imeStamp=2015-06-11 05:08:00|TimeZone=UTC+8|Period=15UID|UserLabel|startTime|ConnEstabAtt|ConnEstabSucc1301HWWX2CELA12ZA1|589832|2015-06-11 05:00:00|18|171301HWWX2CELA12Z45|589833|2015-06-11 05:00:00|259|258性能測量文件中如果含有“測量-子測量”嵌套格式，對于可規(guī)范、可枚舉的子測量（如“分失敗原因統(tǒng)計(jì)”）應(yīng)直接擴(kuò)展為測量；對于不可規(guī)范、不可枚舉的子測量（如“分TA測量”）應(yīng)單獨(dú)形成測量文件。

29、7.4 技術(shù)指標(biāo)No指標(biāo)名稱指標(biāo)含義指標(biāo)值1.必選字段完整性接口必選字段個數(shù)/OMC系統(tǒng)內(nèi)必選字段總個數(shù)*100%99.5%2.記錄完整性接口記錄數(shù)/OMC系統(tǒng)內(nèi)記錄數(shù)*100%99%3.性能數(shù)據(jù)時延性能測量文件生成時延=文件完成生成的時間-性能文件統(tǒng)計(jì)周期結(jié)束時間10分鐘4.數(shù)據(jù)存儲時長性能接口數(shù)據(jù)文件保存時長7天5.并發(fā)連接數(shù)支持ftp客戶端多連接的數(shù)量10個8 告警數(shù)據(jù)接口8.1 接口協(xié)議告警范圍：OMC北向接口必須上報全量告警，不允許在OMC側(cè)進(jìn)行告警過濾或屏蔽。接口協(xié)議：1）實(shí)時告警采用消息方式，采用socket/tcp協(xié)議，OMC為socket的server端，NMS為socket

30、的client端。2）批量告警采用文件方式，采用SFTP或者FTP協(xié)議。接口模式：1）消息方式的實(shí)時告警流水2）文件方式的批量告警同步8.2 通信過程OMC提供一個服務(wù)端口，端口號可選范圍為3123231241，默認(rèn)使用31232。OMC為每個NMS分配不同的賬號，允許每個賬號建立兩個socket連接，一個用于消息方式的實(shí)時告警流水，一個用于文件方式的批量告警同步。8.2.1 消息方式的實(shí)時告警流水1、 NMS作為socket客戶端，主動建立與OMC的連接。2、 NMS發(fā)送登錄請求，登錄請求信息包括用戶名、授權(quán)碼、請求類別（實(shí)時告警流水）。3、 OMC對用戶名和授權(quán)碼進(jìn)行認(rèn)證，接受或拒絕登錄請

31、求。OMC檢測到NMS連續(xù)三次登錄失敗后，主動斷開與NMS的連接。4、 OMC發(fā)送從當(dāng)前時間開始的實(shí)時告警。5、 當(dāng)NMS發(fā)現(xiàn)實(shí)時告警消息序號不連續(xù)時（漏告警）且差值不大于1000時，可向OMC發(fā)起1次消息方式告警同步請求（即每次缺漏的告警，只能發(fā)起1次消息同步請求），并告知OMC同步告警消息的起始序號。實(shí)時告警消息序號差值超過1000時，采用文件方式同步缺失告警。6、 OMC響應(yīng)請求，返回確認(rèn)信息。7、 OMC暫停發(fā)送實(shí)時告警，在告警消息發(fā)送緩存中查詢NMS提供的同步告警消息起始序號的告警，然后補(bǔ)發(fā)從該告警消息序號開始的告警消息（方式和格式同4），含告警產(chǎn)生消息和告警清除消息，之后繼續(xù)上報實(shí)

32、時告警消息。當(dāng)OMC沒有找到該起始序號的告警數(shù)據(jù)(超出緩存范圍)時，忽略該同步請求，從暫停序號之后的最新告警開始實(shí)時告警上報。8、 NMS每隔60秒發(fā)送一次心跳信息給OMC，進(jìn)行連接可用性確認(rèn)。如果在180秒內(nèi)OMC沒有接收到NMS的任何信息時，OMC主動斷開socket連接。9、 OMC收到NMS的心跳后，響應(yīng)返回確認(rèn)信息。如果在180秒內(nèi)NMS沒有接收到OMC的任何信息，NMS主動斷開socket連接，然后嘗試重新連接。10、 NMS告警數(shù)據(jù)接口程序終止前，向OMC發(fā)起關(guān)閉socket連接的通知。OMC收到通知后停止發(fā)送告警，斷開連接。NMS判斷該關(guān)閉通知發(fā)送成功后，斷開和OMC的連接。8

33、.2.2 文件方式的批量告警同步1、 NMS作為socket客戶端，主動建立與OMC的連接。2、 NMS發(fā)送登錄請求，登錄請求信息包括用戶名、授權(quán)碼、請求類別（文件告警同步）。3、 OMC對用戶名和授權(quán)碼進(jìn)行認(rèn)證，接收或拒絕登錄請求。OMC檢測到NMS連續(xù)三次登錄失敗后，主動斷開與NMS的連接。4、 NMS告知OMC同步告警范圍。5、 OMC響應(yīng)請求，返回確認(rèn)信息。6、 NMS每隔60秒發(fā)送一次心跳信息給OMC，進(jìn)行連接可用性確認(rèn)。如果在180秒內(nèi)OMC沒有接收到NMS的任何信息時，OMC主動斷開socket連接。7、 OMC收到NMS的心跳后，響應(yīng)返回確認(rèn)信息。如果在180秒內(nèi)NMS沒有接收

34、到OMC的任何信息，NMS主動斷開socket連接，然后嘗試重新連接。8、 OMC基于請求條件，生成告警數(shù)據(jù)文件，發(fā)送文件通知消息給NMS。9、 NMS從OMC側(cè)獲取數(shù)據(jù)文件。10、 NMS斷開和OMC的連接。補(bǔ)充說明： 一次連接只能申請一次文件同步，獲取完數(shù)據(jù)OMC返回的數(shù)據(jù)文件之后，立即完成步驟10的斷開操作。OMC告警文件同步有兩種模式：1、基于OMC數(shù)據(jù)庫的告警數(shù)據(jù)文件基于OMC數(shù)據(jù)庫的活動告警生成數(shù)據(jù)文件，只有告警產(chǎn)生數(shù)據(jù)，沒有告警清除數(shù)據(jù)。主要用于NMS第一次啟動或者周期性進(jìn)行批量活動告警同步。2、基于告警流水日志的告警數(shù)據(jù)文件基于OMC告警流水日志生成數(shù)據(jù)文件，包括告警產(chǎn)生消息和

35、告警清除消息。主要用于NMS故障或升級、OMC故障或升級、實(shí)時告警流水漏告警條數(shù)大于1000等情況。8.3 消息數(shù)據(jù)8.3.1 消息格式消息數(shù)據(jù)由消息頭和消息體組成。消息頭由9個字節(jié)（byte）表示，消息體長度不固定，各類消息不同。組成中文名稱英文名稱長度/byte取值或說明消息頭開始標(biāo)志startSign2固定為0xFFFF，消息開始標(biāo)識。消息類型msgType1單字節(jié)整型數(shù)，類型編碼含義如下：0:realTimeAlarm1:reqLoginAlarm2:ackLoginAlarm3:reqSyncAlarmMsg4:ackSyncAlarmMsg5:reqSyncAlarmFile6:a

36、ckSyncAlarmFile7:ackSyncAlarmFileResult8:reqHeartBeat9:ackHeartBeat10:closeConnAlarm秒時間戳timeStamp44字節(jié)整型數(shù)，字節(jié)順序?yàn)锽ig-Endian，表示消息產(chǎn)生時間,為距離1970-01-01 00:00:00時間偏移的秒數(shù)。長度lenOfBody22字節(jié)整型數(shù)，字節(jié)順序?yàn)锽ig-Endian，表示消息體字節(jié)長度，取值范圍032767。消息體具體消息內(nèi)容。對于上報的告警消息realTimeAlarm，消息體中只包括一條json格式的告警數(shù)據(jù)。除“實(shí)時告警上報消息”外的所有消息體由消息名和參數(shù)組成。形如

37、：<消息名><參數(shù)名>=<參數(shù)值><參數(shù)名>=<參數(shù)值>1） 消息名、參數(shù)名大小寫不敏感。2） 消息名與參數(shù)間用分號“;”分隔。3） 參數(shù)間用分號“;”分隔。4） 參數(shù)名與參數(shù)值用“=”連接，參數(shù)為空時參數(shù)值為字符串“null”。消息體樣例：reqLoginAlarm; user=yiy; key=qw#$; type=msg8.3.2 登錄與登錄響應(yīng)NMS發(fā)給OMC的登錄請求消息（下行）消息名：reqLoginAlarm參數(shù)：1）user：登錄用戶名，用戶名中不得含有分號“;”。2）key：授權(quán)碼，授權(quán)碼中不得含有分號“;”。3）t

38、ype：連接類型。取值msg為實(shí)時告警流水上報連接。取值ftp為文件方式告警同步連接。消息樣例：reqLoginAlarm; user=yiy; key=qw#$; type=msgOMC發(fā)給NMS的登錄請求的響應(yīng)消息（上行）消息名：ackLoginAlarm參數(shù)：1） result：登錄結(jié)果。取值succ表示登錄成功，fail表示登錄失敗。2） timeZone：時區(qū)信息，如：北京時間為“UTC+8”。3） resDesc：登錄失敗原因，長度小于32個字符。消息樣例：ackLoginAlarm; result=fail; resDesc=username-error8.3.3 消息方式同步告

39、警請求與響應(yīng)NMS發(fā)現(xiàn)缺失告警時，發(fā)給OMC的消息方式同步告警請求消息（下行）消息名：reqSyncAlarmMsg參數(shù)：1）reqID，操作序號，用于區(qū)分同一連接的多次請求。2）alarmSeq，同步告警的起始告警消息序號。丟失多條告警時，為最小告警消息序列號。消息樣例：reqSyncAlarmMsg;reqID=33; alarmSeq=10OMC發(fā)給NMS的消息方式同步告警請求的響應(yīng)消息（上行）消息名：ackSyncAlarmMsg參數(shù)：1）reqID，操作序號，取值為請求消息的reqID。2）result：響應(yīng)結(jié)果。取值succ表示請求成功，fail為請求失敗。3）resDesc：失敗

40、原因，長度小于32個字符，不允許帶分號“;”。消息樣例：ackSyncAlarmMsg; reqId=33; result=succ; resDesc=null8.3.4 文件方式同步告警請求與響應(yīng)NMS發(fā)給OMC的文件方式同步告警請求消息（下行）命令名：reqSyncAlarmFile命令參數(shù)：1） reqID，操作序號，用于區(qū)分同一連接的多次請求。2） startTime，所取活動告警發(fā)生時間的起始時間或告警消息時間的起始時間?？蔀榭?，為空表示取OMC中最早時間的告警。當(dāng)同步請求的起始時間早于OMC中存儲的最早告警時間時，OMC將起始時間自動修正為已有數(shù)據(jù)的最早時間。3） endTime，

41、所取活動告警發(fā)生時間的結(jié)束時間或告警消息時間的結(jié)束時間。可為空，為空表示取OMC中最早時間的告警。當(dāng)同步請求的結(jié)束時間晚于OMC中存儲的最晚告警時間時，OMC將結(jié)束時間自動修正為已有數(shù)據(jù)的最新時間。4） syncSource，同步的告警數(shù)據(jù)源，取值為：0：基于OMC數(shù)據(jù)庫的存量活動告警數(shù)據(jù)文件（對于corba改socket的告警接口升級，數(shù)據(jù)庫中已存儲的告警數(shù)據(jù)如果沒有alarmSeq字段，則需要增加alarmSeq字段且統(tǒng)一填寫為0）。1：基于告警消息日志的歷史告警消息流水?dāng)?shù)據(jù)文件。該模式下，告警消息序號alarmSeq和原實(shí)時上報的要保持一致。消息樣例：reqSyncAlarmFile;r

42、eqId=33;startTime=2014-11-2710:00:00;endTime=2014-11-2710:30:00; syncSource =0OMC發(fā)給NMS的文件方式同步告警請求的響應(yīng)消息（上行）消息名：ackSyncAlarmFile（無結(jié)果的立即應(yīng)答）參數(shù)：1）reqID，操作序號，取值為請求消息的reqID。2）result：響應(yīng)結(jié)果。取值succ表示請求成功，fail表示請求失敗。3）resDesc：失敗原因，長度小于32個字符，不允許帶分號“;”。消息樣例：ackSyncAlarmFile; reqId=33; result=succ; resDesc=nullOMC

43、發(fā)給NMS的文件方式同步告警請求的響應(yīng)消息（上行）消息名：ackSyncAlarmFileResult（含有文件同步結(jié)果的應(yīng)答）參數(shù)：1）reqID，操作序號，取值為請求消息的reqID。2）result：響應(yīng)結(jié)果。取值succ為請求成功，fail為請求失敗。3）fileName：告警數(shù)據(jù)文件的路徑和名稱，多個文件之間用逗號分隔。4）resDesc：失敗原因。消息樣例：ackSyncAlarmFileResult; reqId=33;result=succ; filename=/ftproot/GD/WX/HW/JS_OMC2/FM/20150611/ FM-OMC-1A-V1.1.0-201

44、50611011603-001.txt; resDesc=null8.3.5 心跳請求與響應(yīng)沒有實(shí)時告警數(shù)據(jù)時，NMS每隔60秒向OMC發(fā)送一次心跳消息（下行）消息名：reqHeartBeat參數(shù)：reqID，操作序號，用于區(qū)分同一連接的多次請求。消息樣例：reqHeartBeat;ReqId=33OMC發(fā)給NMS的心跳響應(yīng)消息（上行）消息名：ackHeartBeat參數(shù)：reqID，操作序號，用于區(qū)分同一連接的多次請求。消息樣例：ackHeartBeat;ReqId=338.3.6 關(guān)閉連接通知NMS發(fā)給OMC的關(guān)閉連接通知消息（下行）消息名：closeConnAlarm消息樣例：close

45、ConnAlarm8.3.7 實(shí)時告警上報對應(yīng)的消息頭中的消息類型編碼為0（realTimeAlarm），消息體為具體告警數(shù)據(jù)，采用json格式。消息體信息包括告警消息序號和告警業(yè)務(wù)字段。業(yè)務(wù)字段參見OMC北向接口數(shù)據(jù)規(guī)范-告警數(shù)據(jù)分冊。告警消息序號（alarmSeq），OMC內(nèi)告警事件連續(xù)標(biāo)識，用于判斷是否丟失告警消息，具體要求如下：1、用連續(xù)正整數(shù)編號，初始編號從1開始，如果編號超過最大正整數(shù)(231-1)重新從1開始編號。2、發(fā)送給多個NMS系統(tǒng)的同一條告警，告警消息序號相同。3、在OMC升級、重啟等情況下，需要保證序號能夠繼續(xù)連續(xù)編號。消息體樣例： "alarmSeq" : "10","alarmStatus" : "1","alarmId" : "410969","neUID ":"1301HWWX1ENB2A2367",&q