基于WAM和AMS网管平台的NBI北向接口

网元网管系统北向接口-NBIQiaoJinzhu(Jinzhu.Qiao@)Sep,2011NBIIntroduce|Sep2011目录产品简介针对FXGPON+E8-C场景说明(浙江电信)安装配置说明(PONNBI+ExternalTL1GW)服务启动及日志查看北向各模块说明(SA、CT_FD、CT_IN、ANSITL1CTIAS、Corba)

常见现场问题及UsefullinkNBIIntroduce|Sep2011产品简介－何为PONNBIPONNBI：PONNorthboundInterface。基于PONEMS所开发的一系列接口，用于BOSS/NMS系统调用，提供业务开通配置、性能管理和资源管理等功能。

当前提供的PONNBI系统是同时基于WAM5528和AMS5520两套网管的。为何需要NBI？>有利于运营商建设更低成本、更有效率的BOSS系统>有利于屏蔽不同厂商不同设备的差异性，使用户的业务更容易扩展>符合PON网络更为复杂的管理方式和趋势（相比以前的接入技术）。在此背景下，PONEMS/NBI在运营商的整个生产过程中的重要性有所提升。NBIIntroduce|Sep2011产品简介－目前有哪些北向接口规范目前存在的北向接口规范主要有：◎ASB业务开通接口，TL1协议。ASB定义的接口规范，主要用于联通、移动等运营商。

◎中国电信PONEMS北向接口功能及技术规范，TL1协议。分为四个部分

>业务开通接口规范，用于FTTH/FTTB业务开通及放号

>综合测试接口规范，查询类操作，可用于排障

>综合告警接口规范，告警实时上报，告警查询等

>综合信息查询接口规范，查询及通知类操作，可用于网络资源收集和同步电信规范是电信集团正在极力推广的PON北向接口规范。在这方面，电信远远走在其它两家运营商前面。有可能成为（事实上的）行业技术标准，需重点予以关注。NBIIntroduce|Sep2011产品简介－目前有哪些北向接口规范（续）目前存在的北向接口规范主要有（续）：◎中国移动无源光网络厂商网管系统北向接口技术规范--CORBA规范，主要用于与移动NMS对接，可提供设备资源查询、告警管理、性能管理等功能。基于AMS的corba版本由越南TMA开发。◎北京联通RMS接口规范。WebService技术。仅用于北京联通。

◎其它：如syslog告警上报、csv资源导出NBIIntroduce|Sep2011产品简介－PONNBI产品模块与前文所述的接口规范相对应，目前PONNBI基于网管平台所能提供的主要模块包括：

◎业务开通（SA，ServiceActivator），分为ASB和CT两个规范，均为TL1命令。

◎电信综合测试（CTFD，CTFaultDiagnotor）

◎电信综合查询（CTIN,CTInventory）◎电信综合告警（CTAD，AlarmDispatcher；基于AMS综合告警为ANSITL1CTIAS）◎CMCCCorbaCorba=

CommonObjectRequestBrokerArchitecture公共对象请求代理体系结构★最新发布的北向NBIv1.1版本包括PONNBI_BASE(主体架构)和三大模块的sar包(PONNBI_SA、PONNBI_CTFD、和PONNBI_CTIN)，该1.1版本同时支持WAM和AMS两套网管★基于AMS的综合告警ANSITL1CTIAS目前也已支持EPON、GPON和FTTB(7353)NBIIntroduce|Sep2011产品简介–系统结构PONNBI系统需要与WAM和AMS网管安装于同一主机。并分别通过TL1GW和ExternalTL1GW连接设备，或直接访问设备。

AMSExternalGWNBIIntroduce|Sep2011产品简介－支持的设备类型目前PONNBI能够支持大部分常见的设备：OLT：7342GPON/EPON、7360FX、METAGPON、METAEPON、8500EPON(少量功能)和FX设备GPONONU：ALU:I-240G-A、I-241G-A、I240W-R(Q)、O-00240V-ACIG：I-240E-P、O-16160E-P、O-24240E-PT&W：O-16160E-A、O-24240E-AEPONONU：EONU400、EONU420、EONU400-E、RG200O、800T&W：EONU16160、EONU24240ZyXEL：EONU48480AFTTN：7330、7353NBIIntroduce|Sep2011安装配置说明－PONNBIBASEv1.1.01.环境要求

