Guest

Cisco BTS 10200 Softswitch

CLI Native Data Export

Table Of Contents

Cisco BTS 10200 Softswitch CLI Native Data Export Feature Module

Understanding the CLI Native Data Export Feature

Limitations


Cisco BTS 10200 Softswitch CLI Native Data Export Feature Module


Revised: March 31, 2008

This document describes the Command Line Interface (CLI) Native Data Export feature for Release 6.0 of the Cisco BTS 10200 Softswitch and explains how to use it. The CLI Native Data Export feature allows the user to prepare for system upgrades and system troubleshooting by exporting the native data.

Understanding the CLI Native Data Export Feature

The CLI Native Data Export feature enables the export of all provisioning data from the BTS 10200 system by the use of a CLI command. Execution of the CLI command stores the exported data in a user-named output file in text format in the export directory. The exported file contains all provisioning data from the BTS 10200. The provisioning data is written into the export file using add and change commands for all supported nouns.

The key attributes of the CLI Native Data Export feature are

The user can run the CLI command to export the BTS 10200 provisioning data.

The provisioning data for all the nouns, which enables the use of verbs as "add" and "change" is exported in text format.

The list of all the nouns related to provisioning is kept in an input file (xml format). Upon execution of the export command, the xml input file reads the nouns and their corresponding verbs (operation type, whether add or change), and exports the provisioning data from the BTS 10200.

The CLI export command is:

CLI > export database outfile = <whatever>

Where the noun is database and the verb is export. Execution of the command exports all of the provisioning data from the BTS 10200. All of the exported data is written in the output file as specified by the user. The output file contains all the add and change commands for the existing native data in the BTS 10200. The exported output file is stored in the /opt/ems/export directory.

The result of the export command is a text file that contains add/change CLI commands. The following is an example output text file:

# BTS Config Export 
# EMS Server: priems26-ora 
# User: optiuser 
# Export Start Time : Tue Jan 22 17:23:54 CST 2008 

######################### 
##### Add clli_code ##### 
######################### 
add clli_code ID=ABCD1234567; 


########################## 
##### Add call_agent ##### 
########################## 
add call_agent id=CA146;tsap_addr=CA146.A.12345678901234567890123456789012345678 
901234567890123456;mgw_monitoring_enabled=N;clli=ABCD1234567; 

############################## 
##### Add feature_server ##### 
############################## 
add feature_server ID=FSAIN205;TSAP_ADDR=FSAIN.A.1234567890123456789012345678901 
2345678901234567890123456;TYPE=AIN;DESCRIPTION=123456789012345678901234567890123 
456789012345678901234567890ABCD;EXTERNAL_FEATURE_SERVER=N; 
add feature_server ID=FSPTC235;TSAP_ADDR=FSPTC.A.1234567890123456789012345678901 
2345678901234567890123456;TYPE=POTS;DESCRIPTION=12345678901234567890123456789012 
3456789012345678901234567890ABCD;EXTERNAL_FEATURE_SERVER=N; 

#################################### 
##### Change billing_acct_addr ##### 
#################################### 

################################ 
##### Change billing_alarm ##### 
################################ 

#################################### 
##### Change report_properties ##### 
#################################### 
change report_properties TYPE=EVENT_LOGSIZE;VALUE=30000; 
change report_properties TYPE=ALARM_LOGSIZE;VALUE=30000; 
change report_properties TYPE=EVENT_LEVEL;VALUE=INFO; 

############################# 
##### Change sup_config ##### 
############################# 
change sup_config TYPE=refresh_rate;VALUE=86400; 
change sup_config TYPE=priority;VALUE=5; 
change sup_config TYPE=subterm_mgw_block;VALUE=5; 
change sup_config TYPE=subterm_block_pause;VALUE=9000; 
change sup_config TYPE=subterm_status_pause;VALUE=0; 
change sup_config TYPE=trunkterm_tg_block;VALUE=5; 
change sup_config TYPE=trunkterm_block_pause;VALUE=9000; 
change sup_config TYPE=trunkterm_status_pause;VALUE=0; 
change sup_config TYPE=trunkterm_range_block;VALUE=1000; 
change sup_config TYPE=trunkterm_range_pause;VALUE=20000; 

############################################# 
##### Change command_throttle_threshold ##### 
############################################# 
change command_throttle_threshold SESSION_TYPE=CLI;THRESHOLD=100;ENABLE=Y; 
change command_throttle_threshold SESSION_TYPE=CORBA;THRESHOLD=100;ENABLE=Y; 
change command_throttle_threshold SESSION_TYPE=FTP;THRESHOLD=1000;ENABLE=Y; 
change command_throttle_threshold SESSION_TYPE=MNT;THRESHOLD=100;ENABLE=Y; 
change command_throttle_threshold SESSION_TYPE=SNMP;THRESHOLD=100;ENABLE=Y; 
change command_throttle_threshold SESSION_TYPE=SOAP;THRESHOLD=100;ENABLE=Y; 

################################## 
##### Change config_interval ##### 
################################## 
change config_interval CONFIG_TYPE=THROTTLE;INTERVAL=15; 

# Export End Time : Tue Jan 22 17:24:14 CST 2008 

Limitations

Currently the export command is supported only from the CLI interface. The export command is currently not supported from other interfaces such as CORBA and SOAP.

There is a limitation on the size of the /opt/ems/export directory. Currently the size of the export directory is defined in /opt/ems/etc/bts.properties as 7500000 ~ 700 MB. During the first run of the export command, if the size of the export file is beyond the threshold limit, a warning message is shown to the user after export is finished. The warning message indicates that the export file size has exceeded the threshold and that the user needs to clean up the export directory before running the command again. During additional runs of the export command, if the export directory size is more then the threshold size, a warning is shown to the user that the space of export directory is insufficient for the export and that the user has to clear the export directory before rerunning the export command.