接口培训资料

1、移动网管数据采集接口知识培训2005年11月26日目录接口综述告警采集接口资源(配置)采集接口性能采集接口操作维护接口Q3接口CORBA接口接口在网管系统中的作用位于网管系统与被管理设备之间为整个网管系统提供数据来源,是决定网管系统可用性的基石可靠性、及时性的要求高，日常维护工作量大实现方式复杂多样，涉及的开发技术范围广非常重要，是网管系统开发商入闱测试中最重要的测试部分 被管理网元数据采集机网管系统接口分类（按功能）告警数据采集接口资源管理（配置管理）数据采集接口性能数据采集接口操作维护交互接口接口综述告警采集接口资源(配置)采集接口性能采集接口操作维护接口Q3接口CORBA接口目录标准告警

2、认识告警号告警记录流水号告警对象类型发生告警的对象类型告警对象发生告警的对象标识告警类型告警的类型（取值可为通信告警、设备告警、环境告警、服务质量告警和处理错误管理）告警级别告警级别（取值可为紧急、主要、次要、提示）告警原因告警原因告警原始类型由网元报上来的告警原始类型告警原始级别由网元报上来的告警原始级别告警原始原因由网元报上来的告警原始原因告警发生时间告警发生时间告警确认时间告警确认时间（若未确认，则该域为空）告警清除时间告警清除时间（若未清除，则该域为空）告警确认者告警确认人用户名（若未确认，则该域为空）告警清除者告警清除人用户名（若告警的清除是由于被管系统故障恢复后自动上报的，则该域为

3、空）活动状态未清除告警为当前告警，已清除告警为历史告警告警详细说明对告警进行详细描述告警附加内容告警附加信息趋势某对象的告警级别趋势（可选）告警处理经验相应告警原因的处理经验原始告警认识-SIEMENSTMN ALARM MESSAGEALARM OBJECT : MAL MESSAGE NUMBER : 20537ALARM PRIORITY : MAJOR ALARM DATE : 98-10-27ALARM STATUS : NOTPROC ALARM TIME : 09:13:16ALARM TYPE : COMMUNICATIONS ALARM PROBABLE CAUSE : LO

4、SS OF SIGNAL ALARM-ID: CLASS=PCMMAL LTG=0-24 DIU=1 END TEXT 1276 告警对象“MAL“告警消息号“20537”告警级别”MAJOR主要告警“告警日期“98-19-27”告警状态“没有处理”告警时间“09：13：16”告警类型“通信告警”告警可能原因“信号丢失”告警ID“CLASS=PCMMAL LTG=0-24 DIU=1” 原始告警认识-MOTOROLA#0 - NOT APPL - *NONE*. communicationFailureEvent - MTL - CSMBSC421(CSMBSC421:SITE-0:): 0

5、MTL 9 - 07/04/2005 09:13:05. 0 Signalling Link Failure - FMIC - Critical -/-. Config Tag 800826 10 0A 15 00 00 04 .A B CD E F GH I J KA - 消息编码; B - 告警状态; C - 用户信息; D - 告警类型E - 设备类型; F - 设备具体位置; G - 告警时间; H -告警代码 ;I - 代码内容; J - 告警消息的消除类型; K - 告警级别 原始告警数据-华为+ HW_SWITCH 2004-04-06 11:44:46ALARM 304241

6、故障告警 重要告警 354 对象编号 = 27 对象名称 = ZBD1 对象类型 = iMSC 网元编号 = 27 网元名称 = ZBD1 网元类型 = iMSC 模块编号 = 0 告警名称 = GSTU/GE16板上E1故障 网管类型 = 设备告警 定位信息 = 场地号=0 行号=0 列号=1 框号=5 槽号=5 板号=19 端口号=1 详细解释 = GE16板提供16个E1接口，将E1信号中的数据和信令先分离，再复接成两条传业务的16MHW和一条传模块间控制信令的2MHW，再通过GQSI收敛后将数据信号传至CNET（中央交换网），信令传至CCM（通信控制框）。可能产生此告警的原因：1.GE

7、16板上的PCM线路故障；2.GE16板上的E1端口配置数据错误；3.GE16板上E1端口损坏。 修复建议 = 确认可能异常的E1，然后：1.检查GE16板的E1配线是否接好。2.检查GE16板E1端口后台配置数据，是否和实际用的E1端口相一致。3.可能E1端口故障，考虑更换损坏的GE16板。- END告警采集接口介绍为网管系统提供告警数据来源及时性， 接口程序在运行时产生的开销要尽量小，采集到的数据要 尽快送到网管系统的告警数据库中，此过程的产生延时有着明确的限定。稳定性，必须是“永久”运行的，任何的中断都将导致丢失数据。所以告警采集接口必须要有自我检查、重启机制，以在发生程序错误时自动重启