->建议使用SolarisX86orSprarc64位处理器平台(32位环境下暂时无法正常使用脚本启动服务，需利用workaround方式启动)->JAVA环境:一般情况下，Solaris10主机自带有java1.5的运行环境（可查看/usr目录）2.安装配置

->以root用户登录，将安装文件（PONNBI_BASE_1.1.0.tar.gz）上传至目标目录，缺省为/opt

->进入/opt目录执行以下命令：

gzip-dPONNBI_BASE_1.1.0.tar.gz

tar-xvfPONNBI_BASE_1.1.0.tar

此时，系统会自动在当前opt目录中创建PONNBI_APP目录NBIIntroduce|Sep2011安装配置－SAv1.1(业务开通)同样以root用户登录，将SA安装文件（PONNBI_SA_35.tar）上传至目标目录，缺省为/opt/PONNBI_APP

->进入/opt/PONNBI_APP目录，对该tar包解压：

tar-xvfPONNBI_SA_35.tar解压完之后，检查SA是否安装成功可查看conf和data目录下各新增了很多文件，当然最简单最直接的方法检查以下目录中是否有ponnbi_sa_35.sar文件，有则说明安装成功，无则失败：ls-l/opt/PONNBI_APP/server/jboss-4.2.2.GA/server/default/deploy/★如果现场安装的sar包是135之前的版本，那么需要重新在$PONNBI_HOME/bin目录下执行这两个脚本：

create-db-ams.sh和init-db-ams.shNBIIntroduce|Sep2011安装配置－CT-FDv1.1(综合测试)接口功能：请参考中国电信PONEMS北向接口功能及技术规范（综合测试接口分册）综合测试相关系统主要了实现三方面功能：一是PON网络故障诊断和处理，二是对PON网络进行例行的主动监测，三是PON网络业务开通竣工测试。安装包:

PONNBI_CT_FD_1.1.246.tar部署：将此tar文件放置PONNBI_APP目录下(例如/opt/PONNBI_APP/)进行解压,解压后将在conf目录下新增名为”ctfd”的目录存放配置文件和相关的sar包(/opt/PONNBI_APP/server/jboss-4.2.2.GA/server/default/deploy/ponnbi_ct_fd_46.sar)。日志:

程序运行依然在/opt/PONNBI_APP/bin目录下使用./ponnbi_serverstart启动，日志请到log下tail-fponnbi_wrapper.log即可。端口:

统一端口12015登陆:telnet<网管服务器IP>12015NBIIntroduce|Sep2011安装配置－CT-INv1.1(综合查询)接口功能：请参考中国电信PONEMS北向接口功能及技术规范（综合信息查询接口分册）综合信息查询包括PON网络设备信息、业务配置数据的查询，资源变化的通知以及资源数据的全量导出。发布:PONNBI_CT_IN_1.1.48.tar部署：将此tar文件放置PONNBI_APP目录下(例如/opt/PONNBI_APP/)进行解压,解压后将在Bin目录下新增create-resnotify.sh//这里在部署完之后，一定要运行此脚本conf目录下新增名为“ctquery”的目录存放配置文件Data目录下新增ctquery-resnotify.sql以及server目录下存放的sar和lib包。日志:

请到log下tail-fponnbi_wrapper.log即可。端口:

统一端口12015登陆:telnet<网管服务器IP>12015NBIIntroduce|Sep2011安装配置－综合告警★基于WAM网管的v1.0版本具体安装请见slides36★基于AMS环境的综合告警ANSITL1CTIAS安装：app-ansitl1-_9.0.10-130521-solaris-x86.binplugin-ansitl1-ctias-1.0-1.0_3.0.10_9.0.10-130741-solaris-x86.binplugin-ansitl1-epon-ct-1.0_3.0.10_9.0.10-130741-solaris-x86.binplugin-core-epon-4.6.58-1.0_9.0.10-127281-solaris-x86.binplugin-idm-epon-4.6.58-1.0_2.0.10_9.0.10-127281-solaris-x86.binansitl1平台包Ctias安装包Ansitl1网元安装包针对amsepon网元插件NBIIntroduce|Sep2011配置说明4.PONNBI系统目录结构

NBIIntroduce|Sep2011升级X86补丁

