Versions Compared

Key

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

Add_workflow_for_techpubs
AUTH1UserResourceIdentifier{userKey=8a00a0c880e94aad0181077fa25300098a00a02355cd1c2f0155cd26cb8305e9, userName='null'}
JIRAIDAUTHSBX-128445134075
REV5UserResourceIdentifier{userKey=8a00a02355cd1c2f0155cd26cd5909df8a00a02355cd1c2f0155cd26cb8305e9, userName='null'}
REV6UserResourceIdentifier{userKey=8a00a0c87e188912017e4c24a00e00168a00a02355cd1c2f0155cd26cb8305e9, userName='null'}
REV3UserResourceIdentifier{userKey=8a00a02355cd1c2f0155cd26c90501da8a00a0c86cea5831016cf55639770002, userName='null'}
REV1UserResourceIdentifier{userKey=8a00a02355cd1c2f0155cd26c90501da8a00a0c87aff3cc3017b370aaf890055, userName='null'}

Panel

In this section:

Table of Contents

Available_since
Release12.1.3

Overview

In cloud environmentsBased on call traffic volume, SBC instances are added and removed based on call traffic volumein cloud environments. There are situations when the call volume is low, and instances are removed for optimum to maximize the utilization of resources. SBC instances with minimal impact on the existing calls and registrations are removed by allocating time for those sessions to terminate on their ownindependently. The following object and parameters are added under under the Global  object object to support this feature:

  • System
    • Mode - This parameter specifies the desired new global system state and acts according to the settings of the adjoining parameters. The following options are available:
      • In Service  - When selecting this option is selected, the SBC usually functions normally. The other two parameters (Action and Dry Up Timeout) are ignored. The SBC accepts new calls and refreshes the existing calls per existing SBC functionality.
      • Out of Service - When Service—When this option is selected, the SBC rejects any new calls, registrations, or subscriptions. Existing calls are dealt with in accordance with the The remaining parameters deal with existing calls.
    • Action - This parameter specifies the SBC actions to handle the existing calls when the Mode is set to Out of Service. The following options are available:
      • Dry up - When this option is selected, the SBC enters an Out Of Service Pending state state and rejects all new calls. For existing calls, a A timer is started for existing calls, at the end of which , any remaining calls are force terminated. The duration of that timer is determined by the  Dry Up Timeout parameter , below determines the duration of that timer.  During the dry-up period, messages involved in the maintenance of existing call legs, such as re-INVITEs or UPDATEs, are allowed. Out-of-session messages are rejected. Specific scenarios are covered below. Once all the existing calls/registrations/subscriptions are terminated/cleared or the Dry Up Timeout value expires (whichever happens first), the SBC goes to Out of Service state.
      • Force - When this option is selected, the SBC immediately goes to Out of Service state. The existing calls are terminated. The Dry Up Timeout parameter is bypassed.
    • Dry Up Timeout - This option specifies the time (in minutes) until the SBC goes to Out Of Service state by setting the duration of the dry up timer. Once set, you cannot change the value of the running timer unless you revert the system back to In Service mode. Changing the value of this parameter after starting the dry up  action has no effect on the system. The dry up timeout value may range from 15 minutes to 1440 minutes (1 day).
    • Dry Up Mode Handling - This option specifies which actions while the SBC is in dry-up mode ("out of service mode"). These configurable actions allow the user to silently discard OPTIONS ping or keepalive messages, or to reject these messages with a configurable SIP cause code. Without this feature's configurable actions, the SBC responds to incoming messages for OPTIONS Keepalive and Invite with a "503 Service Unavailable," and for the remaining OODs the SBC sends a "500 Server Internal Error" response.

If the mode is changed from Out of Service to In Service when the dry up times is running, The Dry Up Timeout gets cancelled and the system is reverted to In Service mode.

If the mode is changed from Out of Service to In Service and If there is a dry up timer running and the sessions are not removed completely, all the unterminated calls, registrations and subscriptions are recovered. The SBC does not recover any calls, subscriptions, and registrations for which a tear-down message is initiated.

