内容课件讲稿ponnbi cmpi developer guide

MR1斌2斌2.8.13斌Framework４斌“端口返回的TP5斌2.2.4Event2.66斌..273602.12.3Event.1ManagedElement 获取EmsSessionFactory会 EVENT管 功能模块...................................................................................................................................................... 网元类型判断方 查询系统所有的网元信 根据标识符查询单个网元信 端口返回的TP结构体说 方法使用举 7342 7360 Meta 故障管 启动告警过 取消告警过 查询告警过滤参 修改告警过滤参 暂停告警过 恢复告警过 同步EMS中所有的当前活动告 同步单个网元的当前活动告 按EMS同步历史告 按网元同步历史告 性能管 本文介绍贝尔EMSPON北向接口CMPI，为上层的开发和联调提供参考 PONNML-EML（主要实现静态网络资源的查询厂商系统配（主要实现告警上报，及相关功能告警性能性能性能任务改变通知用户权限管理图形用户界面切入（GUIcutthrough）AMS：贝尔PONEMS系统。CMPI是基于AMS的北向模块NMS：本文中指中国移动的综合系统，使用CORBA协议与贝尔AMS/CMPI进行对接中国移动传输厂商系统北向接术规范(无源光网络分册贝尔CMPI对外开放的接口都继承于相应的POA（对象。NMS通过向Session工厂（EmsSessionFactory_I），获得自己的emsSession。CMPI目前一共支持7种管理器，包括EMS管理（emsMgr（ManagedElement（perormaneMnagemegr（PMask（systemMgr2-1所示。

2-1CMPI贝尔会向上层提供的IDL文件，在进行连接之前，请先编译IDL文件NMS要连接到贝尔CMPI系统并获取命名服务对象，需要使用以下到信息URL：AMS_HOST_IPAMSIP地址EmsSessionFactory是CMPI系统服务的，在命名服务上的服务名是 根据用户需要，贝尔会在EMS上为传输创建相应的账号和，并赋予使用CMPI系统的相应权限，便于传输的接入。得的信息中，有部分内容是中文的，需要上层做相应的转换，否则对应的中文内容会出现乱码。UTF-8格式。要想使用贝尔CMPI系统，首先需要获得EmssessionFactory对象的。通过上述命名服务和服务narrowObjectEmsSessionFactory对象。EmsSessionFactorynameContext=_nsIOR=org.omg.CORBA.ORBorb=org.omg.CORBA.Objectnsobj=orb.string_to_object(_nsIOR);NamingContextns=NamingContextHelper.narrow(nsobj);//CORBAorg.omg.CORBA.ObjectcorbaObj=EmsSessionFactory_I_emsSessionFactory=nmsSession.idlNmsSession_IHelper.java,NmsSession_IHelper.javanarrow方法NmsSession。POAManagermanager=[]policies=neworg.omg.CORBA.policies[0]=rootPOA.create_thread_(ThreadValue.SINGLE_THREAD_MODEL);policies[1]=rootPOA.create_lifespan_(LifespanValue.PERSISTENT);policies[2]=rootPOA.create_id_uniqueness_(IdUniquenessValue.UNIQUE_ID);policies[3]=rootPOA.create_id_assignment_(IdAssignmentValue.USER_ID);policies[4]=rootPOA.create_implicit_activation_(policies[6]=rootPOA.create_request_processing_(//_userPOA_nmsSessionPOA=rootPOA.create_POA(_userbyte[]oid=NmsSessionImpl_nmsSessionServant=neworg.omg.CORBA.Objectobj=_nmsSessionPOA.id_to_reference(oid);NmsSession_I_nmsSession=NmsSession_IHelper.narrow(obj);IDL·方法：voidgetEmsSession(instringuser,instringinnmsSession::NmsSession_IoutemsSession::EmsSession_IemsSessionInterface)2-1getEmsSessionCMPICMPI户nmsEmsSession_IemsSessionemsSession.EmsSession_IHolder=newEmsSession_I_emsSession=emsSessionHolder.value;IDL·方法：voidoutCosNotifyChannelAdmin::EventChanneleventChannel)2-2getEventChannel对象，通道对EventChanel=newEventChanel_I_eventChannel=eventChannelHolder.value;IDL·方法：voidoutmanagerNames_TsupportedManagerList)2-3managerEMSmanagermanagermanagerNames_THoldersupportedManagerListHolder=newIDL·方法：voidgetManager(instringmanagerName, mon_ImanagerInterface)表2-4获取单个manager的方法的参managerstringEvent贝尔CMPI采用push的方式分发通知和告警通知。在NMS一端，可以通过如下的方式获取上CMPIEvent（push方式为例。创建一个Consumer实现类，并继承 通过调用 rHelper中的narrow方法，将步骤3中获得r窄化成一个 r对象创建1中的Consumer的一个实例调用4中获取到的 r的Consumer此时，如果Server侧（r）发送通知，Consumer的实现类的push_structured_event方法就会被调用了。只需要在该方法中处理接收到对象即可。StructuredPushConsumerPOAConsumerAdminadmin=*从获取到的ConsumerAdmin对象中获取r对象Typectype= org.omg.CORBA.IntHolderpid=neworg.omg.CORBA.IntHolder(); = r(ctype, 窄化成一个 r对象 Pushrsp=StructuredPushrHelper.narrow *获取ConsumerPOApoa=org.omg.CORBA.Objectobj=poa.servant_to_reference(this);StructuredPushConsumerref=StructuredPushConsumerHelper.narrow(obj);//在push_structured_event方法中编写处理接收到的代码，贝尔CMPI通过通道（EventChannel）上报通知通知的内容都存放在StructuredEvent对象 ble_data中，type_name2-5type_nameEMS信息、网元、ONU在StructuredEvent对象中，fil ble_data是一个Property类型的数组，每个Property对象都是以键值对的形式存放了一个Any对象，该Any对象中存放了用于描述某一通知字段相对应的内容。其中 ble_data中内容，具体如表2-26所2-6Event存放eventId，用于唯一标识globaldefs::用于描述产生的设备名称NEEMS…描述的附加属注：蓝色标记的属性是的基本属性。对于的附加属性，属性类型全部为String，属性字段的下面给出的是通知的示例（以创建OLT网元为例 -AMS:globaldefs::objectName[0].name="EMS";objectName[0].value="alca objectName[1].name="ManagedElement";objectName[1].value="183";notifications::ObjectTypeOTMANAGED…………在贝尔CMPI系统返回的网元结构体（ManagedElement_T）中，name属性可用于标识EMS中的网为“EMS为“ManagedElement）//ONT/POSOTONUONUPOSPOSIDL·Interface：managedElementManager::·方法：voidinunsignedlongoutmanagedElement::ManagedElementList_TmeList,outmanagedElement::ManagedElementItor_ImeIt)3-1getAllManagedElementsIDL·Interface：managedElementManager::·方法：voidinglobaldefs::NamingAttributes_TmanagedElementName,outmanagedElement::ManagedElement_Tme)raises3-2getManagedElementIDL·Interface：equipment:·方法：voidinglobaldefs::NamingAttributes_T inunsignedlong outEquipmentOrHolderList_T eqList,outEquipmentOrHolderI 3-3getAllEquipment上报的第一批网元设备数量的最大值3.1.4.端口和一个上联口的。IDL·Interface：managedElementManager::·方法：voidinglobaldefs::NamingAttributes_TintransmissionParameters::LayerRaist_TtyerRaist,intransmissionParameters::LayerRaist_TinunsignedlongoutterminationPoint::TerminationPointList_TtpList,outterminationPoint::TerminationPointI tor_ItpIt)3-4网元名称（网元标识符t 要获取的物理终端点的连接层速率列表上报的第一批物理端口的数量的最大值的物理端口的数量超过了how_many大小时，用于存放剩余的物理端口以下给出端口返回的TP结构体参数说明，以及如何判断端口是否被占用3-5terminationPoint::TerminationPoint_T终端点名称(包括OLT上联口、PON口和ONT上联口和业务口，POS端口口globaldefs::NamingAttributes适用于CTPtpMap3-6TPadditionalInfo0物理终端点状态(故障/占用物理终端点环回状态内环回、外环回、不环回物理终端点测试状态(态/正常状态additionalInfoNameAndStringValue_T[]meName=newmeName[0]=newNameAndStringValue_T();meName[0].name="EMS";meName[0].value="alca-meName[1]=newNameAndStringValue_T();meName[1].name="ManagedElement";meName[1].value="37";TerminationPointList_TtpList=newTerminationPointList_T(); tor_ItpIt=newTerminationPointI tor_I();,tpIt结果将在tpList中。name[0].name="EMS";name[0].value="alca name[1].name="ManagedElement";name[1].value="37";name[2].name=name[2].value="/rack=1/shelf=1/slot=21/port=1";userLabel="";nativeEMSName="";ingressTrafficDescriptorName="";egressTrafficDescriptorName="";transmissionParams="";type="TPT_PTP";connectionState="TPCS_NA";tpMapMode="TM_NA";direction="D_BIDIRECTIONAL";additionalInfo[0].value="UplinkPort";additionalInfo[1].name="speed";additionalInfo[1].value="notapplicable";additionalInfo[2].name="layer";additionalInfo[3].value="used";additionalInfo[4].name="loopback";additionalInfo[4].value="FALSE";additionalInfo[5].name="teststate";additionalInfo[5].value="normal";additionalInfo[6].name="fecenable";additionalInfo[6].value="disabled";name[0].name="EMS";name[0].value="alca-wam";name[1].name="ManagedElement";name[1].value="37";name[2].name=name[2].value="/rack=1/shelf=1/slot=7/port=4"userLabel="";nativeEMSName="";ingressTrafficDescriptorName="";egressTrafficDescriptorName="";transmissionParams="";type="TPT_PTP";connectionState="TPCS_NA";tpMapMode="TM_NA";direction="D_BIDIRECTIONAL";additionalInfo[0].value="GPONadditionalInfo[1].name="speed";additionalInfo[1].value="1Gb";additionalInfo[2].name="layer";additionalInfo[3].value="inact";additionalInfo[4].name="loopback";additionalInfo[4].value="FALSE";additionalInfo[5].name="teststate";additionalInfo[5].value="test";additionalInfo[6].name="fecenable";additionalInfo[6].value="disabled";NameAndStringValue_T[]meName=newmeName[0]=newNameAndStringValue_T();meName[0].name="EMS";meName[0].value="alca-meName[1]=newmeName[1].name="ManagedElement";meName[1].value="37/ONT-1-1-4-1-3";TerminationPointList_TtpList=newTerminationPointList_T(); tor_ItpIt=newTerminationPointI tor_I();tpIt通过执行（1）中的方法和步骤，可以获得“FX_8/ONT-1-1-4-1-3ONUPOTS口信息。其中返回的第一批结果将在tpList中。name[0].name="EMS";name[0].value="alca -wam";name[1].name="ManagedElement";name[1].value="37/ONT-1-1-4-1-3";name[2].name="PTP";name[2].value="/rack=1/shelf=1/slot=1/port=8";userLabel="";nativeEMSName="";ingressTrafficDescriptorName="";egressTrafficDescriptorName="";transmissionParams="";type="TPT_PTP";connectionState="TPCS_NA";tpMapMode="TM_NA";direction="D_BIDIRECTIONAL";additionalInfo[0].value="ETH";additionalInfo[1].name="speed";additionalInfo[1].value="auto";additionalInfo[2].name="layer";additionalInfo[3].value="inact";additionalInfo[4].name="loopback";additionalInfo[4].value="FALSE";additionalInfo[5].name="additionalInfo[5].value="testadditionalInfo[6].name="fecenable";additionalInfo[6].value="disabled";tpListTerminationPoint_T元素的结果如下（ONUPOTS口信息，移动现场一般没有配置语言业务，POTS口信息。name[0].name="EMS";name[0].value="alca -wam";name[1].name="ManagedElement";name[1].value="37/ONT-1-1-4-1-3";name[2].name="PTP";name[2].value="/rack=1/shelf=1/slot=2/port=9";userLabel="";nativeEMSName="";ingressTrafficDescriptorName="";egressTrafficDescriptorName="";transmissionParams="";type="TPT_PTP";connectionState="TPCS_NA";tpMapMode="TM_NA";direction="D_BIDIRECTIONAL";additionalInfo[0].value="POTS";additionalInfo[1].name="speed";additionalInfo[1].value="1Gb";additionalInfo[2].name="layer";additionalInfo[3].value="inact";additionalInfo[4].name="loopback";additionalInfo[4].value="FALSE";additionalInfo[5].name="teststate";additionalInfo[5].value="test";additionalInfo[6].name="fecenable";additionalInfo[6].value="disabled";name[0].name="EMS";name[0].value="alca -wam";name[1].name="ManagedElement";name[1].value="37/ONT-1-1-4-1-3";name[2].name="PTP";name[2].value="/rack=1/shelf=1/slot=100/port=1";userLabel="";nativeEMSName="";ingressTrafficDescriptorName="";egressTrafficDescriptorName="";transmissionParams="";type="TPT_PTP";connectionState="TPCS_NA";tpMapMode="TM_NA";direction="D_BIDIRECTIONAL";additionalInfo[0].value="onuUpLinkPort";additionalInfo[1].name="speed";additionalInfo[1].value="1Gb";additionalInfo[2].name="layer";additionalInfo[3].value="used";additionalInfo[4].name="loopback";additionalInfo[4].value="FALSE";additionalInfo[5].name="teststate";additionalInfo[5].value="normal";additionalInfo[6].name="fecenable";additionalInfo[6].value="disabled";NameAndStringValue_T[]meName=newmeName[0]=newNameAndStringValue_T();meName[0].name="EMS";meName[0].value= meName[1]=newNameAndStringValue_T();meName[1].name="ManagedElement";meName[1].value="37/POS-1-1-4-1-1";TerminationPointList_TtpList=newTerminationPointList_T(); tor_ItpIt=newTerminationPointI tor_I();tpIt息主要返回POS端口的定位。其中返回的第一批结果将在tpList中。name[0].name="EMS";name[0].value="alca -wam";name[1].name="ManagedElement";name[1].value="37/POS-1-1-4-1-1";name[2].name="PTP";name[2].value=/rack=1/shelf=1/slot=1/port=1";（上联口port是200）userLabel="";nativeEMSName="";ingressTrafficDescriptorName="";egressTrafficDescriptorName="";transmissionParams="";type="TPT_PTP";connectionState="TPCS_NA";tpMapMode="TM_NA";direction="D_BIDIRECTIONAL";additionalInfo[0].value="POS";additionalInfo[1].name="speed";additionalInfo[1].value="1Gb";additionalInfo[2].name="layer";additionalInfo[3].value="used";additionalInfo[4].name="loopback";additionalInfo[4].value="FALSE";additionalInfo[5].name="teststate";additionalInfo[5].value="normal";additionalInfo[6].name="fecenable";additionalInfo[6].value="disabled";73423-17342OLT73607360ISAMFX_4

3-27360ISAMFX_4NT/A21，NT/B22，ACU23AppliqueSlot7360ISAMFX_8

3-37360ISAMFX_8NT/A21，NT/B22，ACU23AppliqueSlot7360ISAMFX_16

3-47360ISAMFX_16MetaMetaFTTU

3-5MetaFTTU

3-6O16160EA16100ONUO-00240E-P

3-7O-00240E-P100ONUO-00160E-P

3-8O-00160E-P100ONU0E-P

3-9I-240E-PETH4POTS2100ONUCMPIStructuredEvent对象filble_datafilble_data是 ble_data[1]=newProperty("objectName",objectNameAny)以上示例向mEvent（StructuredEvent的实例）中的数组fil “objectNameAnyCMPI193-6在告警中，如果网元名称是中文的，CMPIUTF-8ISO-8859-1，因此NMSISO-8859-1UTF-8NMS端会出现乱码现象。3-6共5类："equipmentAlarm"（设备告警）；IDL中没有连接告警的定告警 _namenumber _name为EMS的名称用于区分不同的EMS；number是告警在该EMS中的IDNVSList；AI_NA（不确定；AI_EVENT_ACKNOWLEDGED（确认；AI_EVENT_UNACKNOWLEDGED（未确认告警源本地名称（EMS告警发生的本地原因告警发生的网元时间告警发生的EMS时间告警发生时在上的时告警结束的EMS时间告警结束时在上的时notifications::AlarmInotificationId简便；SA_UNKNOWN（不确定故障处理的建议操作条告警产生和的标识符之间要有neNativeEMSName:OLT ONU（只有被赋予名称的ONU告警才有 onuProductName：ONU贝尔CMPI支持启动设置告警上报条件来控制厂商系统向上传输系统上报的告警。IDL中的方法为：·Interface：emsMgr::·方法：voidcreateAlarmFilter(instringalarmFilterName,inglobaldefs::NamingAttributesList_TalarmSources,innotifications::PerceivedSeverityList_TseverityList,innotifications::ProbableCauseList_TprobCauseList,innotifications::ObjectTypeList_TobjectTypeList,inglobaldefs::Time_TstartTime,inglobaldefs::Time_TendTime,outAlarmFilter_TAlarmFilter)CMPI3-7createAlarmFilteralarmFilterIDL中的方法为：·Interface：emsMgr::·方法：voiddeleteAlarmFilter(instringalarmFilterName)3-8deleteAlarmFilterCMPINMS查询告警过滤参数，查询当前的告警过滤条件及其参数。IDL中的方法为：·Interface：emsMgr::·方法：voidgetAlarmFilter(instringalarmFilterName,outAlarmFilter_TAlarmFilter)3-9getAlarmFilterCMPINMS修改告警过滤参数，对告警过滤条件进行设置修改。IDL中的方法为：·Interface：emsMgr::·方法：voidinoutAlarmFilter_TAlarmFilter)3-10setAlarmFilterCMPINMS暂停告警过滤的执行。IDL中的方法为：·Interface：emsMgr::·方法：voidsuspendAlarmFilter(instringalarmFilterName,outAlarmFilter_TAlarmFilter)3-11suspendAlarmFilteralarmFilterCMPINMS恢复告警过滤，对暂停的告警过滤进行恢复。IDL中的方法为：·Interface：emsMgr::·方法：(1)voidactivateAlarmFilter(instringalarmFilterName,outAlarmFilter_TAlarmFilter)(2)voidreverseAlarmFilter(instringalarmFilterName,outAlarmFilter_TAlarmFilter)3-12alarmFilter通过接口，NMSEMS中所有的活动告警。IDL中的方法为：·Interface：emsMgr::·方法：voidinnotifications::ProbableCauseList_TexcludeProbCauseList,innotifications::PerceivedSeverityList_TexcludeSeverityList,inglobaldefs::Time_TstartTime,inglobaldefs::Time_TendTime,inunsignedlonghow_many,outnotifications::EventList_TeventList,out tor_I3-13方法getAllEMSAndMEActiveAlarms告警原因（告警类型批中通过接口，NMSIDL·Interface：managedElementManager::·方法：voidinglobaldefs::NamingAttributes_Tinnotifications::ProbableCauseList_TexcludeProbCauseList,innotifications::PerceivedSeverityList_TexcludeSeverityList,inglobaldefs::Time_TstartTime,inglobaldefs::Time_TendTime,inunsignedlonghow_many,outnotifications::EventList_TeventList,out tor_I3-14getAllActiveAlarms告警原因（告警类型批中IDL中的方法为：·Interface：emsMgr::·方法：voidinnotifications::ProbableCauseList_TexcludeProbCauseList,innotifications::PerceivedSeverityList_TexcludeSeverityList,inglobaldefs::Time_TstartTime,inglobaldefs::Time_TendTime,inunsignedlonghow_many,outnotifications::EventList_TeventList,out tor_I3-15方法getAllEMSAndMEActiveHistoryAlarms告警原因（告警类型批中IDL中的方法为：·Interface：managedElementManager::·方法：voidinglobaldefs::NamingAttributes_Tinnotifications::ProbableCauseList_TexcludeProbCauseList,innotifications::PerceivedSeverityList_TexcludeSeverityList,inglobaldefs::Time_TstartTime,inglobaldefs::Time_TendTime,inunsignedlonghow_many,outnotifications::EventList_TeventList,out tor_I3-16方法getAllActiveAlarms告警原因（告警类型批中根据《技术规范》要求，CMPI3-17CPUCPUMemoryOLT/ONUPONUNINNILossofErroredSeverelyIngressEgressIngressIngressIngressIngressIngressEgressEgressEgressEgressEgressIngressOctets64数IngressOctets65to127IngressOctets128to255IngressOctets256to511IngressOctets512to1023IngressOctets-1024toMaxsizeSeverelyFCS数Single数Multiple数inOctets