1.查看并确认网管服务器为Solarisx86还是sparc系统，若是Sparc系统，可跳过此升级页面！可用uname–a查看。SunOSASBWAM015.10Generic_127127-11sun4usparcSUNW,Sun-Fire-V240//Sparc系统SunOSken5.10Generic_141445-09i86pci386i86pc//X86系统2.若是X86平台，请务必更新X86对应的64位补丁，以避免程序在启动的过程中报

“wrapper“错误。3.按照附件中的64位补丁包，依照各个路径分别覆盖到相应的目录下，譬如：

cp/opt/PONNBI_APP/bin/x86/64/wrapper/opt/PONNBI_APP/bincp/opt/PONNBI_APP/lib/x86/64/libwrapper.so/opt/PONNBI_APP/libNBIIntroduce|Sep2011启动预配置（一）

添加AMS数据库数据库安装与初始化

以root用户登录，进入PONNBI_APP/bin，执行以下两条命令(先赋予执行权限)：./create-db-ams.sh和./create-view-ams.sh初始化的时候注意修改这个文件：/opt/PONNBI_APP/conf/init-db.conf<问题点：创建和初始化数据库失败>

执行成功后，除了在ams数据库中新增NBI_view_onu表之外，还会额外新增一个名为ponnbi的北向数据库NBIIntroduce|Sep2011启动预配置（二）

添加WAM数据库[可选]★若现场还需兼容WAM网管环境，请按如下步骤继续操作，否则可忽略此页面！数据库安装与初始化

同样进入到PONNBI_APP/bin目录下，执行以下命令(先chmod赋权)：

./create-db.sh

执行成功后，数据库安装完成(目的是创建3张表，NBI_gongdan_addnot,NBI_onu_sw_meta,NBI_onu_type,其中NBI_onu_sw_meta表中插入6条SWversion记录)。

然后再运行:

./init-db.sh执行成功后，数据库初始化完成(数据库表NBI_onu_type插入相应的defaultdata)

使用SQL数据库工具查看以上操作是否成功。

NBIIntroduce|Sep2011服务启动4.启动方法如下：缺省的的启动方法为，进入/opt/PONNBI_APP/bin目录下，执行：

./ponnbi_serverstart

可跟参数{console|start|stop|restart|condrestart|status|install|remove|dump}NBIIntroduce|Sep2011日志查看及系统卸载6.停止服务

./ponnbi_serverstop请看日志中有如下字段，说明停止成功STATUS|wrapper|2011/09/1510:54:47|<--WrapperStopped7.日志查看默认的日志目录为/opt/PONNBI_APP/log，跟踪日志方法如下:

tail-fponnbi_wrapper.log8.卸载只需删除PONNBI_APP目录即可。如有必要，可卸载JRE1.5。针对相应的系统运行参数，详细请查看PONNBIInstallationGuide安装手册(Usefullink)。NBIIntroduce|Sep2011安装配置–ExternalTL1Gateway（一）可参阅3FE-20649-EBAA-RJZZA-01-5520AMS_ExtTL1GW_2_2_1_InstallGuide.pdf中的1.5和1.6章节安装前，请申请好GW的license，否则无法使用。1.用下面的链接下载ExternalTL1GW压缩包

/cgi-bin/Download.pl?hier_id=

BroadbandProduct->5520AMSEXTERNALTL1GW->2.2.1

使用ad4账号登陆，分sparc和x862.解压并上传到网管服务器目录(该目录可随意指定)3.安装方法如下：

注:无需安装SUDO和GTK2NBIIntroduce|Sep2011安装配置–ExternalTL1Gateway（二）3.1进入到GW所在目录，以sparc为例(/TL1-GW-2.2.0-1019-sparc)，赋权并执行install脚本->chmoda+x*

->./install.sh运行后选择：

1Gateway；2GUI；->default为Gateway回车或选择1回车->输入安装路径，缺省为/opt/alcatel，回车即可；->是否确认路径为/opt/alcatel？缺省y或者回车即可；->询问该路径是否正确，缺省为y或者回车即可；->提示，Override还是Quit，缺省为Override(覆盖)回车即可；至此，安装结束，查看/opt/alcatel/目录下是否有tl1gateway文件夹，有则说明安装成功。NBIIntroduce|Sep2011安装配置–ExternalTL1Gateway（三）3.2确认安装成功之后，创建license(TL1GW安装好之后conf目录下缺省是没有lic文件的)->cd/opt/alcatel/tl1gateway/conf->vitl1gw.lic->将申请的license以下面的方式输入进去，然后保存退出

