OMC系统北向接口通用技术规范V100.docx

1、OMC系统北向接口通用技术规范V100中国移动通信企业标准QB-XX-XXX-XXXXOMC北向接口通用技术规范NorthboundInterfaceGeneral Technology Specification for OMC版本号 1.0.02016-10-24发布 2016-10-24实施中国移动通信集团公司发布目录1 范围 52 规范性引用文件 53 缩略语 54 接口架构 55 通用技术约定 65.1 公共要求 65.2 FTP通用要求 66 资源数据接口 86.1 接口协议 86.2 接口数据 96.3 数据格式 96.4 技术指标 127 性能数据接口 137.1 接口协议 1

2、37.2 接口数据 137.3 数据格式 137.4 技术指标 148 告警数据接口 148.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 编制历史

3、 25前言本标准由中国移动通信集团公司网络部提出并归口。本标准起草单位：中国移动通信集团公司网络部。本标准主要起草人：刘立卫、刘云霞、李健、肖捷、陈丹、高建军、张凤桥。本标准解释单位：中国移动通信集团公司网络部。本标准由中国移动通信集团公司XXX号文发布。1 范围本规范给出了中国移动OMC系统北向接口的通用技术要求，适用于无线网、核心网、传输网和IP网四个专业，适用于新建OMC系统以及现网OMC系统改造。本规范适用于中国移动OMC系统北向接口的设计和实现，是中国移动OMC系统提供商必须遵循的指导性文件。本规范是中国移动各级运营单位进行OMC系统的招标采购、工程设计、网络运营、管理、维护、检查和

4、验收等方面的技术依据。2 规范性引用文件下列文件中的条款通过本标准的引用而成为本标准的条款。凡注日期的引用文件，其随后所有的修改单（不包括勘误的内容）或修订版均不适用于本标准，然而，鼓励根据本标准达成协议的各方研究是否可使用这些文件的最新版本。凡不注日期的引用文件，其最新版本适用于本标准。序号文档名称文档来源01OMC系统功能规范中国移动通信集团公司02OMC系统通用技术规范中国移动通信集团公司03OMC系统北向接口数据规范中国移动通信集团公司3 缩略语英文缩写英文全称中文解释OMCOperations &Maintenance Center操作维护中心NMSNetwork Managemen

5、t System网络管理系统NENet Element网元rmUIDResource ManagementUniversal Identifier网络资源对象的全网唯一标识MTBFMean Time Between Failure平均故障间隔时间MTTRMean Time To Repair平均修复时间4 接口架构OMC北向接口是OMC系统与网络管理系统（NMS）间的接口，分为上行接口和下行接口。上行接口指从OMC到NMS的接口，下行接口指从NMS到OMC的接口。接口总体架构如下：接口说明：1、资源数据接口：数据量相对较小，周期性单向传送，数据时延要求较低。2、性能数据接口：数据量相对较大，周

6、期性单向传送，数据时延要求一般。3、告警数据接口：单条信息数据量较小、总体数据量较大，要求数据实时传送。4、操作指令接口：网络设备的操作指令通道接口，为上层网管提供下行指令通道，并反馈操作指令返回结果，数据量相对较小，实时性要求较高。5 通用技术约定5.1 公共要求1、 时间同步OMC北向接口服务器必须采用当地标准时间，中国大陆地区采用UTC+8（北京标准时间）。接口服务器使用OMC系统的时间同步服务器或公共的时间同步服务器。2、 编码方式所有消息和文件的数据编码采用UTF-8（No BOM）编码方式。3、 数据时间格式如无特殊说明，时间类字段数据格式均为：“YYYY-MM-DD HH24:m

7、m:ss”。5.2 FTP通用要求1、 服务端与客户端OMC提供可以获取资源、告警和性能数据的FTP server，NMS为 FTP client。OMC系统将数据文件放到FTP server上，NMS自行采集数据文件。2、 安全性要求通过授权的用户名、密码信息才能够访问FTP服务器。3、 目录规则目录结构：/FTP根目录/省简称/专业简称/厂家编码/OMC名称/数据类别/日期或时间/示例：资源目录：/ftproot/GD/WX/HW/GZ_OMC2/CM/20150611/性能目录：/ftproot/GD/WX/HW/GZ_OMC2/PM/2015061101/告警目录：/ftproot/G

