33中国联通传输网网络管理系统技术规范V10 第五分册 部省级网管系统接口规范.docx

1、33中国联通传输网网络管理系统技术规范V10 第五分册 部省级网管系统接口规范 中国联通公司发布2004-06-20实施2004-06-20发布中国联通传输网网络管理系统技术规范第五分册 部省级网管系统接口规范Transport Network Management System Technical Specification（报批稿V1.0）QB/CU 332004中国联通公司企业标准目 次前 言 II1 范围 12 规范性引用文件 13 符号及缩写 14 部省两级网管系统间的接口方式 15 部省两级网管系统的接口定义 25.1 接口功能需求 25.1.1 配置接口功能需求 25.1.2 告

2、警故障接口功能需求 35.1.3 性能接口功能需求 35.1.4 报表接口功能需求 35.1.5 工单接口功能需求 35.2 CORBA接口 45.2.1 命名服务定义 45.2.2 操作序列图 45.2.3 IDL接口分析 115.2.4 IDL接口定义 235.3 文件接口 315.3.1 配置（资源）文件的Schema定义 315.3.2 告警文件的Schema定义 445.3.3 性能文件的Schema定义 475.3.4 报表文件的Schema定义 485.3.5 工单文件的Schema定义 53附 录 A （规范性附录） 过滤条件的约定 68A.1. 概述 68A.2. 定购通知中

3、的约束 68A.3. 修改通知过滤条件中的约束 68A.4. 配置数据同步中的约束 68A.5. 配置数据上报设置中的约束 68A.6. 告警查询中的约束 68附 录 B （资料性附录） 网络管理数据文件XML Schema介绍 70B.1. XML简介 70B.2. DTD与XML Schema的比较 70B.3. 网管系统间文件传递流程 70前 言本规范是中国联通传输网网络管理系统技术规范系列技术规范中的第五分册。该系列规范的结构及名称如下：（1） 中国联通传输网网络管理系统技术规范 第一分册 总册；（2） 中国联通传输网网络管理系统技术规范 第二分册 总部网管系统功能规范；（3） 中国联

4、通传输网网络管理系统技术规范 第三分册 一干网管系统功能规范；（4） 中国联通传输网网络管理系统技术规范 第四分册 省级（二干、本地）网管系统功能规范；（5） 中国联通传输网网络管理系统技术规范 第五分册 部省级网管系统接口规范；（6） 中国联通传输网网络管理系统技术规范 第六分册 SDH接口规范；（7） 中国联通传输网网络管理系统技术规范 第七分册 WDM接口规范；（8） 中国联通传输网网络管理系统技术规范 第八分册 部省级接口测试规范。本标准主要起草单位：信息产业部电信传输研究所，中国联通有限公司。本标准主要起草人：徐贵宝，丛日刚，王燕，张德华，陈忠民，李财云，牛莹。本标准的修改和解释权属

5、中国联通有限公司。中国联通传输网网管系统技术规范第五分册 部省级网管系统接口规范1 范围本文档规定了中国联通传输网总部网管系统与一干传输网网管系统及各二干/本地传输网网管系统（以下统称为省级网管系统）之间的接口功能需求和接口信息。 本规范适用于中国联通传输网总部网管系统与一干及各省级传输网网管系统间接口的规划、设计和实施。2 规范性引用文件无。3 符号及缩写本技术规范使用以下缩写：XMLeXtensible Markup LanguageCORBACommon Object Request Broker Architecture4 部省两级网管系统间的接口方式 鉴于中国联通传输网网管建设的需求

6、和现状，总部综合网管系统和一干及省级综合网管系统之间通过CORBA接口和文件传输接口进行管理信息的交互（如图1所示）。数据通信网DCN提供部省两级网管系统间数据传送的物理通路。CORBA接口用来传递总部综合网管系统和省级综合网管系统之间的数据请求、应答以及实时的告警通知等；文件接口用于传递批量数据，如配置数据、告警故障同步数据、性能数据、报表数据、工单数据等。图2 接口示意图总部综合网管系统和一干、省级综合网管系统之间管理命令的交互采用CORBA接口，CORBA接口应支持总部综合网管系统下发的服务请求和请求结果的上报，同时也支持一干和省级综合网管系统管理信息的主动上报。总部综合网管系统和一干、

