Versions Compared

Old Version 4

changes.mady.by.user Ribbon Communications

Saved on

compared with

New Version Current

changes.mady.by.user Ribbon Communications

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Noprint
Panel
borderColorgreen
bgColortransparent
borderWidth2

Back to CLI Configure Mode

Back to Address Context - CLI

Back to Zone - CLI

Back to zone sipTrunkGroup - CLI


Panel

In this section:

Table of Contents
maxLevel3


Use the SIP trunk group CAC parameters to configure call admission control (CAC) settings for a SIP trunk group on ingress, on egress, and as a whole.

Info
titleNote

 

This page describes CLI syntax and parameters for the SIP Trunk Group 'Call Admission Control' object.

 

note

As a best practice, always use UPPERCASE for trunk group names.


Include Page
Param_values_exception
Param_values_exception

Include Page
_Subscribe_CAC_Access_Restriction
_Subscribe_CAC_Access_Restriction

SIP Trunk Group CAC

Command Syntax

Code Block
languagenone
% set addressContext <name> zone <name> sipTrunkGroup <name> cac
	bandwidthLimit <0-2147483647>
	bandwidthLimitThreshold <0-100>
    bandwidthVideoThreshold <0-100>
	callLimit <0-2147483647>
	callLimitThreshold <0-100>
	egress 
	emergencyOversubscription <0-1000>
	estimatedChildRegistrations <1-256>
	extendedEmergencyIpLimit <0-40000>
	hpcOversubscription <0-100>
	ingress 
	registeredEndpointCacProfile <profile name>
	registrationLimit <0-2147483647>
	subscriptionLimit <0-2147483647>
	tcpMediaLimit <0-5000>
	unRegisteredEndpointCacProfile <profile name>

Command Parameters

Caption
0Table
1SIP Trunk Group CAC Parameters


ParameterLength/RangeDescription
bandwidthLimit0-2147483647, or unlimitedThe total media bandwidth limit, in Kbits/sec. (default = "unlimited")
bandwidthLimitThreshold0-100Enter threshold value (as a percentage) to specify bandwidth utilization notification threshold. (range: 0-100 / default = 0)
bandwidthVideoThreshold0-100Enter threshold value (as a percentage of video bandwidth) to limit video streams to a specific bandwidth to prevent video calls consuming call bandwidth otherwise needed for audio calls. (range: 0-100 / default = 0)
callLimit0-2147483647, or unlimitedTotal number of concurrent calls (either ingress or egress) allowed. (default = “unlimited”).
callLimitThreshold0-100Call Limit utilization notification threshold, as a percentage. (default = 0)
egressN/AEgress-specific call admission control configuration for the SIP trunk group.
See sipTrunkGroup cac - CLI
See the Egress Parameters table below for details.
emergencyOversubscription0-1000

The percentage of resource oversubscription allowed for emergency calls. (default = 10)

estimatedChildRegistrations1-256Estimated number of child registrations (i.e. the estimated number of P-Associated-URIs in 200 OK message). (default = 1)
extendedEmergencyIpLimit0-40000

The resource oversubscription (expressed as numeric value) allowed for emergency calls. (default = 0)

hpcOversubscription0-100This parameter specifies the amount of resource over-subscription (as a percentage) allowed for HPC calls. When the baseline call limit and bandwidth limit are reached, normal calls are not admitted, but additional HPC calls are allowed up to the configured percentage value. (default = 10)
ingressN/AIngress-specific call admission control configuration for the SIP trunk group.
See 
See the Ingress Parameters table below for details.
registeredEndpointCacProfileN/A
Endpoint CAC profile containing
<SIP CAC Profile Name> – The name of the SIP CAC Profile (containing endpoint CAC parameters that are applied individually to each
registrant
registered peer) to associate with this trunk group.
registrationLimit0-2147483647, or unlimitedThe total number of concurrent SIP registrations allowed. (default is 'unlimited')
subscriptionLimit0-2147483647, or unlimitedThe total number of concurrent SIP subscriptions allowed on IP trunk group. (default is 'unlimited')
tcpMediaLimit0-5000, or unlimitedMRM session limit per trunk group.

unRegisteredEndpointCacProfile

N/A

<SIP CAC Profile name> – The name of the SIP CAC profile (containing endpoint CAC parameters that are applied individually to each unregistered peer) to associate with this trunk group.

 

(Refer to SIP CAC Profile - CLI for profile details.)



Egress

Command Syntax