Serial-Key=160T2qYRKR4a3sEqN09a10012T0UXU500l1wWR1R7U5iGU1B2q7R0q1q43.3启动ExternalTL1GW脚本(记得先赋可执行权限)->./gwstart.sh//启动->./gwstatus//查看当前GW状态，如果已启动，会出现如下提示：Gatewayisrunning.PID=3269详细的ExternalTL1GW的安装方法请看PONNBI部署说明中的附录部分NBIIntroduce|Sep2011在AMS中添加TL1GW(一)4.GW安装并运行成功之后，此时需添加到AMS，可参考PONNBI(AMS)部署说明.doc中的2.2.2~2.2.4章节，具体如下：安装好ExternalTL1Gateway并启动之后，需要在AMS界面将其集成进来。集成方式如下（参考3JL-01000-AEAB-PCZZA-01-5520AMS_9010_AdministratorGuide.pdf中的第15章）NBIIntroduce|Sep2011在AMS中添加TL1GW(二)配置参数说明：IPAddress:theserver’sipaddressAdminUserName:Thedefaultisadmin.AdminPassword:Thedefaultisadmin.TID:ThenameoftheTL1Gateway.ThedefaultisTNM1NBIIntroduce|Sep2011关联ExternalTL1GW到AMS（一）5.创完GW之后，需要进行AMS连接GW，并且进行GW自动管理网元。也即需要执行以下步骤：1IntheAdministrationTree,chooseEMSAdministration→EMSSystem→Site.ThesitesettingsappearintheObjectDetailsview.2勾选前两项(切记)，如下图所示：关于这三个参数的详细描述见右边的表格，一般只需勾选前两项。NBIIntroduce|Sep2011关联ExternalTL1GW到AMS（二）6.配置GW完成之后，转到GW的显示页面：IntheAdministrationTree,chooseEMSAdministration→EMSSystem→Site→ExternalTL1GWServers.如果GW的ReachabilityStat状态Reachable(如下图中红圈所示)，则说明GW配置成功，否则请参照文档检查出错原因。NBIIntroduce|Sep2011关联ExternalTL1GW到AMS（三）7.GW安装并与AMS关联后，还需要将网元关联到安装的ExternalTL1Gateway。方法如下：NBIIntroduce|Sep2011配置IDM属性业务开通模块具体IDM配置请见PONNBI(AMS)部署说明文档中的第2.3章节★目前支持GPON/EPON/FTTBMDU和ISAM综合查询模块)具体IDM配置请见PONNBI(AMS)部署说明文档中的第2.4章节★目前只支持GPON/EPONNBIIntroduce|Sep2011基于AMS+WAM的NBI端口登陆及业务下发(一)1.当PONNBI和ExteranlTL1GW安装配置结束同时北向服务也启动成功之后，此时可连接缺省的统一端口进行登陆：

缺省的统一端口：12015(可定制，修改/opt/PONNBI_APP/conf/authSys.conf中的TL1_AGENT_PORT)

利用缺省的用户名、密码进行登陆：LOGIN:::CTAG::UN=manager,PWD=123456;CTSA/ASBSA/CTFD/CTIN

也可用

LOGIN-USER:::1.0::USERNAME=manager,PASSWORD=123456;LOGOUT:::CTAG::;//退出2.分权用户登陆，具体分权用户名、密码可见下页LOGIN-USER:::1.0::USERNAME=user1,PASSWORD=123456;ASBSA

LOGIN:::CTAG::UN=user2,PWD=123456;CTFDNBIIntroduce|Sep2011基于AMS+WAM的端口登陆及业务下发（二）1.分权用户名、密码(可参考/opt/PONNBI_APP/conf/ossuser.xml)NBIIntroduce|Sep2011AMSorWAM？修改配置文件：${PONNBI_HOME}/conf/ponnbi_sys.conf例如：/opt/PONNBI_APP/conf/ponnbi_sys.conf同样，修改完之后需要手动重启北向服务，以后可考虑热部署。EMS_RELEASE=WAM8.02或

