...
...
| borderColor | green |
|---|
| bgColor | transparent |
|---|
| borderWidth | 2 |
|---|
Back to Table of Contents
Back to CLI Configure Mode
Back to Address Context - CLI
...
Back to zone sipTrunkGroup - CLI
...
...
This page describes CLI syntax and parameters for the SIP Trunk Group 'Call Admission Control' object.
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.
...
|
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 |
|---|
|
% 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- |
...
...
registeredEndpointCacProfile |
...
<profile name>
registrationLimit <0-2147483647>
subscriptionLimit <0- |
...
...
...
...
unRegisteredEndpointCacProfile <profile name> |
Command Parameters
| Caption |
|---|
| 0 | Table |
|---|
| 1 | SIP Trunk Group CAC Parameters |
|---|
|
| Parameter | Length/Range | Description |
|---|
bandwidthLimit | 0-2147483647, or unlimited | The total media bandwidth limit, in Kbits/sec. (default = "unlimited") | bandwidthLimitThreshold | 0-100 | Enter threshold value (as a percentage) to specify bandwidth utilization notification threshold. (range: 0-100 / default = 0) | bandwidthVideoThreshold | 0-100 | Enter 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) | callLimit | 0-2147483647, or unlimited | Total number of concurrent calls (either ingress or egress) allowed. (default = “unlimited”). | callLimitThreshold | 0-100 | Call Limit utilization notification threshold, as a percentage. (default = 0) | egress | N/A | Egress-specific call admission control configuration for the SIP trunk group. See the Egress Parameters table below for details. | emergencyOversubscription | 0-1000 | The percentage of resource oversubscription allowed for emergency calls. (default = 10) | estimatedChildRegistrations | 1-256 | Estimated number of child registrations (i.e. the estimated number of P-Associated-URIs in 200 OK message). (default = 1) | extendedEmergencyIpLimit | 0-40000 | The resource oversubscription (expressed as numeric value) allowed for emergency calls. (default = 0) | hpcOversubscription | 0-100 | This 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) | ingress | N/A | Ingress-specific call admission control configuration for the SIP trunk group. See the Ingress Parameters table below for details. | registeredEndpointCacProfile | N/A | <SIP CAC Profile Name> – The name of the SIP CAC Profile (containing endpoint CAC parameters that are applied individually to each registered peer) to associate with this trunk group. | registrationLimit | 0-2147483647, or unlimited | The total number of concurrent SIP registrations allowed. (default is 'unlimited') | subscriptionLimit | 0-2147483647, or unlimited | The total number of concurrent SIP subscriptions allowed on IP trunk group. (default is 'unlimited') | tcpMediaLimit | 0-5000, or unlimited | MRM 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 |
|---|
|
% set addressContext <name> zone <name> sipTrunkGroup <name> cac egress
callBurstMax <1-900> (SBC 7000 range is 1-2700)
|
...
...
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)
|
...
...
3000 or unlimited> (1-1000 or unlimited for SBC |
...
5xx0; 1-1500 or unlimited for SBC 5400; 1-3000 or unlimited for SBC 7000)
|
...
...
3000 or unlimited> (1-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 |
|---|
| Egress Parameters |
|---|
| Egress Parameters |
|---|
|
...
| Egress Parameters | | 3 | Egress Parameters |
|---|
|
| Parameter | Length/Range | Description |
|---|
|
...
callBurstMax | SBC 5000: 1-900 |
|
...
...
callLimit – (Default is 'unlimited') Total number of concurrent calls (either ingress or egress) allowed on egress. (range: 0-2147483647, 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') | callLimit | 0-2147483647, or unlimited | Total 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 |
|
...
...
...
callRateMax as 'unlimited'; however, if you assign a value to one parameter, the other must also be assigned a value. |
|
emergencyOversubscription | 0-1000 | Over-subscription of resources (as a percentage) allowed for emergency calls. (default = 10) | extendedEmergencyIpLimit | 0-40000 | The resource oversubscription (expressed as numeric value) allowed for emergency calls. (default = 0) | hpcOversubscription | 0-100 | This parameter specifies the amount of resource over-subscription |
|
...
...
| 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 |
|
...
...
...
...
Maximum sustained egress rate (requests per second) of other out-of-dialog SIP requests. ( |
|
...
default = 'unlimited') | registerBurstMax | SBC 5xx0:
1-1000 |
|
...
or unlimited SBC 5400:
1-1500 or unlimited |
|
...
...
...
...
| Specifies the maximum allowed egress |
|
...
burst (above the allowed sustained rate) for |
|
...
initial SIP registrations. |
|
...
The default value is unlimited.
| registerRateMax
| SBC 5xx0:
1-1000 or unlimited SBC 5400:
1-1500 or unlimited SBC 7000:
1-3000 or unlimited | Specifies the maximum allowed sustained egress rate (registrations per second) |
|
...
for initial SIP registrations |
|
...
. The default value is 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 |
|
...
...
...
...
Maximum sustained egress rate (subscribes per second) of initial SIP subscribe request. ( |
|
...
(Default = 10) The percentage of resource oversubscription allowed for emergency calls.
...
(Default = 0) The resource oversubscription (expressed as numeric value) allowed for emergency calls.
...
Ingress
Command Syntax
| Code Block |
|---|
|
% 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-3000 or unlimited> (1-1000 or unlimited for SBC 5xx0; 1-1500 or unlimited for SBC 5400; 1-3000 or unlimited for SBC 7000)
registerRateMax <1-3000 or unlimited> (1-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 |
|---|
| 0 | Table |
|---|
| 1 | Ingress Parameters |
|---|
| 3 | Ingress Parameters |
|---|
|
| Parameter | Length/Range | Description |
|---|
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') | callLimit | 0-2147483647, or unlimited | Total number of concurrent calls allowed on ingress. ( |
|
...
...
| callRateMax | SBC 5000: 1-450, or unlimited |
|
...
...
: 1-1350, or unlimited | Maximum sustained ingress call rate allowed in calls/second. (default = 'unlimited') |
|
...
...
...
...
CallRateMax as 'unlimited'; however, if you assign a value to one parameter, the other must also be assigned a value. | emergencyOversubscription |
|
...
| 0-1000 | The amount of resource over-subscription (as a percentage) allowed for emergency calls. (default = 10) | extendedEmergencyIpLimit | 0-40000 | The resource oversubscription (expressed as numeric value) allowed for emergency calls. (default = 0) | hpcOversubscription | 0-100 | This 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 |
|
...
...
...
...
Maximum sustained ingress rate (requests per second) of other out-of-dialog SIP requests. ( |
|
...
default = 'unlimited') | registerBurstMax | SBC 5xx0:
1-1000 |
|
...
or unlimited SBC 5400:
1-1500 or unlimited |
|
...
...
...
...
| Specifies the maximum allowed ingress |
|
...
burst (above the allowed sustained rate) for initial SIP registrations. |
|
...
registerRateMax – (Default is 'unlimited') Maximum sustained rate of initial SIP registrations allowed in registrations per second. (range: 1-1000, or unlimited. SBC 7000 range is 1-3000, or unlimited)
...
The default value is unlimited.
| registerRateMax | SBC 5xx0:
1-1000 or unlimited SBC 5400:
1-1500 or unlimited SBC 7000:
1-3000 or unlimited | Specifies the maximum allowed sustained ingress rate (registrations per second) for initial SIP registrations. The default value is 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 |
|
...
...
...
...
Maximum sustained ingress rate (subscribes per second) of initial SIP subscribe request. ( |
|
...