If the system mode is changed from Out of Service > Dry up to Out of Service > Force before the Dry up Timeout expires, the Dry up Timeout timer is cancelled. The system behaves as though the Dry up Timeout has expired and takes all the actions for removing the calls.

If the mode is Out of Service Pending state and the system switches over, the Dry-up timer continues on and is not reset.


Info

This feature is not available on the M-SBC.

REGISTER Message in Out of Service Mode

In Out of Service mode, all new REGISTER messages All registration types (refresh REGISTER, de-REGISTER, new REGISTER) are rejected with a 503 response code503 in the out-of-service mode. The 503 response does not contain a retry-after header. Any DEREGISTER messages received are passed through to the registrar.

Refresh REGISTER requests are also rejected, with the 503 response that does not contain a retry-after header, based on the following conditions:

  • The refresh register may be rejected if the register occurs within the Dry up Timeout.
    The probability of rejection is based on an internal statistical method.
The refresh register will be rejected if it occurs after the Dry up Timeout value.

Once the dryUpTimout timer expires, the SBC will not clear active registrations. 

An RCB destruction timer is started once the 503 response is sent for refresh REGISTER. The RCB is not destroyed immediately since the its contents are required for routing calls to that endpoint through a different SBC instance. The timeout value is chosen in such a manner so that the endpoint has completed registration through an alternate SBC instance before this RCB is destroyed. Once the RCB destruction timer expires, the RCB is destroyed immediately. The SBC does not send any message, especially the unREGISTER, to the inside registrar.At the end of the Dry Up Timer, any remaining connected registrations are destroyed with no further messages sent or received.


SUBSCRIBE Message in Out of Service Mode

In Out of Service mode, all new SUBSCRIBE messages are rejected with a 503 response code. The 503 response does not contain a retry-after header. If there is a matching SCB, then a randomized SCB destruction timer between 10 seconds to 5 minutes is started upon sending the 503 response. This allows the SBC to relay NOTIFIES messages until the endpoint re-subscribes through an alternate SBC instance. Once the SCB destruction timer expires, the SBC sends an unSUBSCRIBE to Egress peer and destroys the SCB. Any response to the unSUBSCRIBE, including a 2xx, 401, or 403 response, is ignored. As stated earlier, a NOTIFY message matching an existing subscription is forwarded.

A refresh SUBSCRIBE which does not match an existing subscription is rejected with a 503 response. The 503 response does not include a retry-after header.

NOTIFY Message in Out of Service Mode

In  Out of Service mode, a NOTIFY messages matching an existing subscription are forwarded. The NOTIFY message is associated with a SUBSCRIBE and until the endpoint has learned about out-of-service and re-subscribed through an alternate SBC instance, the NOTIFY is forwarded.

A refresh NOTIFY which does not match an existing subscription is rejected with a 503 response. The 503 response does not include a retry-after header.

When existing calls are terminated a result of the Dry-up timer expiring or the use of the Force option, the calls are terminated with a BYE message.

OPTIONS Message in Out of Service Mode

In In Out of Service mode mode, all new OPTION all  OPTION (OOD and in-dialog) messages are rejected with a 503 response which does not contain a retry-after header.

R-Factor Computation

In the SBC, the R-Factor computation is decoupled from QoS Routing. As a result, the SBC computes a call's R-Factor and adds it to the Call Data Records (CDRs) even if the QoS routing is not enabled. The parameter rFactorComputation is  added to the Global system level configuration CLI. If enabled, the SBC computes a call's R-Factor and adds it to the STOP CDR.

The R-factor is populated in the STOP CDR in the following fields:

  • Ingress Inbound R-Factor
  • Ingress Outbound R-Factor
  • Egress Inbound R-Factor
  • Egress Outbound R-Factor

Command Syntax