8、D/WX/HW/GZ_OMC2/FM/20150611/1） FTP根目录：OMC厂家自定义的ftp根目录。2） 省份简称、专业简称、厂家编码、数据类别：参见OMC北向接口数据规范-公共数据分册。3） 日期或时间：资源、告警数据按天存放，格式为YYYYMMDD；性能数据按小时存放，格式为YYYYMMDDHH24，小时数为性能数据统计起始时间。4、 文件命名规则1) 文件名字符：英文字母全部大写，不允许有中文字符。2) 文件命名规则：-网元子类-登录用户名-Ri-统计周期-序列号.3) 网元类型：资源、性能数据为网元类型，如MME、ENB、PTN、PON等；告警数据为“OMC”。4) 网元子类：

9、无线网、核心网的资源、性能数据的网元子类为资源数据、性能数据规范定义的空间粒度名称，如：EutranCellTDD、InventoryUnitRru、EthernetPort等；告警数据无此项。传输网的资源、性能数据的资源对象类名，填写资源对象简称，如：隧道（TNL）、标签交换（LBS）。资源对象简称参见OMC北向接口数据规范-XX资源数据分册或OMC北向接口数据规范-XX性能数据分册。IP网数据无此项，核心网的资源、性能数据该项可选。5) 主机编号：两位，每1位可用0-9、A-Z编码。6) 数据版本：遵循接口数据规范规范版本，允许同一目录下存放不同版本的数据文件。7) 数据时间：采用YYYY

10、MMDDHH24MMSS格式。资源、告警数据为数据文件开始生成时间，其中资源数据文件开始生成时间指0点或12点；性能数据为统计周期的起始时间。8) 登录用户名：仅在告警文件同步时使用。用以解决多个NMS同时对同一个OMC发起告警文件同步请求，生成的同步文件名冲突的问题。9) Ri：可选。当接口数据文件内容有误（如数据缺失等）时，OMC重新生成文件提供给NMS进行数据补采，新文件在原文件名后增加”Ri”进行标识，i从1开始，每重新生成一次i加1。10) 统计周期：两位，取值范围为00-99，仅针对性能数据文件，统计周期的分钟数，如05、15、60。资源、告警数据文件无此项。11) 序列号：当文件

11、总量小于100MB(允许上下浮动10%)时，应只形成一个文件；当文件总量大于100MB(允许上下浮动10%)时要求进行文件分割，即分割后的文件大小（除最后一个）均应介于（90MB,110MB）之间。分割后的文件增加序列号标识，序列号为三位，取值为001-999。在文件切分过程中，不能把资源、性能或告警的一条完整的记录切开放到两个文件中。12) 后缀：每个文件都进行压缩，统一采用zip或gzip压缩，压缩文件后缀是zip或gz。13) 文件名样例资源文件：CM-ENB-EUTRANCELLTDD-A1-V1.1.0-20151227000000-001.xml.zip性能文件：PM-ENB-EU

12、TRANCELLTDD-01-V1.1.0-20151227000000-15-001.csv.zip告警文件：FM-OMC-1A-V1.1.0-20150611011603-001.txt.zip对于设备厂家北向接口上报的私有参数文件，在数据版本前增加ALL字样，其他字段要求保持不变。样例：性能文件：PM-ENB-EUTRANCELLTDD-01-ALLV1.1.0-20151227000000-15-001.csv.zip5、 文件生成过程标识文件生成过程中，文件名后缀增加“.tmp”标识，该文件全部生成完成后，去掉“.tmp”标识，以确保NMS获取到的北向数据文件是完整的。对于在数据规范