AMS9.0.10

//WAM版本一般为8.02，如果是8.01建议升级到8.02。注，取值8.02可以兼容WAM8.03。也可以指定为AMS9.0.10(举例)。在PONNBISAV1.1.0版本以上可同时支持WAM和AMS,现场可根据实际需要配置该参数，且该参数必须以WAM或AMS开头。NBI_SPEC=ASB

或CT//该参数指明使用的规范类型，支持贝尔和电信规范，取值为ASB或CT。WAM_PONNBI_IP=//服务器所在IP地址；在有多块网卡的情况下填写提供服务的IPNBIIntroduce|Sep2011SA业务开通(ASBSA2.0规范)功能介绍:PONNBISA（PONNorthboundInterfaceServiceActivator）系统用来进行GPON/EPON/FX业务开通，涵盖ONT（FTTH）创建，语音业务/宽带业务开通等操作。实施业务开通系统的条件：1）通过网管创建并管理网元，包括MDU2）OLT资源创建：PONVLAN/LANXVLAN、相关profiles。所有的OLT应保持一致3）MDU预配置：端口VLAN设置等。

MDU配置应尽可能在预部署阶段完成，业务开通系统只需完成端口开通/关闭NBIIntroduce|Sep2011SA业务开通(ASB规范)－命令列表NBIIntroduce|Sep2011基于AMS和WAM的SA2.0规范TL1命令样例此样例请和用户文档搭配一起看，用到的sar文件为ponnbi_sa_35.sarLogin命令:LOGIN-USER:::1.0::USERNAME=manager,PASSWORD=123456;LOGOUT-USER:::1.1::USERNAME=manager;其中用户名/密码可随现场随意改动，具体文件为，修改后需重启北向服务/opt/PONNBI_APP/conf/ossuser.xml

预配置:Sessionprofile、PQprofile和BWprofileNBIIntroduce|Sep2011电信规范－v1.1SA业务开通PONNBIv1.1新版本业务开通引入了service.xml文件，该文件用于配置每种类型的各个工单命令（如ADD-ONU,ADD-PONVLAN）需要下发到olt上的各个命令及参数情况。该文件一般由开发人员定制，根据现场实际下发业务配置命令来组织模板，再发送到现场进行测试。因此该文件一般不需现场人员改动。以下举例GPONFXE8-CADD-ONU配置（浙江电信）

相关命令样例：

★使用LOID认证，除了在xml文件中修改ONUID为LOID外，还需要在PON口下修改其认证方式为LOID

<payloadblockindex="2">LOID=${INPUT:ONUID},SWVERPLND=3FE53862AOCB34</payloadblock>

★建议使用离线注册ONUNBIIntroduce|Sep2011基于WAM的v1.0电信规范综合告警模块CT_AD接口功能：请参考中国电信PONEMS北向接口功能及技术规范（综合告警接口分册）告警过滤条件设置、告警实时上报、获取告警、告警确认、告警确认取消、告警清除和订阅告警。发布:PONNBI_CT_AD_1.0.0.tar部署：将此tar文件放置PONNBI_APP目录下(例如/opt/PONNBI_APP/)进行解压,解压后新增配置文件和sar包。日志:PONNBI_APP服务启动成功后，系统会自动和WAM的alarmserver建立连接，为的是正常接收告警。具体请到/opt/PONNBI_APP/log下tail-fponnbi_wrapper.log即可。端口:12009telnet<WAMserverIP>12009返回NBIIntroduce|Sep2011目录结构：服务器端包为：NBI_CORBA_1.0.tar解压命令:tar–xvfNBI_CORBA_1.0.tar

，解压后为/nbi文件夹。（目前未放在PONNBI_APP目录，需单独运行）部署与启动:具体安装配置过程请看Wam网管北向接口系统维护手册，启动成功后进程和日志基于WAM的CMCCCorba部署与启动NBIIntroduce|Sep2011什么情况下需要重启Corba:两种情况1.Solaris服务器重启，需要重新启动命名服务和通知服务，然后再重启Corba服务。2.WAM的Alarmserver重启，此时只需要重启Corba服务即可，具体为：先在/nbi/wam/bin目录下执行./kill.sh，然后在执行./run.sh即可基于WAM的Corba停止或重启NBIIntroduce|Sep2011现场常见问题及Trace收集一问题:32位平台下用ponnbi_server启动PONNBI服务失败(适用于AMS和WAM平台)

