Nastar V600R014C00 LTE CDR结果接口 开发指南(中国电信).docx

NastarV600R014C00北向LTE CDR结果文件接口 开发指南(中国电信)文档版本01发布日期2014-08-05华为技术有限公司版权所有 华为技术有限公司2014。 保留一切权利。非经本公司书面许可，任何单位和个人不得擅自摘抄、复制本文档内容的部分或全部，并不得以任何形式传播。商标声明和其他华为商标均为华为技术有限公司的商标。本文档提及的其他所有商标或注册商标，由各自的所有人拥有。注意您购买的产品、服务或特性等应受华为公司商业合同和条款的约束，本文档中描述的全部或部分产品、服务或特性可能不在您的购买或使用范围之内。除非合同另有约定，华为公司对本文档内容不做任何明示或默示的声明或保证。由于产品版本升级或其他原因，本文档内容会不定期进行更新。除非另有约定，本文档仅作为使用指导，本文档中的所有陈述、信息和建议不构成任何明示或暗示的担保。华为技术有限公司地址：深圳市龙岗区坂田华为总部办公楼 邮编：518129网址：客户服务邮箱：客户服务电话：4008302118文档版本 01 (2014-08-05)华为专有和保密信息 版权所有 华为技术有限公司i Nastar北向LTE CDR结果文件接口 开发指南(中国电信)目 录前 言概述介绍Nastar北向LTE CDR结果文件接口的接口描述等信息，并提供了和NMS对接的操作指导。该产品特性在提供业务、服务或维护过程中，将涉及个人数据的使用，因此您需遵循所适用国家的法律或公司用户隐私政策采取足够的措施，以确保用户的个人数据受到充分的保护。产品版本与本文档相对应的产品版本如下所示。产品名称产品版本NastarV600R014C00LTE CDR结果文件北向功能配套的网元与网管版本如下所示：网元/网管名称产品版本eNodeBV100R008C01V100R009C00U2000/M2000M2000 V200R012C00M2000 V200R013U2000 V200R014C00读者对象本指南主要适用于以下工程师：l 技术支持工程师l 维护工程师l 网优工程师修订记录01 (2014-08-05)第一次发布。目 录前 言iii目 录v1 北向LTE CDR结果文件导出简介1-11.1 Nastar北向组网结构1-11.2 北向LTE CDR结果文件导出工作原理1-32 北向LTE CDR结果文件介绍2-12.1 存储路径2-12.2 命名规则2-12.3 删除策略2-12.4 导出方式2-23 北向LTE CDR结果文件接口对接调试3-13.1 协商北向LTE CDR结果文件接口对接参数3-13.2 订阅LTE CDR结果文件3-23.3 调试北向LTE CDR结果文件接口对接3-44 解析北向LTE CDR结果文件4-15 FAQ5-15.1 如何使用FileZilla工具传输文件5-1文档版本 01 (2014-08-05)华为专有和保密信息 版权所有 华为技术有限公司vNastar北向LTE CDR结果文件接口 开发指南(中国电信)1 北向LTE CDR结果文件导出简介1 北向LTE CDR结果文件导出简介介绍Nastar北向组网结构和LTE CDR结果文件的导出工作原理，以便用户了解LTE CDR结果文件导出的网络位置和生成的过程。1.1 Nastar北向组网结构介绍Nastar北向组网结构，以便您了解保存LTE CDR结果文件的eSAU在网络中的位置。Nastar北向组网结构如图1-1所示。图1-1 Nastar北向组网结构图组网结构图中各功能单元说明如表1-1所示。表1-1 各功能单元说明功能单元功能描述Nastar华为公司多用户的电信平台之一，对无线网络进行性能分析，并提供北向数据（如LTE CDR结果文件）导出功能。与U2000/M2000一起部署在OM网络。eSAUNastar系统中数据汇聚平台，其主要功能包括：l 汇聚各SAU预处理后的数据，进行存储和二次汇总。l 提供数据查询接口，向Nastar提供网优分析多维汇总数据。l 提供北向数据接口，向NMS提供北向数据。与Nastar一起部署在OM网络。LTE SAUNastar系统中数据业务感知单元，其主要功能包括：l LTE北向数据导出功能中，从Trace Server上采集北向数据。l 预处理原始数据，完成一次汇总，并将汇总结果上报eSAU。LTE网络，LTE SAU与eSAU一起部署在OM网络，独立硬件。U2000/M2000移动网元管理系统，是华为公司移动网络统一管理平台，给Nastar提供到网元的控制命令通道，同时给Nastar提供配置和性能分析数据。Trace ServerLTE网络数据采集服务器，用于采集LTE网元数据。与U2000/M2000一起部署在OM网络。1.2 北向LTE CDR结果文件导出工作原理介绍Nastar系统北向LTE CDR结果文件的导出工作原理。 LTE CDR结果文件导出工作原理如图1-2所示。图1-2 LTE CDR结果文件导出工作原理图原理图说明如下：1. 通过Nastar客户端创建CDR订阅任务。2. Nastar下发订阅信息至eSAU，包括网元和事件。3. eSAU下发网元开关给U2000/M2000的Trace Server。如果有多个Trace Server，由eSAU进行分发。4. U2000/M2000下发命令到eNodeB网元。5. eNodeB采集原始数据，当数据达到1M或者时间达到5分钟均会生成文件上传给U2000/M2000的Trace Server。6. Trace Server过滤从eNodeB采集到的数据，供LTE SAU周期性获取。7. 通过在LTE SAU上执行脚本打开eNodeB所生成文件的处理功能。LTE SAU预处理获取的数据并输出CSV格式的LTE CDR结果文件。8. LTE SAU上传LTE CDR结果文件至eSAU北向文件存储目录。9. NMS从eSAU导出北向LTE CDR结果文件。文档版本 01 (2014-08-05)华为专有和保密信息 版权所有 华为技术有限公司1-4Nastar北向LTE CDR结果文件接口 开发指南(中国电信)2 北向LTE CDR结果文件介绍2 北向LTE CDR结果文件介绍介绍LTE CDR结果文件的存储路径、命名规则、删除策略和导出方式。2.1 存储路径北向LTE CDR结果文件存储在eSAU上，eSAU提供FTP服务，NMS到eSAU上获取LTE CDR结果文件。eSAU上LTE CDR结果文件存储目录：“/export/home/northdata/CDR/ eNodeBId”。其中，eNodeBId表示eNodeB网元ID。举例：“/export/home/northdata/CDR/123/”。2.2 命名规则介绍LTE CDR结果文件的命名规则。LTE CDR结果文件命名规则：“_.csv.gz”。命名规则字段含义如下所示：l ：eNodeB网元IDl ：表示创建LTE CDR结果文件的时间，格式为YYYYMMDDHHmmss例如，文件生成时间为2014年5月11日17点30分30秒，eNodeB网元ID为123，则生成的文件名为：“123_20140511173030.csv.gz”。获取结果文件后需要使用gunzip算法进行解压，否则无法正确解析文件内容。2.3 删除策略介绍北向LTE CDR结果文件的删除机制。系统自动删除机制说明：l 空间和时间维度监控，启动时检查一次，后续每隔一小时检查一次。l 通过时间维度确认文件是否过期，空间维度确认文件是否超过规定大小。l 时间维度文件过期或空间维度规格超标，均进行删除。删除文件时按时间顺序，先删最旧的文件。例如，2013年1月1日12:00生成的北向LTE CDR结果文件，若保存时间设置为3天，则在空间规格未超标的情况下，该文件将于2013年1月4日12:00之后被删除；在空间规格超标的情况下，系统按时间顺序先删除最旧的文件。2.4 导出方式LTE CDR结果文件支持自动导出方式。通过在Nastar客户端打开eNodeB网元开关，然后通过在LTE SAU主服务器上运行LTE_CDR_north.sh脚本打开北向LTE CDR结果文件专题订阅实现LTE CDR结果文件的自动导出，导出后的文件存放在eSAU服务器上，eSAU提供FTP服务器，NMS可通过FTP方式到该目录下获取文件。LTE CDR结果文件传输支持两种协议：l FTP协议：普通的FTP协议。l SFTP协议：安全FTP协议(SSH FTP)是基于SSH协议的FTP传输模式。Nastar不支持通过界面手工导出当前系统中的LTE CDR结果文件。文档版本 01 (2014-08-05)华为专有和保密信息 版权所有 华为技术有限公司2-2Nastar北向LTE CDR结果文件接口 开发指南(中国电信)3 北向LTE CDR结果文件接口对接调试3 北向LTE CDR结果文件接口对接调试NMS与Nastar进行对接之前，您可以先进行对接调试，根据调试的结果判断北向LTE CDR结果文件接口是否满足与NMS进行对接的要求。3.1 协商北向LTE CDR结果文件接口对接参数NMS与Nastar对接前需要检查License及协商LTE CDR结果文件接口对接参数。检查LicenseNastar系统北向LTE CDR结果文件接口包含1个特性，每个特性独立License控制。特性说明如表3-1所示。表3-1 北向LTE CDR结果文件接口License说明特性名称特性说明LQG6NASTAR51用于导出LTE FDD小区的 CDR结果文件。对接前需要检查Nastar是否具有相应的License，具体步骤如下：1. 登录Nastar客户端。2. 选择“帮助 License管理 License信息”，弹出“License信息”对话框。3. 选择“资源控制项”页签，如果“资源名称”列表中有表3-1中的特性名称，则说明NMS具有使用对应接口的权限。如果没有，请联系华为技术支持工程师获取。协商对接参数参数包括NMS登录的用户名和密码、端口等，表3-2为一组结果文件接口参数的具体示例，以下对接操作均以此例进行描述。表3-2 对接参数示例参数类型参数项参数值说明用户参数（eSAU作为FTP服务器，NMS主动获取文件）FTP用户名northuser不可修改。密码默认值为“Changeme_123”请联系Nastar管理员获取。端口参数FTP端口21如果采用FTP协议传输文件，需要eSAU开放此端口。SFTP端口22如果采用SFTP协议传输文件，需要eSAU开放此端口。3.2 订阅LTE CDR结果文件NMS与Nastar对接前，需要先订阅LTE CDR结果文件，导出LTE CDR结果文件到eSAU指定路径下。前提条件l U2000/M2000服务器上已安装LTE网元适配层软件且系统运行正常。l 已部署Trace Server服务器，且Trace Server运行正常。l 已完成Nastar系统的安装与调测，且系统运行正常。l PC终端与LTE SAU服务器之间通信正常。l Nastar能与U2000/M2000、Trace Server正常通信，具体操作请参见相应机型的Nastar调测指南中的“检查Nastar系统与网管系统之间的网络连接”章节。l 已通过Nastar客户端正确配置以下信息：配置项参考文档eSAU信息“Nastar产品文档 操作与维护 Nastar基础入门 配置OSS与网元信息 配置eSAU信息”U2000/M2000和Trace Server信息“Nastar产品文档 操作与维护 Nastar基础入门 配置OSS与网元信息 配置OSS信息”eNodeB信息“Nastar产品文档 操作与维护 Nastar基础入门 配置OSS与网元信息 配置RAN侧网元信息 选择OSS管理的RAN侧网元”LTE SAU信息“Nastar产品文档 操作与维护 Nastar基础入门 配置OSS与网元信息 配置RAN侧网元信息 配置SAU/LTE SAU信息”操作步骤步骤 1 登录Nastar客户端。步骤 2 执行以下操作，下发MML命令打开网元开关。1. 在Nastar客户端菜单栏，选择“维护 数据订阅管理”，打开“数据订阅管理”窗口。2. 选择“LTE FDD”页签。3. 在右侧订阅界面中选择“基础订阅”页签。4. 在左侧导航树上，选择需要导出LTE CDR结果文件的eNodeB网元。请勿选择以中英文以外的语言命名的网元，否则将会导致北向LTE CDR结果文件获取失败。5. 单击“基础订阅”页签中的“设置”按钮，弹出“基础订阅”对话框。6. 在“基础订阅”对话框的“覆盖分析数据(CHR)” 下拉列表中，选择“打开”。，单击“确定”。7. 单击“覆盖分析数据(CHR)”下拉列表右侧的按钮，打开“高级参数设置(CHR)”对话框。8. 保持“事件块类型”默认值，单击“确定”。步骤 3 执行以下操作， 生成LTE CDR结果文件。1. 使用PuTTY工具以ossuser用户登录LTE SAU主服务器。 2. 执行以下命令，下发专题开关。# cd /opt/ransau/script/process# ./LTE_CDR_north.sh open当系统显示以下信息时，表示订阅打开成功。否则，请联系华为技术支持工程师分析处理。Open subscription succeeded.-结束后续处理关闭LTE CDR结果文件订阅任务的操作步骤如下。步骤 1 使用PuTTY工具以ossuser用户登录LTE SAU主服务器。 # cd /opt/ransau/script/process# ./LTE_CDR_north.sh close当系统显示以下信息时，表示订阅关闭成功。否则，请联系华为技术支持工程师分析处理。close subscription succeeded.-结束3.3 调试北向LTE CDR结果文件接口对接模拟NMS通过FTP方式获取Nastar已经生成的北向LTE CDR结果文件，并根据获取的LTE CDR结果文件判断北向LTE CDR结果文件接口是否满足与NMS进行对接的要求。前提条件l NMS与Nastar网络连接正常。l 已成功订阅北向LTE CDR结果文件，具体请参见3.2 订阅LTE CDR结果文件。l 已获取eSAU服务器的IP地址和FTP用户密码。l 使用支持FTP/SFTP的工具。华为提供了推荐的PSFTP软件和FileZilla工具下载LTE CDR结果文件。本节以采用PSFTP软件为例进行说明，使用FileZilla工具下载文件的方法请参见5.1 如何使用FileZilla工具传输文件。请联系华为技术支持工程师从华为Support网站的“工具 受控小工具 无线 网络规划优化工具 iManager Nastar Nastar Tools”路径下获取PSFTP软件。 操作步骤步骤 1 双击“psftp.exe”。步骤 2 执行以下命令，启动FTP连接。psftp open eSAU服务器IP地址步骤 3 输入eSAU服务器的FTP用户名和密码后，单击“Enter”。确保您输入的FTP用户名为northuser，否则将导致北向LTE CDR结果文件下载失败。步骤 4 执行以下命令，设置文件在本地的保存路径。假设本地保存路径为“D:”。psftp lcd D:数据文件在本地PC上的保存路径不能包含空格和中文字符。Windows的桌面路径中存在空格，因此请不要将数据文件放在桌面上。步骤 5 输入以下命令，切换至eSAU服务器上需要下载的LTE CDR结果文件目录。psftp cd LTE CDR结果文件目录LTE CDR结果文件的存储目录请参见2.1 存储路径。例如：cd /export/home/northdata/CDR/123/步骤 6 输入以下命令，下载LTE CDR结果文件。psftp get LTE CDR结果文件名称LTE CDR结果文件的命名规则请参见2.2 命名规则。若您想同时下载某一个文件夹中的所有文件，请执行命令：get -r 数据文件夹。步骤 7 文件下载完毕后，执行exit命令退出。-结束文档版本 01 (2014-08-05)华为专有和保密信息 版权所有 华为技术有限公司3-5Nastar北向LTE CDR结果文件接口 开发指南(中国电信)4 解析北向LTE CDR结果文件4 解析北向LTE CDR结果文件LTE CDR结果文件为CSV格式，运营商解压后可直接查看，或自行开发工具进行解析。操作步骤步骤 1 解压LTE CDR结果文件。 步骤 2 直接查看LTE CDR结果文件，或者自行开发工具进行解析。-结束文档版本 01 (2014-08-05)华为专有和保密信息 版权所有 华为技术有限公司4-1Nastar北向LTE CDR结果文件接口 开发指南(中国电信)5 FAQ5 FAQ介绍北向LTE CDR结果文件接口对接调试时常见问题及解决办法。5.1 如何使用FileZilla工具传输文件Nastar服务器缺省支持SFTP传输模式，为了提高文件传输的安全性，请使用SFTP协议进行文件传输。FileZilla是一款专用的文件传输工具，不仅支持SFTP传输模式，而且支持断点续传。建议使用FileZilla工具进行文件的传输。前提条件l 已获取目标服务器的IP地址。l PC与目标服务器间通讯正常。l 已联系华为技术支持工程师从华为Support网站网站获取“FileZilla.zip”并解压至PC。您可以使用“软件中心”的“软件搜索工具”，以工具包名称作为搜索关键字，快速查找到工具包。 l 已获取目标服务器的用户密码。操作步骤步骤 1 双击“filezilla.exe”，运行“filezilla.exe”工具。步骤