2023年6月30日发(作者：)
中国移动通信企业标准
QB-XX-XXX-XXXX
OMC北向接口通用技术规范
Northbound Interface General Technology Specification for OMC
版本号
2016-10-24发布
施
2016-10-24实中国移动通信集团公司发布
目录
1 范围 ............................................................................ 5
2 规范性引用文件 .................................................................. 5
3 缩略语 .......................................................................... 5
4 接口架构 ........................................................................ 5
5 通用技术约定 .................................................................... 6
公共要求 ................................................................ 6
FTP通用要求 ............................................................. 6
6 资源数据接口 .................................................................... 8
接口协议 ................................................................ 8
接口数据 ................................................................ 9
数据格式 ................................................................ 9
技术指标 ............................................................... 12
7 性能数据接口 ................................................................... 13
接口协议 ............................................................... 13
接口数据 ............................................................... 13
数据格式 ............................................................... 13
技术指标 ............................................................... 14
8 告警数据接口 ................................................................... 14
接口协议 ............................................................... 14
通信过程 ............................................................... 15
消息方式的实时告警流水 ........................................................ 15
文件方式的批量告警同步 ........................................................ 16
消息数据 ............................................................... 18
消息格式 ...................................................................... 18
登录与登录响应 ................................................................ 19
消息方式同步告警请求与响应 .................................................... 20
文件方式同步告警请求与响应 .................................................... 21
心跳请求与响应 ................................................................ 22
关闭连接通知 .................................................................. 22
实时告警上报 .................................................................. 23
文件数据 ............................................................... 23
技术指标 ............................................................... 24
9 操作指令接口 ................................................................... 24
10 接口日志 ....................................................................... 25
11 接口可靠性要求 ................................................................. 25
12 编制历史 ....................................................................... 25
前 言
本标准由中国移动通信集团公司网络部提出并归口。
本标准起草单位：中国移动通信集团公司网络部。
本标准主要起草人：刘立卫、刘云霞、李健、肖捷、陈丹、高建军、张凤桥。
本标准解释单位：中国移动通信集团公司网络部。
本标准由中国移动通信集团公司XXX号文发布。
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 Management Universal Identifier
Mean Time Between Failure
Mean Time To Repair
中文解释
操作维护中心
网络管理系统
网元
网络资源对象的全网唯一标识
平均故障间隔时间
平均修复时间
4 接口架构
OMC北向接口是OMC系统与网络管理系统（NMS）间的接口，分为上行接口和下行接口。上行接口指从OMC到NMS的接口，下行接口指从NMS到OMC的接口。
接口总体架构如下：
接口说明：
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、 服务端与客户端
OMC提供可以获取资源、告警和性能数据的FTP server，NMS为 FTP client。OMC系统将数据文件放到FTP server上，NMS自行采集数据文件。
2、 安全性要求
通过授权的用户名、密码信息才能够访问FTP服务器。
3、 目录规则
目录结构：/FTP根目录/省简称/专业简称/厂家编码/OMC名称/数据类别/日期或时间/
示例：
资源目录：/ftproot/GD/WX/HW/GZ_OMC2/CM后缀>
1) 网元类型：资源、性能数据为网元类型，如MME、ENB、PTN、PON等；告警数据为“OMC”。
2) 网元子类：无线网、核心网的资源、性能数据的网元子类为资源数据、性能数据规范定义的空间粒度名称，如：EutranCellTDD、InventoryUnitRru、EthernetPort等；告警数据无此项。传输网的资源、性能数据的资源对象类名，填写资源对象简称，如：隧道（TNL）、标签交换（LBS）。资源对象简称参见《OMC北向接口数据规范-XX资源数据分册》或《OMC北向接口数据规范-XX性能数据分册》。IP网数据无此项，核心网的资源、性能数据该项可选。
3) 主机编号：两位，每1位可用0-9、A-Z编码。
4) 数据版本：遵循接口数据规范规范版本，允许同一目录下存放不同版本的数据文件。
5) 数据时间：采用YYYYMMDDHH24MMSS格式。资源、告警数据为数据文件开始生成时间，其中资源数据文件开始生成时间指0点或12点；性能数据为统计周期的起始时间。
6) 登录用户名：仅在告警文件同步时使用。用以解决多个NMS同时对同一个 OMC发起告警文件同步请求，生成的同步文件名冲突的问题。
7) Ri：可选。当接口数据文件内容有误（如数据缺失等）时，OMC重新生成文件提供给NMS进行数据补采，新文件在原文件名后增加”Ri”进行标识，i从1开始，每重新生成一次i加1。
8) 统计周期：两位，取值范围为00-99，仅针对性能数据文件，统计周期的分钟数，如05、15、60。资源、告警数据文件无此项。
9) 序列号：当文件总量小于100MB(允许上下浮动10%)时，应只形成一个文件；当文件总量大于100MB(允许上下浮动10%)时要求进行文件分割，即分割后的文件大小（除最后一个）均应介于（90MB,110MB）之间。分割后的文件增加序列号标识，序列号为三位，取值为001-999。在文件切分过程中，不能把资源、性能或告警的一条完整的记录切开放到两个文件中。
10) 后缀：每个文件都进行压缩，统一采用zip或gzip压缩，压缩文件后缀是zip或gz。
11) 文件名样例
资源文件：性能文件：告警文件：对于设备厂家北向接口上报的私有参数文件，在数据版本前增加ALL字样，其他字段要求保持不变。
样例：
4、
性能文件：文件生成过程标识
文件生成过程中，文件名后缀增加“.tmp”标识，该文件全部生成完成后，去掉“.tmp”标识，以确保NMS获取到的北向数据文件是完整的。
对于在数据规范中定义的一个单一接口文件，如果由于文件过大拆分或分布式处理，形成多个文件的，要求在该批次文件全部生成完成后，去掉“.tmp”标识。
6 资源数据接口
6.1 接口协议
接口协议：采用SFTP或者FTP协议。
数据周期：无线网、核心网、传输网和IP网四个专业每12小时生成一次，即每天0点和12点启动，基于OMC配置数据库中的数据信息生成一套最新的全量资源文件。智 能家庭网关的终端管理平台的资源数据周期为每24小时生成一次，即每天0点启动，基于OMC配置数据库中的数据信息生成一套最新的全量资源文件。
6.2 接口数据
接口数据含公共信息和业务数据。业务数据字段参见相关数据规范。公共信息如下：
No
字段名称
数据生成时间
时区
生成这个网络资源模型文件的OMC的设备供应商
网元类型
资源数据版本
网络资源对象的全网唯一标识
网元标识
用户友好名
网络资源类别名称
英文名称
TimeStamp
TimeZone
VendorName
ElementType
CmVersion
rmUID
数据类型
时间
字符串
取值或说明
开始生成数据文件的时间戳。
时区信息，如：北京时间为“UTC+8”。
字符串，取值长度不大于64个字节，字符串 不限制字符类型。通过该属性取值应可明确识别厂商名称
字符串
字符串
字符串
如MME、ENB、PTN、PON
资源数据版本
网络资源对象的全网唯一标识，具体定义请见《OMC系统北向接口数据规范-公共数据分册》
无线、核心网专业该字段必选，传输、IP专业无该字段
无线、核心网专业该字段必选，传输、IP专业无该字段
该组网络资源模型归属的对象类，具体定义请见《OMC北向接口数据规范-XX资源数据分册》。如：EutranCellTDD、InventoryUnitRru、EthernetPort等。
核心网专业该字段必选。
Dn
UserLabel
字符串
字符串
字符串
ObjectType
6.3 数据格式
资源数据文件采用XML格式。
给定一个网元类型，有两种文件组织方式：（1）同一个空间粒度的资源数据在同一数据文件中；（2）对所有的空间粒度，启用一个CM文件存储其资源数据。核心网专业优选文件组织方案（2）。
XML文件格式要求如下。
1、标签说明
标签名称
dataFile
fileHeader
FiledName
Object
N
V
要求
必须
必须
必须
必须
必须
有条件
说明
数据文件
文件头
网元对象的参数集合
网元
网元对象参数集合中每个参数名称
网元的参数取值，值的个数要与参数的个数相同
2、xml标签属性
属性名称
version
encoding
解释
版本
字符集
要求
必须
必须
类型和取值说明
字符串，取值为：""
字符串，取值为："UTF-8"
3、fileHeader标签属性
属性名称
TimeStamp
TimeZone
VendorNam解释
数据生成时间
时区
生成这个网络资源模型文件的OMC的设备供要求
必选
必选
必选
类型和取值说明
时间格式，YYYY-MM-DDTHH24:mm:ss
时区信息，如：北京时间为“UTC+8”。
字符串，取值长度不大于64个字节，不限制字符类型。通过该属性 e
ElementType
CmVersion
应商
网元类型
资源数据版本
必选
必选
取值应可明确识别厂商名称
字符串，如MME、ENB、PTN、PON
字符串，资源数据版本
4、object标签属性
属性名称
rmUID
Dn
UserLabel
解释
网络资源对象的全网唯一标识
Distinguished
Name，识别名
用户友好名
要求
必须
无线、核心网专业该字段必选，传输、IP专业无该字段
无线、核心网专业该字段必选，传输、IP专业无该字段
类型和取值说明
字符串
字符串
字符串
5、v标签属性
属性名称
i
解释
属性序列号
要求
必须
类型和取值说明
整型，网元参数名和参数值相对应的序列号，从1开始编号
对于传输专业（PTN、PON等），rmUID字段不重复写在v标签中（写在object标签中）。
6、Xml数据文件Schema定义
xmlns:xsi="" elementFormDefault="qualified" attributeFormDefault="unqualified"> minOccurs="0" /> minOccurs="0" /> minOccurs="0" /> type="xs:string" minOccurs="0" /> type="xs:integer" use="required" /> minOccurs="0" maxOccurs="unbounded"> base="xs:string"> name="i" type="xs:integer" use="required" /> use="required" /> name="rmUID" type="xs:string" 6.4 type="xs:string" />