SIP CAC Profile - CLI

sipCacProfile

1-23

The name of SIP Call Admission Control (CAC) profile.

Mandatory Parameters:

bandwidthLimit

0-2147483647

Maximum bandwidth (in Kbps) a peer can utilize. (default is 'unlimited')

bandwidthLimitThreshold

0-100

Bandwidth threshold as percentage. (default = 0).

callEgressAggregateEmergencyPreference

1-10

Emergency call preference within the aggregate policer at Egress. (default = 10)

callEgressAggregatePreference

1-10

Call preference within the aggregate policer at Egress. (default = 1)

callEgressBurstSize

1-500

Maximum call burst size for calls to a registered endpoint or peer. (default = 1).

callEgressEmergencyPreference

N/A

Emergency call preference at Egress.

• disabled (default)
• enabled

callEgressRate

1-500, unlimited

Maximum egress call rate in calls per time period. (default is 'unlimited').

callEgressRatePeriod

1-10

Time period (in seconds) over which the egress call rate applies. (default = 1).

callIngressAggregateEmergencyPreference

1-10

Emergency call preference within the aggregate policer at Ingress. (default = 10)

callIngressAggregatePreference

1-10

Call preference within the aggregate policer at Ingress. (default = 1)

callIngressBurstSize

1-500

Maximum call burst size from a peer or registered endpoint. (default = 1).

callIngressEmergencyPreference

N/A

Emergency call preference at Ingress.

• disabled (default)
• enabled

callIngressRate

1-500, unlimited

Maximum call arrival rate from a peer or registered endpoint per callIngressRatePeriod. (default is 'unlimited').
A value of "0" indicates that call rate policing is not applicable.

callIngressRatePeriod

1-10

Time period (in seconds) over which the callIngressRate applies. (default = 1).

callLimit

0-30000, unlimited

Maximum number of active calls to and from any registered endpoint or peer (e.g. total number of ingress and egress calls). (default is 'unlimited')

callLimitEgress

0-30000, unlimited

Maximum number of outbound active calls. (default is 'unlimited')

callLimitIngress

0-30000, unlimited

Maximum number of inbound active calls. (default is 'unlimited')

callLimitThreshold

0-100

Call Limit utilization notification threshold, as a percentage. (default = 0).

emergencyOversubscription

0-1000

Oversubscription of calls (as a percentage) allowed for emergency calls. (default = 0).

emergencyOversubscriptionEgress

0-1000

Oversubscription of egress calls (as a percentage) allowed for emergency calls. When the baseline limit is reached, normal calls are stopped but emergency calls are allowed up to this additional percentage. (default = 10).

emergencyOversubscriptionIngress

0-1000

Oversubscription of calls (as a percentage) allowed for emergency calls. When the baseline limit is reached, normal calls are stopped but emergency calls are allowed up to this additional percentage. (default = 10).

extendedEmergencyIpLimit

0-40000

Additional number of emergency calls (expressed as a numeric value) allowed for ingress CAC group if call limit and emergency oversubscription quota are exhausted. (default = 0)

state

N/A

Administrative state of this SIP CAC Profile.

• disabled (default)
• enabled

Optional Parameters 

aggregateMessage

N/A

Use this object to configure the Aggregate Message policer settings listed below.

• egressBurstSize – Maximum Aggregate Message egress burst size. (range: 1-10000 / default = 10)
• egressRate – Maximum Aggregate Message egress rate. (range: 1-1000, unlimited / default is 'unlimited')
• egressRatePeriod – Aggregate Message egress rate period in seconds. (range: 1-10 / default = 1)
• ingressBurstSize – Maximum Aggregate Message ingress burst size. (range: 1-10000 / default = 10)
• ingressRate – Maximum Aggregate Message ingress rate. (range: 1-1000, unlimited / default is 'unlimited')
• ingressRatePeriod – Aggregate Message ingress rate period in seconds. (range: 1-10 / default = 1)

dblAggregateRej

N/A

Use this object to Dynamically Blacklist (DBL) an endpoint based on the CAC policer reject rate using settings below.

• ingressBurstSize – Maximum DBL Aggregate Reject ingress burst size.(range: 1-10000 / default = 1)
• ingressRate – Maximum DBL Aggregate Reject ingress rate.(range: 1-1000, unlimited / default is 'unlimited')
• ingressRatePeriod – DBL Aggregate Reject ingress rate period in seconds.(range: 1-10 / default = 1)

