OMC系统北向接口通用技术规范V1.0.0

更新时间:2023-03-18 02:50:01 阅读量: 综合文库 文档下载

说明:文章内容仅供预览,部分内容可能不全。下载后的文档,内容与下面显示的完全一致。下载之前请确认下面内容是否您想要的,是否完整无缺。

中国移动通信企业标准

QB-XX-XXX-XXXX

OMC北向接口通用技术规范

NorthboundInterfaceGeneral Technology Specification for OMC

版本号 1.0.0

2016-10-24发布

2016-10-24实施

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

QB-XX-XXX-XXXX

目录

1 2 3 4 5

范围 ......................................................................................................................................................... 5 规范性引用文件 ..................................................................................................................................... 5 缩略语 ..................................................................................................................................................... 5 接口架构 ................................................................................................................................................. 5 通用技术约定 ......................................................................................................................................... 6 5.1 5.2 6

公共要求 ................................................................................................................................. 6 FTP通用要求 ......................................................................................................................... 6

资源数据接口 ......................................................................................................................................... 9 6.1 6.2 6.3 6.4

接口协议 ................................................................................................................................. 9 接口数据 ................................................................................................................................. 9 数据格式 ............................................................................................................................... 10 技术指标 ............................................................................................................................... 16

7 性能数据接口 ....................................................................................................................................... 16 7.1 7.2 7.3 7.4

接口协议 ............................................................................................................................... 16 接口数据 ............................................................................................................................... 16 数据格式 ............................................................................................................................... 17 技术指标 ............................................................................................................................... 24

8 告警数据接口 ....................................................................................................................................... 24 8.1 8.2

8.2.1 8.2.2

接口协议 ............................................................................................................................... 24 通信过程 ............................................................................................................................... 25

消息方式的实时告警流水 ................................................................................................................. 25 文件方式的批量告警同步 ................................................................................................................. 26

8.3

8.3.1 8.3.2 8.3.3 8.3.4 8.3.5 8.3.6

消息数据 ............................................................................................................................... 28

消息格式 ............................................................................................................................................. 28 登录与登录响应 ................................................................................................................................. 29 消息方式同步告警请求与响应 ......................................................................................................... 30 文件方式同步告警请求与响应 ......................................................................................................... 31 心跳请求与响应 ................................................................................................................................. 32 关闭连接通知 ..................................................................................................................................... 33

2/ 36

QB-XX-XXX-XXXX

8.3.7 实时告警上报 ..................................................................................................................................... 33

8.4 8.5 9

文件数据 ............................................................................................................................... 34 技术指标 ............................................................................................................................... 34

操作指令接口 ....................................................................................................................................... 35

10 接口日志 ............................................................................................................................................... 36 11 接口可靠性要求 ................................................................................................................................... 36 12 编制历史 ............................................................................................................................................... 36

3/ 36

QB-XX-XXX-XXXX

前言

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

本标准主要起草人:刘立卫、刘云霞、李健、肖捷、陈丹、高建军、张凤桥。 本标准解释单位:中国移动通信集团公司网络部。 本标准由中国移动通信集团公司XXX号文发布。

4/ 36

QB-XX-XXX-XXXX

1 范围

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

本规范适用于中国移动OMC系统北向接口的设计和实现,是中国移动OMC系统提供商必须遵循的指导性文件。本规范是中国移动各级运营单位进行OMC系统的招标采购、工程设计、网络运营、管理、维护、检查和验收等方面的技术依据。 2 规范性引用文件

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

序号 [01] [02] [03] 文档名称 OMC系统功能规范 OMC系统通用技术规范 OMC系统北向接口数据规范 文档来源 中国移动通信集团公司 中国移动通信集团公司 中国移动通信集团公司 3 缩略语

英文缩写 OMC NMS NE rmUID MTBF MTTR 英文全称 Operations &Maintenance Center Network Management System Net Element Resource ManagementUniversal Identifier Mean Time Between Failure Mean Time To Repair 中文解释 操作维护中心 网络管理系统 网元 网络资源对象的全网唯一标识 平均故障间隔时间 平均修复时间 4 接口架构

OMC北向接口是OMC系统与网络管理系统(NMS)间的接口,分为上行接口和下行接口。上行接口指从OMC到NMS的接口,下行接口指从NMS到OMC的接口。

接口总体架构如下:

5/ 36

QB-XX-XXX-XXXX

接口说明:

1、资源数据接口:数据量相对较小,周期性单向传送,数据时延要求较低。 2、性能数据接口:数据量相对较大,周期性单向传送,数据时延要求一般。 3、告警数据接口:单条信息数据量较小、总体数据量较大,要求数据实时传送。 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、 服务端与客户端

6/ 36

QB-XX-XXX-XXXX

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/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网数据无

7/ 36

QB-XX-XXX-XXXX

此项,核心网的资源、性能数据该项可选。 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、 文件生成过程标识

8/ 36

QB-XX-XXX-XXXX

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

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

