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

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

《OMC系统北向接口通用技术规范V100.docx》由会员分享，可在线阅读，更多相关《OMC系统北向接口通用技术规范V100.docx（51页珍藏版）》请在冰豆网上搜索。

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

中国移动通信企业标准

QB-XX-XXX-XXXX

OMC北向接口通用技术规范

NorthboundInterfaceGeneralTechnologySpecificationforOMC

版本号1.0.0

2016-10-24发布2016-10-24实施

中国移动通信集团公司发布

目录

1范围5

2规范性引用文件5

3缩略语5

4接口架构5

5通用技术约定6

5.1公共要求6

5.2FTP通用要求6

6资源数据接口8

6.1接口协议8

6.2接口数据9

6.3数据格式9

6.4技术指标12

7性能数据接口13

7.1接口协议13

7.2接口数据13

7.3数据格式13

7.4技术指标14

8告警数据接口14

8.1接口协议14

8.2通信过程15

8.2.1消息方式的实时告警流水15

8.2.2文件方式的批量告警同步16

8.3消息数据18

8.3.1消息格式18

8.3.2登录与登录响应19

8.3.3消息方式同步告警请求与响应20

8.3.4文件方式同步告警请求与响应21

8.3.5心跳请求与响应22

8.3.6关闭连接通知22

8.3.7实时告警上报23

8.4文件数据23

8.5技术指标24

9操作指令接口24

10接口日志25

11接口可靠性要求25

12编制历史25

前言

本标准由中国移动通信集团公司网络部提出并归口。

本标准起草单位：

中国移动通信集团公司网络部。

本标准主要起草人：

刘立卫、刘云霞、李健、肖捷、陈丹、高建军、张凤桥。

本标准解释单位：

中国移动通信集团公司网络部。

本标准由中国移动通信集团公司XXX号文发布。

1范围

本规范给出了中国移动OMC系统北向接口的通用技术要求，适用于无线网、核心网、传输网和IP网四个专业，适用于新建OMC系统以及现网OMC系统改造。

本规范适用于中国移动OMC系统北向接口的设计和实现，是中国移动OMC系统提供商必须遵循的指导性文件。

本规范是中国移动各级运营单位进行OMC系统的招标采购、工程设计、网络运营、管理、维护、检查和验收等方面的技术依据。

2规范性引用文件

下列文件中的条款通过本标准的引用而成为本标准的条款。

凡注日期的引用文件，其随后所有的修改单（不包括勘误的内容）或修订版均不适用于本标准，然而，鼓励根据本标准达成协议的各方研究是否可使用这些文件的最新版本。

凡不注日期的引用文件，其最新版本适用于本标准。

序号

文档名称

文档来源

[01]

OMC系统功能规范

中国移动通信集团公司

[02]

OMC系统通用技术规范

中国移动通信集团公司

[03]

OMC系统北向接口数据规范

中国移动通信集团公司

3缩略语

英文缩写

英文全称

中文解释

OMC

Operations&MaintenanceCenter

操作维护中心

NMS

NetworkManagementSystem

网络管理系统

NE

NetElement

网元

rmUID

ResourceManagementUniversalIdentifier

网络资源对象的全网唯一标识

MTBF

MeanTimeBetweenFailure

平均故障间隔时间

MTTR

MeanTimeToRepair

平均修复时间

4接口架构

OMC北向接口是OMC系统与网络管理系统（NMS）间的接口，分为上行接口和下行接口。

上行接口指从OMC到NMS的接口，下行接口指从NMS到OMC的接口。

接口总体架构如下：

接口说明：

1、资源数据接口：

数据量相对较小，周期性单向传送，数据时延要求较低。

2、性能数据接口：

数据量相对较大，周期性单向传送，数据时延要求一般。

3、告警数据接口：

单条信息数据量较小、总体数据量较大，要求数据实时传送。

4、操作指令接口：

网络设备的操作指令通道接口，为上层网管提供下行指令通道，并反馈操作指令返回结果，数据量相对较小，实时性要求较高。

5通用技术约定

5.1公共要求

1、时间同步

OMC北向接口服务器必须采用当地标准时间，中国大陆地区采用UTC+8（北京标准时间）。

接口服务器使用OMC系统的时间同步服务器或公共的时间同步服务器。

2、编码方式

所有消息和文件的数据编码采用UTF-8（NoBOM）编码方式。

3、数据时间格式

如无特殊说明，时间类字段数据格式均为：

“YYYY-MM-DDHH24:

mm:

ss”。

5.2FTP通用要求

1、服务端与客户端

OMC提供可以获取资源、告警和性能数据的FTPserver，NMS为FTPclient。

OMC系统将数据文件放到FTPserver上，NMS自行采集数据文件。

2、安全性要求

通过授权的用户名、密码信息才能够访问FTP服务器。

3、目录规则

目录结构：

/FTP根目录/省简称/专业简称/厂家编码/OMC名称/数据类别/日期或时间/

