U2000北向XML接口用户指南-V100R006C0201

iManagerU2000统一网络管理系统V100R006C02北向XML接口用户指南文档版本01发布日期2012-06-30华为技术有限公司版权所有©华为技术有限公司2012。保留一切权利。非经本公司面许可，任何单位和个人不得擅自摘抄、复制本文档内容的部分或全部，并不得以任何形式传播。商标声明和其他华为商标均为华为技术有限公司的商标。本文档提及的其他所有商标或注册商标，由各自的所有人拥有。注意您购买的产品、服务或特性等应受华为公司商业和条款的约束，本文档中描述的全部或部分产品、服务或特性可能不在您的购买或使用范围之内。除非合同另有约定，华为公司对本文档内容不做任何明示或默示的声明或保证。由于产品版本升级或其他原因，本文档内容会不定期进行更新。除非另有约定，本文档仅作为使用指导，本文档中的所有陈述、信息和建议不构成任何明示或暗示的担保。华为技术有限公司地址：深圳市龙岗区坂田华为总部办公楼邮编：518129网址：http://www.huawei.com客户服务邮箱：support@huawei.com客户服务电话：4008302118文档版本01(2012-06-30)华为专有和保密信息版权所有©华为技术有限公司i前言产品版本与本文档相对应的产品版本如下所示。产品名称产品版本iManagerU2000V100R006C02读者对象本文档介绍了北向XML接口的基本概念，原理以及部署、维护操作。同时还提供了License项与接口关系、服务端口说明以及术语和缩略语等。本文档指导用户了解北向XML接口的基本操作。本文档主要适用于以下工程师：l网络规划工程师l安装调测工程师l数据配置工程师l应用开发人员符号约定在本文中可能出现下列标志，它们所代的含义如下。符号说明以本标志开始的文本表示有高度潜在危险，如果不能避免，会导致人员死亡或严重伤害。以本标志开始的文本表示有中度或低度潜在危险，如果不能避免，可能导致人员轻微或中等伤害。iManagerU2000统一网络管理系统北向XML接口用户指南前言文档版本01(2012-06-30)华为专有和保密信息版权所有©华为技术有限公司ii符号说明以本标志开始的文本表示有潜在风险，如果忽视这些文本，可能导致设备损坏、数据丢失、设备性能降低或不可预知的结果。以本标志开始的文本能帮助您解决某个问题或节省您的时间。以本标志开始的文本是正文的附加信息，是对正文的强调和补充。命令行格式约定格式意义粗体命令行关键字（命令中保持不变、必须照输的部分）采用加粗字体表示。斜体命令行参数（命令中必须由实际值进行替代的部分）采用斜体表示。[]表示用“[]”括起来的部分在命令配置时是可选的。{x|y|...}表示从两个或多个选项中选取一个。[x|y|...]表示从两个或多个选项中选取一个或者不选。{x|y|...}*表示从两个或多个选项中选取多个，最少选取一个，最多选取所有选项。[x|y|...]*表示从两个或多个选项中选取多个或者不选。图形界面元素引用约定格式意义“”带双引号“”的格式表示各类界面控件名称和数据表，如单击“确定”。>多级菜单用“>”隔开。如选择“文件>新建>文件夹”，表示选择“文件”菜单下的“新建”子菜单下的“文件夹”菜单项。iManagerU2000统一网络管理系统北向XML接口用户指南前言文档版本01(2012-06-30)华为专有和保密信息版权所有©华为技术有限公司iii修订记录修改记录累积了每次文档更新的说明。最新版本的文档包含以前所有文档版本的更新内容。产品版本（V100R006C02）-文档版本01(2012-06-30)第一次正式发布。iManagerU2000统一网络管理系统北向XML接口用户指南前言文档版本01(2012-06-30)华为专有和保密信息版权所有©华为技术有限公司iv目录前言....................................................................................................................................................ii1系统概述...........................................................................................................................................11.1引言....................................................................................................................................................................21.2遵从的介绍................................................................................................................................................21.3在综合网管中的地位........................................................................................................................................31.4支持的领域和功能............................................................................................................................................31.4.1告警功能介绍...........................................................................................................................................31.4.2配置功能介绍...........................................................................................................................................41.4.3性能功能介绍...........................................................................................................................................61.4.4资源功能介绍...........................................................................................................................................61.5系统结构..........................................................................................................................................................101.6技术指标..........................................................................................................................................................112原理描述.........................................................................................................................................132.1相关技术说明..................................................................................................................................................142.2架构描述..........................................................................................................................................................152.3北向XML接口运作原理...............................................................................................................................162.4流程样例..........................................................................................................................................................213部署和配置北向XML接口..........................................................................................................233.1概述..................................................................................................................................................................253.2配置要求..........................................................................................................................................................263.3配置北向XML接口流程...............................................................................................................................263.4检查License.....................................................................................................................................................283.5启动网络管理系统维护工具..........................................................................................................................303.5.1启动网络管理系统维护工具服务器端进程.........................................................................................303.5.2登录网络管理系统维护工具客户端.....................................................................................................303.5.3修改网络管理系统维护工具密码.........................................................................................................323.6检查北向XML接口状态...............................................................................................................................323.7添加北向XML接口组件...............................................................................................................................333.8配置北向XML接口.......................................................................................................................................343.9配置告警确认通知上报开关..........................................................................................................................414维护北向XML接口......................................................................................................................43iManagerU2000统一网络管理系统北向XML接口用户指南目录文档版本01(2012-06-30)华为专有和保密信息版权所有©华为技术有限公司v4.1对维护操作人员要求......................................................................................................................................444.2例行维护操作..................................................................................................................................................444.3运行和停止北向XML接口...........................................................................................................................454.3.1登录系统监控客户端.............................................................................................................................454.3.2停止北向XML接口..............................................................................................................................464.3.3禁用北向XML接口..............................................................................................................................484.3.4重新启动北向XML接口......................................................................................................................494.3.5删除北向XML接口实例......................................................................................................................504.3.6删除北向XML接口组件......................................................................................................................524.4常见问题处理..................................................................................................................................................524.4.1启动北向XML接口失败应该怎么处理..............................................................................................534.4.2如何判断U2000已经成功打开北向XML接口.................................................................................534.4.3如何判断U2000是否支持北向XML接口功能.................................................................................535系统与上层网管或OSS对接.......................................................................................................555.1OSS系统接入指导..........................................................................................................................................565.1.1检查网络连通性.....................................................................................................................................565.1.2为OSS创建北向XML接口网管用户.................................................................................................565.1.3接入北向XML接口..............................................................................................................................585.2SSL原理与配置..............................................................................................................................................585.2.1SSL原理.................................................................................................................................................585.2.2北向XML接口对SSL的支持.............................................................................................................595.2.3SSL配置.................................................................................................................................................595.2.4配置SSL证书........................................................................................................................................605.3连接互通性检测..............................................................................................................................................615.3.1检测北向XML接口请求连接的互通性..............................................................................................615.3.2通知服务连接检测.................................................................................................................................61A安全证书说明................................................................................................................................62A.1安全证书类型.................................................................................................................................................63A.2申请SSL证书................................................................................................................................................63A.3配置安全证书.................................................................................................................................................64A.3.1替换安全证书........................................................................................................................................64A.3.2加密ActiveMQ安全证书密码.............................................................................................................65A.3.3加密XMLAgent安全证书密码...........................................................................................................66A.3.4加密HTTPS安全证书密码..................................................................................................................67A.3.5吊销SSL证书.......................................................................................................................................68BLicense项与接口的关系..............................................................................................................70C服务端口说明................................................................................................................................73C.1注意事项..........................................................................................................................................................74C.2服务器和OSS之间的端口............................................................................................................................74D支持的设备类型............................................................................................................................75iManagerU2000统一网络管理系统北向XML接口用户指南目录文档版本01(2012-06-30)华为专有和保密信息版权所有©华为技术有限公司viE术语.................................................................................................................................................78F缩略语.............................................................................................................................................82iManagerU2000统一网络管理系统北向XML接口用户指南目录文档版本01(2012-06-30)华为专有和保密信息版权所有©华为技术有限公司vii1系统概述关于本章如无特殊说明，本文中所描述的北向XML接口特指遵循MTOSI2.0标准的标准化接口。本节介绍北向XML接口的技术特点。1.1引言通过结合现代软件技术模型和先进技术模型，电信管理论坛（TMF）推出了新的接口标准，多技术操作系统接口（Multi-TechnologyOperationsSystemsInterface，MTOSI）。MTOSI有利于程序间的交互，减少部署时间，并降低运营商OSS成本。1.2遵从的标准介绍iManagerU2000遵循MTOSI系列标准，通过北向XML接口，上层综合网管系统或OSS系统可以实现对华为传送设备、IP设备、接入设备的统一管理。1.3在综合网管中的地位介绍北向XML接口在综合网管中的地位。1.4支持的领域和功能北向XML接口提供了告警、配置、性能和资源功能，可以方便的与上层OSS系统集成。1.5系统结构本节介绍北向XML接口的系统结构。1.6技术指标本节介绍北向XML接口的技术指标，用于OSS对接时作为参考。iManagerU2000统一网络管理系统北向XML接口用户指南1系统概述文档版本01(2012-06-30)华为专有和保密信息版权所有©华为技术有限公司11.1引言通过结合现代软件技术模型和先进技术模型，电信管理论坛（TMF）推出了新的接口标准，多技术操作系统接口（Multi-TechnologyOperationsSystemsInterface，MTOSI）。MTOSI有利于程序间的交互，减少部署时间，并降低运营商OSS成本。iManagerU2000参考MTOSI（Multi-TechnologyOperationsSystemsInterface）系列建议开发出了北向XML接口。通过北向XML接口可以为各级网管系统提供统一的互联通道。采用北向XML接口可以很好地适应网管综合化、跨域化的发展趋势。1.2遵从的标准介绍iManagerU2000遵循MTOSI系列标准，通过北向XML接口，上层综合网管系统或OSS系统可以实现对华为传送设备、IP设备、接入设备的统一管理。遵从的业务标准表1-1业务标准TMF标准版本说明MTOSI2.0lTMF518MTOSIBusinessAgreementlTMF612MTNMInformationAgreementlTMF864MTOSISolutionSet遵从的技术标准表1-2技术标准项目版本SOAP1.1WSDL1.1HTTP(S)1.1JMS1.1所采用的中间件表1-3中间件及其版本中间件版本ApacheCXF2.1.3iManagerU2000统一网络管理系统北向XML接口用户指南1系统概述文档版本01(2012-06-30)华为专有和保密信息版权所有©华为技术有限公司2中间件版本ApacheActiveMQ5.2.0SonicMQ7.6.21.3在综合网管中的地位介绍北向XML接口在综合网管中的地位。北向XML接口在综合网管中的地位如图1-1所示。图1-1北向XML接口在综合网管中的地位安全设备传送网SDH/WDM/OTN/MWIP网Router/Switch/PTN/BRASOSSU2000北向XML接口U2000传送网SDH/WDM/OTN/MW其他网管其他设备1.4支持的领域和功能北向XML接口提供了告警、配置、性能和资源功能，可以方便的与上层OSS系统集成。1.4.1告警功能介绍北向XML接口支持以下告警功能。l告警查询l告警数目统计l告警确认、去确认l告警上报iManagerU2000统一网络管理系统北向XML接口用户指南1系统概述文档版本01(2012-06-30)华为专有和保密信息版权所有©华为技术有限公司3l查询性能越限事件1.4.2配置功能介绍表1-4北向XML接口支持的配置功能功能概述功能详细说明涉及的领域单站VPN业务发放单站VPLS业务、PWE3业务(AES/CES/EES)、L3VPN业务的创建、删除、修改、激活、去激活，以及相应的通知上报单站VPLS业务站点的添加、删除、激活、去激活，以及相应的通知上报单站L3VPN业务站点的添加、删除、激活、去激活，以及相应的通知上报单站PWSwitch的创建、删除、激活、去激活，以及相应的通知上报路由域PWE3、VPLS、L3VPN业务支持Qos特性配置，VPLS和L3VPN业务支持组播特性配置，L3VPN业务支持BRAS特性配置支持L3VPN中静态路由的IP地址配置为IPV6路由、PTN单站Tunnel管理单站Tunnel(RSVP-TE/static/IP)的创建、删除、修改、激活、去激活，已及相应的通知上报路由器设备上的双向StaticCRTunnel管理，包括：创建/删除/激活/去激活路由器设备上的双向StaticCRTunnel路由、PTNQos模板管理Qos模板的创建、删除、修改、应用、去应用，以及Qos模板创建和删除的通知上报Qos模板在端口上的应用、去应用路由、PTN物理端口属性配置IP域物理端口(POS、ATM、Ethernet、PDH)属性配置，以及相应的通知上报传送域物理端口属性设置，以及相应的通知上报接入域物理端口属性(ETH、POTS、ADSL、VDSL、GPON)设置，以及相应的通知上报路由、PTN、交换机、接入、传送iManagerU2000统一网络管理系统北向XML接口用户指南1系统概述文档版本01(2012-06-30)华为专有和保密信息版权所有©华为技术有限公司4功能概述功能详细说明涉及的领域逻辑端口管理逻辑端口(ETHTrunk/IPTrunk/MPGroup/IMA/逻辑串口/MFRGroup/VLANIF/TunnelIF/LoopBack)的创建、删除、修改，以及相应的通知上报聚合类型逻辑端口成员端口配置，包括增加、修改和删除成员端口，以及相应的通知上报交换机Eth-Trunk聚合端口管理，支持创建、删除Eth-Trunk逻辑端口、配置Eth-Trunk端口的成员端口接入域(POTSUser/VLAN)逻辑端口管理。支持VLAN的创建、删除、修改以及增加成员端口；支持POTSUser的创建、删除、修改；路由、PTN、交换机、接入子接口管理子接口的创建、删除、属性设置，以及相应的通知上报路由端口VLAN管理端口工作模式配置端口缺省VLAN、允许通过VLAN、剥离VLAN属性配置VLANStacking、VLANMapping、端口VLAN组播特性配置路由、交换机全局VLAN管理接入域VLAN的创建、删除、修改，支持组播特性交换机全局VLAN的创建、删除、修改，支持组播特性路由域全局VLAN的创建、删除、修改接入、交换机、路由网元属性配置网元基本属性设置，删除网元，以及相应的通知上报全域GPON业务发放GPON业务发放，支持GPON业务的创建、删除、修改、激活、去激活接入ONT网元管理ONT网元的创建、删除、属性配置，ONT端口的属性配置接入传输描述符管理传输描述符的创建、删除，以及对应的通知上报PTNTunnel策略管理Tunnel策略的创建、删除、修改，以及对应的通知上报路由VRRP管理VR接口的创建、修改、删除，VR监视接口的增加、删除、修改，VR接口全局属性配置，以及相应的通知上报路由ANCP管理ANCP全局属性配置，创建、删除ANCP全局模板，应用ANCP邻居模板到端口，设置ANCP线路参数路由iManagerU2000统一网络管理系统北向XML接口用户指南1系统概述文档版本01(2012-06-30)华为专有和保密信息版权所有©华为技术有限公司5功能概述功能详细说明涉及的领域SDHE2E业务发放包括：创建/删除/激活/去激活SDH路径、修改SDH路径的路由。包括SDH设备和RTN设备OTNE2E业务发放包括：创建/删除/激活/去激活OTN路径、修改OTN路径（只支持Client级别）源宿端。包括：创建/删除/激活/去激活以太专线、专网业务。包括WDM设备和OTN设备维护管理包括：创建/删除/执行测试套，创建/删除/执行测试例包括：执行OAM检测、设置OAM相关参数、创建/删除以太网OAM维护点MP、创建/删除以太网OAM维护联盟MA、创建/删除以太网OAM维护域MD、创建/删除以太网OAM统计路由1.4.3性能功能介绍表1-5北向XML接口支持的性能功能功能概述功能详细说明涉及的领域当前性能查询支持按输入的监视条件和参数名称过滤，查询当前性能PTN、传送历史性能查询支持按输入的监视条件和参数名称过滤，查询历史性能路由、PTN、交换机、传送性能监控实例管理支持对象监控实例的查询、创建，使能、去使能、删除路由、交换机性能越限事件通知上报支持性能越限事件的通知上报路由、PTN、交换机、传送1.4.4资源功能介绍表1-6北向XML接口支持的资源功能功能概述功能详细说明涉及的领域管理域、OS查询查询华为U2000管理域以及OS信息N/AiManagerU2000统一网络管理系统北向XML接口用户指南1系统概述文档版本01(2012-06-30)华为专有和保密信息版权所有©华为技术有限公司6功能概述功能详细说明涉及的领域资源站点查询查询管理域内传送域所有的光网元信息查询管理域内传送域所有的光网元名称信息指定光网元名称查询单个光网元详细信息指定光网元名称查询其下的资源信息(单板、槽位信息等)支持光网元创建和删除通知上报支持光网元包含的资源改变通知上报支持光网元属性改变通知上报传送网元信息查询查询所有网元名称信息查询所有的网元详细信息指定网元名称查询单个网元详细信息根据IP地址查询网元信息(路由域和交换机)支持网元的创建、删除、属性改变通知上报全域纤缆查询查询传送域的光纤信息查询路由域的IP链路、L2链路信息支持光纤、IP链路、L2链路创建、删除通知上报支持IP链路、L2链路属性改变通知上报传送、路由网元Equipment信息查询根据网元名称查询其下的子架、槽位、单板、子槽信息根据容器名称查询其下的单板、子槽等信息支持子架（仅支持WDM）、单板的添加和删除通知上报支持子架、单板的属性改变通知上报全域物理端口信息查询根据网元名称查询网元内的所有物理端口(POS、ATM、Ethernet、PDH)名称信息根据网元名称查询网元内的所有物理端口详细信息根据物理端口名称查询单个物理端口的详细信息支持物理端口重要属性改变通知上报支持物理端口状态改变通知上报全域iManagerU2000统一网络管理系统北向XML接口用户指南1系统概述文档版本01(2012-06-30)华为专有和保密信息版权所有©华为技术有限公司7功能概述功能详细说明涉及的领域逻辑端口信息查询根据网元名称查询网元内的所有逻辑端口(ETHTrunk/IPTrunk/MPGroup/IMA/逻辑串口/MFRGroup/VLANIF/LoopBack)名称信息根据网元名称查询网元内的所有逻辑端口详细信息根据逻辑端口名称查询单个逻辑端口的详细信息支持逻辑端口创建、删除、属性改变通知上报支持聚合类型逻辑端口成员端口的增加、删除、属性改变通知上报支持逻辑端口状态改变通知上报传送、路由、PTN、交换机、接入子接口查询根据物理端口或者逻辑端口名称查询其下的所有子接口名称信息根据物理端口或者逻辑端口名称查询其下的所有子接口详细信息根据指定子接口的名称查询单个子接口的详细信息支持子接口创建、删除、属性、状态改变通知上报路由、传送VPN业务查询根据网元名称查询网元内的所有VPN业务(PWE3/VPLS/L3VPN)名称信息根据网元名称查询网元内的所有VPN业务(PWE3/VPLS/L3VPN)详细信息根据指定VPN业务名称单条VPN业务(PWE3/VPLS/L3VPN)详细信息支持VPN业务创建通知上报、删除通知上报、状态改变通知上报、属性改变通知上报路由、PTNQos模板查询查询管理域下所有的全局Qos模板名称信息查询管理域下所有的全局Qos模板详细信息根据Qos模板名称查询单个Qos模板的详细信息根据Qos模板名称查询应用该Qos模板的资源信息支持Qos模板创建、删除通知上报路由、PTNTunnel查询根据网元名称查询其下的所有动态、静态、IPTunnel名称信息根据网元名称查询其下的所有动态、静态、IPTunnel详细信息根据Tunnel名称查询单条Tunnel的详细信息支持Tunnel创建、删除、状态改变、属性改变通知上报支持路由器双向static-CRTunnel路由、PTNiManagerU2000统一网络管理系统北向XML接口用户指南1系统概述文档版本01(2012-06-30)华为专有和保密信息版权所有©华为技术有限公司8功能概述功能详细说明涉及的领域Tunnel策略查询查询网元内所有的Tunnel策略名称信息查询网元内所有的Tunnel策略详细信息支持Tunnel策略的创建、删除通知上报路由传输描述符信息查询查询网元内所有的传输描述符名称信息查询网元内所有的传输描述符详细信息支持传输描述符的创建、删除通知上报PTN路径、交叉查询查询全网的SDH/WDM/OTN/RTN路径名称信息查询全网的SDH/WDM/OTN/RTN路径详细信息指定路径名称查询单条SDH/WDM/OTN/RTN路径的详细信息查询网元内的所有交叉信息指定路径名称查询其路由信息指定路径名称查询其路由和经过的光纤信息支持路径的创建、删除、状态改变、属性改变通知上报支持路径路由属性改变通知上报支持传送领域根据服务层查所有客户层路径传送保护组查询查询网元内所有的SDH、WDM、OTN、PTN、RTN和设备保护组信息查询RTN和PTN网元内所有的TunnelAPS保护组信息以及保护倒换数据查询指定名称的单个SDH、WDM、OTN、PTN、RTN或者设备保护组详细信息查询指定名称的单个SDH、WDM、OTN、PTN、RTN或者设备保护组的保护倒换数据支持保护组创建、删除、保护组倒换通知上报传送GPON业务查询根据网元名称查询网元内的所有GPON业务名称信息根据网元名称查询网元内的所有GPON业务详细信息根据GPON业务名称查询单条GPON业务的详细信息根据GPON业务名称查询其路由信息接入ONT查询根据OLT网元、PON端口、ONT网元名称查询其关联的ONT网元信息接入iManagerU2000统一网络管理系统北向XML接口用户指南1系统概述文档版本01(2012-06-30)华为专有和保密信息版权所有©华为技术有限公司9功能概述功能详细说明涉及的领域ServicePort和模板信息查询根据网元名称查询网元内的ServiePort信息根据网元名称查询网元内的ADSL链路模板、GHSDL链路模板、MEFIP流量模板信息支持查询全网GPONONT增值业务模板名称、GPONMDUSNMP模板名称、GPONONT能力模板名称、GPON告警模板名称、GPON业务模板名称、GPON线路模板名称接入ANCP信息查询根据网元名称查询网元内的所有ANCP邻居模板信息根据网元名称查询网元内的所有ANCP线路信息根据ANCP邻居模板查询其应用的端口信息路由VRRP信息查询根据网元名称查询网元内的所有VR接口名称信息根据网元名称查询网元内的所有VR接口详细信息根据VR接口名称查询其监视接口信息根据VR接口名称查询其全局属性路由粗粒度接口物理存量查询根据getInventory接口查询管理域、OS、线缆、网元信息根据getInventory接口查询全网或者指定网元内的子架、槽位、单板、物理端口信息支持根据请求参数过滤查询存量对象的名称、属性、或者其全部信息getInventory接口支持SIT、AFB等多种消息交互模式全域WDM端到端业务查询查询端到端以太专线和专网业务WDM和OTN设备维护信息查询查询测试例信息、查询测试例执行结果查询测试套信息、查询测试套执行结果查询OAM参数查询以太网OAM维护点MP查询以太网OAM维护联盟MA查询以太网OAM维护域MD查询以太网OAM统计查询以太网OAM检测结果路由1.5系统结构本节介绍北向XML接口的系统结构。iManagerU2000统一网络管理系统北向XML接口用户指南1系统概述文档版本01(2012-06-30)华为专有和保密信息版权所有©华为技术有限公司10北向XML接口的软件架构图如图1-2所示。图1-2软件架构图OSSApplicationsQx/SNMPASN.1SOAP/JMSSOAP/HTTP/HTTPS/FTP/SFTPManagedNetworksU2000GUIClientInventory(get)Provisioning(set/create/delete/active/deactive)Performance(get)Alarm(get/set)InventoryUpdate(SC/AVC/OC/OD)AlarmNotificationTCAEventHeartBeat表1-7北向XML接口组件组件功能U2000U2000服务器，对网络进行管理，并对外提供北向接口。GUIClientU2000客户端，提供图形化的界面对网络进行操作。与U2000服务器之间的通信为Asn.1。OSSApplications高层OSS系统，通过U2000提供的北向XML接口对网络进行操作。1.6技术指标本节介绍北向XML接口的技术指标，用于OSS对接时作为参考。北向XML接口的各项性能指标如表1-8所示。iManagerU2000统一网络管理系统北向XML接口用户指南1系统概述文档版本01(2012-06-30)华为专有和保密信息版权所有©华为技术有限公司11表1-8北向XML接口性能指标项目指标同时允许的最大OSS连接数10个XML请求响应时延小于3秒（CPU占用少于50%时）告警通知处理能力不小于每秒60条（连接3个NMS时）告警通知时延小于10秒（连接3个NMS时）iManagerU2000统一网络管理系统北向XML接口用户指南1系统概述文档版本01(2012-06-30)华为专有和保