CNAi+Import+Export+Instructions

Internal Information1 (12)

Prepared (also subject responsible if other) No. EUS-03:002096 Uen

Anwar SayeedApproved Checked Date Rev Reference

Franz De Waal 05/05/03 PA2

Export/Import of pre-defined cell data using CNAI

Internal Use

I. OVERVIEW..............................................................................................................................................2

II. SETUP DIRECTORIES AND FILES IN OSS..................................................................................................................3

III. EXPORT CELL DATA FROM CNAI................................................................................................................................5

IV. IMPORT CELL DATA FROM THE FILE TO CNAI......................................................................................................9

V. UNIX COMMANDS – ADDENDUM................................................................................................................................11

VI. ATTACHMENTS .....................................................................................................................................................12

V11. REFERENCE........................................................................................................................................................................12





I. Overview

This document descirbes how to use CNAi for Importing and Exporting big volume of data between network and OSS. Figure 1 shows the basic concept involved.

CNAi Export will allow dumping data from the Valid area into individual files stored under predefined OSS directory. This is explained by System audit example. The export will be done on Cell and BSC parameters and will be audited against recommended Operator settings

CNAi Import will allow data to load to the network by first importing all the changes into a Planned area under CNA and later runing an Update job on the same planned area. The example used to illustrate this process is a System retune. The import process will apply new BCCH and hopping frequency into the network

CNAi Import

Network

OSSFigure 1

Figure 2 shows the step-by-step procedure of importing and exporting data from/to CNAI. Following is a breif describtion of each section.

Section II – Setup directories and files in OSS. Before Import/Export with CNAI is executed, user must setup a directory environment

Section III – Export data from CNAI, gives guideline to use pre-defined files to export cell parameters from the system (CNA valid area).

Section IV – Import data to CNAI, gives guideline to use pre defined files to import new BCCH and hopping frequecnies to the network (CNA planned Area)

MSCCNA

Adjustment JobValid Area

Planned AreaUpdate Job

Files stored under OSS

CNAi Export





Section V – Unix commands Addendum, lists some Unix commands which are used in this guideline.

Section II

Section III

Figure 2

Section IV

II. Setup directories and files in OSS

1. Run Citrix application2. Open OSS Terminal window

a. Right click (window will appear with multiple selections)b. Select Sun Tools -> Terminal

3. Using Terminal, create /cnai directory in your home directory

cd $HOME

start

Setup Directory and transfer files in OSS using

File Manager Terminal

EXPORT

1. Edit AuditBSClist.txt2. Edit cnai2tcp and save3. Run cnai2tcp

IMPORT

1. Populate import file import_bcch&hop_freq.txt with real data and store it under $HOME/cnai/import

2. Edit tcp2cnai and save 3. Open CNA and run Adjustment job4. Run tcp2cnai5. Under CNA open the Planned area

created in step46. Run planning report7. Run Update job on Planned area

created ini step 4

FTP





mkdir cnai

4. create /export ; /import ; /data ; /report directories in your /cnai directory

cd $HOME/cnai mkdir export mkdir import mkdir data mkdir report

5. transfer filesa. cnai2tcpb. tcp2cnai

to $HOME/cnai directory.

Use FTP which is available also in F-Secure SSH Client application - click on Quick Connect to connect it to the OSS server. Go to home directory and use drag-and-drop to transfer files from Windows explorer to SSH File transfer Window under appropriate directories

Figure 3





6. transfer files:a. AuditCelldata.txtb. AuditBSCdata.txt These files are used in Export examplec. AuditBSClist.txtd. export_freq.txte. export_neigh.txtf. export_freq_neigh.txt

to /cnai/data directory

7. transfer files:a. import_bcch&hop_freq.txt This file is used in Import exampleb. import_only_bcch_freq.txtc. import_only_neighb.txtd. import_all_freq&neighb.txt

to /cnai/import directory.

The import files are only sample files which represent the structure only. They should be populated with real data.

8. Under OSS Terminal window change mode of cnai2tcp and tcp2cnai batch files to executable files. Type:

cd $HOME/cnai chmod +x cnai2tcp chmod +x tcp2cnai

III. Export cell data from CNAI

The export process will be illustrated with an example. The objective of this example is to do a System audit. This requires exporting all cell and BSC parameters and compare against recommended setting.

1. Edit AuditBSClist.txt file Modify file to include BSC under audit. In our case it is HOTXB05. Edit this file using text editor in OSS or simply in Notepad and transfer it from PC to OSS using FTP. The edited file should be saved under $HOME/cnai/data directory. Figure 4 shows the files being used.





Figure 4

How to use text editor for editing AuditBSClist.txt file

If you use (or have access) to Citrix application then you can use Text Editor from OSS – simply click right mouse button to display GSM-OSS Workspace Menu, select SUN Tools and Text Editor, see Fig5.Then in Text Editor open file AuditBSC.txt and list BSC(s) which you want to use in exporting. Save the file.





Figure.5: Citrix – where to find TextEditor…

2. Edit cnai2tcp (use vi editor or TextEditor, or edit it in Notepad and FTP to OSS into $HOME/cnai/ directory)

Figure 6 shows the changes made to this file

Go to line cna_export and make the highlighted changes

