Toolpack Debug Application:Tbsigtrace
m (remove unnecessary space) |
|||
| Line 1: | Line 1: | ||
| − | Tbsigtrace is a | + | 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 [http://www.wireshark.org wireshark] format.<br> |
| + | <br> | ||
| − | == | + | == Application Location<br> == |
| − | The binary is located in the [InstallDir]/[PackageVersion]/bin/release/[Platform]/ | + | The binary is located in the [InstallDir]/[PackageVersion]/bin/release/[Platform]/ |
| − | Example: | + | Example: |
| + | |||
| + | 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 | ||
| Line 30: | Line 36: | ||
:-isdn Default isdn trace activation | :-isdn Default isdn trace activation | ||
:-ip Default ip trace activation (sip and sigtran) | :-ip Default ip trace activation (sip and sigtran) | ||
| − | :-h248 Default h248 trace activation | + | :-h248 Default h248 trace activation |
:-cap CAP format enabled | :-cap CAP format enabled | ||
:-regroup Regroup entity of same type | :-regroup Regroup entity of same type | ||
| Line 60: | Line 66: | ||
tbsigtrace -gw 12358 -adapter TB000544 -h248 -cap | tbsigtrace -gw 12358 -adapter TB000544 -h248 -cap | ||
| − | === Configuration file (optional) === | + | === Configuration file (optional) === |
The configuration file will allow to get several blades in the same file | The configuration file will allow to get several blades in the same file | ||
| Line 75: | Line 81: | ||
</signaling> | </signaling> | ||
| − | === Web<br> === | + | === Web<br> === |
| − | You can start/stop tbsigtrace via web.<br> | + | You can start/stop tbsigtrace via web.<br> |
| − | Create a new application configuration: | + | Create a new application configuration: |
<pre>Name -> oamsigtrace | <pre>Name -> oamsigtrace | ||
Application Type -> User Specific | Application Type -> User Specific | ||
| Line 86: | Line 92: | ||
Command-line arguments -> -adapter all -ss7 -regroup -cap | Command-line arguments -> -adapter all -ss7 -regroup -cap | ||
| − | </pre> | + | </pre> |
| − | Create a new application instance:<br> | + | Create a new application instance:<br> |
<pre>Name -> oamsigtrace | <pre>Name -> oamsigtrace | ||
Host -> (put required host) | Host -> (put required host) | ||
Application Config -> oamsigtrace | Application Config -> oamsigtrace | ||
| − | </pre> | + | </pre> |
| − | You can control the application "oamsigtrace" with the application status page OR<br>you can use the option 'o' in tboamapp (page=Application launch manager) and change the state of oamsigtrace application<br>state (0=stop 1-mgmt 2-run).<br> | + | You can control the application "oamsigtrace" with the application status page OR<br>you can use the option 'o' in tboamapp (page=Application launch manager) and change the state of oamsigtrace application<br>state (0=stop 1-mgmt 2-run).<br> |
'''WARNING: tbsigtrace application should not be used all the time, otherwise it will reduce performance and fill completely your hard drive'''. | '''WARNING: tbsigtrace application should not be used all the time, otherwise it will reduce performance and fill completely your hard drive'''. | ||
Revision as of 13:37, 19 May 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
- -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.
