DO NOT SHARE THESE DOCS WITH CUSTOMERS!

This is an LA release that will only be provided to a select number of PLM-sanctioned customers (PDFs only). Contact PLM for details.


Packets that cause a direct SBC fault can lead to a catastrophic failure of an SBC service, which is known as a packet-stimulated fault avalanche. These packets appear for various reasons, such as: the SBC adds a new Session Initiation Protocol (SIP) endpoint, upgrades or replaces a peering endpoint or gateway (GW), changes a configuration on a peer, or introduces a new call scenario. The SBC does not currently check for double faults, which is when the SBC has a failover and then another failover. Double faults cause call loss.

The goal of Avalanche Fault Detection and Control is not to prevent individual crashes, but to detect and control continuous "avalanche" faults that can lead to complete service outages. This feature uses the information from the existing faults to attempt to prevent future faults.

  

The fault avalanche feature does not:

  • Prevent the first crash an offending packet causes
  • Prevent crashes by similar SIP messages (such as the same call flow) that have different key values
  • Prevent crashes that a packet does not directly (crash due to memory build up) cause
  • Avoid fault avalanche across separate SBC clusters.
  • Avoid crashes in non-SIP modules


The fault avalanche feature tracks potentially problematic values of key types in SIP packets. To track these values the fault avalanche feature extracts and saves values from the following fields of the SIP packet that causes a crash:

  • Call ID
  • Called Party Address
  • Calling Party Address (From or P-Asserted-Identity header)
  • Source IP of the Packet

Each key type associates with a threshold value. The threshold value indicates the maximum amount of crashes allowed for a particular value of the key type before the SBC blocks that key value. The SBC defines the threshold values so that they ensure the threshold for more specific blocks trigger before less specific blocks. The following table shows the default key type thresholds.

  


Default Key Thresholds

Key Type
Threshold
Call ID0
Calling + Called1
Calling Party3
Called Party3
Source IP5


The SBC determines the calling party for a SIP packet in the following order:

  1. If present, the P-Asserted-Identity header user part or telephone number.
  2. If present, the P-Preferred-Identity header user part or telephone number.
  3. If not anonymous, the From header user part or telephone number.

The SBC obtains the called party for a SIP packet from either a Request URI of a SIP request, or the To header URL of a SIP response.


Note

The SBC cannot monitor the fault count for user(s) if no usable calling party information is available; however, the SBC can control faults based on the source IP.

Ribbon recommends that you set the thresholds according to how strict (or lenient) you prefer to be with faults in a cluster. If you do not want the SBC to block a specific key element or source, instruct the SBC using CLI commands.


The Layer 3 source IP address of the packet determines the peer IP address.

Command Syntax

Use the following command to set and configure the faultAvalancheControl parameter.

% set system faultAvalancheControl callIdThreshold <0-999> calledPartyThreshold <0-999> callingNCalledPartyThreshold <0-999> callingPartyThreshold <0-999> sourceIpThreshold <0-999> faultRecAgeingTimeOut <15-60>

Use the following command to enable or disable the faultAvalancheControl parameter.

% set system faultAvalancheControl facState <disabled | enabled>

Use the following command to block or allow future SIP messages.

% set system faultAvalancheControl facBlockSuspects <disabled | enabled>

Command Parameters


faultAvalancheControl Parameter

ParameterLength/RangeDefaultDescriptionM/O
faultAvalancheControlN/AN/A

This parameter controls the fault avalanche issue.

O
callIdThreshold0-9990

<0-999> - The number of crashes the specific call-ID causes, after which the SBC drops the SIP messages that carry the same call-ID.

O
calledPartyThreshold0-9993

<0-999> - The number of crashes the specific called party causes, after which the SBC drops the SIP messages that carry the same called party address.

O
callingPartyThreshold0-9993

<0-999> - The number of crashes the specific calling party causes, after which the SBC drops the SIP messages that carry the same calling party address.

O
callingNCalledPartyThreshold0-9991<0-999> - The number of crashes the specific calling & called party causes, after which the SBC drops the SIP messages that carry the same calling and called party address.O
faultRecAgeingTimeOut15-6030<15-60> - Configure this parameter with the timeout (in minutes) of the fault record aging.O
sourceIpThreshold0-9995<0-999> - The number of crashes the SIP messages from a specific source IP address cause, after which the SBC drops the SIP messages from the same source IP address.O
facState N/Aenabled

Use this flag to enable or disable the Fault Avalanche Control feature. When you update this flag from enabled to disabled, the system deletes the existing fault records and blocking entries. This update does not impact the fault records that this system might have previously broadcast to other SBCs in the cluster.

  • enabled (default)
  • disabled - The SBC does not perform tracking or blocking.
O
facBlockSuspectsN/Adisabled

Determines if future SIP messages are blocked.

  • enabled
  • disabled (default)


Note

If you disable the facState flag, the system:

  • Must not perform any extra parsing of SIP Protocol Data Units (PDUs) to implement this functionality,
  • Must not create, distribute, or request fault records.
  • Must not check any received packets for blocking.
  • Must discard any received fault records.


Command Examples

The following command is an example of how to set and configure faultAvalancheControl.

Example
 % set system faultAvalancheControl callIdThreshold 2 calledPartyThreshold 5 callingNCalledPartyThreshold 2 callingPartyThreshold 5 sourceIpThreshold 5 faultRecAgeingTimeOut 35

The following command is an example of how to enable faultAvalancheControl.

Example
% set system faultAvalancheControl facState enabled

The following command is an example of how to view faultAvalancheControl.

> show status system faultAvalancheControl