接口协议:采用SFTP或者FTP协议。

数据周期:无线网、核心网、传输网和IP网四个专业每12小时生成一次,即每天0点和12点启动,基于OMC配置数据库中的数据信息生成一套最新的全量资源文件。智能家庭网关的终端管理平台的资源数据周期为每24小时生成一次,即每天0点启动,基于OMC配置数据库中的数据信息生成一套最新的全量资源文件。 6.2 接口数据

接口数据含公共信息和业务数据。业务数据字段参见相关数据规范。公共信息如下:

No 字段名称 英文名称 数据类型 取值或说明 时间 字符串 开始生成数据文件的时间戳。 时区信息,如:北京时间为“UTC+8”。 字符串,取值长度不大于64个字节,不限制字符类型。通过该属性取值应可明确识别厂商名称 如MME、ENB、PTN、PON 资源数据版本 网络资源对象的全网唯一标识,具体定义请见《OMC系统北向接口数据规范-公共数据分册V1.0.0》 无线、核心网专业该字段必选,传输、IP专业无该字段 无线、核心网专业该字段必选,传输、IP专业无该字段 1. 数据生成时间 TimeStamp 2. 时区 生成这个网络资源模型文件3. 的OMC的设备供应商 4. 网元类型 TimeZone VendorName 字符串 ElementType 字符串 字符串 字符串 5. 资源数据版本 CmVersion 6. 网络资源对象的全网唯一标识 7. 网元标识 8. 用户友好名 rmUID Dn UserLabel 字符串 字符串 9/ 36

QB-XX-XXX-XXXX

ObjectType 字符串 9. 网络资源类别名称 该组网络资源模型归属的对象类,具体定义请见《OMC北向接口数据规范-XX资源数据分册》。如:EutranCellTDD、InventoryUnitRru、EthernetPort等。 核心网专业该字段必选。 6.3 数据格式

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

给定一个网元类型,有两种文件组织方式:(1)同一个空间粒度的资源数据在同一数据文件中;(2)对所有的空间粒度,启用一个CM文件存储其资源数据。核心网专业优选文件组织方案(2)。

XML文件格式要求如下。

1、标签说明

标签名称 dataFile fileHeader FiledName Object N V 要求 必须 必须 必须 必须 必须 有条件 说明 数据文件 文件头 网元对象的参数集合 网元 网元对象参数集合中每个参数名称 网元的参数取值,值的个数要与参数的个数相同 2、xml标签属性

10/ 36

QB-XX-XXX-XXXX

属性名称 version encoding 解释 版本 字符集 要求 必须 必须 类型和取值说明 字符串,取值为:\字符串,取值为:\3、fileHeader标签属性

属性名称 TimeStamp TimeZone VendorName 解释 数据生成时间 时区 生成这个网络资源模型文件的OMC的设备供应商 要求 必选 必选 必选 类型和取值说明 时间格式,YYYY-MM-DDTHH24:mm:ss 时区信息,如:北京时间为“UTC+8”。 字符串,取值长度不大于64个字节,不限制字符类型。通过该属性取值应可明确识别厂商名称 字符串,如MME、ENB、PTN、PON 字符串,资源数据版本 ElementType 网元类型 CmVersion 资源数据版本 必选 必选 4、object标签属性

属性名称 rmUID Dn UserLabel 解释 网络资源对象的全网唯一标识 要求 必须 类型和取值说明 字符串 Distinguished Name,无线、核心网专业该字段必选,字符串 识别名 传输、IP专业无该字段 用户友好名 无线、核心网专业该字段必选,字符串 传输、IP专业无该字段 5、v标签属性

属性名称 i 解释 属性序列号 要求 必须 类型和取值说明 整型,网元参数名和参数值相对应的序列号,从1开始编号 对于传输专业(PTN、PON等),rmUID字段不重复写在v标签中(写在object标签中)。

6、Xml数据文件Schema定义

xmlns:xsi=\

elementFormDefault=\

11/ 36

QB-XX-XXX-XXXX

minOccurs=\minOccurs=\minOccurs=\

name=\

type=\

name=\

type=\

12/ 36

QB-XX-XXX-XXXX

minOccurs=\

maxOccurs=\

base=\

name=\

use=\

name=\

type=\

7、数据样例 PTN资源文件样例:

13/ 36

QB-XX-XXX-XXXX

e:///C:/Users/Administrator/Desktop/schema.xsd\

2015-01-12T04:01:06 UTC+8

huawei< ElementType>PTN V1.0.0

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

xsi:noNamespaceSchemaLocation=\

2016-04-18T05:00:04 UTC+8 ZTE MME

14/ 36

QB-XX-XXX-XXXX

V1.3.0

EthernetPort

rmUID=\214,ManagedElement=214,EthernetPort=214_65535_12_1\

rmUID=\214,ManagedElement=214,EthernetPort=214_65535_25_1\

15/ 36

QB-XX-XXX-XXXX

