系统北向接口通用关键技术标准规范.doc

资源描述

1、中华人民共和国移动通信公司原则QB-XX-XXX-XXXXOMC北向接口通用技术规范Northbound Interface General Technology Specification for OMC版本号 1.0.0-910-1244发布-109-1244实行中华人民共和国移动通信集团公司发布目录1范畴52规范性引用文献53缩略语54接口架构55通用技术商定65.1公共规定65.2FTP通用规定66资源数据接口86.1接口合同86.2接口数据96.3数据格式96.4技术指标127性能数据接口137.1接口合同137.2接口数据137.3数据格式137.4技术指标148告警数据接口148

2、.1接口合同148.2通信过程158.2.1消息方式实时告警流水158.2.2文献方式批量告警同步168.3消息数据188.3.1消息格式188.3.2登录与登录响应198.3.3消息方式同步告警祈求与响应208.3.4文献方式同步告警祈求与响应218.3.5心跳祈求与响应228.3.6关闭连接告知228.3.7实时告警上报238.4文献数据238.5技术指标249操作指令接口2410接口日记2511接口可靠性规定2512编制历史25前言本原则由中华人民共和国移动通信集团公司网络部提出并归口。本原则起草单位：中华人民共和国移动通信集团公司网络部。本原则重要起草人：刘立卫、刘云霞、李健、肖捷、

3、陈丹、高建军、张凤桥。本原则解释单位：中华人民共和国移动通信集团公司网络部。本原则由中华人民共和国移动通信集团公司XXX号文发布。1 范畴本规范给出了中华人民共和国移动OMC系统北向接口通用技术规定，合用于无线网、核心网、传播网和IP网四个专业，合用于新建OMC系统以及现网OMC系统改造。本规范合用于中华人民共和国移动OMC系统北向接口设计和实现，是中华人民共和国移动OMC系统提供商必要遵循指引性文献。本规范是中华人民共和国移动各级运营单位进行OMC系统招标采购、工程设计、网络运营、管理、维护、检查和验收等方面技术根据。2 规范性引用文献下列文献中条款通过本原则引用而成为本原则条款。凡注日期引

4、用文献，其随后所有修改单（不涉及勘误内容）或修订版均不合用于本原则，然而，勉励依照本原则达到合同各方研究与否可使用这些文献最新版本。凡不注日期引用文献，其最新版本合用于本原则。序号文档名称文档来源01OMC系统功能规范中华人民共和国移动通信集团公司02OMC系统通用技术规范中华人民共和国移动通信集团公司03OMC系统北向接口数据规范中华人民共和国移动通信集团公司3 缩略语英文缩写英文全称中文解释OMCOperations &Maintenance Center操作维护中心NMSNetwork Management System网络管理系统NENet Element网元rmUIDResource

5、 Management Universal Identifier网络资源对象全网唯一标记MTBFMean Time Between Failure平均故障间隔时间MTTRMean Time To Repair平均修复时间4 接口架构OMC北向接口是OMC系统与网络管理系统（NMS）间接口，分为上行接口和下行接口。上行接口指从OMC到NMS接口，下行接口指从NMS到OMC接口。接口总体架构如下：接口阐明：1、资源数据接口：数据量相对较小，周期性单向传送，数据时延规定较低。2、性能数据接口：数据量相对较大，周期性单向传送，数据时延规定普通。3、告警数据接口：单条信息数据量较小、总体数据量较大，规定

6、数据实时传送。4、操作指令接口：网络设备操作指令通道接口，为上层网管提供下行指令通道，并反馈操作指令返回成果，数据量相对较小，实时性规定较高。5 通用技术商定5.1 公共规定1、时间同步OMC北向接口服务器必要采用本地原则时间，中华人民共和国大陆地区采用UTC+8（北京原则时间）。接口服务器使用OMC系统时间同步服务器或公共时间同步服务器。2、编码方式所有消息和文献数据编码采用UTF-8（No BOM）编码方式。3、数据时间格式如无特殊阐明，时间类字段数据格式均为：“YYYY-MM-DD HH24:mm:ss”。5.2 FTP通用规定1、服务端与客户端OMC提供可以获取资源、告警和性能

7、数据FTP server，NMS为 FTP client。OMC系统将数据文献放到FTP server上，NMS自行采集数据文献。2、安全性规定通过授权顾客名、密码信息才可以访问FTP服务器。3、目录规则目录构造：/FTP根目录/省简称/专业简称/厂家编码/OMC名称/数据类别/日期或时间/示例：资源目录：/ftproot/GD/WX/HW/GZ_OMC2/CM/0611/性能目录：/ftproot/GD/WX/HW/GZ_OMC2/PM/061101/告警目录：/ftproot/GD/WX/HW/GZ_OMC2/FM/0611/1） FTP根目录：OMC厂家自定义ftp根目录。2）省份