message

N/A

Use this object to configure the MESSAGE message in a SIP CAC profile using the settings below.

• egressAggregatePreference – MESSAGE preference within egress aggregate policer. (range: 1-10 / default = 1)
• egressBurstSize – Maximum MESSAGE egress burst size. (range: 1-10000 / default = 1)
• egressRate – Maximum MESSAGE egress rate. (range: 1-1000, unlimited / default is 'unlimited')
• egressRatePeriod – MESSAGE egress rate period in seconds. (range: 1-10 / default = 1)
• ingressAggregatePreference – MESSAGE preference within ingress aggregate policer. (range: 1-10 / default = 1)
• ingressBurstSize – Maximum MESSAGE ingress burst size. (range: 1-10000 / default = 1)
• ingressRate – Maximum MESSAGE ingress rate. (range: 1-1000, unlimited / default is 'unlimited')
• ingressRatePeriod – MESSAGE ingress rate period in seconds. (range: 1-10 / default = 1)

notify

N/A

Use this object to configure the NOTIFY message in a SIP CAC profile. (egress and ingress settings are same as 'message' parameter above)

options

N/A

Use this object to configure the OPTIONS message in a SIP CAC profile. (egress and ingress settings are same as 'message' parameter above)

otherRequests

N/A

Use this object to configure the OTHER REQUESTS message in a SIP CAC profile using the settings below.

• egressAggregatePreference – OTHER REQUESTS preference within egress aggregate policer. (range: 1-10 / default = 1)
• egressBurstSize – Maximum OTHER REQUESTS egress burst size. (range: 1-10000 / default = 5)
• egressRate – Maximum OTHER REQUESTS egress rate. (range: 1-1000, unlimited / default is 'unlimited')
• egressRatePeriod – OTHER REQUESTS egress rate period in seconds. (range: 1-10 / default = 1)
• ingressAggregatePreference – OTHER REQUESTS preference within ingress aggregate policer. (range: 1-10 / default = 1)
• ingressBurstSize – Maximum OTHER REQUESTS ingress burst size. (range: 1-10000 / default = 5)
• ingressRate – Maximum OTHER REQUESTS ingress rate. (range: 1-1000, unlimited / default is 'unlimited')
• ingressRatePeriod – OTHER REQUESTS ingress rate period in seconds. (range: 1-10 / default = 1)

qoe

N/A

Use this object to configure the Quality of Service-based routing configuration. The following parameters are used to measure signaling quality:

• asr – Answer Seizure Ratio measurement.
  • asrCriticalLimit – The critical ASR limit below which call admission stops. (range: 0-70% / default = 40)
  • defaultQosAsr – Default ASR value to use when no calls are made for a sampling period. (range: 0-100% / default = 90)
  • majorQosAsrLimit – The major ASR limit. When breached, an INFO log is generated and trunk group stats are incremented one value. (range: 0-90% / default = 70)
• clu – Call Limit Utilization measurement.
  • cluCriticalLimit – Critical CLU limit (as percentage) below which the trunk group or peer is marked out of service for egress calls. (range: 80-100% / default = 80)
• minTimeToProceed – Minimum time to wait (in seconds) before call admission resumes after peer/trunk group KPI falls below critical threshold. (range: 60-3600 seconds / default = 60)
• pgrd – Post Gateway Ringing Delay measurement.
  • defaultPgrdFactor – Default PGRD value when no calls are made for a sampling period. (range: 50-10000 milliseconds / default = 500)
  • pgrdCriticalLimit – Critical PGRD limit above which the trunk group is marked out of service, and not chosen for routing. (range: 50-10000 milliseconds / default = 2000)
• scru– Sustained Call Rate Utilization measurement.
  • scruCriticalLimit – SCRU KPI critical limit (as percentage) above which the trunk group/peer is not chosen for routing. (range: 80-100% / default = 80)

refer

N/A

Use this object to configure the REFER message in a SIP CAC profile. (egress and ingress settings are same as 'message' parameter above)

response

N/A

Use this object to configure the REFER message in a SIP CAC profile.(egress and ingress settings are same as 'otherRequests' parameter above)

subscribe

N/A

Use this object to configure the SUBSCRIBE message in a SIP CAC profile. (egress and ingress settings are same as 'message' parameter above)