Code Block
languagenone
% set addressContext <name> zone <name> sipTrunkGroup <name> cac egress 
	callBurstMax <1-900> (SBC 7000 range is 1-2700)
	callLimit <0-2147483647>
	callRateMax <1-450> (SBC 7000 range is 1-1350)
	emergencyOversubscription <0-1000>
	extendedEmergencyIpLimit <0-40000>
	hpcOversubscription <0-100>
	otherReqBurstMax <1-1000> (SBC 7000 range is 1-3000)
	otherReqRateMax <1-1000> (SBC 7000 range is 1-3000)
	registerBurstMax <1-1000>3000 or unlimited> (SBC 7000 range is1-1000 or unlimited for SBC 5xx0; 1-1500 or unlimited for SBC 5400; 1-3000 or unlimited for SBC 7000)
	registerRateMax <1-1000>3000 or unlimited> (1-1000 or unlimited for SBC 7000 range is 5xx0; 1-1500 or unlimited for SBC 5400; 1-3000 or unlimited for SBC 7000)
	subscribeBurstMax <1-1000> (SBC 7000 range is 1-3000)
	subscribeRateMax <1-1000> (SBC 7000 range is 1-3000)

Command Parameters

Info

Call policing using callRateMax and callBurstMax is applicable only to normal and emergency calls, not to high priority calls (HPC).

Anchor
Egress Parameters
Egress Parameters

Caption
0Table
1Egress Parameters
3Egress Parameters


ParameterLength/RangeDescription
callBurstMax

SBC 5000: 1-900, or unlimited

SBC 7000: 1-2700, or unlimited

Maximum allowed burst size (above the allowed sustained rate) for egress call attempts, in calls per second. (default = 'unlimited')
callLimit0-2147483647, or unlimitedTotal number of concurrent calls (either ingress or egress) allowed on egress. (default = 'unlimited')
callRateMax

SBC 5000: 1-450, or unlimited

SBC 7000: 1-1350, or unlimited).

Maximum sustained egress call rate allowed in calls per second. (default = 'unlimited')

NOTE: You can set both callBurstMax and callRateMax as 'unlimited'; however, if you assign a value to one parameter, the other must also be assigned a value.

emergencyOversubscription  0-1000Over-subscription of resources (as a percentage) allowed for emergency calls. (default = 10)
extendedEmergencyIpLimit0-40000

The resource oversubscription (expressed as numeric value) allowed for emergency calls. (default = 0)

hpcOversubscription0-100This parameter specifies the amount of resource over-subscription (as a percentage) allowed for HPC calls. When the baseline call limit and bandwidth limit are reached, normal calls are stopped, but additional HPC calls are allowed up to the configured percentage value. (default = 10)
otherReqBurstMax

SBC 5000: 1-1000, or unlimited

SBC 7000: 1-3000, or unlimited

Maximum allowed burst (above the allowed sustained rate) for any other egress out-of-dialog SIP request. (default = 'unlimited')
otherReqRateMax

SBC 5000: 1-1000, or unlimited

SBC 7000: 1-3000, or unlimited

Maximum sustained egress rate (requests per second) of other out-of-dialog SIP requests. (default = 'unlimited')

registerBurstMax

SBC

5000

5xx0:
1-1000

,

or unlimited

SBC 5400:
1-1500 or unlimited

SBC 7000:
1-3000

,

or unlimited

Maximum

Specifies the maximum allowed egress burst (above the allowed sustained rate) for

egress

initial SIP registrations.

(

The default

= 'unlimited')

value is unlimited. 

Available_since
Release8.2.5

registerRateMax

SBC

5000

5xx0:
1-1000

,

or unlimited

SBC 5400:
1-1500 or unlimited

SBC 7000:
1-3000

,

or unlimited

)

Maximum

Specifies the maximum allowed sustained egress rate (registrations per second)

of

for initial SIP registrations

allowed

.

(

The default

= 'unlimited')NOTE: You can set both registerBurstMax and registerRateMax as 'unlimited'

value is unlimited. 

Available_since
Release8.2.5

Note: You can set both “registerBurstMax” and “registerRateMax” as unlimited; however, if you assign a value to one parameter, the other must also be assigned a value.

 subscribeBurstMax

SBC 5000: 1-1000, or unlimited

SBC 7000: 1-3000, or unlimited

Maximum allowed burst (above the allowed sustained rate) for egress initial SIP subscribe request. (default = 'unlimited')
subscribeRateMax

SBC 5000: 1-1000, or unlimited

SBC 7000: 1-3000, or unlimited

Maximum sustained egress rate (subscribes per second) of initial SIP subscribe request. (default = 'unlimited')


Ingress

Command Syntax