示例：

资源目录：

/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）省份简称、专业简称、厂家编码、数据类别：

参见《OMC北向接口数据规范-公共数据分册》。

3）日期或时间：

资源、告警数据按天存放，格式为YYYYMMDD；性能数据按小时存放，格式为YYYYMMDDHH24，小时数为性能数据统计起始时间。

4、文件命名规则

1）文件名字符：

英文字母全部大写，不允许有中文字符。

2）文件命名规则：

<数据类别>-<网元类型>[-网元子类]-<主机编号>-<数据版本>-<数据时间>[-登录用户名][-Ri][-统计周期][-序列号].<后缀>

3）网元类型：

资源、性能数据为网元类型，如MME、ENB、PTN、PON等；告警数据为“OMC”。

4）网元子类：

无线网、核心网的资源、性能数据的网元子类为资源数据、性能数据规范定义的空间粒度名称，如：

EutranCellTDD、InventoryUnitRru、EthernetPort等；告警数据无此项。

传输网的资源、性能数据的资源对象类名，填写资源对象简称，如：

隧道（TNL）、标签交换（LBS）。

资源对象简称参见《OMC北向接口数据规范-XX资源数据分册》或《OMC北向接口数据规范-XX性能数据分册》。

IP网数据无此项，核心网的资源、性能数据该项可选。

5）主机编号：

两位，每1位可用0-9、A-Z编码。

6）数据版本：

遵循接口数据规范规范版本，允许同一目录下存放不同版本的数据文件。

7）数据时间：

采用YYYYMMDDHH24MMSS格式。

资源、告警数据为数据文件开始生成时间，其中资源数据文件开始生成时间指0点或12点；性能数据为统计周期的起始时间。

8）登录用户名：

仅在告警文件同步时使用。

用以解决多个NMS同时对同一个OMC发起告警文件同步请求，生成的同步文件名冲突的问题。

9）Ri：

可选。

当接口数据文件内容有误（如数据缺失等）时，OMC重新生成文件提供给NMS进行数据补采，新文件在原文件名后增加”Ri”进行标识，i从1开始，每重新生成一次i加1。

10）统计周期：

两位，取值范围为00-99，仅针对性能数据文件，统计周期的分钟数，如05、15、60。

资源、告警数据文件无此项。

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-EUTRANCELLTDD-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.zip

5、文件生成过程标识

文件生成过程中，文件名后缀增加“.tmp”标识，该文件全部生成完成后，去掉“.tmp”标识，以确保NMS获取到的北向数据文件是完整的。

对于在数据规范中定义的一个单一接口文件，如果由于文件过大拆分或分布式处理，形成多个文件的，要求在该批次文件全部生成完成后，去掉“.tmp”标识。

6资源数据接口

6.1接口协议

接口协议：

采用SFTP或者FTP协议。

数据周期：

无线网、核心网、传输网和IP网四个专业每12小时生成一次，即每天0点和12点启动，基于OMC配置数据库中的数据信息生成一套最新的全量资源文件。

智能家庭网关的终端管理平台的资源数据周期为每24小时生成一次，即每天0点启动，基于OMC配置数据库中的数据信息生成一套最新的全量资源文件。

6.2接口数据

接口数据含公共信息和业务数据。

业务数据字段参见相关数据规范。

公共信息如下：

No

字段名称

英文名称

数据类型

取值或说明

1.

数据生成时间

TimeStamp

时间

开始生成数据文件的时间戳。

2.

时区

TimeZone

字符串

时区信息，如：

北京时间为“UTC+8”。

3.

生成这个网络资源模型文件的OMC的设备供应商

VendorName

字符串

字符串，取值长度不大于64个字节，不限制字符类型。

通过该属性取值应可明确识别厂商名称

4.

网元类型

ElementType

字符串

如MME、ENB、PTN、PON

5.

资源数据版本

CmVersion

字符串

资源数据版本

6.

网络资源对象的全网唯一标识

rmUID

字符串

网络资源对象的全网唯一标识，具体定义请见《OMC系统北向接口数据规范-公共数据分册V1.0.0》

7.

网元标识

Dn

字符串

无线、核心网专业该字段必选，传输、IP专业无该字段

8.

用户友好名

UserLabel

字符串

无线、核心网专业该字段必选，传输、IP专业无该字段

9.

网络资源类别名称

ObjectType

字符串

该组网络资源模型归属的对象类，具体定义请见《OMC北向接口数据规范-XX资源数据分册》。

如：

EutranCellTDD、InventoryUnitRru、EthernetPort等。

核心网专业该字段必选。

6.3数据格式

资源数据文件采用XML格式。

给定一个网元类型，有两种文件组织方式：

（1）同一个空间粒度的资源数据在同一数据文件中；

（2）对所有的空间粒度，启用一个CM文件存储其资源数据。

核心网专业优选文件组织方案

