Toolpack Debug Application:Tbsigtrace

Revision as of 07:27, 29 September 2011

Tbsigtrace is a debug tool that is use to collect protocol messages. It can trace SS7, ISDN, SIP, Sigtran and CAS messages and put it in a wireshark format.

Application Location

The binary is located in the [InstallDir]/[PackageVersion]/bin/release/[Platform]/

Example:

Version 2.5.55, TMG unit (PPC 32bits)

/lib/tb/toolpack/pkg/2.5.55/bin/release/ppc-linux/tbsigtrace

Version 2.5.55, CentOS 64 bits system

/lib/tb/toolpack/pkg/2.5.55/bin/release/x86_64-linux64/tbsigtrace

Version 2.5.55, Windows system

C:\TelcoBridges\toolpack\pkg\2.5.55\bin\release\i586-win32\tbsigtrace.exe

How to use it

Command line

Options available:

-d Daemon mode

-name XYZ Application name

-db Not used

-c XYZ Configuration file to load

-gw XYZ SystemId (i.e. 12358)

-adapter TBXYZ Adapter name to connect or "all" to connect to all adapter in the system

-ss7 Default ss7 trace activation

-isdn Default isdn trace activation

-old Isdn trace in cap file with lapd layer

-ip Default ip trace activation (sip, sigtran and iua)

-h248 Default h248 trace activation

-lapd Default lapd trace activation

-cap CAP format enabled

-format TXT format enabled

-single Create one file by signaling entity

-regroup Regroup identical signaling entity types in one file

Examples

Starting with releases 2.4.59, 2.5.116 and 2.6, "-adapter all -regroup -cal" options are included automatically when launching tbsigtrace.
To avoid regrouping entities, you need to use "-single".
To have the text format, you need to use "-format".

This will gather all ss7 links from one blade and put this in a single cap file

tbsigtrace -gw 12358 -adapter TB000544 -ss7

This will gather all isdn links from one blade and put them in several files

tbsigtrace -gw 12358 -adapter TB000544 -isdn
tbsigtrace -gw 12358 -adapter TB000544 -isdn -old       (for lapd layer analysis)

This will gather all sip traces and put them in a single cap file

tbsigtrace -gw 12358 -adapter TB000544 -ip

In release 2.4 This will gather all sip and sigtran traces and put them in a single cap file for all adapters in the system

tbsigtrace -gw 12358 -ip

This will gather all h248 messages on the system and put this in a single cap file

tbsigtrace -gw 12358 -h248

This will gather all IUA (ip and tdm sides) messages on the system and put this in a single cap file

tbsigtrace -gw 12358 -adapter TB000544 -ip -lapd

Configuration file (optional)

The configuration file will allow to get several blades in the same file

Example MTP2_LINK_0,MTP2_LINK_1 are on the same blade and MTP2_LINK_10,MTP2_LINK_11 are on an other blade

 <signaling>
 
 <sysmgr name = "MTP2_LINK_0" grpname="LS1" capfile="true" />
 <sysmgr name = "MTP2_LINK_1" grpname="LS1" capfile="true" />
 <sysmgr name = "MTP2_LINK_10" grpname="LS1" capfile="true" />
 <sysmgr name = "MTP2_LINK_11" grpname="LS1" capfile="true" />
 
 </signaling>

Web

You can start/stop tbsigtrace via web.

Create a new application configuration:

Name                   -> oamsigtrace
Application Type       -> User Specific
Bin Path               -> @{PKG_BIN}/tbsigtrace
Working Path           -> ../tbsigtrace
Command-line arguments -> -adapter all -ss7 -cap

Create a new application instance:

Name                   -> oamsigtrace
Host                   -> (put required host)
Application Config     -> oamsigtrace

You can control the application "oamsigtrace" with the application status page OR
you can use the option 'o' in tboamapp (page=Application launch manager) and change the state of oamsigtrace application
state (0=stop 1-mgmt 2-run).

WARNING: tbsigtrace application should not be used all the time, otherwise it will reduce performance and fill completely your hard drive.