Toolpack Debug Application:Tbsigtrace

From TBwiki
(Difference between revisions)
Jump to: navigation, search
m (Modified so that default is package 2.5.55, added ppc)
m (remove unnecessary space)
Line 9: Line 9:
  
 
Version 2.5.55, TMG unit (PPC 32bits)
 
Version 2.5.55, TMG unit (PPC 32bits)
  /lib/tb/toolpack/pkg/2.5.55/bin/release/ppc-linux/tbsigtrace
+
/lib/tb/toolpack/pkg/2.5.55/bin/release/ppc-linux/tbsigtrace
 
Version 2.5.55, CentOS 64 bits system
 
Version 2.5.55, CentOS 64 bits system
  /lib/tb/toolpack/pkg/2.5.55/bin/release/x86_64-linux64/tbsigtrace
+
/lib/tb/toolpack/pkg/2.5.55/bin/release/x86_64-linux64/tbsigtrace
 
Version 2.5.55, Windows system
 
Version 2.5.55, Windows system
  C:\TelcoBridges\toolpack\pkg\2.5.55\bin\release\i586-win32\tbsigtrace.exe
+
C:\TelcoBridges\toolpack\pkg\2.5.55\bin\release\i586-win32\tbsigtrace.exe
  
 
== How to use it  ==
 
== How to use it  ==
Line 38: Line 38:
 
This will gather all ss7 links from one blade and put this in a single cap file  
 
This will gather all ss7 links from one blade and put this in a single cap file  
  
  tbsigtrace -gw 12358 -adapter TB000544 -ss7 -regroup -cap
+
tbsigtrace -gw 12358 -adapter TB000544 -ss7 -regroup -cap
  
 
This will gather all isdn links from one blade and put them in several files  
 
This will gather all isdn links from one blade and put them in several files  
  
  tbsigtrace -gw 12358 -adapter TB000544 -isdn -cap
+
tbsigtrace -gw 12358 -adapter TB000544 -isdn -cap
  
 
This will gather all sip traces and put them in a single cap file  
 
This will gather all sip traces and put them in a single cap file  
  
  tbsigtrace -gw 12358 -adapter TB000544 -sip -regroup -cap
+
tbsigtrace -gw 12358 -adapter TB000544 -sip -regroup -cap
  
 
<br> 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  
 
<br> 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 -regroup -cap
+
tbsigtrace -gw 12358 -adapter all -ip -regroup -cap
  
 
This command will regroup all signaling types by group in 3 files (1 file for ss7, 1 for isdn and a last for sip( or ip)).  
 
This command will regroup all signaling types by group in 3 files (1 file for ss7, 1 for isdn and a last for sip( or ip)).  
  
  tbsigtrace -gw 12358 -adapter TB000544 -regroup -cap
+
tbsigtrace -gw 12358 -adapter TB000544 -regroup -cap
  
 
This will gather all h248 messages on the system and put this in a single cap file  
 
This will gather all h248 messages on the system and put this in a single cap file  
  
  tbsigtrace -gw 12358 -adapter TB000544 -h248 -cap
+
tbsigtrace -gw 12358 -adapter TB000544 -h248 -cap
  
 
=== Configuration file (optional) ===
 
=== Configuration file (optional) ===

Revision as of 09:06, 29 April 2011

Tbsigtrace is a Toolpack debug tool that is use to collect protocol messages.


Contents

Where it is located

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 and sigtran)
-h248 Default h248 trace activation
-cap CAP format enabled
-regroup Regroup entity of same type

Examples

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

tbsigtrace -gw 12358 -adapter TB000544 -ss7 -regroup -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 -regroup -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 -regroup -cap

This command will regroup all signaling types by group in 3 files (1 file for ss7, 1 for isdn and a last for sip( or ip)).

tbsigtrace -gw 12358 -adapter TB000544 -regroup -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

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 -regroup -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.

Personal tools