MDAS集采附录55中国移动MDAS类设备网络管理北向接口技术规范.docx
《MDAS集采附录55中国移动MDAS类设备网络管理北向接口技术规范.docx》由会员分享，可在线阅读，更多相关《MDAS集采附录55中国移动MDAS类设备网络管理北向接口技术规范.docx（11页珍藏版）》请在冰豆网上搜索。
MDAS集采附录55中国移动MDAS类设备网络管理北向接口技术规范
中国移动通信有限公司2015年度
光纤分布系统设备产品集中采购
技术规范书附录五
中国移动MDAS设备网络管理北向接口技术规范
2015年8月
1目录
1范围1
2规范参考文件1
3概述1
4配置管理接口1
5性能管理接口1
6故障管理接口2
6.1功能定义2
6.2接口概述2
6.3数据格式定义2
6.4告警告警接口3
6.4.1接口协议3
6.4.2接口数据编码格式3
6.4.3接口说明3
6.4.4通信规程3
6.4.5消息格式定义3
6.4.6告警字段要求4
6.4.7告警样例6
6.5心跳检测接口7
6.5.1接口协议7
6.5.2接口数据编码格式7
6.5.3接口定义7
6.5.4消息格式定义7
6.5.5心跳样例7
6.6同步告警信息接口8
6.6.1接口协议8
6.6.2接口数据编码格式8
6.6.3接口定义8
6.6.4告警字段要求8
6.6.5文件格式8
2前言
本规范定义了运营商MDAS网络监控管理的监控系统北向接口规范。
本标准的附录A和B为规范性附录。
本规范由规范归口部门负责解释。
1范围
本标准供运营商内部和厂商共同使用，适用于MDAS网络管理接口部分的规划和设计。
2规范参考文件
下列文件中的条款通过本标准的引用而成为本标准的条款。
凡是注日期的引用文件，其随后所有的修改单（不包括勘误的内容）或修订版均不适用于本标准，然而，鼓励根据本标准达成协议的各方研究是否可使用这些文件的最新版。
凡是不注日期的引用文件，其最新版本适用于本标准。
[1]
《移动通信网网络运维业务需求V1.0.2》
3概述
MDAS系统与网管系统（省）之间的接口称为北向接口（Itf-N），网管系统（省）通过此接口实现对MDAS系统的管理，MDAS系统监控系统须通过此接口实现对配置管理接口功能、故障管理接口功能、性能管理接口功能的支持。
✧故障管理接口功能：
实现对MDAS系统设备故障告警数据的实时采集和集中监视，辅助故障定位。
提供对告警信息的各种处理功能，提供对历史告警信息的统计查询功能。
✧配置管理接口功能：
采集MDAS系统的全量网元、站点、基站配置数据。
✧性能管理接口功能：
采集MDAS系统的全量网元、站点、基站性能数据。
配置管理接口、性能管理接口所采集的配置、性能数据以及其模型关系，以总部维护优化处发布的相关数据规范为准。
4配置管理接口
配置管理接口采用Ftp协议，以XML方式定期提供配置数据。
文件组织格式与命名规则以总部维护优化处发布的相关规范为准。
如维护优化处的规范中未约定配置数据的时间粒度，则XML方式需支持24小时粒度的配置数据文件生成。
5性能管理接口
性能管理接口采用Ftp协议，以XML方式定期提供性能数据。
文件组织格式与命名规则以总部维护优化处发布的相关规范为准。
性能数据的采集时间粒度与空间粒度以总部维护优化处发布的相关数据规范为准。
6故障管理接口
6.1功能定义
MDAS系统网管需要提供实时告警接口和告警同步接口。
本方案主要确定MDAS系统网管与省网管的接口方式以及规范告警正文的格式。
6.2接口概述
说明：
本地网管系统跟大网管之间采用2种接口方式：
1）对于接收到的网元告警及告警清除消息通过实时告警接口采用TCP长连接方式立即发送给大网管；并当链路空闲无消息时发送心跳包维持该链路。
2）本地网管采用FTP方式每天定时同步活动告警到大网管，数据采用CSV文件格式，每天同步一次。
6.3数据格式定义
说明符含义解释
一对尖括号<>之间的内容为实际输出内容。
\r\n换行符。
表示连续n个空格符。
其中：
A0表示左对齐，A1表示右对齐。
默认左对齐。
其中：
'Mn表示此信息段最大长度n字符。
其中：
'Ln表示此信息段总长度是n字符，不足部分用空格填充；
'L0表示输出该字段的实际长度，不用填充。
标记下划线的文字，为确定输出字样
XXXX为其他部分实际输出更改；
某一部分信息空缺，则填；
如<局名'M32A0>表示局名信息最大长度32字符，左对齐。
6.4告警告警接口
6.4.1接口协议
接口采用TCP/IP（Socket）方式，数据格式为文本流。
6.4.2接口数据编码格式
采用GBK编码。
6.4.3接口说明
由MDAS系统网管系统向省网管系统提供告警接口，将告警数据通过告警接口发送到省网管系统。
MDAS系统网管系统与省网管系统通过TCP/IP方式进行连接时，通过Client/Server的方式进行通信。
MDAS网管系统作为Server端，提供接口服务器的IP地址和端口，省网管系统作为Client端。
6.4.4通信规程
省网管连接MDAS服务器（指定IP、PORT）,MDAS系统网管采集到告警信息后，将该告警按照指定的格式发送到省网管系统。
针对异常处理说明：
当省网管连接MDAS网管系统不成功时，需等待一定时间（可设定），再次重新尝试连接MDAS网管系统接口服务器，三次不成功则产生一次告警（无法连接话务网管接口服务器），同时继续尝试连接，直至成功
6.4.5消息格式定义
6.4.5.1消息头
<4SP><8SP>\r\n
<2SP><2SP><2SP><2SP><2SP>\r\n
6.4.5.2消息体
由6.4.6.2节中的告警字段组成，每一行包含一个字段，格式”（字段名）<2SP>=<2SP>（内容）\r\n”组成，如:
objectId<2SP>=<2SP>100
objectClass<2SP>=<2SP>百货大楼北3F干放
6.4.5.3消息尾
END\r\n
6.4.6告警字段要求
6.4.6.1消息头字段要求
字段名称
中文名称
说明
deviceLabel
设备编号
设备编号作为设备的唯一标识，与MDAS系统设备的名称一一对应；
eventDate
告警产生/恢复日期
告警产生/恢复的日期,格式为：
YYYY-MM-DD例如：
2014-08-1818:
28:
08
eventTime
告警产生/恢复时间
告警产生/恢复的时间,格式为：
HH:
mm:
SS如：
18:
28:
08
eventLabel
告警标志
固定为“ALARM”
eventStatus
告警类别
告警类别有两类：
告警、恢复；
告警是指由于硬件设备故障或某些功能异常而产生的故障告警。
恢复是指故障设备或异常功能恢复正常时产生的恢复告警。
在告警报告中，以“故障”表示故障告警、“恢复”表示恢复告警；
perceivedSeverity
告警级别
告警级别用于标识某项告警的严重程度，按严重程度递减分为：
严重告警
主要告警
次要告警
警告告警
通知信息
alarmSource
告警来源
显示的字符串是具体的网元名称，即MDAS系统的中文名称。
alarmRecordID
告警编号
某一条告警/恢复的唯一标识，MDAS系统网管提供告警编号。
要求：
恢复告警报告中的告警编号与对应的故障告警的告警编号相同，即某一告警报告是否对应有恢复报告，以此编号识别。
alarmType
告警分类
告警类型包括如下：
设备告警
派生告警
系统告警
信源告警
市电原因告警
进程退出告警
进程错误告警
服务质量告警
违反安全服务或机制告警
通信告警
处理错误告警
环境告警
设备告警
完整性错误
物理层错误
时间域错误
处理异常中断告警
网络干扰
业务处理异常
软件操作异常
协议告警
阈值告警
网管告警
时限告警
其他告警
6.4.6.2消息体字段要求
字段名称
中文名称
说明
probableCause
告警原因
适用于MDAS型设备。
表明告警发生的可能原因；
proposedRepairActions
修复建议
适用于MDAS型设备。
表明处理该条告警的可能建议；
alarmTitle
告警名称
表明告警的中文名称。
要求：
恢复告警报告中告警名称与对应的故障告警的告警名称相同。
即通常的告警标题；
alarmID
告警标识
告警名称的编号或描述，唯一确定告警名称。
deviceID
自选编号
运营商在MDAS系统网管中创建MDAS系统网元时定义的编号；
objectClass
设备分类
MDAS网管设备类型如下：
系统网关
安全网关
AAA
MDAS基站
家庭级基站
多模光纤直放站
企业级基站
MDAS
基站拉远单元
时钟服务器
交换机
防火墙
服务器
objectLocation
设备场所
MDAS系统设备安装位置，设备场所有两类，分别为“室内设备”和“室外设备；
vendor
设备厂家
MDAS分布系统设备的生产厂家
substitute
代维厂家
MDAS系统设备的维护厂家
monitorArea
监控区域
是指用户所负责管辖监控的范围
monitorScope
业务区域
是指某监控区域下可进行监控管理的范围。
cell
基站小区
基站对应的小区ID
6.4.7告警样例
START0008122416360000012008-12-2416:
48:
18
ALARM故障主要告警京信地下停车场MDAS基站98488通信告警
probableCause=告警原因描述
proposedRepairActions=修复建议描述
alarmTitle=S1LinkFailure
alarmRecordID=10000
deviceID=自选编号
objectClass=MDAS基站
objectLocation=室内设备
vendor=京信通信
substitute=京信通信
monitorArea=杭州
monitorScope=西湖区
cell=1000
END
6.5心跳检测接口
6.5.1接口协议
接口采用TCP/IP（Socket）方式，数据格式为文本流。
6.5.2接口数据编码格式
采用GBK编码。
6.5.3接口定义
当TCP/IP通道1分钟内没有数据交互时，检测方送心跳检测消息，接收方收到该消息时进行消息回复；心跳检测包及回应报采用固定长度。
省网管作为心跳检测方，MDAS网管作为心跳接收方。
6.5.4消息格式定义
6.5.4.1消息头
固定为START\r\n
6.5.4.2消息体
每一行包含一个字段，格式”<字段名>\r\n”组成，
发起方:
HEARTBEAT
接收回应:
HEARTBEATRESPONSE
6.5.4.3消息尾
固定为END\r\n
6.5.5心跳样例
检测方：
START\r\n
HEARTBEAT
END\r\n
接收方：
START\r\n
HEARTBEATRESPONSE
END\r\n
6.6同步告警信息接口
6.6.1接口协议
接口采用FTP文件方式。
6.6.2接口数据编码格式
采用GBK编码。
6.6.3接口定义
同步告警信息接口采用FTP接口方式，每天在固定时间（可配置）定时同步网管全量活动告警到大网管，同步数据采用CSV文件格式。
6.6.4告警字段要求
见6.4.6小节所述。
6.6.5文件格式
同步告警信息接口传输的文件格式如附件《活动告警信息.csv》
升级会员 