Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Panel

In this section:

Table of Contents
maxLevel3

 

The SBC performs Packet Capture using 'tcpdump' and allows the captured file to be downloaded. The following section describes how to capture packets and download them.

Note
titleCaution

Performing a Media packet capture with no host filters or against hosts terminating multiple calls can impact traffic and cause current or future calls to fail or experience other problems.

Performing a long duration capture which is outside of a maintenance window can adversely impact traffic, and should be avoided when possible.

Note

For

Spacevars
0series

It is mandatory to You must insert either an ASM or external USB into the

Spacevars
0series
in order to save packet capture files. Without this, packet capture is not allowed due to available space limitations.

Info

For

Spacevars
0series2

It is recommended to Sonus recommends that you insert either an AMS ASM or external USB into the

Spacevars
0series2
in order to save packet capture files; otherwise only a small capture session is permitted due to available space limitations on the internal flash.

pagebreak

Enabling Packet Capture

Warning

The Packet Capture feature is intended for short duration packet captures. For that reason, a maximum duration of 120 minutes (2 hours) is permitted.

The Enable Packet Capture option (available from the Packet Capture menu bar) enables the packet capture ability in the

Spacevars
0product2
.

To enable packet capture:

  1. In the WebUI, click the Diagnostics tab.

  2. In the left navigation bar, select Sonus TAC Troubleshooting > Packet Capture.

  3. From the menu bar, click Enable Packet Capture.

    Panel
    borderStylenone
    Caption
    0Figure
    1Enable Packet Capture

  4. At the Warning note, click OK. 

    Warning
    Enable Packet Capture only under the direction of Sonus TAC.
    Panel
    borderStylenone
    Caption
    0Figure
    1Enable Packet Capture - Warning Message

Packet Capture is enabled. Refer to Start Packet Capture.

Pagebreak

Starting Packet Capture

Note

Packet Capture must be enabled before capturing packets. Refer to Enable Packet Capture.

Info

To view Alarm/Event history logs for Packet Capture, access the Diagnostics tab and click Logs > Alarm/Event History.

Tip

To capture T.38 Fax, Sonus recommends enabling RTP Media and adding the Host 1 and Host 2 IP addresses of the next hop neighbor in Media SDP.

The Start Capture option (available from the Packet Capture menu bar) enables the

Spacevars
0product2
 to capture packets.

To start capturing packets:

  1. In the WebUI, click the Diagnostics tab.

  2. In the left navigation bar, select Sonus TAC Troubleshooting > Packet Capture.

  3. From the menu bar, click Start Capture.

    Panel
    borderStylenone
    Caption
    0Figure
    1Start Capture

     

     

    Panel
    borderStylenone
    Caption
    0Figure
    1Packet Capture Options

  4. Select the network interface (including IP Version) from which the packets will be captured.

  5. Select an protocol(s) from which to capture the packets.

  6. Configure any relevant information for the Other Options sections. For details, refer to Field Definitions.

  7. Click OK.

    The Packet Capture status turns to In Progress.

    Panel
    borderStylenone
    Caption
    0Figure
    1Packet Capture in Progress

     

     

Anchor
FieldDefinitions
FieldDefinitions
Interface - Field Definitions

Div
stylepadding-left:3%;

Interface

Panel
bgColor#FAFAFA
borderStylenone

Specifies the network interface from which the packets will be captured.

IP Version

Panel
bgColor#FAFAFA
borderStylenone

Specifies the IP version of the interface from which the packets will be captured. Valid selections: IPv4, IPv6 or Both.

Protocol - Field Definitions

Div
stylepadding-left:3%;

Media (RTP/RTCP)

Panel
bgColor#FAFAFA
borderStylenone

This field applies to SBC 1000/2000 only.

Specifies whether or not to capture RTP/RTCP Packets.

  • Default: False

DSP/CSME

Panel
bgColor#FAFAFA
borderStylenone

This field applies to SBC 1000/2000 only.

Specifies whether or not to capture DSC/CSME Packets.

  • Default: False

Active Directory

Panel
bgColor#FAFAFA
borderStylenone

Specifies whether or not to capture LDAP Packets.

  • Default: False

HTTP/HTTPS

Panel
bgColor#FAFAFA
borderStylenone

Specifies whether or not to capture HTTP/HTTPS Packets.

  • Default: False

All Other Protocols

Panel
bgColor#FAFAFA
borderStylenone

Specifies whether or not to capture all other packet types not defined above.

  • Default: False

 

Other Options - Field Definitions

Div
stylepadding-left:3%;

TCP/UDP Ports