6.4 技术指标

No 指标名称 指标含义 接口必选字段个数/OMC系统内必选字段总个数*100% 接口B类字段个数/OMC系统内B类字段总个数*100% 接口记录数/OMC系统内记录数*100% 全量资源文件生成时延=文件完成生成的时间-文件开始生成的时间(文件开始生成的时间,这里指0点或12点) 性能数据、告警数据中资源对象的rmUID必须与资源数据的rmUID保持一致。数据一致的记录数量/总记录数量*100% 资源接口数据文件保存时长 支持ftp客户端多连接的数量 指标值 =100% ≥90% ≥99% ≤1小时 ≥99% ≥7天 ≥10个 1. 字段完整性 2. 记录完整性 3. 数据时延 4. 数据一致性 5. 数据存储时长 6. 并发连接数 7 性能数据接口 7.1 接口协议

接口协议:采用SFTP或者FTP协议。

数据周期:性能测量周期分为5分钟、15分钟、60分钟、24小时等。各专业各类设备性能测量周期的具体要求参见《OMC北向接口数据规范-性能数据分册》。 7.2 接口数据

接口数据含公共信息和业务数据。业务数据字段参见相关数据规范。公共信息如下:

No 字段名称 英文名称 数据类型 要求 取值或说明 时间 必选 开始生成数据文件的时间戳。XML格式文件中,格式为YYYY-MM-DDTHH24:mm:ss;CSV格式文件中,格式为YYYY-MM-DDHH24:mm:ss 数据生成TimeStamp 1. 时间 16/ 36

QB-XX-XXX-XXXX