8、简称、专业简称、厂家编码、数据类别：参见OMC北向接口数据规范-公共数据分册。3）日期或时间：资源、告警数据按天存储，格式为YYYYMMDD；性能数据按小时存储，格式为YYYYMMDDHH24，小时数为性能数据记录起始时间。4、文献命名规则1) 文献名字符：英文字母所有大写，不容许有中文字符。2) 文献命名规则：-网元子类-登录顾客名-Ri-记录周期 -序列号.3) 网元类型：资源、性能数据为网元类型，如MME、ENB、PTN、PON等；告警数据为“OMC”。4) 网元子类：无线网、核心网资源、性能数据网元子类为资源数据、性能数据规范定义空间粒度名称，如：EutranCellTDD、Inv

9、entoryUnitRru、EthernetPort等；告警数据无此项。传播网资源、性能数据资源对象类名，填写资源对象简称，如：隧道（TNL）、标签互换（LBS）。资源对象简称参见OMC北向接口数据规范-XX资源数据分册或OMC北向接口数据规范-XX性能数据分册。IP网数据无此项，核心网资源、性能数据该项可选。5) 主机编号：两位，每1位可用0-9、A-Z编码。6) 数据版本：遵循接口数据规范规范版本，容许同一目录下存储不同版本数据文献。7) 数据时间：采用YYYYMMDDHH24MMSS格式，。资源、告警数据为数据文献开始生成时间，其中资源数据文献开始生成时间指0点或12点，；性能数据为记录

10、周期起始时间。8) 登录顾客名：仅在告警文献同步时使用。用以解决各种NMS同步对同一种OMC发起告警文献同步祈求，生成同步文献名冲突问题。9) Ri：可选。当接口数据文献内容有误（如数据缺失等）时，OMC重新生成文献提供应NMS进行数据补采，新文献在原文献名后增长”Ri”进行标记，i从1开始，每重新生成一次i加1。10) 记录周期：两位，取值范畴为00-99，仅针对性能数据文献，记录周期分钟数，如05、15、60。资源、告警数据文献无此项。11) 序列号：当文献总量不大于100MB(容许上下浮动10%)时，应只形成一种文献；当文献总量不不大于100MB(容许上下浮动10%)时规定进行文献分割，

11、即分割后文献大小（除最后一种）均应介于（90MB,110MB）之间。分割后文献增长序列号标记，序列号为三位，取值为001-999。在文献切分过程中，不能把资源、性能或告警一条完整记录切开放到两个文献中。12) 后缀：每个文献都进行压缩，统一采用zip或gzip压缩，压缩文献后缀是zip或gz。13) 文献名样例资源文献：CM-ENB-EUTRANCELLTDD-A1-V1.1.0-001.xml.zip性能文献：PM-ENB-EUTRANCELLTDD-01-V1.1.0-15-001.csv.zip告警文献：FM-OMC-1A-V1.1.0-001.txt.zip对于设备厂家北向接口上报私有

12、参数文献，在数据版本前增长ALL字样，其她字段规定保持不变。样例：性能文献：PM-ENB-EUTRANCELLTDD-01-ALLV1.1.0-15-001.csv.zip5、文献生成过程标记文献生成过程中，文献名后缀增长“.tmp”标记，该文献所有生成完毕后，去掉“.tmp”标记，以保证NMS获取到北向数据文献是完整。对于在数据规范中定义一种单一接口文献，如果由于文献过大拆分或分布式解决，形成各种文献，规定在该批次文献所有生成完毕后，去掉“.tmp”标记。6 资源数据接口6.1 接口合同接口合同：采用SFTP或者FTP合同。数据周期：无线网、核心网、传播网和IP网四个专业每12小时生成一次

13、，即每天0点和12点启动，基于OMC配备数据库中数据信息生成一套最新全量资源文献。智能家庭网关终端管理平台资源数据周期为每24小时生成一次，即每天0点启动，基于OMC配备数据库中数据信息生成一套最新全量资源文献。6.2 接口数据接口数据含公共信息和业务数据。业务数据字段参见有关数据规范。公共信息如下：No字段名称英文名称数据类型取值或阐明1.数据生成时间TimeStamp时间开始生成数据文献时间戳。2.时区TimeZone字符串时区信息，如：北京时间为“UTC+8”。3.生成这个网络资源模型文献OMC设备供应商VendorName字符串字符串，取值长度不不不大于64个字节，不限制字符类型。通过

