Toolpack Debug Application:Tbsigtrace

Revision as of 12:29, 23 June 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

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

-h248 Default h248 trace activation

-lapd Default lapd trace activation

-cap CAP format enabled

Examples

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

tbsigtrace -gw 12358 -adapter TB000544 -ss7 -cap

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

tbsigtrace -gw 12358 -adapter TB000544 -isdn -cap

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

tbsigtrace -gw 12358 -adapter TB000544 -sip -cap

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 -adapter all -ip -cap

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

tbsigtrace -gw 12358 -adapter TB000544 -h248 -cap

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 -cap

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.