7、省级综合网管系统之间的文件接口采用支持FTP协议的接口。5 部省两级网管系统的接口定义5.1 接口功能需求总部综合网管系统与一干和省级综合网管系统的接口需求如表1所示。表1 ：部省接口功能需求接口功能接口内容查询（同步）功能实时通知定时上报过滤能力 配置数据有(同步一干或某省网内或其中某些地区的当前配置数据)无有(定时上报一干或某省网当前的配置信息)有（总部有能力设置上报何种类型的配置数据，以减少网络传输的负载）告警数据/故障分析数据有(同步一干或某省网内的告警数据和故障分析数据)有(实时/准实时通知一干或某省网内特定告警的产生和改变,以及故障分析数据的产生等)无有(总部有能力设置上报何种告警

8、/故障分析数据, 以减少网络传输的负载)性能数据有(查询一干或某省网某时段内产生的特定性能数据)无有(定时上报一干或某省网内或某些地区要求时段的性能数据)有（总部有能力设置采集何种性能数据，以减少网络传输负载）报表数据有(查询一干或某省网某时段内产生的报表)无有(定时上报一干或某省网内的所有新报表)无工单数据总部和省级（含一干）综合网管系统可通知对方系统工单已准备好。5.1.1 配置接口功能需求通过配置数据接口，总部综合网管系统能够综合了解到各省传输资源的配备和使用情况，统计全网资源，以便加强管理，发挥效益，并据此完成总部拓扑显示。配置数据接口功能需求包括配置数据的同步和配置数据的定时上报。配

9、置数据的同步功能是指在需要时总部综合网管系统可以对一干或某省网内或其中某些地区的设备资源配备信息进行同步，以保持总部综合网管系统和省级综合网管系统配置数据的一致性。配置数据的定时上报功能指一干系统或省级综合网管系统应按要求定时上报该省网当前的配置信息，总部综合网管系统可以对上报的周期进行设置。配置数据的上报过滤功能是指在需要时总部综合网管系统能够设置配置数据上报的过滤条件（如：VPN租线客户、租线电路名称等），只有符合条件的配置数据才能由一干或省级综合网管系统传送给总部综合网管系统。配置数据以文件方式上报，配置文件的Schema定义见5.3.1。5.1.2 告警故障接口功能需求总部综合网管系统

10、能够通过告警故障数据接口对各省网络中的重要告警或故障分析数据进行实时或准实时监视，以掌握传输网络运行状况。告警故障数据接口功能需求包括告警故障过滤功能、实时告警通知功能/准实时故障分析数据通知功能和告警故障数据查询同步功能。告警故障过滤功能是指总部能够设置告警故障的上报条件（如按照告警源、告警类型、告警级别、业务类型、VPN租线客户名称、租线电路名称等进行上报），只有符合条件的告警故障数据才能由一干或省级综合网管系统传送给总部综合网管系统。实时告警通知功能/准实时故障分析数据通知功能是指当一干或省网中有符合上报条件的告警和故障产生时，一干或省级综合网管系统应向总部综合网管系统实时通知告警和故障

11、信息。告警故障数据查询功能是指当需要时（如进行告警相关分析或统计），总部综合网管系统可将一干或各省级网管系统的历史告警信息和故障信息进行条件设置的查询。告警数据同步功能是指当需要时（如由于接口通信问题或其他原因导致实时告警通知的丢失），总部综合网管系统可将一干或各省网内当前的活跃告警信息进行同步。所同步的活跃告警也需符合告警过滤中设置的过滤条件。告警数据以文件方式上报，数据文件的Schema定义见5.3.2。注：活跃告警指尚未清除的告警；历史告警指已经清除的告警。5.1.3 性能接口功能需求性能数据的接口功能需求包括性能数据的定时上报和性能数据的补取查询。通过该接口，总部综合网管系统可以对性能

12、数据定时采集、上报的参数进行过滤设置（如可设置业务性能数据过滤条件：给定VPN租线客户名称、租线电路名称等），一干或省级综合网管系统应按要求定时上报此段时间间隔内新产生的性能数据。同时，总部综合网管系统可进行性能数据的补取（即性能数据的查询功能）。性能数据以文件方式上报，性能文件的Schema定义见5.3.3。5.1.4 报表接口功能需求报表接口用于一干或各省级综合网管系统向总部综合网管系统传递总部要求的报表，报表的内容和采集时间参照中国联通的相关规定。 报表的接口功能需求包括报表的定时上报和报表的补取查询。总部综合网管系统可以对一干或各省报表定时上报的周期进行设置，一干或省级综合网管系统应按