13、中定义的一个单一接口文件，如果由于文件过大拆分或分布式处理，形成多个文件的，要求在该批次文件全部生成完成后，去掉“.tmp”标识。6 资源数据接口6.1 接口协议接口协议：采用SFTP或者FTP协议。数据周期：无线网、核心网、传输网和IP网四个专业每12小时生成一次，即每天0点和12点启动，基于OMC配置数据库中的数据信息生成一套最新的全量资源文件。智能家庭网关的终端管理平台的资源数据周期为每24小时生成一次，即每天0点启动，基于OMC配置数据库中的数据信息生成一套最新的全量资源文件。6.2 接口数据接口数据含公共信息和业务数据。业务数据字段参见相关数据规范。公共信息如下：No字段名称英文名称

14、数据类型取值或说明1. 数据生成时间TimeStamp时间开始生成数据文件的时间戳。2. 时区TimeZone字符串时区信息，如：北京时间为“UTC+8”。3. 生成这个网络资源模型文件的OMC的设备供应商VendorName字符串字符串，取值长度不大于64个字节，不限制字符类型。通过该属性取值应可明确识别厂商名称4. 网元类型ElementType字符串如MME、ENB、PTN、PON5. 资源数据版本CmVersion字符串资源数据版本6. 网络资源对象的全网唯一标识rmUID字符串网络资源对象的全网唯一标识，具体定义请见OMC系统北向接口数据规范-公共数据分册V1.0.07. 网元标识D

15、n字符串无线、核心网专业该字段必选，传输、IP专业无该字段8. 用户友好名UserLabel字符串无线、核心网专业该字段必选，传输、IP专业无该字段9. 网络资源类别名称ObjectType字符串该组网络资源模型归属的对象类，具体定义请见OMC北向接口数据规范-XX资源数据分册。如：EutranCellTDD、InventoryUnitRru、EthernetPort等。核心网专业该字段必选。6.3 数据格式资源数据文件采用XML格式。给定一个网元类型，有两种文件组织方式：（1）同一个空间粒度的资源数据在同一数据文件中；（2）对所有的空间粒度，启用一个CM文件存储其资源数据。核心网专业优选文件

16、组织方案（2）。XML文件格式要求如下。1、标签说明标签名称要求说明dataFile必须数据文件fileHeader必须文件头FiledName必须网元对象的参数集合Object必须网元N必须网元对象参数集合中每个参数名称V有条件网元的参数取值，值的个数要与参数的个数相同2、xml标签属性属性名称解释要求类型和取值说明version版本必须字符串，取值为：1.0encoding字符集必须字符串，取值为：UTF-83、fileHeader标签属性属性名称解释要求类型和取值说明TimeStamp数据生成时间必选时间格式，YYYY-MM-DDTHH24:mm:ssTimeZone时区必选时区信息，如

17、：北京时间为“UTC+8”。VendorName生成这个网络资源模型文件的OMC的设备供应商必选字符串，取值长度不大于64个字节，不限制字符类型。通过该属性取值应可明确识别厂商名称ElementType网元类型必选字符串，如MME、ENB、PTN、PONCmVersion资源数据版本必选字符串，资源数据版本4、object标签属性属性名称解释要求类型和取值说明rmUID网络资源对象的全网唯一标识必须字符串DnDistinguished Name，识别名无线、核心网专业该字段必选，传输、IP专业无该字段字符串UserLabel用户友好名无线、核心网专业该字段必选，传输、IP专业无该字段字符串5、

18、v标签属性属性名称解释要求类型和取值说明i属性序列号必须整型，网元参数名和参数值相对应的序列号，从1开始编号对于传输专业（PTN、PON等），rmUID字段不重复写在v标签中（写在object标签中）。6、Xml数据文件Schema定义 7、数据样例PTN资源文件样例： 2015-01-12T04:01:06 UTC+8huaweiPTNV1.0.0nativeNamevendorequipmemtDomainMAS-U2000-1-PFHPTNMAS-U2000-2-PFHPTN核心网专业资源文件样例： 2016-04-18T05:00:04 UTC+8 ZTE MME V1.3.0 EthernetPort PortId UserLabel PortRate