sipXcom 14.10 and later

sipx-trace is back with the inclusion of the sipxtools package.

sipXcom 4.6.0 and 14.04

sipXecs has Homer integrated.  Homer captures all SIP traffic all the time.

With the inclusion of Homer, sipx-trace has been depreciated.

To access Homer, login to sipXecs as an administrator, click on Diagnostics an select SIP Capture.  On the SIP Capture page, the web interface is accessible from a hyperlink in the upper right of the page.  Login to Homer with an administrator privileged account by default.

sipXcom Version 4.4.0 & earlier

"sipx-network-trace" is a easy to use, command line based diagnosis tool. It captures network traffic into trace files and those trace files can be reviewed later with any pcap parsing tool, such as wireshark.

       sipx-network-trace [xecsuserV4r2:-i <interface>] [xecsuserV4r2:-f <output file>] [xecsuserV4r2:-s <file size x 1,000,000 bytes>] [xecsuserV4r2:-r <number of files>] [xecsuserV4r2:-t <seconds to run>] start|stop|status 

Maximum size of each output file with a unit of 1,000,000 bytes. For example, "-s 2" means the each output file size is up to 2M bytes (Notes that it's 2000,000, not 2 * 1024 * 1024 bytes).

The output could be split into multiple files. By default it's 1.For example, "-r 3" instructs the tool to create 3 files with each file's name defined as" <output file> + <index number which starts from 0>". If the <output file> parameter is "mypcap", then mypcap0, mypcap1 and mypcap2" are created.This parameter is used  in  conjunction with the -s option, this will limit the number of files created to the specified number, and begin over-writing files from the beginning, thus creating a "rotating" buffer.  In addition, it will name the files with enough  leading 0s to support the maximum number of files, allowing them to sort correctly 

Define the period for the tool to run. 

Start the tool , stop the tool  or report the tool running status respectively.