Cisco BTS 10200 Softswitch

Field Notice: BTS 10200 Collecting Omni Debug Data During an SS7 Event

February 14, 2004

Products Affected

Product #


BTS10200 Softswitch R3.X -

Does not apply to R4.X

Problem Description

There have been a few field cases where root cause analysis of SS7 related problems has been difficult or impossible due to insufficient data from the incident. In the event of any significant customer problem with SS7 (offnet) calls, omni debug data should be captured as soon as the problem is noticed and before steps are taken to recover. This data takes only one or two minutes to collect and is critical to being able to find the root cause of certain kinds of SS7 related problems.


3.X releases of the BTS10200 incorporates a third party SS7 stack, sometimes called omni, from Ulticom INC. In addition to standard BTS trace logs, some classes of SS7 related problems require omni debug data in order to determine the root cause of the problem. This field notice will serve as an instructional guide to the BTS customers on the proper steps for collecting omni debug data.

Problem Symptoms

Degraded or interruption of SS7 functionality.


The following steps should be used to collect the data from both sides of the call agent in the event of any significant problem that is SS7 related;

  1. cd /opt/omni/bin

  2. omnimon -dir . (omnimon space minus dir space dot, where the dot at the end of the command says to write the file to the current directory)

  3. The command in step 2 will produce a directory named debug.MMDD, where MM=month and DD=day.

    Steps 1-3 should be executed immediately when a problem is noticed. The remaining steps can be completed after the problem has been resolved.

  4. Rename the directory so the filename indicates which side the data was taken from.

  5. Tar up the directory and save the tar file for analysis by Cisco.

For More Information

If you require further assistance, or if you have any further questions regarding this field notice, please contact the Cisco Systems Technical Assistance Center (TAC) by one of the following methods:

Receive Email Notification For New Field Notices

Product Alert Tool - Set up a profile to receive email updates about reliability, safety, network security, and end-of-sale issues for the Cisco products you specify.