Skip to end of metadata
Go to start of metadata

In this section:

Modified: for 5.1.1

 

 

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

 

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

Unless annotated otherwise, the parameter values in this section apply to the SBC Core.

 

SIP Trunk Group CAC

Command Syntax

% set addressContext <name> zone <name> sipTrunkGroup <name> cac
	bandwidthLimit <0-2147483647, or unlimited>
	bandwidthLimitThreshold <0-100>
	callLimit <0-2147483647, or unlimited>
	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>

Command Parameters

Table : SIP Trunk Group CAC Parameters

ParameterLength/RangeDescription
bandwidthLimit0-2147483647, or unlimitedThe total media bandwidth limit, in Kbits/sec. (default = "unlimited")
bandwidthLimitThreshold0-100Bandwidth utilization notification threshold as a percentage. (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 Egress Parameters table below for details.
emergencyOversubscription0-1000

The percentage of resource over-subscription 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 over-subscription (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 Ingress Parameters table below for details.
registeredEndpointCacProfileN/AEndpoint CAC profile containing CAC parameters that are applied individually to each registrant.
registrationLimit0-2147483647, or unlimitedThe total number of concurrent SIP registrations allowed. (default = 'unlimited')
subscriptionLimit0-2147483647, or unlimitedThe total number of concurrent SIP subscriptions allowed on IP trunk group. (default = 'unlimited')
tcpMediaLimit0-5000, or unlimitedMRM session limit per trunk group.

 

Egress

Command Syntax

% set addressContext <name> zone <name> sipTrunkGroup <name> cac egress 
	callBurstMax <SBC 5000: 1-900, or unlimited / SBC 7000: 1-2700, or unlimited>
	callLimit <0-2147483647>
	callRateMax <SBC 5000: 1-450, or unlimited / SBC 7000: 1-1350, or unlimited>
	emergencyOversubscription <0-1000>
	extendedEmergencyIpLimit <0-40000>
	hpcOversubscription <0-100>
	otherReqBurstMax <SBC 5000: 1-1000, or unlimited / SBC 7000: 1-3000, or unlimited>
	otherReqRateMax <SBC 5000: 1-1000, or unlimited / SBC 7000: 1-3000, or unlimited>
	registerBurstMax <SBC 5000: 1-1000, or unlimited / SBC 7000: 1-3000, or unlimited>
	registerRateMax <SBC 5000: 1-1000, or unlimited / SBC 7000: 1-3000, or unlimited>
	subscribeBurstMax <SBC 5000: 1-1000, or unlimited / SBC 7000: 1-3000, or unlimited>
	subscribeRateMax <SBC 5000: 1-1000, or unlimited / SBC 7000: 1-3000, or unlimited>

Command Parameters

Table : Egress 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 over-subscription (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: 1-1000, or unlimited

SBC 7000: 1-3000, or unlimited

Maximum allowed burst (above the allowed sustained rate) for egress initial SIP registrations. (default = 'unlimited')
registerRateMax

SBC 5000: 1-1000, or unlimited

SBC 7000: 1-3000, or unlimited)

Maximum sustained egress rate (registrations per second) of initial SIP registrations allowed. (default = 'unlimited')

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

% set addressContext <name> zone <name> sipTrunkGroup <name> cac ingress
	callBurstMax <SBC 5000: 1-900, or unlimited / SBC 7000: 1-2700, or unlimited>
	callLimit <0-2147483647>
	callRateMax <SBC 5000: 1-450, or unlimited / SBC 7000: 1-1350, or unlimited>
	emergencyOversubscription <0-1000>
	extendedEmergencyIpLimit <0-40000>
	hpcOversubscription <0-100>
	otherReqBurstMax <SBC 5000: 1-1000, or unlimited / SBC 7000: 1-3000, or unlimited>
	otherReqRateMax <SBC 5000: 1-1000, or unlimited / SBC 7000: 1-3000, or unlimited>
	registerBurstMax <SBC 5000: 1-1000, or unlimited / SBC 7000: 1-3000, or unlimited>
	registerRateMax <SBC 5000: 1-1000, or unlimited / SBC 7000: 1-3000, or unlimited>
	subscribeBurstMax <SBC 5000: 1-1000, or unlimited / SBC 7000: 1-3000, or unlimited>
	subscribeRateMax <SBC 5000: 1-1000, or unlimited / SBC 7000: 1-3000, or unlimited>

Command Parameters

Table : Ingress 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 over-subscription (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: 1-1000, or unlimited

SBC 7000: 1-3000, or unlimited

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

registerRateMax

SBC 5000: 1-1000, or unlimited

SBC 7000: 1-3000, or unlimited

Maximum sustained rate of initial SIP registrations allowed in registrations per second. (default = 'unlimited')

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')