8、 。大部分情况下是单向接口，仅在做告警同步时需要向网元发送命令。告警数据采集接口开发技术专用命令方式，设备厂商在其系统上提供一条专用的命令，运行此命令后，就可以在该命令的标准输出上得到所需的设备告警消息 SOCKET端口方式，设备厂商在OMC系统上以server方式在TCP/IP协议的某个端口上提供告警消息，采集程序需要以client方式连接该端口，经过一系列的鉴权后，就可以从此SOCKET上得到告警消息 TMN标准接口方式，目前有Q3接口和CORBA接口两种（相关介绍请参见后面章节） 直连网元方式，这种方式下设备通过其硬件端口（X.25接口、RS232串口等等）送出告警数据，采集方往往需要先

9、用一定的硬件设备（如IOLAN、PAD等设备等）连接这些端口，然后才能采用软件编程的方式获得告警数据 文件方式，这种情况下设备方面在其OMC系统的告警文件中生成告警消息，采集程序需要不断地查询文件以获取最新的告警消息 其他方式，如查询OMC的数据库等 告警采集程序现状负责工作: 从网元采集原始告警消息,将原始告警格式化成标准告警消息后添加一定的说明字段,然后将分析后的消息压入TUXEDO队列.队列的另一端是告警监控模块的alarmrec,已不属于接口模块的功能范畴.告警采集程序架构统一:在运行时生成一个主进程和一组子进程.其中主进程负责为每个要采集的网元生成一个采集子进程并监督这些子进程的运行

10、情况,而子进程则负责具体的告警采集工作.目前每种网元都配备有相应的告警采集程序,全部用C语言写成.经过了两次版本升级,目前正在项目现场运行的是第二版,源码位于tuxsrc/alcol_v2.0目录下,功能已稳定;日常维护工作非常多,在接口工作中所占的比重最大.最版本的告警采集程序目前正在测试中,即将后面将要介绍的“集中告警采集系统”。告警采集程序流程介绍主进程开始使自己成为后台守护进程读配置文件形成采集网元列表为列表的每个网元派生一个采集子进程检查采集子进程有子进程退出?更新采集网元列表采集子进程开始读原始告警消息读取成功?分析原始告警消息形成完整告警?压TUXEDO队列成功?子进程退出在主进

11、程内?NNNNYYYYYN告警程序现状 程序列表sdunicoma$pwd/u1/tmn/tuxsrc/alcol_v2.0sdunicoma$lsalarmCount alcol_boc alcol_nortel_bsm alcol_ztealarmExam alcol_eastcom_in alcol_nortel_bss-q3 alcol_zte_in_cdmaalarm_autodeal alcol_eric_ne alcol_nortel_cmsc alcol_zte_monalarm_check_time alcol_eric_oss alcol_nortel_sdm alcol_

12、zte_smc3.0alarm_durg_deal alcol_hw_gsm-in alcol_pfalarm alcol_zx_pbxalarm_freqdeal alcol_hw_scp alcol_pm_self alrmDelaySndalarm_hour_check alcol_lucent_omp alcol_pm_self.tar alsyn_ericalcol_alcatel_bss alcol_moto_gprs30 alcol_pm_zte alsyn_nortelalcol_alcatel_ismc alcol_moto_omc alcol_pm_zte.old auto

13、Checkalcol_alcatel_msc alcol_nokia_msc alcol_server bak_fxjalcol_alcatel_q3 alcol_nokia_rnc alcol_siemens_bss nokia_alarm_testalcol_bell alcol_nortel alcol_siemens_q3 tmpsdunicoma$接口综述告警采集接口资源(配置)采集接口性能采集接口操作维护接口Q3接口CORBA接口目录资源管理（配置管理）采集接口主要为网管系统的资源管理模块提供所需数据 特点是要采集的数据量大，但对及时性要求不高，而是周期运行的（运行周期一般为一天或

14、一周）。 由于配置数据的变动情况相对较少，所以对该类接口对采集完整性要求也不是很高，一般情况下，本次采集周期没有采集到的数据可以在下次运行周期时采集补充，不必刻意实现补采机制 大部分情况下为双向接口，即采集数据时需要与被管理网元交互资源数据采集接口开发技术专用命令，一般在OMC系统上提供一条专用的命令，运行此命令后就可以得到配置数据数据库接口方式，即采用查询OMC数据库的方法来得到所需的配置数据。这种采集方式在早期的接口系统中曾经使用过（如中兴、华为的GSM交换和无线系统的采集接口），目前已比较少见 读取文件方式，这种情况下设备方面在OMC系统上定期生成配置数据文件，采集系统通过FTP等工具拷

