Internal Information

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

Anwar
Approved
Sayeed Checked Date Rev Reference

Franz De Waal 05/05/03 PA2

Export/Import of pre-defined cell data using CNAI

Internal Use

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

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

1V. IMPORT CELL DATA FROM THE FILE TO CNAI............................................................................................................9

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

V1. ATTACHMENTS......................................................................................................................................................................12
 Internal Information
2 (12)
Prepared (also subject responsible if other) No. EUS-03:002096 Uen

Anwar
Approved
Sayeed Checked Date Rev Reference

Franz De Waal 05/05/03 PA2

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

MSC
CNA CNAi Import
Planned Area
Update Job

Valid Area Adjustment Job

CNAi Export
Network
Files stored
under OSS

OSS
Figure 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)
 Internal Information
3 (12)
Prepared (also subject responsible if other) No. EUS-03:002096 Uen

Anwar
Approved
Sayeed Checked Date Rev Reference

Franz De Waal 05/05/03 PA2

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

start

Setup Directory and transfer files in OSS using

File
Section II Manager Terminal FTP

EXPORT IMPORT

1. Edit AuditBSClist.txt 1. Populate import file

2. Edit cnai2tcp and save import_bcch&hop_freq.txt
3. Run cnai2tcp with real data and store it under
$HOME/cnai/import
2. Edit tcp2cnai and save
3. Open CNA and run Adjustment job
4. Run tcp2cnai
5. Under CNA open the Planned area
Section III created in step4
6. Run planning report
7. Run Update job on Planned area
Figure 2 created ini step 4

Section IV

II. Setup directories and files in OSS

1. Run Citrix application

2. 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
 Internal Information
4 (12)
Prepared (also subject responsible if other) No. EUS-03:002096 Uen

Anwar
Approved
Sayeed Checked Date Rev Reference

Franz De Waal 05/05/03 PA2

 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 files
a. cnai2tcp
b. 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
 Internal Information
5 (12)
Prepared (also subject responsible if other) No. EUS-03:002096 Uen

Anwar
Approved
Sayeed Checked Date Rev Reference

Franz De Waal 05/05/03 PA2

6. transfer files:
a. AuditCelldata.txt
b. AuditBSCdata.txt These files are used in Export example
c. AuditBSClist.txt
d. export_freq.txt
e. export_neigh.txt
f. export_freq_neigh.txt

to /cnai/data directory

7. transfer files:
a. import_bcch&hop_freq.txt  This file is used in Import example
b. import_only_bcch_freq.txt
c. import_only_neighb.txt
d. 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.
 Internal Information
6 (12)
Prepared (also subject responsible if other) No. EUS-03:002096 Uen

Anwar
Approved
Sayeed Checked Date Rev Reference

Franz De Waal 05/05/03 PA2

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.
 Internal Information
7 (12)
Prepared (also subject responsible if other) No. EUS-03:002096 Uen

Anwar
Approved
Sayeed Checked Date Rev Reference

Franz De Waal 05/05/03 PA2

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.

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

Anwar
Approved
Sayeed Checked Date Rev Reference

Franz De Waal 05/05/03 PA2

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=Audi
tBSCdata.txt,OUTPUT=BSCParameter

This completes the export process. Once the cell and BSC data is available it can be compared against
recommended settings
 Internal Information
9 (12)
Prepared (also subject responsible if other) No. EUS-03:002096 Uen

Anwar
Approved
Sayeed Checked Date Rev Reference

Franz De Waal 05/05/03 PA2

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 frequencies
b. export_neigh.txt ...... will export neighbor
c. 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_file
Populate 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 file

The 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
 Internal Information
10 (12)
Prepared (also subject responsible if other) No. EUS-03:002096 Uen

Anwar
Approved
Sayeed Checked Date Rev Reference

Franz De Waal 05/05/03 PA2

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

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

Anwar
Approved
Sayeed Checked Date Rev Reference

Franz De Waal 05/05/03 PA2

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.

UNIX commands – addendum

Some basic UNIX commands are listed:

1. to display the contents of the current directory:

a. ls
b. ls –l
c. ll
2. to change directory
a. cd directory_name
b. cd ..
3. to change directory to home directory
a. cd $HOME
b. cd ~
4. to see in which directory you are
a. pwd
5. to create directory
a. mkdir directory_name
6. to delete directory
a. rmdir directory_name
7. to remove a file
 Internal Information
12 (12)
Prepared (also subject responsible if other) No. EUS-03:002096 Uen

Anwar
Approved
Sayeed Checked Date Rev Reference

Franz De Waal 05/05/03 PA2

a. rm filename
8. 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