Toolpack Debug Application:Tbsigtrace
(→Command line) |
(→Command line) |
||
| Line 40: | Line 40: | ||
:-lapd Default lapd trace activation | :-lapd Default lapd trace activation | ||
:-cap CAP format enabled | :-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 ==== | ==== Examples ==== | ||
Revision as of 07:19, 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.
Contents |
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
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 tbsigtrace -gw 12358 -adapter TB000544 -isdn -cap -old (for lapd layer analysis)
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.