15、贝即可 TMN标准接口方式，目前有Q3接口和CORBA接口两种（相关介绍请参见后面章节） 登录网元查询方式，即登陆到网元设备上发送命令查询相关的配置数据，这也是目前我们采用的最普遍（在SIEMENS、NORTEL、ALCATEL、ERICSSON、华为等等设备都有应用）的采集方式 目前大部分用语言实现也有shell或perl语言版本资源数据采集程序现状负责工作：将原始数据从网元上采集下来生成文件，放置到预定目录下即可。不负责分析和入库工作。目前已经通过“集中数据采集程序”（get）和“代理系统”（proxy）初步实现了资源管理数据的集中采集，涉及设备包括ERICSSON、SIEMENS、NOR

16、TEL、ALCATEL、HUAWEI、MOTOROLA等。LUCENT、ZHONGXING等厂家设备因不能够提供操作维护接口，还在使用专用的资源管理数据采集程序。大部分厂家的无线资源管理数据也通过专用采集程序采集。CDMA网管的资源管理数据主要由CORBA接口来采集，目前设备厂家包括ZHONGXING、ALCATEL、SAMSUNG。日常维护工作大部分都在“集中数据采集程序get”和CORBA接口方面，工作量较大。Get程序介绍集中化的数据采集程序，依托代理系统proxy，仿真普通的代理系统用户工作。适合于能提供命令行方式的操作维护接口的设备，使用命令交互方式（即发采集命令，接收返回数据）实现

17、数据采集工作。不但可用于资源管理数据的采集，还可用于局数据、网元巡检等方面的数据采集，目前这三部分的数据都由该程序实现。位于项目网管服务器的“$HOME/bin”目录下，包括get、get、get等一组程序。日志文件位于“$HOME/log”目录下，详细记录采集的每个步骤。用C语言编写，已经过多次版本升级，最新版本号为3.15，功能已非常稳定。一般在调度系统的驱动下运行，自动完成数据采集工作。也可以用手工方式运行。运行格式: get nename -cmdid -sessid -outdir -cmdstr “命令字符串”。通过标准输出报告采集任务完成与否。接口综述告警采集接口资源(配置)采集

18、接口性能采集接口操作维护接口Q3接口CORBA接口目录性能数据采集接口为网管系统的性能管理模块（或性能报表系统）提供所需数据 周期运行的，运行周期一般为15分钟、30分钟、1小时等该类接口对数据的即时性、完全性要求非常严格，在中国移动、联通所颁发的网管规范中，对此接口产生延时也有着明确的限定 该类接口对采集完整性要求很高，采集程序一定要有补采机制，以备在在采集周期中丢失数据时重采数据 一般为单向接口，即采集时不需要和网元交互性能数据采集接口开发技术读取文件方式，即设备方面在OMC等系统的特定目录下定期生成性能测量文件，而采集程序则是用FTP或UNIX系统的rcp等工具定期来读取这些数据文件。这

19、种方法简单、高效、稳定，产生的延时也很小，是目前应用最广泛一种采集方式，但需精确掌握采集时机，保证数据完整性TMN标准接口方式，目前有Q3接口和CORBA接口两种（相关介绍请参见后面章节）数据库接口方式，即采用查询OMC数据库的方法来得到所需的性能数据因为设备方面将性能数据存入数据库也需要时间，所以这方式时也需要精心选择采集的时机，以避免采集到不完整的数据该方法对数据库产生的压力较大且不易保证数据的完整性，目前已不大应用登录网元查询方式，即登陆到网元设备上发送命令查询性能数据，这是目前比较少见的一种采集方式，一般是当前述的几种方式采集所需的数据时，作为补充手段使用。 目前大部分用SHELL或p

20、erl语言编程实现性能数据采集程序现状负责工作：从设备上采集性能数据形成文件，放置到预定目录下即可，不负责文件的分析和入库。由于网管系统架构的原因，目前的性能数据采集程序大部分是为metrica系统服务的，只有海南CDMA网管项目、江苏移动项目例外。Metrica系统的性能数据采集程序绝大部分用shell语言编写，另外辅助使用了perl和awk等语言。而海南项目的性能数据采集工作由CORBA接口负责完成，采用C+语言编写；江苏项目使用perl语言编写。性能数据采集程序都在网管服务器的crontab驱动下运行，运行周期大部分为1小时，此外也有30分钟、15分钟的。新设备的采集程序编写由接口方面负