14、该属性取值应可明确辨认厂商名称4.网元类型ElementType字符串如MME、ENB、PTN、PON5.资源数据版本CmVersion字符串资源数据版本6.网络资源对象全网唯一标记rmUID字符串网络资源对象全网唯一标记，详细定义请见OMC系统北向接口数据规范-公共数据分册V1.0.07.网元标记Dn字符串无线、核心网专业该字段必选，传播、IP专业无该字段8.顾客和谐名UserLabel字符串无线、核心网专业该字段必选，传播、IP专业无该字段9.网络资源类别名称ObjectType字符串该组网络资源模型归属对象类，详细定义请见OMC北向接口数据规范-XX资源数据分册。如：EutranCell

15、TDD、InventoryUnitRru、EthernetPort等。核心网专业该字段必选。6.3 数据格式资源数据文献采用XML格式。给定一种网元类型，有两种文献组织方式：（1）同一种空间粒度资源数据在同一数据文献中；（2）对所有空间粒度，启用一种CM文献存储其资源数据。核心网专业优选文献组织方案（2）。XML文献格式规定如下。1、标签阐明标签名称规定阐明dataFile必要数据文献fileHeader必要文献头FiledName必要网元对象参数集合Object必要网元N必要网元对象参数集合中每个参数名称V有条件网元参数取值，值个数要与参数个数相似2、xml标签属性属性名称解释规定类型和取值

16、阐明version版本必要字符串，取值为：1.0encoding字符集必要字符串，取值为：UTF-83、fileHeader标签属性属性名称解释规定类型和取值阐明TimeStamp数据生成时间必选时间格式，YYYY-MM-DDTHH24:mm:ssTimeZone时区必选时区信息，如：北京时间为“UTC+8”。VendorName生成这个网络资源模型文献OMC设备供应商必选字符串，取值长度不不不大于64个字节，不限制字符类型。通过该属性取值应可明确辨认厂商名称ElementType网元类型必选字符串，如MME、ENB、PTN、PONCmVersion资源数据版本必选字符串，资源数据版本4、ob

17、ject标签属性属性名称解释规定类型和取值阐明rmUID网络资源对象全网唯一标记必要字符串DnDistinguished Name，辨认名无线、核心网专业该字段必选，传播、IP专业无该字段字符串UserLabel顾客和谐名无线、核心网专业该字段必选，传播、IP专业无该字段字符串5、v标签属性属性名称解释规定类型和取值阐明i属性序列号必要整型，网元参数名和参数值相相应序列号，从1开始编号对于传播专业（PTN、PON等），rmUID字段不重复写在v标签中（写在object标签中）。6、Xml数据文献Schema定义7、数据样例PTN资源文献样例： -01-12T04:01:06UTC+8huawe

18、iPTNV1.0.0 nativeName vendor equipmemtDomain MAS-U-1-P FH PTN MAS-U-2-P FH PTN 核心网专业资源文献样例：-04-18T05:00:04UTC+8ZTEMMEV1.3.0EthernetPortPortIdUserLabelPortRateAdministrativeStateOperationalStatePortLocationSignTransMediaMacAddressIpAddressList214_65535_12_1214_65535_12_11024000UNLOCKEDENABLED11-2-17-

19、12-1OPTIC00.d0.d0.a1.09.060.0.0.0214_65535_25_1214_65535_25_11024000UNLOCKEDENABLED11-2-25-25-1ELECTIC00.d0.d0.a1.09.060.0.0.06.4 技术指标No指标名称指标含义指标值1.字段完整性接口必选字段个数/OMC系统内必选字段总个数*100%=100%接口B类字段个数/OMC系统内B类字段总个数*100%90%2.记录完整性接口记录数/OMC系统内记录数*100%99%3.数据时延全量资源文献生成时延=文献完毕生成时间-文献开始生成时间（文献开始生成时间，这里指0点或12点）

20、1小时4.数据一致性性能数据、告警数据中资源对象rmUID必要与资源数据rmUID保持一致。数据一致记录数量/总记录数量*100%99%5.数据存储时长资源接口数据文献保存时长7天6.并发连接数支持ftp客户端多连接数量10个7 性能数据接口7.1 接口合同接口合同：采用SFTP或者FTP合同。数据周期：性能测量周期分为5分钟、15分钟、60分钟、24小时等。各专业各类设备性能测量周期详细规定参见OMC北向接口数据规范-性能数据分册。7.2 接口数据接口数据含公共信息和业务数据。业务数据字段参见有关数据规范。公共信息如下：No字段名称英文名称数据类型规定取值或阐明1.数据生成时间TimeSta