13、要求定时上报此段时间间隔内新产生的报表数据。当总部综合网管系统在必要时需对报表进行补取或查询时，可通过向一干或省级综合网管系统下发查询命令来获取所需报表。报表数据以文件方式上报，报表文件的Schema定义见5.3.4。5.1.5 工单接口功能需求工单接口用于总部综合网管系统与一干或各省级综合网管系统间相互通报工单已准备好。工单数据以文件方式上报，工单文件的Schema定义见5.3.5。5.2 CORBA接口5.2.1 命名服务定义本规范采用OMG的命名服务来完成对对象引用的访问。命名服务部署在总部综合网管系统，一干和省级综合网管系统需向命名服务进行注册，注册约定如下所示。命名服务自身的引用使用

14、corbaloc以URL的方式发布。各省注册时，以各省的省名进行注册，省名为拼音的全称，首字母大写，其余为小写。其中陕西省注册为Shanxi，山西省注册为Shanxi2。Yigan指一干综合网管系统。5.2.2 操作序列图5.2.2.1 修改通知过滤条件 NNMC通过向PNMC发送comModifyFilter请求来对PNMC上报的通知（包括数据准备好通知、告警、故障数据等）进行限制（可通过OMG的通知头中的“type_name”域对数据准备好通知、告警信息，或故障信息等进行过滤）。comModifyFilter response5.2.2.2 配置数据管理5.2.2.2.1 配置数据同步当N

15、NMC需要向PNMC进行配置管理数据同步时, NNMC向PNMC发送cmSync请求， PNMC收到后给出响应, 表示PNMC已收到该请求, 与此同时, PNMC开始准备数据，NNMC开始等待数据。当PNMC准备好数据后, 则向NNMC发送数据准备好（DATA_READY）通知, NNMC收到该通知后可通过FTP协议从PNMC处取数据文件, 当数据传输完毕或传输中断（传输中断导致失败的后续操作参见5.2.3.2.2，下同。）则向PNMC发送comDataRetrieved命令，表示数据的接收情况，PNMC收到后应给出响应。5.2.2.2.2 设置配置数据定时上报参数NNMC可设置PNMC定时上

16、报配置数据的参数，如需要上报配置数据的网元类型、业务类型等，上报时间或时间间隔。NNMC向PNMC发送cmSetReport请求，PNMC应给出响应以示设置成功与否。5.2.2.2.3 配置数据定时上报当配置数据定时上报参数设置成功后，PNMC应按要求定时上报该省网当前的配置数据，包括所有网元的信息。在设定时间到达时,PNMC应向NNMC发送数据准备好（DATA_READY）通知，告知上报的数据文件（当前省网的配置信息）已准备好，NNMC收到该通知后可通过FTP协议从PNMC处取数据文件, 当数据传输完毕或传输中断则向PNMC发送comDataRetrieved，PNMC收到后即给出响应。5.

17、2.2.3 告警故障数据管理5.2.2.3.1 告警数据同步当NNMC需要向PNMC进行告警数据同步时（同步当前活跃告警数据）, NNMC向PNMC发送fmSync请求，PNMC收到应给出响应表示PNMC已收到消息, 与此同时, PNMC开始准备数据，NNMC则开始等待数据。当PNMC准备好数据后, 则向NNMC发送数据准备好（DATA_READY）通知, NNMC收到该通知后可通过FTP协议从PNMC处取数据文件, 当数据传输完毕或传输中断则向PNMC发送comDataRetrieved，PNMC收到后应给出响应。5.2.2.3.2 告警故障数据查询当NNMC需要向PNMC进行告警故障数据的

18、查询时, NNMC向PNMC发送fmQuery请求，PNMC收到应给出响应表示PNMC已收到消息, 与此同时, PNMC开始准备数据，NNMC则开始等待数据。当PNMC准备好数据后, 则向NNMC发送数据准备好（DATA_READY）通知, NNMC收到该通知后可通过FTP协议从PNMC处取数据文件, 当数据传输完毕或传输中断则向PNMC发送comDataRetrieved，PNMC收到后应给出响应。5.2.2.3.3 告警故障实时通知 告警故障信息实时通知包括告警信息实时通知功能和故障分析信息准实时通知功能，其中告警信息通知包括新告警和告警状态改变两大类通知。当有上述事件产生时，且符合告警故