Panel
bgColor#FAFAFA
borderStylenone

Specifies the port or ports used to capture packets. A maximum of four comma separated port numbers may be specified.

  • Range: 1 - 65535

Host #1

Panel
bgColor#FAFAFA
borderStylenone

Specifies a unique host from which to capture packets. Host is specified by IPv4 Address or FQDN.

  • Range: 1 - 256 ASCII characters

Host #1 Direction

Info

The following field is only visible if an address has been entered in Host #1.

Panel
bgColor#FAFAFA
borderStylenone

Specifies the whether the captured packets are being sent to the host or received from the host, or both.

  • Default: Transmit and Receive

Host #2

Panel
bgColor#FAFAFA
borderStylenone

Specifies a unique host from which to capture packets. Host is specified by IPv4 Address or FQDN.

  • Range: 1 - 256 ASCII characters

Host #2 Direction

Info

The following field is only visible if an address has been entered in Host #2.

Panel
bgColor#FAFAFA
borderStylenone

Specifies the whether the captured packets are being sent to the host or received from the host, or both.

  • Default: Transmit and Receive

Maximum Packet Size

Panel
bgColor#FAFAFA
borderStylenone

Specifies the maximum size of the individual packets to be captured.

  • Range: 100 - 1600 Bytes
  • Default: 1600

Overwrite

Panel
bgColor#FAFAFA
borderStylenone

Specifies whether or not the SBC overwrites capture files in round robin fashion or not when the maximum file size has been reached.

  • Default: False

Duration

Panel
bgColor#FAFAFA
borderStylenone
Warning

A maximum duration of 120 minutes (2 hours) is permitted for packet capture.

Specifies the duration of the capture in minutes. The maximum value represents 2 hours.

  • Range: 1 - 120
  • Default: 10

 

Stopping Packet Capture

The Stop Packet capture feature is optional; this option is used to stop the packet capture early (before the packet capture reaches the time limit set in the Duration field).

To stop capturing packets:

  1. In the WebUI, click the Diagnostics tab.

  2. In the left navigation bar, select Sonus TAC Troubleshooting > Packet Capture.

  3. From the menu bar, click Stop Capture.

    Panel
    borderStylenone
    Caption
    0Figure
    1Stop Capture Option


    The Packet Capture stops.

    Panel
    borderStylenone
    Caption
    0Figure
    1Packet Capture Stops

 

Downloading Capture Files

Once the packet capture has stopped, the captured file will appear in the table List of Captured Files.

Info
titleTo Stop Packet Capture Early

If you need to stop the packet capture early, from the menu bar, click Stop Capture.

To download captured files:

  1. From the List of Capture Files table, next to the desired file, click Download.

    Panel
    borderStylenone
    Caption
    0Figure
    1Capture Files



  2. Select the appropriate location to save the file. Click OK.

    Panel
    borderStylenone
    Caption
    0Figure
    1Save File

     

     

Info
titleNote

Only one packet capture can be downloaded at a time. Depending on the size of the file and network connection, a download can take several minutes.

Moving Internal or ASM Capture Files

If the file location for the packet capture is Internal or an ASM, and the system has an external USB present and available, an additional option, Move, will appear under the Action column. The Move action relocates the packet file to the external USB, which can then be removed and taken to a PC. 

Info

The packet capture can only be saved on the internal flash for SBC 2000.

To move captured files:

  1. From the List of Capture Files table, next to the desired file, click Move.

    Panel
    borderStylenone
    Caption
    0Figure
    1List of Capture Files

     

     

Packet Capture Limitations

The following lists the limitations of Packet Capture.

Size Limitations
  1. An individual Packet Capture file is limited to 350 MiB in size. After the 350 MiB limit has been reached, a new file will be created to continue the packet capture.

  2. A Packet Capture session size limit is dependent on whether or not
    1. 30 GiB is less than the available storage space minus ( - ) 30%
      Or
    2. Available storage space minus ( - ) 30% is less than 30 GiB

  3. For SBC 1000, if there is no external USB or ASM module with a mounted hard drive, the Packet Capture will not be allowed to occur because of storage limitations.
Protocol Filters Restrictions

If Protocol Filters Active Directory, HTTP/HTTPS, or All Other Protocols are set to True, the following options will be hidden and no longer configurable:

  1. Media

  2. DSP/CSME
     

  3. TCP/UDP Ports
TCP/UPD Ports Restrictions

If any TCP/UDP Ports are entered, the following options will be hidden and no longer configurable:

  1. Active Directory

  2. HTTP/HTTPS

  3. All Other Protocols

Pagebreak