21、mp时间必选开始生成数据文献时间戳。XML格式文献中，格式为YYYY-MM-DDTHH24:mm:ss；CSV格式文献中，格式为YYYY-MM-DD HH24:mm:ss2.时区TimeZone字符串必选时区信息，如：北京时间为“UTC+8”。3.记录周期Period数字必选测量记录周期分钟数，如5、15、60等4.OMC设备供应商名VendorName字符串必选生成这个网络资源模型文献OMC设备供应商。必选5.网元类型ElementType字符串必选如MME、ENB、PTN、PON6.性能数据版本PmVersion字符串必选性能数据版本7.网络资源对象全网唯一标记rmUID字符串必选网络资源

22、对象全网唯一标记，详细定义请见OMC系统北向接口数据规范-公共数据分册V1.0.08.网元标记Dn字符串必选无线、核心网专业该字段必选，传播、IP专业无该字段9.顾客和谐名UserLabel字符串必选UserLabel字段转义规定：用双引号字符封闭UserLabel字段值，对UserLabel中浮现双引号字符用一对双引号字符表达。例如，UserLabel为北京|海淀，输出为北京|海淀，或者UserLabel 北京新建，输出为北京新建。无线、核心网专业该字段必选，传播、IP专业无该字段10.记录周期起始时间startTime时间必选性能数据记录周期起始时间。XML格式文献中，格式为YYYY-M

23、M-DDTHH24:mm:ss；CSV格式文献中，格式为YYYY-MM-DD HH24:mm:ss11.网络资源类别名称ObjectType字符串条件必选该组网络资源模型归属对象类，详细定义请见OMC北向接口数据规范-XX资源数据分册。如：EutranCellTDD、InventoryUnitRru、EthernetPort等。核心网专业该字段必选。7.3 数据格式无线、传播、IP专业OMC性能测量文献必要采用CSV格式（竖线分隔）。规定无线专业同一种空间粒度测量项必要在同一PM文献中。核心网OMC性能测量文献优先采用CSV格式（竖线分隔），可以采用XML格式。给定一种网元类型，有两种文献组织

27、_Cause），有两种解决方案：方案一：该空间粒度每类伪子测量单独存储一种文献。文献命名在文献名规则“网元子类”某些增长伪子测量标记，-网元子类_子测量类型-登录顾客名-Ri-记录周期-.如PM-ENB-EUTRANCELLTDD_CAUSE-01-V1.1.0-15-001.csv.zip；该文献列除资源对象标记和时间外，涉及伪子测量标记（._背面某些）和所有该类型伪子测量指标。详细见样例“数据样例（伪子测量）”。数据样例（伪子测量）：TimeStamp=-06-11 05:08:00|TimeZone=UTC+8|Period=15|VendorName=ZTE|ElementType=E

28、NB|PmVersion=V2.6.0rmUID|Dn|UserLabel|startTime|Cause|RRC.AttConnEstab._Cause|RRC.SuccConnEstab._Cause|RRC.SuccConnReestab._Cause1301HWWX2CELA12ZA1|ZTE-CMZJ-TZ,SubNetwork=ltetdd18,ManagedElement=ENODEBME747785,EnbFunction=747785,EutranCellTdd=1|589832|-06-11 10:00:00|12345|2|2|2其中Cause就是伪子测量类型标记，背面都

29、是带有._Cause指标名。由于不同Cause指标记录对象也许不同，因此也许存在某些指标列为空状况，例如：1301HWWX2CELA12ZA1|ENODEB1|-06-11 10:00:00|12345|1|2方案二：空间粒度每类伪子测量项和普通测量项在同一种文献中上报。文献命名规则参见5.2章节，样例：PM-ENB-EUTRANCELLTDD-01-V1.1.0-15-001.csv.zip。当前，TD-LTE eNB记录数据规范中有3类伪子测量，测量命名规则及扩展办法分别为： 1）._Qci相应子测量项，命名为“19数字，并可递加扩展，如ENBHB01每QCI平均E-RAB数子项名称为ER

30、AB.NbrMeanEstab.1ERAB.NbrMeanEstab.9；因而，._Qci相应子测量项可以所有展开成测量名称.1测量名称.9，数量固定。 2）._Cause相应子测量项，命名为英文字母开头字符串（仅由大小写字母、数字和“_”构成），例如为3GPP或厂家私有因素英文字符串缩写（不含空格）；._Cause可以所有展开成测量名称.字符串。但对于不同测量._Cause，其因素数量是不同，并且在不同厂家间，数量也是不同。3）._PRB相应子测量项，命名为英文字母或数字开头字符串（仅由大小写字母、数字和“_”构成）；._PRB，可以所有展开成测量名称.0测量名称.99，数量固定。数据样例（伪子测量）：TimeStamp=-06-16 10:54:56|TimeZone=UTC+8|Period=15|VendorName=Huawei|ElementType=ENB|PmVersion=V2.6.0rmUID|Dn|UserLabel|startTime|C

展开阅读全文