beroNet Gateways have a very powerful mechanism to analyze ISDN, SIP or other configuration problems with the Fulltrace. The Fulltrace is intended to be used for troubleshooting of a beroNet gateway. It is basically an archive file, containing basic configuration data of the device, information of the state of the device and SIP/PSTN traffic captured while the trace was running.

The Fulltrace has basically two modes, Basic and Advanced. Basic mode has no options, and is usually enough to analyze SIP traffic, PSTN event and call flow. RTP voice traffic is not captured in this mode. To capture the RTP traffic, the trace needs to be started in Advanced Mode. Since RTP traffic produces large amounts of data and because of the device’s limited storage capacity, this reduces the amount of other trace data which can be stored.

For fine tuning the trace according to problem to be analyzed, the Advanced Mode allows setting of additional options too.

The Advanced Fulltrace options are described here: Advanced Full Trace Options

NOTE: The Fulltrace is the most helpful tool for beroNet to support you in analyzing a problematic situation.

Creating a Fulltrace

The Fulltrace can be started via the GUI under "Management->Fulltrace".

Open

A Trace can be started by clicking the Start button.

Open

While the trace is running, you can stop it by pressing the Stop & Download button.

Open

Stopping the trace takes a moment, since the debug data is compressed into a tar.gz archive, which will be offered as download as soon it is finished.

Open

A usual scenario is to upload such a DebugFiles.tar.gz trace in our support portal. In the support portal traces and other files can be uploaded via following button:

Open

As options you can choose which ISDN Ports should be traced, if the SIP Signalling and the SIP Audio should be traced. SIP Audio will consume a lot of memory, so it should be used only in very short time scales. A beroNet Gateway can only store about 2MB of trace data (per ISDN Port and SIP), after that it will stop tracing. Now the trace can be started via the "Start" button. Now the situation can be reproduced and after that the stop button should be pressed. Now you can download the Fulltrace via the "Download" Button.

Fulltrace Content

The Fulltrace default name is DebugFiles.tar.gz and consist of a gzipped tarball. The content of the Fulltrace consists of:

^{/usr - Directory containing beroNet Gateway internal configuration files isgw.* - beroNet Gateway Debugging files tcpDump - Wireshark readable SIP Trace tcpDump.lo - Wireshark readable SIP Trace (for ISDN-ISDN calls) ISDNdebug-* - Wireshark readable ISDN Trace (for each Port one trace)}

The Files that are Wireshark readable are the most helpful ones, because they contain the raw SIP and ISDN Protocol Data. To view those files you need the wireshark tool, that is normally shipped by a Linux Distribution, but can also be downloaded for linux and Windows at:

http://www.wireshark.org/