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

Nastar

V600R014C00

北向LTE CDR 结果文件接口 开发

指南(中国电信)

文档版本

01 发布日期 2014-08-05

华为技术有限公司

版权所有? 华为技术有限公司2014。保留一切权利。

非经本公司书面许可，任何单位和个人不得擅自摘抄、复制本文档内容的部分或全部，并不得以任何形式传播。

商标声明

和其他华为商标均为华为技术有限公司的商标。

本文档提及的其他所有商标或注册商标，由各自的所有人拥有。

注意

您购买的产品、服务或特性等应受华为公司商业合同和条款的约束，本文档中描述的全部或部分产品、服务或特性可能不在您的购买或使用范围之内。除非合同另有约定，华为公司对本文档内容不做任何明示或默示的声明或保证。

由于产品版本升级或其他原因，本文档内容会不定期进行更新。除非另有约定，本文档仅作为使用指导，本文档中的所有陈述、信息和建议不构成任何明示或暗示的担保。

华为技术有限公司

地址：深圳市龙岗区坂田华为总部办公楼邮编：518129

网址：https://www.360docs.net/doc/1510183675.html,

客户服务邮箱：support@https://www.360docs.net/doc/1510183675.html,

客户服务电话：4008302118

前言

概述

介绍Nastar北向LTE CDR结果文件接口的接口描述等信息，并提供了和NMS对接的

操作指导。

该产品特性在提供业务、服务或维护过程中，将涉及个人数据的使用，因此您需遵循所适用国家

的法律或公司用户隐私政策采取足够的措施，以确保用户的个人数据受到充分的保护。

产品版本

与本文档相对应的产品版本如下所示。

LTE CDR结果文件北向功能配套的网元与网管版本如下所示：

读者对象

本指南主要适用于以下工程师：

●技术支持工程师

●维护工程师

网优工程师修订记录

01 (2014-08-05)

第一次发布。

目录

前言................................................................................................................................................ i ii 目录.. (v)

1 北向LTE CDR结果文件导出简介........................................................................................... 1-1

1.1 Nastar北向组网结构 ................................................................................................................................... 1-1

1.2 北向LTE CDR结果文件导出工作原理.................................................................................................... 1-3

2 北向LTE CDR结果文件介绍................................................................................................... 2-1

2.1 存储路径...................................................................................................................................................... 2-1

2.2 命名规则...................................................................................................................................................... 2-1

2.3 删除策略...................................................................................................................................................... 2-1

2.4 导出方式...................................................................................................................................................... 2-2

3 北向LTE CDR结果文件接口对接调试................................................................................... 3-1

3.1 协商北向LTE CDR结果文件接口对接参数............................................................................................ 3-1

3.2 订阅LTE CDR结果文件............................................................................................................................ 3-2

3.3 调试北向LTE CDR结果文件接口对接.................................................................................................... 3-4

4 解析北向LTE CDR结果文件................................................................................................... 4-1

5 FAQ ............................................................................................................................................... 5-1

5.1 如何使用FileZilla工具传输文件 .............................................................................................................. 5-1

1 北向LTE CDR结果文件导出简介

介绍Nastar北向组网结构和LTE CDR结果文件的导出工作原理，以便用户了解LTE

CDR结果文件导出的网络位置和生成的过程。

1.1 Nastar北向组网结构

介绍Nastar北向组网结构，以便您了解保存LTE CDR结果文件的eSAU在网络中的位

置。

Nastar北向组网结构如图1-1所示。

图1-1Nastar北向组网结构图

组网结构图中各功能单元说明如表1-1所示。表1-1各功能单元说明

1.2 北向LTE CDR结果文件导出工作原理

介绍Nastar系统北向LTE CDR结果文件的导出工作原理。

LTE CDR结果文件导出工作原理如图1-2所示。

图1-2L TE CDR结果文件导出工作原理图

(4)

eNodeB

原理图说明如下：

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结果文件。

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”。

命名规则字段含义如下所示：

●：eNodeB网元ID

●：表示创建LTE CDR结果文件的时间，格式为YYYYMMDDHHmmss

例如，文件生成时间为2014年5月11日17点30分30秒，eNodeB网元ID为123，

则生成的文件名为：“123_20140511173030.csv.gz”。

获取结果文件后需要使用gunzip算法进行解压，否则无法正确解析文件内容。

2.3 删除策略

介绍北向LTE CDR结果文件的删除机制。

系统自动删除机制说明：

●空间和时间维度监控，启动时检查一次，后续每隔一小时检查一次。

●通过时间维度确认文件是否过期，空间维度确认文件是否超过规定大小。

●时间维度文件过期或空间维度规格超标，均进行删除。删除文件时按时间顺序，

先删最旧的文件。

例如，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结果文件传输支持两种协议：