2. 时区 3. 统计周期 TimeZone Period 字符串 数字 字符串 必选 时区信息,如:北京时间为“UTC+8”。 必选 测量统计周期的分钟数,如5、15、60等 4. OMC设备供VendorName 应商名 5. 网元类型 6. 性能数据版本 必选 生成这个网络资源模型文件的OMC的设备供应商。必选 必选 如MME、ENB、PTN、PON ElementType 字符串 PmVersion 字符串 字符串 必选 性能数据版本 必选 网络资源对象的全网唯一标识,具体定义请见《OMC系统北向接口数据规范-公共数据分册V1.0.0》 必选 无线、核心网专业该字段必选,传输、IP专业无该字段 必选 UserLabel字段的转义要求:用双引号字符''''封闭UserLabel字段的值,对UserLabel中出现的双引号字符用一对双引号字符表示。例如,UserLabel为北京|海淀,输出为\北京|海淀\,或者UserLabel北京\新建\,输出为\北京\新建\。无线、核心网专业该字段必选,传输、IP专业无该字段 性能数据统计周期的起始时间。XML格式文件中,格式为YYYY-MM-DDTHH24:mm:ss;CSV格式文件中,格式为YYYY-MM-DDHH24:mm:ss 该组网络资源模型归属的对象类,具体定义请见《OMC北向接口数据规范-XX资源数据分册》。如:EutranCellTDD、InventoryUnitRru、EthernetPort等。 核心网专业该字段必选。 7. 网络资源rmUID 对象的全网唯一标识 8. 网元标识 Dn 字符串 字符串 9. 用户友好UserLabel 名 10. 统计周期startTime 的起始时间 时间 必选 11. 网络资源ObjectType 字符串 类别名称 条件必选 。

7.3 数据格式

无线、传输、IP专业OMC性能测量文件必须采用CSV格式(竖线分隔)。要求无线专业同一个空间粒度的测量项必须在同一PM文件中。

核心网OMC性能测量文件采用XML格式。给定一个网元类型,有两种文件组织方式:(1)要求同一个空间粒度的测量项在同一数据文件中;(2)对所有的空间粒度的测量项,启用一个PM文件存储其测量结果数据。核心网专业优选文件组织方案(2)。

CSV格式(竖线分隔)要求:

17/ 36

QB-XX-XXX-XXXX

1、第一行数据是公共信息。

2、第二行数据是字段名称信息,每个字段用ASCII字符竖线“|”进行分隔。 3、第三行开始是具体数据,每条记录一行,每个数据项用ASCII字符竖线“|”分隔。

4、在每行的行尾不加分隔符“|” 数据样例(普通测量):

TimeStamp=2015-06-1105:08:00|TimeZone=UTC+8|Period=15|VendorName=ZTE|ElementType=ENB|PmVersion=V2.6.0

rmUID|Dn|UserLabel|startTime|ConnEstabAtt|ConnEstabSucc

1301HWWX2CELA12ZA1|ZTE-CMZJ-TZ,SubNetwork=ltetdd18,ManagedElement=ENODEBME747785,EnbFunction=747785,EutranCellTdd=1|''589832''|2015-06-1105:00:00|18|17

1301HWWX2CELA12Z45|ZTE-CMZJ-TZ,SubNetwork=ltetdd18,ManagedElement=ENODEBME747785,EnbFunction=747785,EutranCellTdd=2|''589833''|2015-06-1105:00:00|259|258

如果业务字段值为空,如VendorName值为空,则VendorName字段及值在CSV文件中为空,即TimeStamp=2015-06-11 05:08:00|TimeZone=UTC+8|Period=15||ElementType=ENB|PmVersion=V2.6.0

性能数据指标命名依据《OMC北向接口数据规范-性能数据分册》,文件划分也参照该规范,具体要求如下;

1) 同一个空间粒度的普通测量项存储在一个数据文件中;

2) 如果该空间粒度还含有一系列的伪子测量项(在性能数据分册中包含“._”的子测量项,如._Cause),有两种解决方案:

方案一:

该空间粒度的每类伪子测量单独存储一个文件。文件的命名在文件名规则的“网元子类”部分增加伪子测量的标识,

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

如PM-ENB-EUTRANCELLTDD_CAUSE-01-V1.1.0-20151227000000-15-001.csv.zip; 该文件列除资源对象标识和时间外,包括伪子测量的标识(._后面的部分)和所有该类型伪子测量指标。具体见样例“数据样例(伪子测量)”。

18/ 36

QB-XX-XXX-XXXX

数据样例(伪子测量):

TimeStamp=2015-06-1105:08:00|TimeZone=UTC+8|Period=15|VendorName=ZTE|ElementType=ENB|PmVersion=V2.6.0

rmUID|Dn|UserLabel|startTime|Cause|RRC.AttConnEstab._Cause|RRC.SuccConnEstab._Ca

use|RRC.SuccConnReestab._Cause

1301HWWX2CELA12ZA1|ZTE-CMZJ-TZ,SubNetwork=ltetdd18,ManagedElement=ENODEB

ME747785,EnbFunction=747785,EutranCellTdd=1|''589832''|2015-06-1110:00:00|12345|2|2|2

其中Cause就是伪子测量类型标识,后面都是带有._Cause的指标名。

因为不同Cause指标的统计对象可能不同,所以可能存在某些指标列为空的情况,比如:

1301HWWX2CELA12ZA1|ENODEB1|2015-06-11 10:00:00|12345||1|2 方案二:

空间粒度的每类伪子测量项和普通测量项在同一个文件中上报。文件命名规则参见5.2章节,样例:PM-ENB-EUTRANCELLTDD-01-V1.1.0-20151227000000-15-001.csv.zip。

目前,TD-LTE eNB统计数据规范中有3类伪子测量,测量命名规则及扩展方法分别为:

1)._Qci对应子测量项,命名为“1\~\数字,并可递加扩展,如ENBHB01每QCI平均E-RAB数子项的名称为ERAB.NbrMeanEstab.1~ERAB.NbrMeanEstab.9;因此,._Qci对应子测量项可以全部展开成测量名称.1~测量名称.9,数量固定。

2)._Cause对应子测量项,命名为英文字母开头的字符串(仅由大小写字母、数字和“_”组成),例如为3GPP或厂家私有原因英文字符串缩写(不含空格);._Cause可以全部展开成测量名称.字符串。但对于不同测量的._Cause,其原因数量是不同的,并且在不同厂家间,数量也是不同的。

3)._PRB对应子测量项,命名为英文字母或数字开头的字符串(仅由大小写字母、数字和“_”组成);._PRB,可以全部展开成测量名称.0~测量名称.99,数量固定。 数据样例(伪子测量):

TimeStamp=2016-06-16 10:54:56|TimeZone=UTC+8|Period=15|VendorName=Huawei|ElementType=ENB|PmVersion=V2.6.0

rmUID|Dn|UserLabel|startTime|CONTEXT.AttInitalSetup|CONTEXT.AttInitalSetup.Csfb|CONTEXT.AttMod|CONTEXT.AttMod.Csfb|CONTEXT.AttRelEnb|CONTEXT.AttRelEnb.CauseUserInactivity|CONTEXT.AttRelEnb.HOFailure|CONTEXT.AttRelEnb.Normal|CONTEXT.AttRelEnb.R

19/ 36

QB-XX-XXX-XXXX

NL|CONTEXT.AttRelEnb.UeLost|CONTEXT.AttRelMme|CONTEXT.AttRelMme.Normalrel|CONTEXT.FailInitalSetup|CONTEXT.FailInitalSetup.NoRadioRes|CONTEXT.FailInitalSetup.RNL|CONTEXT.FailInitalSetup.SecurModeFail|CONTEXT.FailInitalSetup.UeNoReply|CONTEXT.FailMod|CONTEXT.NbrLeft|CONTEXT.SuccInitalSetup.Csfb|CONTEXT.SuccInitalSetup|CONTEXT.SuccMod.Csfb|CONTEXT.SuccMod|ERAB.ActiveMaxNbrDL.1|ERAB.ActiveMaxNbrDL.2|ERAB.ActiveMaxNbrDL.3|ERAB.ActiveMaxNbrDL.4|ERAB.ActiveMaxNbrDL.5|ERAB.ActiveMaxNbrDL.6|ERAB.ActiveMaxNbrDL.7|ERAB.ActiveMaxNbrDL.8|ERAB.ActiveMaxNbrDL.9

4301HWWXACEL2148075184|HW-CMHN-CS,ManagedElement=2216,EnbFunction=1|EutranCellTdd=0|\

14:30:00|850|785|131|-440||794|561|327|508|424|902|719|188|457|496|894|485|-641|418|403|662|83|772|905|64|955|990|918|312|928|81

无线LTEOMC性能数据上报采用方案二方式。 核心网XML文件Schema定义:

20/ 36

QB-XX-XXX-XXXX

10 接口日志

No 指标名称 指标含义 记录客户端日志,包括客户端IP地址、用户名、连接时间、断开时间等。 记录实时告警消息发送日志,包含客户端IP地址、用户名、发送时间、告警消息序号,用于OMC和NMS数据核查。 告警流水包含活动告警和清除告警,多个客户端共享一份告警流水日志。 指标值 1. 操作日志 ≥30天 2. 告警流水日志 ≥3天 11 接口可靠性要求

No 指标名称 指标值要求 ≥99.9%(7×24) ≤2小时 ≤3次/年 1. 接口可用性 2. 接口故障平均恢复时间(MTTR) 3. 接口故障发生频次(MTBR) 12 编制历史

版本号 V1.0.0 更新时间 2016.10.24 修订内容 新建文档

36/ 36

QB-XX-XXX-XXXX

21/ 36

QB-XX-XXX-XXXX

核心网XML文件样例:

2016-06-27T22:37:45

UTC+8 15

ZTE CSCF V2.0.0

2016-06-27T22:15:00

IcscfFunction

ZTE-CMHN-CS,SubNetwork=100001,ManagedElement=532024_24,IcscfFunction=1\

22/ 36

QB-XX-XXX-XXXX

UserLabel=\

LIQ.FailLIA.5001 0

LIQ.FailLIA.5003 0

UR.FailUAA.5001 0

UR.FailUAA.5002 0

UR.FailUAA.5003 0

UR.FailUAA.5004 0

EpRpDynCxIcscf

ZTE-CMHN-CS,SubNetwork=100001,ManagedElement=100021_21,IcscfFunction=1,EpRpDynCxIcscf=1001\

23/ 36

QB-XX-XXX-XXXX

7.4 技术指标

No 指标名称 指标含义 接口必选字段个数/OMC系统内必选字段总个数*100% 接口B类字段个数/OMC系统内B类字段总个数*100% 接口记录数/OMC系统内记录数*100% 性能测量文件生成时延=文件完成生成的时间-性能文件统计周期结束时间 性能接口数据文件保存时长 支持ftp客户端多连接的数量 指标值 ≥99.5% ≥90% ≥99% ≤10分钟 ≥7天 ≥10个 1. 字段完整性 2. 记录完整性 3. 性能数据时延 4. 数据存储时长 5. 并发连接数 8 告警数据接口 8.1 接口协议

告警范围:OMC北向接口必须上报全量告警,不允许在OMC侧进行告警过滤或屏蔽。 接口协议:

1)实时告警采用消息方式,采用socket/tcp协议,OMC为socket的server端,NMS为socket的client端。

2)批量告警采用文件方式,采用SFTP或者FTP协议。 接口模式:

1)消息方式的实时告警流水 2)文件方式的批量告警同步

24/ 36

QB-XX-XXX-XXXX

8.2 通信过程

OMC提供一个服务端口,端口号可选范围为31232~31241,默认使用31232。 OMC为每个NMS分配不同的账号,允许每个账号建立两个socket连接,一个用于消息方式的实时告警流水,一个用于文件方式的批量告警同步。 8.2.1 消息方式的实时告警流水

NMSOMC1连接23登录响应4实时告警上报567消息方式同步告警请求响应先补发告警之后恢复实时告警查找告警89心跳下发响应10断开连接

1、 NMS作为socket客户端,主动建立与OMC的连接。

25/ 36

QB-XX-XXX-XXXX

2、 NMS发送登录请求,登录请求信息包括用户名、授权码、请求类别(实时告警流水)。 3、 OMC对用户名和授权码进行认证,接受或拒绝登录请求。OMC检测到NMS连续三次登录失败后,主动断开与NMS的连接。 4、 OMC发送从当前时间开始的实时告警。

5、 当NMS发现实时告警消息序号不连续时(漏告警)且差值不大于1000时,可向

OMC发起1次消息方式告警同步请求(即每次缺漏的告警,NMS只能发起1次消息同步请求),并告知OMC同步告警消息的起始序号(如果同步请求未成功,NMS下次请求时至少比前次请求的告警消息起始序号+1)。实时告警消息序号差值超过1000时,采用文件方式同步缺失告警。 6、 OMC响应请求,返回确认信息。

7、 OMC暂停发送实时告警,在告警消息发送缓存中查询NMS提供的同步告警消息起

始序号的告警,然后补发从该告警消息序号开始的告警消息(方式和格式同4),含告警产生消息和告警清除消息,之后继续上报实时告警消息。当OMC没有找到该起始序号的告警数据(超出缓存范围)时,忽略该同步请求,从暂停序号之后的最新告警开始实时告警上报。

8、 NMS每隔60秒发送一次心跳信息给OMC,进行连接可用性确认。如果在180秒内

OMC没有接收到NMS的任何信息时,OMC主动断开socket连接。

9、 OMC收到NMS的心跳后,响应返回确认信息。如果在180秒内NMS没有接收到

OMC的任何信息,NMS主动断开socket连接,然后尝试重新连接。

10、 NMS告警数据接口程序终止前,向OMC发起关闭socket连接的通知。OMC收到

通知后停止发送告警,断开连接。NMS判断该关闭通知发送成功后,断开和OMC的连接。

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

26/ 36

QB-XX-XXX-XXXX

NMSOMC1连接23456789登录响应文件方式同步告警请求响应心跳下发响应文件告警同步结果消息FTP获取数据文件生成文件10断开连接

1、 NMS作为socket客户端,主动建立与OMC的连接。

2、 NMS发送登录请求,登录请求信息包括用户名、授权码、请求类别(文件告警同步)。 3、 OMC对用户名和授权码进行认证,接收或拒绝登录请求。OMC检测到NMS连续

三次登录失败后,主动断开与NMS的连接。 4、 NMS告知OMC同步告警范围。 5、 OMC响应请求,返回确认信息。

6、 NMS每隔60秒发送一次心跳信息给OMC,进行连接可用性确认。如果在180秒内

OMC没有接收到NMS的任何信息时,OMC主动断开socket连接。

7、 OMC收到NMS的心跳后,响应返回确认信息。如果在180秒内NMS没有接收到

27/ 36

QB-XX-XXX-XXXX

OMC的任何信息,NMS主动断开socket连接,然后尝试重新连接。 8、 OMC基于请求条件,生成告警数据文件,发送文件通知消息给NMS。 9、 NMS从OMC侧获取数据文件。 10、

NMS断开和OMC的连接。

补充说明:

一次连接只能申请一次文件同步,获取完数据OMC返回的数据文件之后,立即完成步骤10的断开操作。

OMC告警文件同步有两种模式: 1、基于OMC数据库的告警数据文件

基于OMC数据库的活动告警生成数据文件,只有告警产生数据,没有告警清除数据。主要用于NMS第一次启动或者周期性进行批量活动告警同步。 2、基于告警流水日志的告警数据文件

基于OMC告警流水日志生成数据文件,包括告警产生消息和告警清除消息。主要用于NMS故障或升级、OMC故障或升级、实时告警流水漏告警条数大于1000等情况。 8.3 消息数据 8.3.1 消息格式

消息数据由消息头和消息体组成。消息头由9个字节(byte)表示,消息体长度不固定,各类消息不同。消息头的9个字节不能当做字符处理,需要按整型数处理。

28/ 36

QB-XX-XXX-XXXX

组成 中文名称 开始标志 英文名称 startSign 长度/byte 2 取值或说明 固定为0xFFFF,消息开始标识。 单字节整型数,类型编码含义如下: 0:realTimeAlarm 1:reqLoginAlarm 2:ackLoginAlarm 3:reqSyncAlarmMsg 4:ackSyncAlarmMsg 5:reqSyncAlarmFile 6:ackSyncAlarmFile 7:ackSyncAlarmFileResult 8:reqHeartBeat 9:ackHeartBeat 10:closeConnAlarm 4字节整型数,字节顺序为Big-Endian,表示消息产生时间,为距离1970-01-01 00:00:00时间偏移的秒数。 2字节整型数,字节顺序为Big-Endian,表示消息体字节长度,取值范围0~32767。 消息类型 消息头 msgType 1 秒时间戳 timeStamp 4 长度 消息体 lenOfBody 2 具体消息内容。对于上报的告警消息realTimeAlarm,消息体中只包括一条json格式的告警数据。

除“实时告警上报消息”外的所有消息体由消息名和参数组成。 形如:<消息名>;<参数名>=<参数值>[;<参数名>=<参数值>] 1)消息名、参数名大小写不敏感。 2)消息名与参数间用分号“;”分隔。 3)参数间用分号“;”分隔。

4)参数名与参数值用“=”连接,参数为空时参数值为字符串“null”。 消息体样例:reqLoginAlarm;user=yiy;key=qw#$@;type=msg 8.3.2 登录与登录响应

NMS发给OMC的登录请求消息(下行) 消息名:reqLoginAlarm 参数:

29/ 36

QB-XX-XXX-XXXX

1)user:登录用户名,用户名由字母和数字组成,字母不区分大小写。 2)key:授权码,授权码中不得含有分号“;”。

3)type:连接类型。取值msg为实时告警流水上报连接。取值ftp为文件方式告警同步连接。

消息样例:reqLoginAlarm;user=yiy;key=qw#$@;type=msg OMC发给NMS的登录请求的响应消息(上行) 消息名:ackLoginAlarm 参数:

1)result:登录结果。取值succ表示登录成功,fail表示登录失败。 2)resDesc:登录失败原因,长度小于32个字符。 消息样例:ackLoginAlarm;result=fail;resDesc=username-error 8.3.3 消息方式同步告警请求与响应

NMS发现缺失告警时,发给OMC的消息方式同步告警请求消息(下行) 消息名:reqSyncAlarmMsg 参数:

1)reqId,操作序号,用于区分同一连接的多次请求。

2)alarmSeq,同步告警的起始告警消息序号。丢失多条告警时,为最小告警消息序列号。同一个起始告警消息序号的消息方式同步请求NMS只能发送一次。 消息样例:reqSyncAlarmMsg;reqId=33;alarmSeq=10

OMC发给NMS的消息方式同步告警请求的响应消息(上行) 消息名:ackSyncAlarmMsg 参数:

1)reqId,操作序号,取值为请求消息的reqId。

2)result:响应结果。取值succ表示请求成功,fail为请求失败。 3)resDesc:失败原因,长度小于32个字符,不允许带分号“;”。 消息样例:ackSyncAlarmMsg;reqId=33;result=succ;resDesc=null

30/ 36

QB-XX-XXX-XXXX

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

NMS发给OMC的文件方式同步告警请求消息(下行) 命令名:reqSyncAlarmFile 命令参数:

1)reqId,操作序号,用于区分同一连接的多次请求。

2)startTime/endTime:所取告警的开始时间和结束时间。若startTime或endTime为空,表示该条件不生效(即:若startTime为空,则从当前告警中最早的开始;若endTime为空,则取到当前最新的告警截止)。 告警的开始/结束时间取值的约定:

对于syncSource=0的情况:取告警发生的时间,即告警本身的event_time; 对于syncSource=1的情况:取北向接口记录日志流水的时间。

3)alarmSeq,同步告警的起始告警消息序号。只适用于syncSource=1的情况,且在一次请求中给定alarmSeq和startTime/endTime是互斥的,同一条请求中只能出现其中之一。即一次文件流水方式同步,按起始告警消息序号同步,或者按告警流水记录时间同步。

4)syncSource,同步的告警数据源,取值为:

0:基于OMC数据库的存量活动告警数据文件。该模式下,告警消息序号alarmSeq的取值不做要求,但alarmSeq字段必须有。

1:基于告警消息日志的告警消息流水数据文件。该模式下,告警消息序号alarmSeq和原实时上报的要保持一致。

为提高omc北向接口部分搜索告警流水数据文件的速度,建议在存储的文件名上直接体现该文件所存储的告警数据的起止告警消息起始序号和告警流水记录起止时间,以便通过文件名即可确定需要同步的告警文件范围。 消息样例:

reqSyncAlarmFile;reqId=33;startTime=2014-11-2710:00:00;endTime=2014-11-2710:30:00; syncSource=0

reqSyncAlarmFile;reqId=34;startTime=2014-11-27 10:00:00;endTime=2014-11-27 10:30:00;

31/ 36

QB-XX-XXX-XXXX

syncSource=1

reqSyncAlarmFile;reqId=35;alarmSeq=100;syncSource=1

OMC发给NMS的文件方式同步告警请求的响应消息(上行) 消息名:ackSyncAlarmFile(无结果的立即应答) 参数:

1)reqId,操作序号,取值为请求消息的reqId。

2)result:响应结果。取值succ表示请求成功,fail表示请求失败。 3)resDesc:失败原因,长度小于32个字符,不允许带分号“;”。 消息样例:ackSyncAlarmFile;reqId=33;result=succ;resDesc=null OMC发给NMS的文件方式同步告警请求的响应消息(上行) 消息名:ackSyncAlarmFileResult(含有文件同步结果的应答) 参数:

1)reqId,操作序号,取值为请求消息的reqId。

2)result:响应结果。取值succ为请求成功,fail为请求失败。 3)fileName:告警数据文件的路径和名称,多个文件之间用逗号分隔。 4)resDesc:失败原因。

消息样例:ackSyncAlarmFileResult;reqId=33;result=succ;

filename=/ftproot/GD/WX/HW/JS_OMC2/FM/20150611/FM-OMC-1A-V1.1.0-20150611011603-001.txt;resDesc=null 8.3.5 心跳请求与响应

没有实时告警数据时,NMS每隔60秒向OMC发送一次心跳消息(下行) 消息名:reqHeartBeat

参数:reqId,操作序号,用于区分同一连接的多次请求。 消息样例:reqHeartBeat;reqId=33

OMC发给NMS的心跳响应消息(上行)

32/ 36

QB-XX-XXX-XXXX

消息名:ackHeartBeat

参数:reqId,操作序号,用于区分同一连接的多次请求。 消息样例:ackHeartBeat;reqId=33 8.3.6 关闭连接通知

NMS发给OMC的关闭连接通知消息(下行) 消息名:closeConnAlarm 消息样例:closeConnAlarm 8.3.7 实时告警上报

对应的消息头中的消息类型编码为0(realTimeAlarm),消息体为具体告警数据,采用json格式。

消息体信息包括告警消息序号和告警业务字段。业务字段参见《OMC北向接口数据规范-告警数据分册》。

告警消息序号(alarmSeq),OMC内告警事件连续标识,用于判断是否丢失告警消息,具体要求如下:

1、用连续正整数编号,初始编号从1开始,如果编号超过最大正整数(2^31-1)重新从1开始编号。

2、发送给多个NMS系统的同一条告警,告警消息序号相同。 3、在OMC升级、重启等情况下,需要保证序号能够继续连续编号。 消息体样例: {

\alarmSeq\\

\

\\深圳同发路D-HLH\

33/ 36

QB-XX-XXX-XXXX

??

\数据通道配置失败\\}

8.4 文件数据

同步告警文件采用txt格式文件,文件后缀为“.txt”,每条告警信息(告警产生或

告警清除)为json格式,多个告警消息的{}间用\\r\\n分割。 格式样例: {

\alarmSeq\\ }

8.5 技术指标

No 指标名称 指标含义 NMS收到告警数/OMC系统内告警数*100% OMC发送告警时间-告警发生时间 北向输出告警的时序必须和OMC收到告警的时序保持一致,北向输出时序正常的告警条数/告警总条数*100% 对每个NMS,OMC实时上报全量告警消息的能力,告警消息包括活动告警和清除告警消息 指标值 =100% ≤5秒 =100% ≥1000条/秒 \

\\深圳同发路D-HLH\

??

\数据通道配置失败\\

1. 告警完整性 2. 告警时延 3. 告警时序性 4. 告警接口吞吐率 34/ 36

QB-XX-XXX-XXXX

5. 6. 存量活动告警文件生成时延 实时告警消息缓存条数 每10000条存量活动告警打包成接口文件的处理时间 OMC接口应缓存实时告警消息,用于网络瞬间故障时,以消息方式同步告警流水 支持接收告警的NMS数量 支持ftp客户端多连接的数量 ≤5秒 ≥1000条 ≥10个 ≥5个 7. 告警并发连接数 8. FTP并发连接数 9 操作指令接口

操作指令接口提供NMS下发指令给OMC的指令通道,最终操作OMC或者网元。用于网络设备状态查询、配置查询、重启、数据配置、参数修改、智能巡检等。基本的要求如下:

1. OMC系统在北向接口开放所有操作指令,并提供完备的指令说明文档; 2. 指令方式支持不同的连接模式;

3. 操作指令接口至少可以支持设置指令操作结果是否分页显示,是否屏蔽告警等

实时信息或者通知。

4. 接口协议可采用Telnet/SSH/TL1等协议;OMC对全部操作指令提供统一的服务

端口,端口号可选范围为31232~31241,默认使用31241。特别说明,PON的操作指令接口协议采用TL1。

5. 全部操作指令必须具有统一的结束符,且结束符在各种接入方式下可见,此外,

结束符不能用在任何其他的地方;

6. 指令回复必须返回明确的执行结果,且需要明确标识执行成功或错误等状态信

息;指令回复执行结果后必须具有统一的结束符,并结束符在各种接入方式下可见,此外,结束符不能用在任何其他的地方。

技术指标:

No 指标名称 指标含义 单条指令下发的响应时延 复杂指令下发的响应时延。对涉及多个网元对象串行执行的操作,响应时延要求根据串行操作对象的数量倍乘。 操作指令接口的并发连接数 指标值 ≤6秒 ≤10秒*对象数量 ≥100个 1. 响应时延 2. 复杂交互响应时延 3. 并发连接数 35/ 36

QB-XX-XXX-XXXX

10 接口日志

No 指标名称 指标含义 记录客户端日志,包括客户端IP地址、用户名、连接时间、断开时间等。 记录实时告警消息发送日志,包含客户端IP地址、用户名、发送时间、告警消息序号,用于OMC和NMS数据核查。 告警流水包含活动告警和清除告警,多个客户端共享一份告警流水日志。 指标值 1. 操作日志 ≥30天 2. 告警流水日志 ≥3天 11 接口可靠性要求

No 指标名称 指标值要求 ≥99.9%(7×24) ≤2小时 ≤3次/年 1. 接口可用性 2. 接口故障平均恢复时间(MTTR) 3. 接口故障发生频次(MTBR) 12 编制历史

版本号 V1.0.0 更新时间 2016.10.24 修订内容 新建文档

36/ 36

本文来源:https://www.bwwdw.com/article/msrf.html

Top