Code Block
languagenone
% set addressContext <name> zone <name> sipTrunkGroup <name> cac ingress 
	callBurstMax <1-900> (SBC 7000 range is 1-2700)
	callLimit <0-2147483647>
	callRateMax <1-450> (SBC 7000 range is 1-1350)
	emergencyOversubscription <0-1000>
	hpcOversubscription <0-100>
	extendedEmergencyIpLimit <0-40000>
	otherReqBurstMax <1-1000> (SBC 7000 range is 1-3000)
	otherReqRateMax <1-1000> (SBC 7000 range is 1-3000)
	registerBurstMax <1-1000>3000 or unlimited> (1-1000 or unlimited for SBC 7000 range is 5xx0; 1-1500 or unlimited for SBC 5400; 1-3000 or unlimited for SBC 7000)
	registerRateMax <1-1000>3000 or unlimited> (SBC 7000 range is1-1000 or unlimited for SBC 5xx0; 1-1500 or unlimited for SBC 5400; 1-3000 or unlimited for SBC 7000)
	subscribeBurstMax <1-1000> (SBC 7000 range is 1-3000)
	subscribeRateMax <1-1000> (SBC 7000 range is 1-3000)

Command Parameters

Info

Call policing using callRateMax and callBurstMax is applicable only to normal and emergency calls, not to high priority calls (HPC).

Anchor
Ingress Parameters
Ingress Parameters

Caption
0Table
1Ingress Parameters
3Ingress Parameters


ParameterLength/RangeDescription
callBurstMax

SBC 5000: 1-900, or unlimited

SBC 7000: 1-2700, or unlimited

Maximum allowed burst (above the allowed sustained rate) for ingress calls in calls per second. (default = 'unlimited')
callLimit0-2147483647, or unlimited

Total number of concurrent calls allowed on ingress. (default = 'unlimited')

callRateMax 

SBC 5000: 1-450, or unlimited

SBC 7000: 1-1350, or unlimited

Maximum sustained ingress call rate allowed in calls/second. (default = 'unlimited')

NOTE: You can set both callBurstMax and CallRateMax as 'unlimited'; however, if you assign a value to one parameter, the other must also be assigned a value.

emergencyOversubscription0-1000The amount of resource over-subscription (as a percentage) allowed for emergency calls. (default = 10)
extendedEmergencyIpLimit0-40000

The resource oversubscription (expressed as numeric value) allowed for emergency calls. (default = 0)

hpcOversubscription0-100This parameter specifies the amount of resource over-subscription (as a percentage) allowed for HPC calls. When the baseline call limit and bandwidth limit are reached, normal calls are not admitted, but additional HPC calls are allowed up to the configured percentage value. (default = 10)
otherReqBurstMax 

SBC 5000: 1-1000, or unlimited

SBC 7000: 1-3000, or unlimited

Maximum allowed burst (above the allowed sustained rate) for any other ingress out-of-dialog SIP request. (default = 'unlimited')

otherReqRateMax

SBC 5000: 1-1000, or unlimited

SBC 7000: 1-3000, or unlimited

Maximum sustained ingress rate (requests per second) of other out-of-dialog SIP requests. (default = 'unlimited')

registerBurstMax

SBC

5000

5xx0:
1-1000

,

or unlimited

SBC 5400:
1-1500 or unlimited

SBC 7000:
1-3000

,

or unlimited

Maximum

Specifies the maximum allowed ingress burst (above the allowed sustained rate) for initial SIP registrations.

(

The default

= 'unlimited')

value is unlimited. 

Available_since
Release8.2.5

registerRateMax

SBC

5000

5xx0:
1-1000

,

or unlimited

SBC 5400:
1-1500 or unlimited

SBC 7000:
1-3000

,

or unlimited

Maximum

Specifies the maximum allowed sustained

rate of

ingress rate (registrations per second) for initial SIP registrations

allowed in registrations per second

.

(

The default

= 'unlimited')

value is unlimited. 

Available_since
Release8.2.5

Note: You

NOTE: You

can set both “registerBurstMax” and “registerRateMax” as unlimited; however, if you assign a value to one parameter, the other must also be assigned a value.

subscribeBurstMax

SBC 5000: 1-1000, or unlimited

SBC 7000: 1-3000, or unlimited

Maximum allowed burst (above the allowed sustained rate) for ingress initial SIP subscribe request. (default = 'unlimited')

subscribeRateMax

SBC 5000: 1-1000, or unlimited

SBC 7000: 1-3000, or unlimited

Maximum sustained ingress rate (subscribes per second) of initial SIP subscribe request. (default = 'unlimited')


Pagebreak