21、责，而日常维护工作大部分由性能管理方面负责。目前还没有实现性能数据采集程序的集中化，但拷贝文件方式实现的采集程序的架构已逐渐统一。接口综述告警采集接口资源(配置)采集接口性能采集接口操作维护接口Q3接口CORBA接口目录操作维护接口该类接口的主要责任不是采集数据，而是负责为网管系统的操作维护模块与被管理网元之间建立连接通道为满足操作维护的交互需要，该接口产生的延时要尽量小双向接口，负责把操作者下发的操作命令发送给网元，同时将网元对命令的返回数据回送给操作者。 一般为纯码接口，但在交互过程中也可能需要对数据进行封装拆封工作往往要负责一部分数据（一般为资源管理数据）采集工作操作维护接口开发技术SO

22、CKET直连方式，即通过TCP/IP协议直接连接设备的操作维护端口。这种方法简单、稳定，是目前应用最普遍一种实现方法目前大部分厂家的网元，如ERICSSON、NOKIA、NORTEL、华为、中兴等等厂家的新型号设备都已直接支持这种方式 传统接口方式，即设备方面不支持TCP/IP连接，而是提供了x.25、RS232串口等传统的硬件接口，采集方需要先用一定的硬件设备（如IOLAN、PAD等设备等）连接这些端口，将这些传统接口转换成TCP/IP接口后，才能采用前述SOCKET连接方式开发操作维护接口OMC系统转发命令方式，即生产厂家在网元的OMC系统上提供了专用的转发命令工具，用于将操作命令转发给指

23、定的网元，并将该网元的返回消息送给操作者，操作人员需要通过调用该转发命令工具的方法实现操作维护目前大部分用语言编程实现我公司的核心产品是“代理系统proxy”。代理系统proxy简介我公司在山东移动NSP项目中开发的一个操作维护平台，是该项目和我公司网管项目最有特色的模块！已移植到山东联通、天津联通、湖南移动项目。负责工作：使用各种方式接入（SOCKET、命令行等）设备提供的操作维护接口，给登陆代理系统的用户提供一个风格、模式统一的操作维护平台。使用户摆脱网元的IP地址、端口号、用户名、密码等登陆参数及烦琐登陆步骤的限制，用户只需简单输入网元名就可实现登陆。集中日志，所有登陆用户的操作维护活动

24、都被同步记录到日志文件中和数据库中，以备事后监督使用。集中鉴权，可按安全管理模块配置权限情况控制用户可登陆哪一个网元，在山东移动项目更实现了命令级的鉴权，即可以控制用户在具体网元上可发送哪些命令。用户活动跟踪，可让高级用户实时监控其他用户在网元上的活动（监控所发命令和返回数据），在必要时可以杀掉该用户，保证网元完全。消息互通，登陆用户可以在代理系统上互相发送文本消息，完成交互功能。不但可满足操作维护工作，还可支持“集中采集程序get”完成资源管理、局数据、网元巡检等模块的数据采集工作。运行程序位于项目现场服务器的“$HOME”目录下，一般有几个版本的程序同时存在。用C语言编写，已经过数十次版本

25、升级，目前功能已非常稳定。日常维护量较大，由项目现场人员负责。代理系统工作模式网元会话功能：建立两个SOCKET，一个位于用户和代理系统之间，另一个位于代理系统和网元之间，然后在两个SOCKET之间透明传送数据。操作员Sockfd_cSockfd_s网元PROXY平台2。用户管理功能：使用UNIX系统的共享内存为手段，用“用户槽”的方式实现用户的管理及互发消息功能。用户信息域（用户名、进程号、IP地址）登陆网元信息域（网元名、IP、端口）互通消息域（消息区、发送者信息）一个登陆用户占用代理系统工作流程 主进程初始化开始初始化申请共享内存成功建立监听SOCKET监听用户登陆Fork会话子进程成功

26、主进程结束会话子进程YYNN代理系统工作流程 会话子进程-1处理用户输入命令初始化开始用户登陆PROXY成功将用户信息插入用户槽等待用户输入命令Y命令N判断输入是网元名/命令网元名到数据库取该网元的厂家、类型、地址、用户、密码成功YN使用上述取到的地址、用户、密码登陆网元成功NY12345进程终止判断是否为退出命令YN进程终止将用户登陆信息插入连接槽清理该用户占用资源清理该用户占用资源清空该用户的连接槽代理系统工作流程 会话子进程-2Y34从sockfd_c读用户输入从sockfd_s读网元返回信息进行命令鉴权操作切换网元？35鉴权通过？N将命令通过sockfd_s送到网元将信息通过sockf

