Page History
Add_workflow_for_techpubs | ||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
Panel | |
---|---|
In this section:
|
Overview
To configure the HPC/GETS feature, perform the following configuration steps:
Include Page | ||||
---|---|---|---|---|
|
Anchor | ||||
---|---|---|---|---|
|
This section describes the minimal configuration of the SBC for the HPC/GETS features.
Info | ||
---|---|---|
| ||
The steps mentioned below are not strictly sequential. However, Ribbon recommends executing them in the order mentioned in this document. |
Anchor | ||||
---|---|---|---|---|
|
Command Syntax
Code Block |
---|
% set profiles sipCacProfile <profile_name> hpcCallLimits maxCalls <unlimited | blockAll | 1-1000> maxIngressRate <unlimited | 1-2000> ingressRateInterval <1-30> bucketSize <1-4000> |
Tip | ||
---|---|---|
| ||
For more information on configuring |
Relevant GETS Parameters
Table 1: hpcCallLimits Parameters
Parameter | Length/Range | Default | Description | M/O |
---|---|---|---|---|
hpcCallLimits | N/A | N/A | Use this parameter to provision the HPC call limits for the SIP CAC profile for the TG. | O |
maxCalls | N/A | unlimited | Use this parameter to configure the maximum number of simultaneous HPC calls.
| O |
maxIngressRate | N/A | unlimited | Use this parameter to configure the maximum rate of ingress HPC calls.
| O |
ingressRateInterval | 1-30 | 5 |
| O |
bucketSize | 1-4000 | 10 | <1-4000> - Use this parameter to limit the rate of received HPC calls. |
Command Example
Code Block |
---|
% set profiles sipCacProfile testSipCacProfile hpcCallLimits maxCalls 500 maxIngressRate 50 ingressRateInterval 10 bucketSize 32 % commit |
Anchor | ||||
---|---|---|---|---|
|
Command Syntax
Configure the
dscpProfile.
Code Block % set profiles services dscpProfile <dscp_profile_name> hpcDscpValue <0-63> dscpValue <0-63> state <disabled | enabled>
Attach the configured
dscpProfile
withpolicyServer globalConfig.
Code Block % set system policyServer globalConfig dscpProfile <dscp_profile_name>
Configure
mediaPortRange.
Code Block % set system media mediaPortRange highPriorityPortRangeLocation <bottom | top> highPriorityPortRangeSize <0-25>
Tip | ||
---|---|---|
| ||
For more information on configuring |
Relevant GETS parameters
Table 2: hpcCallLimits Parameters
Parameter | Length/Range | Default | Description | M/O |
---|---|---|---|---|
dscpProfile | 1-23 | N/A | Use this parameter to configure the DSCP values for HPC and non-HPC calls. | O |
dscpValue | 0-63 | 0 | Specifies the DSCP value reserved for non-HPC calls. | O |
hpcDscpValue | 0-63 | 0 | Specifies the DSCP value reserved for HPC calls. | O |
state | N/A | disabled | Use this flag to enable or disable the DSCP profile.
| O |
Command Example
Code Block |
---|
% set profiles services dscpProfile HPC hpcDscpValue 32 dscpValue 22 state enabled % commit % set system policyServer globalConfig dscpProfile HPC % commit % set system media mediaPortRange highPriorityPortRangeLocation bottom highPriorityPortRangeSize 10 % commit |
Info | ||
---|---|---|
| ||
The percentage specified as |
Tip | ||
---|---|---|
| ||
The configuration for the parameters For example, if the overall MPR is defined as 1024-65535, and the High Priority Port Range is 10% (starting with the lower limit of MPR), then the HPMPR is 1024-7475. Ribbon recommends configuring additional SIP Signaling and other Control UDP ports within the range 1024-7475. In case of congestion, such configuration ensures that while processing ingress packets, packets received at ports within the range configured for HPMPR are prioritized. Normal calls are allocated local UDP ports ranging from 7476-65535, and GETS/HPC calls are allocated local UDP ports ranging from 1024-7475. |
Anchor | ||||
---|---|---|---|---|
|
Command Syntax
Code Block |
---|
% set profiles services hpcCallProfile <profile_name> dscp <egress | ingress> useRecvdValue <disabled | enabled> |
Info | ||
---|---|---|
| ||
The SBC supports configuring up to 256 HPC Call Profiles. |
Tip | ||
---|---|---|
| ||
For more information on configuring |
Relevant GETS parameters
Table 3: dscp Parameters
Parameter | Default | Description | M/O |
---|---|---|---|
dscp | N/A | The SBC uses the DSCP value received in the initial INVITE for the DSCP marking of the SIP message.
| O |
useRecvdValue | disabled | When the HPC call profile attaches to a TG acting as an egress TG, use this flag to control DSCP marking for SIP messages the SBC sends forward (INVITE or ACK for example). When the HPC call profile attaches to a TG acting as an ingress TG, use this flag to control DSCP marking for SIP messages the SBC sends backward (18x or 200 OK for example).
| O |
Command Example
The following examples are applicable for egress and ingress call legs:
Code Block |
---|
% set profiles services hpcCallProfile testHpcCallProfile dscp egress useRecvdValue disabled % commit % set profiles services hpcCallProfile testHpcCallProfile dscp ingress useRecvdValue disabled % commit % set profiles services hpcCallProfile testHpcCallProfile dscp egress useRecvdValue enabled % commit % set profiles services hpcCallProfile testHpcCallProfile dscp ingress useRecvdValue enabled % commit |
Anchor | ||||
---|---|---|---|---|
|
Prerequisite
Info | ||
---|---|---|
| ||
The prerequisite step is OPTIONAL; implement it based on the configuration requirement. |
By default, the SBC sends a response code 600 when the call queue is full. If the configuration requirement is to send the response code 503 when the call queue is full, execute the following commands:
Configure
causeMap 161
to correspnd withsipCause 503
.
Command Syntax:Code Block % set profiles signaling sipCauseCodeMapping cpcToSipCauseMapProfile <profile_name> baseProfile defaultCpcSip causeMap 161 sipCause 503
Command Example:Code Block % set profiles signaling sipCauseCodeMapping cpcToSipCauseMapProfile TEST baseProfile defaultCpcSip causeMap 161 sipCause 503
Associate the
cpcSipCauseMappingProfile
used in the previous step withsignaling causeCodeMapping
.
Command Syntax:Code Block % set addressContext default zone <zone_name> sipTrunkGroup <ingress_trunk_group> signaling causeCodeMapping cpcSipCauseMappingProfile <profile_name>
Command Example:Code Block % set addressContext default zone ZONE1 sipTrunkGroup INGRESS_TG signaling causeCodeMapping cpcSipCauseMappingProfile TEST
Command Syntax
Configure the
queueLength
forcallQueuing
at aglobal
level.Code Block % set global callQueuing queueLength <1-4096>
Configure the Call Admission Control (
cac
) forcallLimit
andhpcOverSubscription
restrictions.Code Block % set addressContext default zone <INTERNAL_ZONE> sipTrunkGroup <Ingress_TG | Egress_TG> cac callLimit <0-2147483647> hpcOversubscription <0-100>
Configure the
queue
for thehpcCallProfile
.Code Block % set profile services hpcCallProfile <hpc_call_profile> queue length <1-256> timeout <1-90> state <disabled | enabled>
Attach the configured
hpcCallProfile
with ingress or egress trunk group.Code Block % set addressContext default zone <INTERNAL_ZONE> sipTrunkGroup <Ingress_TG | Egress_TG> services hpcCallProfile <hpc_call_profile>
Tip | ||
---|---|---|
| ||
For more information on configuring For more information on configuring HPC |
Relevant GETS parameters
Table 4: queue Parameters
Parameter | Length/Range | Default | Description | M/O |
---|---|---|---|---|
queue | N/A | N/A | This parameter configures the HPC call queuing for trunk groups. | O |
length | 1-256 | 5 | <1-256> - Specifies the maximum number of calls that can simultaneously queue at each trunk group. | O |
timeout | 1-90 |
|
| O |
state | N/A | disabled | Use this flag to enable or disable the queuing of HPC calls.
| O |
Table 5: callQueuing Parameters
Parameter | Length/Range | Default | Description | M/O |
---|---|---|---|---|
callQueuing | N/A | N/A | Use this parameter to configure the HPC call queuing at the global level. | O |
queueLength | 1-4096 | 1024 | <1-4096> - Specifies the maximum number of HPC calls that the SBC can queue, combining all trunk groups. | O |
Command Example
The following example are applicable for both ingress and egress trunk groups:
Note | ||
---|---|---|
| ||
Do not enable HPC call queuing for ingress and egress trunk groups simultaneously. |
Code Block |
---|
% set global callQueuing queueLength <1-4096> % commit % set addressContext default zone INTERNAL sipTrunkGroup Ingress_TG cac callLimit 1 hpcOversubscription 100 % commit % set addressContext default zone EXTERNAL sipTrunkGroup Egress_TG cac callLimit 1 hpcOversubscription 100 % commit % set profile services hpcCallProfile test_hpc_call_profile queue length 50 timeout 10 state enabled % commit % set addressContext default zone INTERNAL sipTrunkGroup Ingress_TG services hpcCallProfile test_hpc_call_profile % commit % set addressContext default zone EXTERNAL sipTrunkGroup Egress_TG services hpcCallProfile test_hpc_call_profile % commit |
Anchor | ||||
---|---|---|---|---|
|
Command Syntax
Configure the
rph etsDefaultValue
for thehpcCallProfile
to be associated with ingress SIP TG.Code Block % set profiles services hpcCallProfile <hpcCallProfile_ingress> rph etsDefaultValue <0-4>
Enable the
hpcCallProfile
associated with the ingress SIP TG.Code Block % set profiles services hpcCallProfile <hpcCallProfile_ingress> state <disabled | enabled>
Associate the
hpcCallProfile
with the ingress SIP TG.Code Block % set addressContext <address_context> zone <ingress_zone> sipTrunkGroup <ingress_sip_tg> services hpcCallProfile <hpcCallProfile_ingress>
Configure the
rph etsDefaultValue
for thehpcCallProfile
to be associated with egress SIP TG.Code Block % % set profiles services hpcCallProfile <hpcCallProfile_egress> rph etsDefaultValue <0-4>
Enable the
hpcCallProfile
associated with the egress SIP TG.Code Block % set profiles services hpcCallProfile <hpcCallProfile_egress> state <disabled | enabled>
Associate the
hpcCallProfile
with the egress SIP TG.Code Block % set addressContext default zone <ingress_zone> sipTrunkGroup <egress_sip_tg> services hpcCallProfile <hpcCallProfile_egress>
Tip | ||
---|---|---|
| ||
The |
Command Example
Code Block |
---|
% set profiles services hpcCallProfile HPC_INGRESS rph etsDefaultValue 2 % commit % set profiles services hpcCallProfile HPC_INGRESS state enabled % commit % set addressContext default zone INTERNAL sipTrunkGroup INGRESS_TG services hpcCallProfile HPC_INGRESS % commit % set profiles services hpcCallProfile HPC_EGRESS rph etsDefaultValue 3 % commit % set profiles services hpcCallProfile HPC_EGRESS state enabled % commit % set addressContext default zone EXTERNAL sipTrunkGroup EGRESS_TG services hpcCallProfile HPC_EGRESS % commit |
Anchor | ||||
---|---|---|---|---|
|
Ribbon supports three types of GETS strings:
accessNumber an
featureCode fc
numberTranslation nt
You can configure the SBC for matching any of supported GETS string values with the received string. The following table describes the maximum number of configurations allowed for the supported GETS string types.
Caption | ||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||||||
|
Tip | ||
---|---|---|
| ||
For mor information on configuring |
Configure accessNumber an
Command Syntax
Code Block |
---|
% set profiles service hpcCallProfile <hpcCallProfile_ingress> getsStrings accessNumber an <3-10 digit number> |
Command Example
Code Block |
---|
% set profiles service hpcCallProfile HPC_INGRESS getsStrings accessNumber an 7106274387 % commit |
Configure featureCode fc
Command Syntax
Code Block |
---|
% set profiles service hpcCallProfile <hpcCallProfile_ingress> getsStrings featureCode fc <3-10 characters without visual separators> |
Command Example
Code Block |
---|
% set profiles service hpcCallProfile HPC_INGRESS getsStrings featureCode fc *272 % commit |
Configure numberTranslation nt
Command Syntax
Code Block |
---|
% set profiles service hpcCallProfile <hpcCallProfile_ingress> getsStrings numberTranslation nt <3-10 digit number> |
Command Example
Code Block |
---|
% set profiles service hpcCallProfile HPC_INGRESS getsStrings numberTranslation nt 7102001234 % commit |
Anchor | ||||
---|---|---|---|---|
|
Info | ||
---|---|---|
| ||
The sample below shows a fully configured |
Command Example
Code Block |
---|
% show profiles services hpcCallProfile testHpcProfile state enabled; rph { ingress { invalidEtsWps reject; validEtsWps accept; nonEtsWps ignore; } egress { validEtsWps dontInclude; nonEtsWps include; } } getsStrings { featureCode { fc *272; } accessNumber { an 7106274387; } numberTranslation { nt 7102001234; } } queue { state enabled; length 50; timeout 60; } dscp { egress { useRecvdValue enabled; } } dscpValue 50; |
External PSX Configuration
For information on PSX configuration, refer to the following pages:
RAMP Configuration
For information on the NW-HPC license, refer to the page Licensed Applications and Features on RAMP.