19、障过滤的选择条件，PNMC将实时向NNMC上报这些通知。5.2.2.4 性能数据管理5.2.2.4.1 设置性能数据定时采集上报任务当NNMC需要设置PNMC定时采集上报性能数据时，NNMC向PNMC发送pmSetReport请求，PNMC应给出响应以示设置成功与否。总部综合网管系统可以设置性能采集的对象、也可以设置性能数据定时采集上报任务的周期、开始时间、上报任务的工作状态（启动或暂停该上报任务）等。5.2.2.4.2 性能数据定时上报PNMC应在规定的时间将产生的性能数据准实时上报给NNMC。当规定的上报时间到达时，PNMC应向NNMC发送数据准备好（DATA_READY）通知，告知要上报

20、性能数据，NNMC收到该通知后可通过FTP协议从PNMC处取数据文件, 当数据传输完毕或传输中断则向PNMC发送comDataRetrieved，PNMC收到后应给出响应。5.2.2.4.3 性能数据查询当NNMC需要向PNMC查询某个时段的性能数据时, NNMC向PNMC发送pmQuery请求，PNMC收到应给出响应表示已收到该请求,与此同时, PNMC开始准备数据，NNMC则开始等待数据。当PNMC准备好数据后, 则向NNMC发送数据准备好（DATA_READY）通知, NNMC收到该通知后可通过FTP协议从PNMC处取数据文件, 当数据传输完毕或传输中断则向PNMC发送comDataRe

21、trieved，PNMC收到后应给出响应。5.2.2.5 报表数据管理5.2.2.5.1 设置报表定时上报任务当NNMC需要设置PNMC定时上报报表时，NNMC向PNMC发送rfSetReport请求，PNMC应给出响应以示设置成功与否。总部综合网管系统可以设置报表数据定时上报任务的周期（一般周期设为一天）、开始时间以及上报任务的工作状态（启动或暂停该上报任务）。5.2.2.5.2 报表定时上报PNMC应在规定的时间将当天产生的报表上报给NNMC。当规定的上报时间到达时，PNMC应向NNMC发送数据准备好（DATA_READY）通知，告知要传送报表，NNMC收到该通知后可通过FTP协议从PNM

22、C处取数据文件, 当数据传输完毕或传输中断则向PNMC发送comDataRetrieved消息，PNMC收到后应给出响应。5.2.2.5.3 报表查询当NNMC需要向PNMC查询某个时段的报表时, NNMC向PNMC发送rfQuery请求，PNMC收到后应给出响应表示已收到该请求, 与此同时, PNMC开始准备数据，NNMC则开始等待数据。当PNMC准备好数据后, 则向NNMC发送数据准备好（DATA_READY）通知, NNMC收到该通知后可通过FTP协议从PNMC处取数据文件, 当数据传输完毕或传输中断则向PNMC发送comDataRetrieved，PNMC收到后应给出响应。5.2.2.

23、6 工单数据管理5.2.2.6.1 总部通报工单已准备好当NNMC已经准备好工单时，NNMC向PNMC发送sheetReady请求，PNMC应给出响应以示成功收到该请求与否。PNMC收到该请求后可通过FTP协议从NNMC处取数据文件。5.2.2.6.2 省级或一干通知工单已准备好当PNMC已经准备好工单时，PNMC向NNMC发出通知：sheetReady，告知要传送工单，NNMC收到该通知后可通过FTP协议从PNMC处取数据文件, 当数据传输完毕或传输中断则向PNMC发送comDataRetrieved消息，PNMC收到后应给出响应。5.2.3 IDL接口分析5.2.3.1 概述下表列出本规范

24、定义的各类操作或通知，其中NNMC代表总部综合网管系统，PNMC代表一干或省级综合网管系统。表2：IDL接口（请求/通知）一览表接口类别名称类型方向含义通用类comDataRetrieved请求NNMC-PNMC通知对方数据文件取到情况comSubscribe请求NNMC-PNMCNNMC向PNMC定购通知comUnsubscribe请求NNMC-PNMCNNMC向PNMC撤销定购comModifyFilter请求NNMC-PNMCNNMC向PNMC修改通知过滤条件配置管理类同步功能cmSync请求NNMC-PNMCNNMC要求同步PNMC的配置数据配置改变定时上报cmSetReport请求N

