79.31. How to trace the internal events for debugging purposes

79.31. How to trace the internal events for debugging purposes
	Chapter 79. HowTo - Management

Enter into the Abilis control-program with a Terminal Emulator with file transfer support (e.g. Windows HyperTerminal, Zoc, etc), and type the following commands.

d pstack	Identify the internal port number associated to the resource for which you want to activate the trace. (e.g. suppose the Eth-1 resource).
trace act po:24 data:1600	Activate the trace function.
trace start	Start saving the events.
trace stop	Stop tracing the events.
trace get z	Download the trace from Abilis.

Warning

	Warning
Verify parameters settings of the internal events trace using the command trace param. If a trace is running the following message is shown: [14:04:34] ABILIS_CPX:`trace act po:19,18 data:1600` TRACE RUNNING The trace continues to be active on ports shown by trace param command and not on those specified by trace act command. [14:04:50] ABILIS_CPX:`trace param` Configured Value Active Value Description ------------------------------------------------------------------------------ PO: 024,019 024,019 Ports to be traced SIZE: 8192 (Kbytes) 8192 (Kbytes) Tracer buffer size DATA: 1600 (bytes) 1600 (bytes) Max. event buffer size CMD: STD STD Command(s) to be traced LSN: ALL ALL SD/RV lsn to be traced TYPE: ALL ALL SD/RV type to be traced STATE: - RUNNING Current Tracer state TSAVE: NO NO Automatic trace saving EVENTS: - 49929 Number of events SNDRCV: - 24943 Number of send & receive LENGTH: - 8191 (Kbytes) Current trace length Stop the trace and set it inactive: [14:13:42] ABILIS_CPX:`trace stop` COMMAND EXECUTED [14:15:14] LUIGI_DEMURO:`trace inact` COMMAND EXECUTED Configure the trace and follow the steps of the how to: [14:17:40] ABILIS_CPX:`trace act po:24,18 data:1600` COMMAND EXECUTED [14:17:48] ABILIS_CPX:`trace param` Configured Value Active Value Description ------------------------------------------------------------------------------ PO: 024,019 024,018 Ports to be traced SIZE: 8192 (Kbytes) 8192 (Kbytes) Tracer buffer size DATA: 1600 (bytes) 1600 (bytes) Max. event buffer size CMD: STD STD Command(s) to be traced LSN: ALL ALL SD/RV lsn to be traced TYPE: ALL ALL SD/RV type to be traced STATE: - ACTIVE/READY Current Tracer state TSAVE: NO NO Automatic trace saving EVENTS: - 0 Number of events SNDRCV: - 0 Number of send & receive LENGTH: - 0 (Kbytes) Current trace length

Verify parameters settings of the internal events trace using the command trace param. If a trace is running the following message is shown:

[14:04:34] ABILIS_CPX:trace act po:19,18 data:1600

TRACE RUNNING

The trace continues to be active on ports shown by trace param command and not on those specified by trace act command.

[14:04:50] ABILIS_CPX:trace param

        Configured Value       Active Value           Description
------------------------------------------------------------------------------
PO:     024,019                024,019                Ports to be traced
SIZE:   8192 (Kbytes)          8192 (Kbytes)          Tracer buffer size
DATA:   1600 (bytes)           1600 (bytes)           Max. event buffer size
CMD:    STD                    STD                    Command(s) to be traced
LSN:    ALL                    ALL                    SD/RV lsn to be traced
TYPE:   ALL                    ALL                    SD/RV type to be traced
STATE:  -                      RUNNING                Current Tracer state
TSAVE:  NO                     NO                     Automatic trace saving
EVENTS: -                      49929                  Number of events
SNDRCV: -                      24943                  Number of send & receive
LENGTH: -                      8191 (Kbytes)          Current trace length

Stop the trace and set it inactive:

[14:13:42] ABILIS_CPX:trace stop

COMMAND EXECUTED 

[14:15:14] LUIGI_DEMURO:trace inact

COMMAND EXECUTED

Configure the trace and follow the steps of the how to:

[14:17:40] ABILIS_CPX:trace act po:24,18 data:1600

COMMAND EXECUTED 