27、d_c送用户分析信息中有无退出网元标志无有发现退出标志？Y退出网元？NYN2清空该用户连接槽代理系统操作示例sdunicoma$telnet sdunicoma 18000Trying .Connected to sdunicoma.Escape character is . = 网元登录代理系统 V3.18 欢迎使用！ 版权所有，浪潮乐金信息系统有限公司 =请输入用户名:rootroot请输入口令:cnhome登录成功！-MSC网元列表如下，共0个：-BSC网元列表如下，共0个：-HLR网元列表如下，共0个：-请输入网元名（格式：#，如：#JNB1）或系统命令接口综述告警采集接口资源(配置)

28、采集接口性能采集接口操作维护接口Q3接口CORBA接口目录Q3接口简介标准接口,用来规范网元的数据采集接口,消除复杂多样性。分为两大组成部分：Agent和Manager。Agent位于厂家设备端，由设备制造商实现，负责与硬件设备交互；Manager位于网管系统端，由网管系统开发商实现，负责与Agent交互，完成所需的管理功能.Agent与Manager之间使用Q3标准定义的操作原语和消息进行交互。由Manager向Agent发送的操作原语分别为：GET、CANCELGET、SET、CREATE、DELETE、ACTION，而由Agent向Manager发送的只有一种NOTIFICATION，即

29、事件消息。 开发时需要两个重要的MIB库文件：GDMO文件、ASN1文件，GDMO文件是模型描述文件，定义了所有可被管理的网元的结构和层次关系，可以进行哪些管理操作;ASN1文件是数据类型描述文件，通过他我们可以了解Agent端各种属性所使用的具体数据类型。上述两种文件在开发时都要被编译成具体的编程语言需要使用专业的开发平台,且开发调试过程复杂 ,接口实现的成本较高。可提供告警、资源、性能数据采集功能，但无法实现操作维护接口。Q3接口GDMO文件认识 -CM- MSC related MOCs- cTelMscFunctionD OBJECT CLASSDERIVED FROMcTelMscF

30、unction MANAGERec. X.721 | ISO/IEC 10165-2 : 1992:top;CHARACTERIZED BYmscFunctionPackageCommon,cTelMscFunctionAdditonalPackage;CONDITIONAL PACKAGESITU-T Rec. M.3100:1995: createDeleteNotificationsPackage PRESENT IF the objectCreation and objectDeletion notifications (as defined in CCITT X.721) are s

31、upported by this managed object,ITU-T Rec. M.3100:1995: attributeValueChangeNotificationPackage PRESENT IF the attributeValueChange notification (as defined in CCITT X.721) is supported by this managed object,ITU-T Rec. M.3100:1995: stateChangeNotificationPackage PRESENT IF the stateChange notificat

32、ion (as defined in CCITT X.721) is supported by this managed object;REGISTERED AS cTel-gsm-nmc-cm-objectClass 130;Q3接口GDMO文件认识 -FMcommunicationsAlarm NOTIFICATION BEHAVIOUR communicationsAlarmBehaviour; WITH INFORMATION SYNTAX Notification-ASN1Module.AlarmInfo AND ATTRIBUTE IDS probableCause probabl

33、eCause, specificProblems specificProblems, perceivedSeverity perceivedSeverity, backedUpStatus backedUpStatus, backUpObject backUpObject, trendIndication trendIndication, thresholdInfo thresholdInfo, notificationIdentifier notificationIdentifier, correlatedNotifications correlatedNotifications, stat

34、eChangeDefinition stateChangeDefinition, monitoredAttributes monitoredAttributes, proposedRepairActions proposedRepairActions, additionalText additionalText, additionalInformation additionalInformation; REGISTERED AS smi2Notification 2;communicationsAlarmBehaviourBEHAVIOUR DEFINED ASThis notificatio

35、n type is used to report when the object detects a communications error.;Q3接口GDMO文件认识 -PMtransferUpReady NOTIFICATIONBEHAVIOUR transferUpReadyBehaviour BEHAVIOURDEFINED ASThis Notification is issued by the object to indicate that one or more are now ready for transfer from the OMC to the NMC. The co

36、ntained in the EventInfo field of the PDU identifies the file(s) that have been prepared for NMC read.The TransferNotificationArg of the syntax contains the following parameters:1 loginInfo: this field contains the userName and password of the logining infomation, which NMC shall use for FTP2 : name(s) of th