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