NW=AXE,MSC=all,MSC_REF=none,BSC=AuditBSClist.txt,BSC_REF=none,CELL=all,CELL_REF=AuditCelldata.txt,OUTPUT=CellParameter

Save cnai2tcp file.





Figure 6

Attention!!!!: Output file name has to be unique. All output files are stored in $Home/cnai/export directory. Export will fail if the file already exist in /cnai/export directory.

3. Run cnai2tcp using OSS Terminal

go to $HOME/cnai directory: cd $HOME/cnai

cnai2tcp

Batch file will run with ” Export in progress: ## %” information

The exported file Cellparameter will be stored under $Home/cnai/export directory. FTP this file to PC

When the export is finished, a report file is created under $Home/cnai/report. This file contains the information about the export process. Any failure to export process will be notified in this file.

Repeat steps 2 and 3 for getting BSC parameters by editing the following line in cnai2tcp file with the highlighted data

NW=AXE,MSC=all,MSC_REF=none,BSC=AuditBSClist.txt,BSC_REF=none,CELL=all,CELL_REF=AuditBSCdata.txt,OUTPUT=BSCParameter

This completes the export process. Once the cell and BSC data is available it can be compared against recommended settings





Similarly the remaining files stored in the $Home/cnai/data diretory can be used the same way to obtain different information. These files are

a. export_freq.txt ...... will export BCCH and hopping frequenciesb. export_neigh.txt ...... will export neighborc. export_freq_neigh.txt ...... will export both frequency and neighbor

1V. Import cell data from the file to CNAI

Import CNAi funciton is explained with frequecy retune example.

1. Import_filePopulate import_bcch&hop_freq.txt file with new BCCH and hopping frequencies as shown in figure 7. FTP it to $HOME/cnai/import directory.

Figure 7

2. Edit tcp2cnai script fileThe script file tcp2cnai has to be modified before it is executed.

a. open tcp2cnai file for editing (use any editor)b. go to line:

cna_import [options] input_file.txt planned_area_name

and make the following highlighted changes

cna_import import_bcch&hop_freq.txt SystemRetune (no option chosen)

c. Save file





OPTIONS-a Allows deletion of channel groups. Channel group that exist in the CNA valid area but are not

specified in the transfer file will be deleted in the planned area.

-b Allows deletion of neighbor relations and UTRAN neighbor relations. Neighbor relations and UTRAN neighbor relations that exist in the CNA valid area but are not specified in the transfer file will be deleted in the planned area.

-c Disables the distribution of the BCCHNO parameter to the Active and Idle parameters. This flag can be used to speed up cell data import, but Consistency Check should be performed afterwards.

-f informs the function that the transfer file contains data from another OMC and that the data will be handled as foreign cell data. This option turns off -a, -b, -i and -s.

-i Allows deletion of internal cells or UTRAN cells. Internal cells or UTRAN cells that exist in the CNA valid area but are not specified in the transfer file will be deleted in the planned area.

-n Informs the function that the transfer file contains data from another OMC and that it should search for neighbor relation data. This option turns off -a, -b, -i and -s.

-s Allows deletion of sites. Sites that exist in the CNA valid area but are not specified in the transfer file will be deleted in the planned area.

If options are not specified, then data in import file will substitute data which are in CNA planned area. If neighbors are not in planned area they will be created according to import_file.txt

3. Open CNA and run Adjustment job

a. Right click on OSS desktop ->Configuration Management -> Cellular Network Administration (CNA)

b. CNA -> File -> New Job -> Adjustment Job -> New Adjustment job window -> Hit New (fill info first)

4. Run file tcp2cna from OSS terminal.

Go to $HOME/cnai directory: cd $HOME/cnai

cnai2tcp

You should get a prompted information:

Import in progress: xx%

5. Open planned area in CNA





File -> Open -> Planned Area -> My Own

And select the planned area created in step 4

6. Run Planning report in CNA To verify the data being sent out to Network is correct

View -> Planning Report 7. Run Update job for the planned area under CNA

File -> Update Job -> New Job ->New Update Job window

This complete the import process

Similarly other files stored in the $Home/cnai/import diretory can be used to obtain desired information

i. import_only_bcch_freq.txt ..... this file contains the following data: bcchno, ncc, bcc

ii. import_only_neighb.txt ..... this file sets only neighbor relations

iii. import_all_freq&neighb.txt ..... combination of above.

V. UNIX commands – addendum

Some basic UNIX commands are listed:

1. to display the contents of the current directory: a. lsb. ls –lc. ll

2. to change directorya. cd directory_nameb. cd ..

3. to change directory to home directorya. cd $HOMEb. cd ~

4. to see in which directory you area. pwd

5. to create directory a. mkdir directory_name

6. to delete directorya. rmdir directory_name

7. to remove a file





a. rm filename8. to change file status to executable

a. chmod +x filename

V1. Attachments

- cnai2tcp- tcp2cnai- AuditBSClist.txt- AuditCelldata.txt- AuditBSCdata.txt- Audit_Neighdata.txt- Export_freq.txt- Export_freq_neighb.txt- Export_neigh.txt- Import_all_freq&neighb.txt- Import_bcch&hop_freq.txt- Import_only_bcch_freq.txt- Import_only_neighb.txt

V11. Reference

Alex Configuration Management Documents under Operation Support System (OSS) R9.1 library