（2）。

XML文件格式要求如下。

1、标签说明

标签名称

要求

说明

dataFile

必须

数据文件

fileHeader

必须

文件头

FiledName

必须

网元对象的参数集合

Object

必须

网元

N

必须

网元对象参数集合中每个参数名称

V

有条件

网元的参数取值，值的个数要与参数的个数相同

2、xml标签属性

属性名称

解释

要求

类型和取值说明

version

版本

必须

字符串，取值为：

"1.0"

encoding

字符集

必须

字符串，取值为：

"UTF-8"

3、fileHeader标签属性

属性名称

解释

要求

类型和取值说明

TimeStamp

数据生成时间

必选

时间格式，YYYY-MM-DDTHH24:

mm:

ss

TimeZone

时区

必选

时区信息，如：

北京时间为“UTC+8”。

VendorName

生成这个网络资源模型文件的OMC的设备供应商

必选

字符串，取值长度不大于64个字节，不限制字符类型。

通过该属性取值应可明确识别厂商名称

ElementType

网元类型

必选

字符串，如MME、ENB、PTN、PON

CmVersion

资源数据版本

必选

字符串，资源数据版本

4、object标签属性

属性名称

解释

要求

类型和取值说明

rmUID

网络资源对象的全网唯一标识

必须

字符串

Dn

DistinguishedName，识别名

无线、核心网专业该字段必选，传输、IP专业无该字段

字符串

UserLabel

用户友好名

无线、核心网专业该字段必选，传输、IP专业无该字段

字符串

5、v标签属性

属性名称

解释

要求

类型和取值说明

i

属性序列号

必须

整型，网元参数名和参数值相对应的序列号，从1开始编号

对于传输专业（PTN、PON等），rmUID字段不重复写在v标签中（写在object标签中）。

6、Xml数据文件Schema定义

xmlversion="1.0"encoding="UTF-8"?

>

schemaxmlns:

xs="http:

//www.w3.org/2001/XMLSchema"

xmlns:

xsi="http:

//www.w3.org/2001/XMLSchema-instance"

elementFormDefault="qualified"attributeFormDefault="unqualified">

elementname="DataFile">

complexType>

sequence>

elementname="FileHeader">

complexType>

sequence>

elementname="TimeStamp"type="xs:

dateTime"/>

elementname="TimeZone"type="xs:

string"/>

elementname="VendorName"type="xs:

string"

minOccurs="0"/>

elementname="ElementType"type="xs:

string"

minOccurs="0"/>

elementname="CmVersion"type="xs:

string"

minOccurs="0"/>

sequence>

complexType>

element>

elementname="Objects"maxOccurs="unbounded">

complexType>

sequence>

elementname="ObjectType"type="xs:

string"minOccurs="0"/>

--核心网专业，该字段必选-->

elementname="FieldName">

complexType>

sequenceminOccurs="0"maxOccurs="unbounded">

elementname="N">

complexType>

simpleContent>

extensionbase="xs:

string">

attributename="i"type="xs:

integer"use="required"/>

extension>

simpleContent>

complexType>

element>

sequence>

complexType>

element>

elementname="FieldValue">

complexType>

sequenceminOccurs="0"maxOccurs="unbounded">

elementname="Object">

complexType>

sequenceminOccurs="0"maxOccurs="unbounded">

elementname="V">

complexType>

simpleContent>

extensionbase="xs:

string">

attributename="i"type="xs:

integer"use="required"/>

extension>

simpleContent>

complexType>

element>

sequence>

attributename="rmUID"type="xs:

string"

use="required"/>

attributename="Dn"type="xs:

string"/>

--//无线、核心网专业该字段必选，传输、IP专业无该字段-->

attributename="UserLabel"type="xs:

string"/>

--//无线、核心网专业该字段必选，传输、IP专业无该字段-->

complexType>

element>

sequence>

complexType>

element>

sequence>

complexType>

element>

sequence>

complexType>

element>

schema>

7、数据样例

PTN资源文件样例：

xmlversion="1.0"encoding="UTF-8"?

>

xsi=http:

//www.w3.org/2001/XMLSchema-instancexsi:

noNamespaceSchemaLocation="file:

///C:

/Users/Administrator/Desktop/schema.xsd">

2015-01-12T04:

01:

06

UTC+8

huaweiPTN

V1.0.0

nativeName

vendor

equipmemtDomain

MAS-U2000-1-P

FH

PTN

MAS-U2000-2-P

FH

PTN

核心网专业资源文件样例：

xmlversion="1.0"encoding="UTF-8"?

>

xsi="http:

//www.w3.org/2001/XMLSchema-instance"

xsi:

noNamespaceSchemaLocation="file:

///C:

/Users/Administrator/Desktop/schema.xsd">

2016-04-18T05:

00:

04

UTC+8

ZTE

MME

V1.3.0

EthernetPort

PortId

UserLabel

PortRate