●FTP协议：普通的FTP协议。

●SFTP协议：安全FTP协议(SSH FTP)是基于SSH协议的FTP传输模式。

Nastar不支持通过界面手工导出当前系统中的LTE CDR结果文件。

3 北向LTE CDR结果文件接口对接调试

NMS与Nastar进行对接之前，您可以先进行对接调试，根据调试的结果判断北向LTE

CDR结果文件接口是否满足与NMS进行对接的要求。

3.1 协商北向LTE CDR结果文件接口对接参数

NMS与Nastar对接前需要检查License及协商LTE CDR结果文件接口对接参数。

检查License

Nastar系统北向LTE CDR结果文件接口包含1个特性，每个特性独立License控制。

特性说明如表3-1所示。

表3-1北向L TE CDR结果文件接口License说明

对接前需要检查Nastar是否具有相应的License，具体步骤如下：

1.登录Nastar客户端。

2.选择“帮助> License管理> License信息”，弹出“License信息”对话框。

3.选择“资源控制项”页签，如果“资源名称”列表中有表3-1中的特性名称，则

说明NMS具有使用对应接口的权限。如果没有，请联系华为技术支持工程师获取。协商对接参数

参数包括NMS登录的用户名和密码、端口等，表3-2为一组结果文件接口参数的具体

示例，以下对接操作均以此例进行描述。

表3-2 对接参数示例

3.2 订阅LTE CDR 结果文件

NMS 与Nastar 对接前，需要先订阅LTE CDR 结果文件，导出LTE CDR 结果文件到

eSAU 指定路径下。

前提条件

●

U2000/M2000服务器上已安装LTE 网元适配层软件且系统运行正常。 ●

已部署Trace Server 服务器，且Trace Server 运行正常。 ●

已完成Nastar 系统的安装与调测，且系统运行正常。 ●

PC 终端与

LTE SAU 服务器之间通信正常。 ● Nastar 能与U2000/M2000、Trace Server 正常通信，具体操作请参见相应机型的

Nastar 调测指南中的“检查Nastar 系统与网管系统之间的网络连接”章节。

● 已通过Nastar 客户端正确配置以下信息：

操作步骤

步骤 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进行对接的要

求。

前提条件

●NMS与Nastar网络连接正常。

●已成功订阅北向LTE CDR结果文件，具体请参见3.2 订阅LTE CDR结果文件。

●已获取eSAU服务器的IP地址和FTP用户密码。

●使用支持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命令退出。

----结束

4 解析北向LTE CDR结果文件

LTE CDR结果文件为CSV格式，运营商解压后可直接查看，或自行开发工具进行解

析。

操作步骤

步骤 1解压LTE CDR结果文件。

步骤 2直接查看LTE CDR结果文件，或者自行开发工具进行解析。

----结束

5 FAQ

介绍北向LTE CDR结果文件接口对接调试时常见问题及解决办法。

5.1 如何使用FileZilla工具传输文件

Nastar服务器缺省支持SFTP传输模式，为了提高文件传输的安全性，请使用SFTP协

议进行文件传输。FileZilla是一款专用的文件传输工具，不仅支持SFTP传输模式，而

且支持断点续传。建议使用FileZilla工具进行文件的传输。

前提条件

●已获取目标服务器的IP地址。

●PC与目标服务器间通讯正常。

●已联系华为技术支持工程师从华为Support网站网站获取“FileZilla.zip”并解压至

PC。

您可以使用“软件中心”的“软件搜索工具”，以工具包名称作为搜索关键字，快

速查找到工具包。

●已获取目标服务器的用户密码。

操作步骤

步骤 1双击“filezilla.exe”，运行“filezilla.exe”工具。

步骤 2在“FileZilla”窗口中，单击左上方的。

步骤 3在“站点管理器”对话框的左下方，单击“新站点”。

步骤 4在“通用”页签中，根据表8-1配置站点参数。

表5-1站点管理器配置参数说明

步骤 5单击“连接”。

●连接过程中弹出的提示框可不关注，单击“确定”。

●连接成功后“远程站点”区域显示远程服务器的目录信息。

步骤 6在“远程站点”区域，设置服务器上的目标路径，如“/export/home/sysm”目录。

路径设置完毕后，“远程站点”区域会显示该路径下的所有文件。

步骤 7在“本地站点”区域，设置要上传的文件在PC上的路径，如“D:\”目录。

路径设置完毕后，“本地站点”区域会显示该路径下的所有文件。

步骤 8根据实际需要选择相应操作。

如果上传或下载失败，可以在“FileZilla”窗口的左下方单击“传输失败”页签，右键选择传输

失败的文件后，在弹出的快捷菜单中选择“重置并重新请求所选的文件”，恢复文件传输。

----结束