[14:17:48] ABILIS_CPX:trace param                 

        Configured Value       Active Value           Description
------------------------------------------------------------------------------
PO:     024,019                024,018                Ports to be traced
SIZE:   8192 (Kbytes)          8192 (Kbytes)          Tracer buffer size
DATA:   1600 (bytes)           1600 (bytes)           Max. event buffer size
CMD:    STD                    STD                    Command(s) to be traced
LSN:    ALL                    ALL                    SD/RV lsn to be traced
TYPE:   ALL                    ALL                    SD/RV type to be traced
STATE:  -                      ACTIVE/READY           Current Tracer state
TSAVE:  NO                     NO                     Automatic trace saving
EVENTS: -                      0                      Number of events
SNDRCV: -                      0                      Number of send & receive
LENGTH: -                      0 (Kbytes)             Current trace length

For example, if you use Zoc program:

Abilis CPX traces are saved in a proprietary format “cpx”. Follow these instructions to convert them in other formats (PCAP, I4B, etc).

79.31.1. How to trace only the SIP signaling traffic

Enter into the Abilis control-program with a Terminal Emulator with file transfer support (e.g. Windows HyperTerminal, Zoc, etc), and type the following commands.

d pstack res:udp	Identify the internal port number associated to the resource UDP for which you want to activate the trace.
d d udp locport:5060	Identify the Lsn to be traced.
trace act po:11 lsn:0013 data:1600	Activate the trace function.
trace start	Start saving the events.
trace stop	Stop tracing the events.
trace get z	Download the trace from Abilis.

Example:

[10:44:37] ABILIS_CPX:d pstack res:udp

+------------+---------------+------------------------------------------------+
|  Resource  |    Act/Run    | Port(s)                                        |
+------------+---------------+------------------------------------------------+
| Udp        | Act/Run       | 11(Udp)                                        |
+------------+---------------+------------------------------------------------+

[10:48:11] ABILIS_CPX:d d udp locport:5060

RES:Udp -----------------------------------------------------------------------
       User_Datagram_Protocol                                                  
       ------------------------------------------------------------------------
       ID    Lsn           LocPort     Resource
       ------------------------------------------------------------------------
       18    0013 (   19)  5060        CtiSip

Warning

	Warning
Verify parameters settings of the internal events trace using the command trace param. If a trace is running the following message is shown: [14:04:34] ABILIS_CPX:`trace act po:11 lsn:0013 data:1600` TRACE RUNNING The trace continues to be active on ports shown by trace param command and not on those specified by trace act command. [14:04:50] ABILIS_CPX:`trace param` Configured Value Active Value Description ------------------------------------------------------------------------------ PO: 024,019 024,019 Ports to be traced SIZE: 8192 (Kbytes) 8192 (Kbytes) Tracer buffer size DATA: 1600 (bytes) 1600 (bytes) Max. event buffer size CMD: STD STD Command(s) to be traced LSN: ALL ALL SD/RV lsn to be traced TYPE: ALL ALL SD/RV type to be traced STATE: - RUNNING Current Tracer state TSAVE: NO NO Automatic trace saving EVENTS: - 49929 Number of events SNDRCV: - 24943 Number of send & receive LENGTH: - 8191 (Kbytes) Current trace length Stop the trace and set it inactive: [14:13:42] ABILIS_CPX:`trace stop` COMMAND EXECUTED [14:15:14] LUIGI_DEMURO:`trace inact` COMMAND EXECUTED

Verify parameters settings of the internal events trace using the command trace param. If a trace is running the following message is shown:

[14:04:34] ABILIS_CPX:trace act po:11 lsn:0013 data:1600

TRACE RUNNING

The trace continues to be active on ports shown by trace param command and not on those specified by trace act command.

[14:04:50] ABILIS_CPX:trace param

        Configured Value       Active Value           Description