Code Block
languagenone
% set global system
	action <dryup | force>
    anonymizeDtmfLogging <disabled | enabled>
	dryupTimeout <15-1440 mins>
 	dryupModeHandling
        optionsKeepalive <disabled | reject | silentDiscard>
        optionsKeepaliveRejectReason <400-699>
        oodAndInvite <disabled | reject | silentDiscard>
        oodAndInviteRejectReason <400-699>   mode <inService | outOfService>	
	rFactorComputation <disabled | enabled>

Command Parameters

Caption
0Table
1Set Global System Parameters
3Set Global System Parameters


Parameter

Length/Range

Description

M/O

action

N/A

Specifies the action to take when putting the SBC to outOfService.

  • dryUp (default)
  • force

anonymizeDtmfLogging

N/A

Enable this flag to anonymize DTMF digits from the TRC file. This is to ensure the DTMF digits don't contain personal information such as credit card and personal identification details. A new file with extension ".TRC.ANN" is generated under the evlog directory, and the original file remains unchanged. If you disable this feature, the copied ".TRC.ANN" files are not deleted in case different log streamers/collectors require them.

File anonymization applies to TRC log level 4 only. This feature does not support anonymizing DTMF data below log level 4.

  • disabled (default)
  • enabled

Note: This feature is applicable to SBC SWe on AWS, Azure and GCP (public cloud) environments only.

O

dryupTimeout

15 to 1,440 minutes

Specifies the time in minutes for calls and registrations to dryUp before terminating them. (default 120 minutes)


dryupModeHandling

N/A

Handles actions while the SBC is in dry-up mode, including: silently discard INVITE and other OOD messages, or reject messages with a configurable SIP cause code.

  • oodAndInvite – Handles the INVITE and other Out Of Dialog messages during dry-up mode. These configurable actions allow the user to silently discard OOD messages (REGISTER, OPTIONS, SUBSCRIBE, NOTIFY, PUBLISH, INFO, MESSAGE, REFER) and INVITE messages, or to reject these messages with a configurable SIP cause code
    • disabled (default)
    • reject The SBC rejects messages with a configurable SIP cause code in oodAndInviteRejectReason
    • silentDiscard – The SBC silently discards OOD and INVITE messages.
  • oodAndInviteRejectReason – The SIP cause code used for rejecting the new INVITE, OPTIONS that require further routing, as well as OOD messages (REGISTER, OPTIONS, SUBSCRIBE, NOTIFY, PUBLISH, INFO, MESSAGE, REFER).
  • optionsKeepalive – Handles the OPTIONS health-check or keepalive messages during dry up mode.
    • disabled (default)
    • reject The SBC rejects messages with a configurable SIP cause code in optionsKeepaliveRejectReason
    • silentDiscard – The SBC silently discards OPTIONS ping and keepalive messages.
  • optionsKeepaliveRejectReason – The SIP cause code used for rejecting the keepalive OPTIONS message.

Available_since
TypeAvailable Since
Release12.1.1


mode

N/A

Specifies the service state of the SBC.

  • inService (default)
  • outOfService

rFactorComputation

N/A

Enable this flag to compute the R-Factor and add it to the STOP CDR even if the QoS routing is not enabled. Since R-Factor computations are CPU-intensive, this parameter limits the computations to applicable call flows only. The default setting is "disabled".

  • disabled (default)
  • enabled


Command Example

In this example, the system is pushed to out of service mode with dry up action (Dry Up Timeout = 180 mins). The system immediately goes to out of service standby mode and stops accepting new calls and registrations. Once all the existing calls/registrations/subscriptions are terminated/cleared or the Dry Up Timeout value expires (whichever happens first), the SBC goes to Out of Service mode. The R-Factor computation is enabled to compute the R-Factor and add it to the STOP CDR even if the QoS routing is not enabled.

Code Block
% set global system mode outOfService action dryUp dryupTimeout 180 rFactorComputation enabled


Code Block
languagenone
set global system anonymizeDtmfLogging enabled
commit