25、NMC-PNMCNNMC设置PNMC配置数据定时上报参数告警管理类同步功能fmSync请求NNMC-PNMCNNMC要求同步PNMC的所有符合过滤条件的活动告警数据查询功能fmQuery请求NNMC-PNMCNNMC要求同步PNMC的所有符合过滤条件的活动告警数据性能管理类设置性能数据定时采集上报参数pmSetReport请求NNMC- PNMCNNMC设置PNMC性能数据上报参数，如起始时间、上报周期等。查询性能数据pmQuery请求NNMC- PNMCNNMC主动向PNMC查询某个时间段所需的性能数据报表管理类设置报表定时上报参数rfSetReport请求NNMC- PNMCNNMC设置P

26、NMC报表上报参数，如起始时间、上报周期等。查询报表数据rfQuery请求NNMC- PNMCNNMC主动向PNMC查询所需的某个时间段的报表工单管理类通报工单已准备好sheetReady请求NNMC-PNMCNNMC主动告诉PNMC，总部的工单已准备好。通知类数据准备好通知push_dataReady通知PNMC-NNMC通知对方相应数据文件已准备好告警通知push_alarm通知PNMC-NNMCPNMC向NNMC实时上报符合过滤条件的告警通知告警状态改变通知push_alarmChange通知PNMC-NNMCPNMC向NNMC上报告警状态改变通知故障分析数据通知push_fault通知

27、PNMC-NNMCPNMC向NNMC实时上报符合过滤条件的故障分析数据通知工单准备好push_sheetReady通知PNMC-NNMCPNMC向NNMC通知省级（或一干）的工单已准备好。5.2.3.2 接口操作分析5.2.3.2.1 概述本规范定义的操作中，每个操作都具备参数invokeId，其值唯一标识了本操作的流水号，该流水号由NNMC侧生成。5.2.3.2.2 comDataRetrieved操作说明：通过该操作，NNMC告知PNMC数据文件取到情况，参数中对各数据文件的获取状态进行说明，包括所获取的的文件名和文件状态，文件状态包括：成功取到、文件未找到导致的失败、文件格式错误导致的失

28、败、传输中断导致的失败及其他原因导致的失败等。PNMC收到该消息后，若文件状态为成功取到，则NNMC在收到PNMC返回的应答后结束此次会话；若文件状态为失败，则PNMC将根据返回的失败原因进行调整，并采取适当的重传机制，对于未成功传输的数据文件，重新向NNMC发送数据准备好通知，请求再次传递这些未成功获取的数据文件。输入参数：invokeId “参数invokeId的值唯一标识了本操作的流水号。” notificationId “NNMC在收到某个数据准备好通知后，会获取相应数据文件，本操作是对获取结果的指示，参数notificationId的值对应该“数据准备好通知”的通知标识符，通知标识符

29、为本省内通知的唯一标识，整型。”fileResult“参数fileResult定义了数据文件获取的结果，包括每个文件的文件名（全路径名）和文件状态，文件状态包括：成功取到、文件未找到导致的失败、文件格式错误导致的失败、传输中断导致的失败及其他原因导致的失败等。”输出参数 无。5.2.3.2.3 comSubscribe操作说明：本规范中使用CORBA的通知服务来完成通知的上报。NNMC通过此操作向PNMC定购需要上报的通知，通知类型可能包括告警通知、告警变化通知、故障分析数据通知、数据准备好通知等（对通知类型的过滤可通过OMG的通知头中的“type_name”域进行过滤）。定购成功后，PNMC

30、将根据定购要求向NNMC上报相应的通知。NNMC可提供撤销定购操作将其撤销，若NNMC退出PNMC，该定购也将被撤销。该操作将通知的定购在接口上进行封装，即在接口上CORBA的通知通道不可见。PNMC接收到该操作后，将创建SequenceProxyPushSupplier对象，由该对象调用connect_sequence_push_consumer操作完成事件接收者对象（见输入参数consumerRef）与事件通道的对应关系。输入参数consumerRef : SequencePushConsumer“输入参数consumerRef是NNMC侧事件接收者对象的引用（IOR），事件通道通过对consumerRef调用push操作将事件信息传送给NNMC。该参数的类型是从CORBA事件服务中CosNotifyComm 模块导入的SequencePushConsumer类型。”constraintList : ConstrainExpSeq“输入参数constraintList定义过滤条件，由PNMC设置事件通道，从而实现对通知的过滤。其类型为从CORBA事件服务中CosNotifyFilt