------------------------------------------------------------------------------
PO:     024,019                024,019                Ports to be traced
SIZE:   8192 (Kbytes)          8192 (Kbytes)          Tracer buffer size
DATA:   1600 (bytes)           1600 (bytes)           Max. event buffer size
CMD:    STD                    STD                    Command(s) to be traced
LSN:    ALL                    ALL                    SD/RV lsn to be traced
TYPE:   ALL                    ALL                    SD/RV type to be traced
STATE:  -                      RUNNING                Current Tracer state
TSAVE:  NO                     NO                     Automatic trace saving
EVENTS: -                      49929                  Number of events
SNDRCV: -                      24943                  Number of send & receive
LENGTH: -                      8191 (Kbytes)          Current trace length

Stop the trace and set it inactive:

[14:13:42] ABILIS_CPX:trace stop

COMMAND EXECUTED 

[14:15:14] LUIGI_DEMURO:trace inact

COMMAND EXECUTED

Configure the trace and follow the steps of the how to:

[14:17:40] ABILIS_CPX:trace act po:11 lsn:0013 data:1600

COMMAND EXECUTED 

[10:59:48] ABILIS_CPX:trace start

COMMAND EXECUTED
WARNING: THE AUTOMATIC TRACE SAVING IS ACTIVE

[10:59:52] ABILIS_CPX:trace param

        Configured Value       Active Value           Description
-------------------------------------------------------------------------------
PO:     011                    011                    Ports to be traced
SIZE:   8192 (Kibyte)          3651 (Kibyte)          Tracer buffer size
DATA:   200  (bytes)           1600 (bytes)           Max. event buffer size
CMD:    STD                    STD                    Command(s) to be traced
LSN:    0018                   0013                   SD/RV lsn to be traced
TYPE:   ALL                    ALL                    SD/RV type to be traced
STATE:  -                      RUNNING                Current Tracer state
tact:   YES                    YES                    Trace activation at boot
TSAVE:  YES                    YES                    Automatic trace saving
EVENTS: -                      43                     Number of events
SNDRCV: -                      21                     Number of send & receive
LENGTH: -                      17 (Kibyte)            Current trace length

[11:01:03] ABILIS_CPX:trace stop

COMMAND EXECUTED

Download the trace from Abilis. For example, if you use Zoc program:

Abilis CPX traces are saved in a proprietary format “cpx”. Follow these instructions to convert them in other formats (PCAP, I4B, etc).

79.31.2. How to convert Abilis CPX traces

Go to http://support.abilis.net/downloads/cpx2k/download.html and click the System and tools link of the firmware Release that you want to use; in the following page, download download a “Trace Converter” program (trcmgrw.exe).

For example, the “GUI CPX trace converter” (trcmgrw.exe) converts Abilis CPX traces into:

“TAB separated”: is a general purpose format usable to import data into Libreoffice or Openoffice or Excel spreadsheets.
PCAP: is used by Wireshark/Tcpdump for Ethernet/PPP/RawIP representation.
I4B: it's a format for ISDN layer 1 representation and it can be loaded by Wireshark.
VN: Visual Network format; it's used for PPP traces with DTE/DCE direction indication and can be loaded by Wireshark.

For example, if you want to convert the trace in PCAP format, follow these instructions.

Double click the trcmgrw.exe file: the following window will appear.
In the To PCAP tab, select the in the Source file name field the trace that must be converted and in the Target file name field the name of the new trace.

Click the OK button: in the next window selects the port traced and the format.

	Tip
	If the traced port is associated with the resource UDP (e.g. Section 79.31.1, “How to trace only the SIP signaling traffic”), then is needed to select the format "Internal-UDP".

Click the OK button: the result of the conversion is shown.
Click the OK button to close the window and then the Exit button to close the program.

For example, if you want to convert the trace in I4B format, follow these instructions.

Double click the trcmgrw.exe file: the following window will appear.
In the To I4B tab, select the in the Source file name field the trace that must be converted and in the Target file name field the name of the new trace.
Select the port and the format, and click the OK button.
Tip
The selected port 10031 it's for CTIP:31. (Selected port =100+CTIP Number)
Click the OK button: the result of the conversion is shown.
Click the OK button to close the window and then the Exit button to close the program.

	Tip
	The selected port 10031 it's for CTIP:31. (Selected port =100+CTIP Number)


79.30. How to configure Abilis as a SYSLOG client		79.32. How to prevent brute force attacks