CNAI操作.doc
《CNAI操作.doc》由会员分享，可在线阅读，更多相关《CNAI操作.doc（14页珍藏版）》请在冰豆网上搜索。
ＣＮＡＩ操作
一、概述 1
二、CNAI的环境设置 2
2.1默认的路径设置 2
2.2定义自己的环境变量 2
三、命令介绍及示例 3
3.1CNAI可以处理的Objects 3
3.2输出命令语法 3
3.2.1输出命令 3
3.2.2数据输出的示例 5
3.3输入命令语法 7
3.3.1输入指令 7
3.3.2数据输入的示例 7
四、错误处理 14
一、概述
CNAI是命令行方式的一种应用，实现CNA数据库和外部系统之间的数据交换。
利用CNAI可进行的操作有：
从CNA输出小区数据；输入小区数据到CNA；输入外部小区数据。
二、CNAI的环境设置
2.1默认的路径设置
·/etc/opt/ericsson/cnai/templ模版文件，每个CNAobject一个模版文件，文件中列出了所有可以输出的参数。
·/etc/opt/ericsson/cnai/dataobjectfiles，文件中包含CNAobjects的名字，它们的数据会被输出；此目录还放有parameterfiles，文件内容为每个objecttype要输出的参数名。
·/var/opt/ericsson/cnai/data/export保存输出文件。
·/var/opt/ericsson/cnai/data/import输入命令需要的输入文件。
·/var/opt/ericsson/cnai/log/reports输入/输出任务产生的ReportFiles。
2.2定义自己的环境变量
为便于管理，每个用户要定义自己的CNAI环境变量，不要使用默认的路径设置。
在自己目录下建立目录，目录里包含的文件名分别有data、export、import和report。
例如，现在我们用ERICSSON这个用户名登陆到服务器，在这个目录下建立lanzhou这个文件名，在lanzhou目录下建立文件名为data、export、import和report的文件夹。
在data文件夹里，要含有编辑好的msc_objfile、bsc_objfile和参数文件，msc_objfile和bsc_objfile的文件内容是网元名，即要输出的小区属于哪些MSC和BSC，参数文件则包含需要提取的参数，在这里我们把这三个文件分别命名为msc、bsc和antparameter。
注：
这三个文件不能有后缀，如果有后缀在export时会出现错误提示。
三、命令介绍及示例
3.1CNAI可以处理的Objects
CNAI可以处理以下的Objects:
·Network（NW）
·MobileservicesSwitchingCentre（MSC）
·BaseStationController（BSC）
·PriorityProfile（PP）
·Site（SITE）
·TransceiverGroup（TG）
·Cell（CELL）
·ForeignCell（FCELL）
3.2输出命令语法
注意，以下指令是大小写敏感的。
3.2.1输出命令
输出命令，can_export[AREA=user:
area_name,]NW=network,MSC=obj_file|all,MSC_REF=param_file|none|all,[BSC=obj_file|all,BSC_REF=param_file|none|all,[PP=obj_file|none|all,PP_REF=param_file|none|all,][SITE=obj_file|all,SITE_REF=param_file|none|all,[TG=obj_file|all,TG_REF=param_file|none|all,]][CELL=obj_file|all,CELL_REF=param_file|none|all,]]OUTPUT=transfer_file_name
如输出小区参数指令如下：
cna_exportNW=AXE,MSC=msc_objfile,MSC_REF=none,BSC=bsc_objfile,BSC_REF=none,CELL=all,CELL_REF=all,OUTPUT=outputname
在执行cna_export指令之前必须先编辑msc_objfile和bsc_objfile这两个文件，它们在/data目录下；如果有参数文件，也需要事先编辑保存在/data目录下。
msc_objfile文件内容是MSC名----要输出的小区属于哪些MSC（可以使用通配符*?
）
举例：
如有一个msc.obj文件，内容为“FSAMSC”
bsc_objfile文件内容是BSC名----要输出的小区属于哪些BSC（可以使用通配符*?
）
举例：
如有一个bsc.obj文件，内容为“FSA*”表示FSAMSC下的所有BSC
CELL=all表示包括指定MSC、BSC下的所有小区
CELL_REF=all表示输出小区的所有参数
参见示例文件：
osscell_wz（cnai\export\osscell_wz）
输出结果可通过设置空格为分隔符在EXCEL中打开。
参数文件（param_file）格式：
列出参数的名称，以空格隔开；all：
所有参数；none：
不输出
输出文件由OUTPUT指定名称，会输出在/export目录下面。
3.2.2数据输出的示例
点击Terminal，在弹出的对话框中分别输入以下指令：
env
setenvCNAI_DATA_DIR/home/ericsson/lanzhou/data
setenvCNAI_EXPORT_DIR/home/ericsson/lanzhou/export
setenvCNAI_IMPORT_DIR/home/ericsson/lanzhou/import
setenvCNAI_REPORT_FILE_DIR/home/ericsson/lanzhou/report
env
然后，输入导出小区数据的指令：
cna_exportNW=axe,MSC=all,MSC_REF=none,BSC=bsc,BSC_REF=none,CELL=all,CELL_REF=antparameter,OUTPUT=cnadata.log（如果MSC不是软交换，要把DATA文件夹里放MSC文本文件，MSC文件内包换涉及MSC，本次是华为软交换）
这样导出的小区数据的文件为celldata.log，保存在上述设定的路径/home/ericsson/lanzhou/export下。
3.3输入命令语法
同样，输入指令也要注意大小写。
3.3.1输入指令
输入指令，can_import[-abcfins]import_file_nameplanned_area_name
选项释义：
-a在plannedarea中删除validarea中存在而import_file_name文件中未指定的channelgroups。
-b在plannedarea中删除validarea中存在而import_file_name文件中未指定的NeighbourRelations。
-c禁止将BCCHNO参数设为ActiveandIdle，用于加快小区参数的输入速度，但之后，要进行一致性检查。
-f告诉CNAI输入文件包含其它OMC的数据，这些数据被视为ForeignCell。
-f选项将关闭-a–b选项。
-I在plannedarea中删除validarea中存在而import_file_name文件中未指定的internalcell。
-n告诉CNAI输入文件包含其它OMC的数据，系统要查找NeighbourRelation的数据。
-n选项将关闭-a–b选项。
-s在plannedarea中删除validarea中存在而import_file_name文件中未指定的sites。
输入文件：
对输出指令获得的输出文件的相应参数进行更改后，可以作为输入文件输入；也可以将excel文另存为用空格隔开的文本文件作为输入文件。
输入文件在/import目录下
输入指令帮助文件见cnai/can_import
输入结果：
执行输入指令成功后，会在CNA中产生一个规划域plannedarea，之后可以根据CNA的功能进行操作，如：
consistencycheck及update
3.3.2数据输入的示例
现在以修改LZBSC3G的小区LZ0899B的BCCHNO为例，LZ0899B的BCCHNO由94修改为76，该小区与LZBSC8G的小区LZ0991A存在邻区关系。
步骤一：
根据要修改的内容，按照CNAI的格式做好文件，并上传到/home/ericsson/lanzhou/import目录下
注意：
上传的文件同样不能有后缀，即没有扩展名。
步骤二：
打开CNAI，输入以下指令：
env
setenvCNAI_DATA_DIR/home/ericsson/lanzhou/data
setenvCNAI_EXPORT_DIR/home/ericsson/lanzhou/export
setenvCNAI_IMPORT_DIR/home/ericsson/lanzhou/import
setenvCNAI_REPORT_FILE_DIR/home/ericsson/lanzhou/report
env
cna_importlz0899bimport
注释：
lz0889b为要导入的文件名，该文件如上面说的那样存放在/home/ericsson/lanzhou/import目录下，import为CNAI完成数据导入后在CNA中生成的PLANNEDAREA的名字。
CNAI在IMPORT过程中有导入的进度，和导入完成后的REPORT名和存放路径：
步骤三：
将Reportfile下载到本地，查看Report的内容是否与我们要进行修改的内容一致。
步骤四：
打开CNA，选择FILE-OPEN-PLANNEDAREA，确认是否有名字为“IMPORT”的PLANNEDAREA；如果有，则选中该PLANNEDAREA，依次点击LOCK和OPEN。
这样我们就进入“IMPORT”这个PLANNEDAREA。
步骤五：
在CNA中确认要修改BCCHNO的小区LZ0899B是否修改，及其相邻小区的测量频点是否修改。
LZBSC3
LZBSC8
至此，利用CNAI进行数据的IMPORT及检查确认已经完成，接着只要按照CNA操作方法，对规划域进行CONSISTENCYCHECK后再做UPDATE，就可以实现小区数据的更改。
四、错误处理
输入或输出指令执行中发现的错误，都会在report目录中产生一个report文件，查看report文件改正相应的错误。
输出：
给出的objectname在CNAI数据库中不存在，输出会继续，只在report文件中产生一项错误输出。
如果参数文件中的参数名不存在，则输出会停止。
输入：
给出的objectname在CNAI数据库
升级会员 