目前PONNBI程序暂时只支持64位环境平台，对于32位平台可用以下方法运行PONNBI服务：进入/opt/PONNBI_APP/server/jboss-4.2.2.GA/bin目录下，执行

nohup./run.sh–b&

执行结束后，按键盘上的Enter回车键，然后再查看该日志，日志名为nohup.out文件

tail–fnohup.out返回NBIIntroduce|Sep2011问题:基于WAM平台，FailedtogetSAimplementationobject

基本上都是由于onuImpl.conf未配置导致，例如:还有另一种情况是onuImpl.conf配置也没问题，但仍报此异常。解决办法:检查该OLT在数据库NE表中的类型(dneT)列是不是FTTU

现场常见问题二NBIIntroduce|Sep2011问题:基于WAM平台，DBoperationfailed!couldnotfoundONUInfo.

出现这种异常，问题可定位于WAM数据库的MDU表中找不到该ONU信息，此时可依照此ONU的AID去检查数据库是否存在。若存在，请检查该ONU的信息是否完整；若不存在，请用业务开通命令执行ADD-ONT操作，使ONU能正常入库。注:

7330/7302/7353FTTB(2U_MDU)由于不支持ADD-ONT，所以除了要在WAM的拓扑上以NE的方式创建之外，还需要在相应的OLTPON口下去创建。而16160/24240/48480，只需到OLT的PON口下去创建即可。现场常见问题三NBIIntroduce|Sep2011问题:基于AMS平台，当执行./create-view-ams.sh创建北向试图表的时候报错：

ERROR1054(42S22)atline61:Unknowncolumn'name'in'fieldlist‘与之类似的还有’IP’等Unknown信息

出现这种异常，可根据《PONNBI(AMS)部署说明.doc》，检查

2.3节中配置IDM属性是否都已配，从报错信息来看是ont的name和IP未采集造成的。

★

当采集项选择好并保存之后，需要右键网元的Inventory->ForceCollection即可现场常见问题四NBIIntroduce|December2011问题:创建和初始化北向数据库失败mysql:notfound检查两个点：首先，用cat或more检查$PONNBI_HOME/bin目录下的create-db-ams.sh和create-view-ams.sh这两个文件，确认ams的mysql路径是否与实际的相符，尤其注意下图中标出来的区域x86/sparc；然后再检查/opt/PONNBI_APP/conf/init-db.conf配置文件mysql.host=72mysql.port=3307//AMS数据库端口为3307mysql.db=emlplatform//AMS数据库mysql.username=root//用户名mysql.password=mysql//密码缺省为mysql返回现场常见问题五NBIIntroduce|Sep2011问题:下发北向命令出现NEunreachable出现这种情况是由于网元的session被占满了，可用工具登陆到网元上查看确认，然后再用工具删掉就可以了。用法：1.用”查看session工具”检查的session被占掉的IP地址，附件中有如何具体使用的方法。2.打开”删session工具”，将server.txt中的IP改为网元的IP，然后运行client.exe，点击”closeall”(可多点几次)，即可释放掉被占用的IP。现场常见问题六NBIIntroduce|Sep2011问题:注册ONU的过程中报resourceconflict和resourcealreadyexist异常从字面意思上可以看出，说明你当前下发的ONU和数据库中的数据冲突了，导致命令下发失败。北向下发命令的过程中会去和数据库做精确匹配，譬如ONUAID、MAC/LOID/SN/SLID、ONUNAME等

在数据库中存在的话，自然会上报这个异常。还有一种情况，如果我最开始手动在OLT上注册了一个ONU，然后在AMS做过forcecollection之后，使得该ONU数据进入了数据库。然后我再用NBI北向命令去注册同一个ONU的时候也回报这个错误。★解决这个办法，只能手动在AMS或北向ponnbi数据库中删掉此ONU即可。现场常见问题七NBIIntroduce|Sep2011问题:EPON+RG200O场景，下发ADD-ONU的时候，命令处理到ED-ELLID处报SNMPOperationfailed错误（此场景不走service.xml）属于UPBWPROF和DNBWPROF缺省的profileid=10未预配导致的，请现场在OLT上做预配创建一个ID为