【YD通讯标准】 高精度同步网网络管理技术要求 第4部分: EMS-NMS 接口功能

ICS33.040
中华人民共和国通信行业标准
YD/T3042.4-2016
高精度同步网网络管理技术要求第4部分：EMS-NMS接口功能
Technical requirements forhigh-precisiorsynchronizednetworkmanagementPart4:EMS-NMSinterfacefunction2016-04-05发布bzxZ.net
2016-07-01实施
中华人民共和国工业和信息化部发布前
1范围·
2术语、定义和缩略语
3EMS信息管理接口
3.1接口功能概述
3.2EMS信息管理
4配置信息管理接口
4.1接口功能概述
4.2配置信息管理功能
4.3通知描述
5故障信息接口功能要求·
5.1接口功能概述：
5.2故障管理功能
5.3通知描述-
6性能监控管理接口
接口功能概述·
性能监控管理功能
通知描述
7心跳管理接口·
7.1通知描述
8返回错误码定义
接口总体技术要求
9.1接口性能要求
YD/T3042.4-2016
YD/T3042.4-2016
YD/T3042《高精度同步网网络管理技术要求》预计包含以下部分：第1部分：基本原则：
一第2部分：EMS系统功能：
第3部分：NMS系统功能；
一第4部分：EMS-NMS接口功能；第5部分：EMS-NMS接口通用信息模型；一第6部分：基于IDL/IIOP技术的EMS-NMS接口信息模型。本部分为YD/T3042的第4部分。
本部分按照GB/T1.1-2009给出的规则起草。请注意本文件的某些内容可能涉及专利。本文件的发布机构不承担识别这些专利的责任。本部分由中国通信标准化协会提出并归口。本部分起草单位：中国移动通信集团设计院有限公司、华为技术有限公司、大唐电信科技产业集团、武汉烽火科技集团有限公司、中兴通讯股份有限公司、上海贝尔股份有限公司。本部分主要起草人：成梦虹、吕良栋、张昱、邓万球，HiiKAoNiKAca
1范围
高精度同步网网络管理技术要求第4部分：EMS-NMS接口功能
本部分规定了高精度同步网网络管理体系中EMS-NMS接口功能，本部分适用于高精度同步网的网元管理系统和网络管理系统2术语、定义和缩略语
2.1术语和定义
下列术语和定义适用于本文件。2.1.1
网络管理系统NetworkManagementSystem（NMS）YD/T3042.4-2016
高精度同步网网络管理系统，即为管理高精度同步网网络所使用的软硬件系统。网络管理系统提供全网的同步跟踪网络视图，能够管理网络内多设备供应商的同步网网元设备的高精度同步网络。2.1.2
网元管理系统ElementManagementSystem（EMs）高精度同步网网元管理系统，管理由单一设备供应商提供的高精度同步网网元。2.1.3
同步网网元SynchronizedNetworkElement（SNE）高精度时间同步设备，在同步网网络中提供时间和时钟同步信息。文中未作说明的网元均指同步网网元。
2.2缩略语
下列缩略语适用于本文件。
File Transfer Protocol
Internet Protocol
3EMS信息管理接口
3.1接口功能概述
EMS信息管理接口功能见表1。
接口名称
EMS信息查询接口
3.2EMS信息管理
3.2.1EMS信息查询（getEMS）
文件传输协议
互联网协议
表1EMS信息管理接口功能
接口功能
通过该接口查询EMS系统的详细信息NMS通过该接口，查询EMS的详细信息，如果查询成功，返回EMS信息包括：a）EMS的名称：
b）EMS的软件版本；
c）厂家自定义类型：
HiiKAoNiKAca
YD/T3042.4-2016
d）附加信息。
配置信息管理接口
4.1接口功能概述
配置信息管理接口功能见表2
接口名称
查询指定网元信息接口
查询所有网元信息接口
查询所有网元名称接口
查询指定单板或容器信息接口
查询指定网元或容器下单板信息接口查询指定物理终端点信息接口
条件查询物理终端点信息接口
4.2配置信息管理功能
表2配置信息管理接口功能
接口功能
通过该接口查询指定网元的详细信息通过该接口查询EMS内所有网元的详细信息通过该接口查询EMS内所有网元的名称通过该接口查询指定单板或容器的详细信息通过该接口查询指定网元或容器下所有单板以及容器的详细信息通过该接口查询指定物理终端点的详细信息通过该接口查询指定网元下满足过滤条件的物理终端点信息查询指定网元信息接口（getManagedElement）4.2.1
NMS通过该接口查询指定网元的详细信息，包括：a）网元名称：
b）网元本地名称：
c）网元位置：
d）网元版本：
e）网元类型：
f）网元和网管通讯状态：
g）网元IP地址：
h）网元当前最高告警级别。
4.2.2查询所有网元信息接口（getAlManagedElements）NMS通过该接口查询EMS内所有网元的详细信息，包括：a）网元名称：
b）网元本地名称：
c）网元位置：
d）网元版本；
e）网元类型：
f）网元和网管通讯状态：
g）网元IP地址：
h）网元当前最高告警级别。
4.2.3查询所有网元名称接口（getAllManagedElementNames）NMS通过该接口查询EMS内所有网元的名称，包括：a）网元名称。
TiiKAoNiKAca
4.2.4查询指定单板或容器信息接口（getEquipment）NMS通过该接口查询指定单板或容器的详细信息，包括：a）单板/容器名称：
b）单板/容器本地名称；
c）单板/容器工作状态：
d）单板/容器类型；
e）单板序列号：
f）单板版本号；
g）已安装单板类型（只对插有单板的slot型容器有效，否则为空）；h）可安装单板类型（只对slot型容器有效，否则为空）：i）附加信息
4.2.5查询指定网元或容器下单板以及容器信息接口（getAllEquipments）NMS通过该接口查询指定网元或容器下所有单板以及容器的详细信息，包括：a）单板/容器名称：
b）单板/容器本地名称：
c）单板/容器工作状态：
d）单板/容器类型：
e）单板序列号：
f）单板版本号：
g）已安装单板类型（只对插有单板的slot型容器有效，否则为空）：h）可安装单板类型（只对slot型容器有效，否则为空）：i）附加信息。
4.2.6查询指定物理终端点信息接口（getTP）NMS通过该接口查询指定物理终端点的详细信息，包括：a）终端点名称标识：
b）本地名称；
c）流入流量描述：
d）流出流量描述：
e）终端点类型；
f）连接状态；
g）终端点映射模式：
h）终端点方向；
i）传输参数：
j）附加信息。
4.2.7条件查询物理终端点信息接口（getAllPTPs）NMS通过该接口查询指定网元下满足过滤条件的物理终端点信息，包括：a）终端点名称：
b）本地名称：
YD/T3042.4-2016
HiiKAoNiKAca
YD/T3042.4-2016
c）流入流量描述：
d）流出流量描述；
e）终端点类型；
f）连接状态；
g）终端点映射模式：
h）终端点方向：
i）传输参数：
j）附加信息。
3通知描述
当网元配置信息发生改变后，EMS可根据要求向NMS发出相应的通知，包括：对象创建通知、对象删除通知、对象属性改变通知和对象状态改变通知。4.3.1对象创建通知（notifyObjectCreation）新的网元被创建时，EMS应支持发送创建通知给所有订购了该通知的NMS。北向接口上报的创建通知应包括如下信息：a）通知事件领域：
b）通知事件名称；
c）通知事件超时时间：
d）通知号：通知标识符，用来在需要时唯一标识通知，可进行通知的关联；e）对象的名称：
f）对象的类型；
g）EMS上报事件的时间值：
h）网元上报事件的时间值
i）通知类型；
j）保留体：创建对象的详细信息4.3.2对象删除通知（notifyObjectDeletion）网元被删除时，EMS应支持发送删除通知给所有订购了该通知的NMS。北向接口上报的删除通知应包括如下信息：a）通知事件领域：
b）通知事件名称：
c）通知事件超时时间；
d）通知号：通知标识符，用来在需要时唯一标识通知，可进行通知的关联：e）对象的名称；
f）对象的类型；
g）EMS上报事件的时间值；
h）网元上报事件的时间值：
i）通知类型；
j）保留体：始终为空。
HiiKAoNiKAca
4.3.3对象属性改变通知（notifyAttributeValueChange）网元属性改变时，EMS应支持发送属性改变通知给所有订购了该通知的NMS北向接口上报的属性改变通知应包括如下信息：a）通知事件领域：
b）通知事件名称：
c）通知事件超时时间：
d）通知号：通知标识符，用来在需要时唯一标识通知，可进行通知的关联：e）对象的名称；
f）对象的类型：
g）EMS上报事件的时间值；
h）网元上报事件的时间值：
i）通知类型；
j）发生改变的属性值列表。
4.3.4对象状态改变通知（notifyStateChange）网元状态改变时，EMS应支持发送状态改变通知给所有订购了该通知的NMS北向接口上报的状态改变通知应包括如下信息：a）通知事件领域：
b）通知事件名称：
c）通知事件超时时间：
d）通知号：通知标识符，用来在需要时唯一标识通知，可进行通知的关联；e）对象的名称：
f）对象的类型：
g）EMS上报事件的时间值：
h）网元上报事件的时间值；
i）通知类型：
j）发生改变的状态值列表。
5故障信息接口功能要求
5.1接口功能概述
故障信息接口功能见表3。
表3故障信息接口功能
接口名称
获取告警信息列表接口
5.2故障管理功能
接口功能
通过该接口获取EMS系统中的告警和事件5.2.1获取告警信息列表接口（getAllEMSAndMEActiveAlarms）NMS通过该接口，查询EMS上所有当前告警和事件，包括：a）流水号；
b）告警源；
YD/T3042.4-2016
HiiKAoNiKAca
YD/T3042.4-2016
c）告警源相关信息：
d）告警原因；
e）告警类型：
f）告警级别；
g）EMS上报事件的时间值：
h）网元上报事件的时间值；
i）标识是否可以被清除：
j）告警确认状态信息：
k）附加信息
5.3通知描述
当对象配置信息发生改变后，EMS可根据要求向NMS发出相应的通知，包括：对象属性改变通知告警确认状态改变通知、新的告警通知和清除的告警通知。5.3.1告警通知（NTALARM）
告警信息产生时，EMS应支持发送告警通知给所有订购了该通知的NMS。北向接口上报的告警应包括如下信息：a）通知事件领域：
b）通知类型：
c）通知事件名称；
d）通知事件超时时间：
e）通知号：通知标识符，用来唯一标识通知，可进行通知的关联；f）对象名：
g）产生告警的对象的相关信息；h）EMS用户界面上描述的告警原因：i）上报该告警的对象的类型；
j）EMS上报事件的时间值：
k）网元上报事件的时间值；
1）标识是否可以被清除；
m）告警类型：
n）可能原因；
o）告警级别；
p）附加信息：与通知相关的附加信息。5.3.2事件通知
事件信息产生时，EMS应支持发送事件通知给所有订购了该通知的NMS。北向接口上报的事件应包括如下信息：a）通知事件领域：
b）通知类型；
c）通知事件名称：
d）通知事件超时时间；
HiiKAoNiKAca
e）通知号：通知标识符，用来唯一标识通知，可进行通知的关联：f）对象名：
g）产生事件的对象的相关信息；h）EMS用户界面上描述的事件原因：i）上报该告警的对象的类型；
j）EMS上报事件的时间值；
k）网元上报事件的时间值；
1）标识是否可以被清除；
m）告警级别：
n）附加信息：与通知相关的附加信息。5.3.3清除的告警通知（notifyClearedAlarm）告警清除时，EMS应支持发送告警清除通知给所有订购了该通知的NMS。北向接口上报的清除告警应包括如下信息：a）通知事件领域：
b）通知类型；
c）通知事件名称：
d）通知事件超时时间：
e）通知号：通知标识符，用来唯一标识通知，可进行通知的关联；f）对象名：
g）产生告警的对象的相关信息
h）EMS用户界面上描述的告警原因：i）上报该告警的对象的类型；
j）EMS上报事件的时间值：
k）网元上报事件的时间值；
1）告警类型；
m）可能原因：
n）告警级别。
性能监控管理接口
6.1接口功能概述
性能监控管理接口的功能见表4。表4性能监控管理接口功能
接口名称
查询历史性能信息接口
6.2性能监控管理功能
接口功能
通过该接口查询满足条件的历史性能信息6.2.1查询历史性能信息接口（getHistoryPMData）YD/T3042.4-2016
NMS应能通过文件方式从EMS获取性能监控数据。NMS可通过如下信息向EMS获取性能数据a）目的地址：
YD/T3042.4-2016
b）FTP用户名：
c）FTP密码：
d）性能查询对象列表：
e）周期列表；
f）开始时间：
g）结束时间；
6.3通知描述
当性能文件开始传输时，EMS会向NMS发出文件传输状态通知。6.3.1文件传输状态通知表（notifyFileTransferStatus）北向接口上报的文件传输通知应包括如下信息：a）通知事件领域：
b）通知事件名称：
c）通知事件超时时间：
d）通知类型；
e）通知号：通知标识符，用来在需要时唯一标识通知，可进行通知的关联：f）文件的名称；
g）文件传输的当前状态：
h）文件传输完成的百分比；
i）文件传输失败的原因：文件传输失败的原因，传输成功时，这里取值为空。7心跳管理接口
7.1通知描述
EMS会持续向NMS发出心跳通知。7.1.1心跳通知表（notifyHeartbeat）北向接口上报的心跳通知应包括如下信息：a）通知事件领域：
b）通知事件名称：
c）通知事件超时时间：
d）通知号：通知标识符，用来在需要时唯一标识通知，可进行通知的关联e）对象的名称：
f）对象的类型；
g）EMS上报事件的时间值；
h）通知类型：上报的通知的类型8
返回错误码定义
返回错误码的定义见表5。
EN(error- code)
EXCPT_INTERNAL_ERROR
EXCPT_TOO_MANY_OPEN_ITERATORSEXCPT_NOT_IMPLEMENTED
EXCPT_UNABLE_TO_COMPLY
EXCPT INVALID INPUT
EXCPT_ENTITY_NOT_FOUND
接口总体技术要求
接口性能要求
接口接入能力要求
5返回错误码定义
EMS内部错误
选代子数量过多
网管不支持
YD/T3042.4-2016
ENDESC (error-description)
EMS不能执行此操作
输入非法
输入的对象不存在
EMS-NMS接口至少应支持同时接入三个用户的能力。9.1.2
接口性能要求
接口性能要求见表6。
表6接口性能要求
技术指标
通知上报
设置操作
不低于100条/秒
不需下发至网元：2秒内完成设置业务能力
：一般操作5秒内完成设置
需下发至网元：
小提示：此标准内容仅展示完整标准里的部分截取内容，若需要完整标准请到上方自行免费下载完整标准文档。