Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Add_workflow_for_techpubs
AUTH2UserResourceIdentifier{userKey=8a00a02355cd1c2f0155cd26cb41059c, userName='null'}
AUTH1UserResourceIdentifier{userKey=8a00a02355cd1c2f0155cd26ca7f046c, userName='null'}
JIRAIDAUTHSBX-88903
REV5UserResourceIdentifier{userKey=8a00a02355cd1c2f0155cd26cb8305e9, userName='null'}
REV6UserResourceIdentifier{userKey=8a00a02355cd1c2f0155cd26cb8305e9, userName='null'}
REV3UserResourceIdentifier{userKey=8a00a02355cd1c2f0155cd26c8c30172, userName='null'}
REV1UserResourceIdentifier{userKey=8a00a02355cd1c2f0155cd26c8c30172, userName='null'}


Panel

In this section:

Table of Contents


Anchor
SBC Configuration
SBC Configuration
SBC Configuration

This section describes the minimal configuration of the SBC for the HPC/GETS features.

Info
titleNote

The steps mentioned below are not strictly sequential. However, Ribbon recommends executing them in the order mentioned in this document.

Anchor
Configure hpcCallLimits and policer rate in sipCacProfile
Configure hpcCallLimits and policer rate in sipCacProfile
Configure hpcCallLimits and policer rate in sipCacProfile

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
titleTip

For more information on configuring hpcCallLimits, refer to the section "HPC Call Limits" of the page SIP CAC Profile - CLI.

Relevant GETS Parameters

Table 1: hpcCallLimits Parameters

ParameterLength/RangeDefaultDescriptionM/O
hpcCallLimitsN/AN/AUse this parameter to provision the HPC call limits for the SIP CAC profile for the TG.O
maxCallsN/Aunlimited

Use this parameter to configure the maximum number of simultaneous HPC calls.

  • blockAll
  • unlimited (default)
  • <1-1000>
O
maxIngressRateN/Aunlimited

Use this parameter to configure the maximum rate of ingress HPC calls.

  • unlimited (default)
  • <1-2000>
O
ingressRateInterval1-305

<1-30> - Use this parameter to configure the interval for the ingress rate of HPC calls.

O
bucketSize1-400010<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
Configure DSCP marking for DIAMETER+ packets
Configure DSCP marking for DIAMETER+ packets
Configure DSCP marking for DIAMETER+ packets

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 with policyServer 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
titleTip

For more information on configuring dscpProfile, refer to DSCP Profile - CLI.

Relevant GETS parameters

Table 2: hpcCallLimits Parameters

ParameterLength/RangeDefaultDescriptionM/O
dscpProfile1-23N/AUse this parameter to configure the DSCP values for HPC and non-HPC calls.O
dscpValue0-630

Specifies the DSCP value reserved for non-HPC calls.

O
hpcDscpValue0-630

Specifies the DSCP value reserved for HPC calls.

O
stateN/Adisabled

Use this flag to enable or disable the DSCP profile.

  • disabled (default)
  • enabled
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
titleNote

The percentage specified as highPriorityPortRangeSize is used as the High Priority reserve for both Media Port Range (MPR) and LIF bandwidth. For more information on Media Port Range, refer to Media System - CLI.


Tip
titleTip

The configuration for the parameters highPriorityPortRangeLocation and highPriorityPortRangeSize defines the High Priority Media Port Range (HPMPR) as a subset of the overall MPR. The SBC uses the configuration to quickly identify UDP packets (both media and non-media) arriving within the overall MPR, and prioritizes them while processing ingress UDP packets. For GETS/HPC applications, Ribbon recommends reserving 10% of the MPR as HPMPR. If additional SIP Signaling Ports (besides the default port 5060), and/or other Control UDP ports are within the overall MPR, Ribbon recommends configuring them within the HPMPR. Such configuration ensures that during congestion, they are prioritized while processing ingress packets.

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
Configure DSCP for useRecvdValue
Configure DSCP for useRecvdValue
Configure DSCP for useRecvdValue

Command Syntax

Code Block
% set profiles services hpcCallProfile <profile_name> 
	dscp <egress | ingress> 
	useRecvdValue <disabled | enabled>


Info
titleNote

The SBC supports configuring up to 256 HPC Call Profiles.


Tip
titleTip

For more information on configuring hpcCallProfile, refer to HPC Call Profile - CLI.

Relevant GETS parameters

Table 3: dscp Parameters

ParameterDefaultDescriptionM/O
dscpN/A

The SBC uses the DSCP value received in the initial INVITE for the DSCP marking of the SIP message.

  • egress
  • ingress
O
useRecvdValuedisabled

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

  • disabled (default)
  • enabled
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
Configure HPC Call Queuing
Configure HPC Call Queuing
Configure HPC Call Queuing

Prerequisite

Info
titleNote

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 with sipCause 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 with signaling 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 for callQueuing at a global level.

    Code Block
    % set global callQueuing queueLength <1-4096>


  • Configure the Call Admission Control (cac) for callLimit and hpcOverSubscription 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 the hpcCallProfile.

    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
titleTip

For more information on configuring hpcCallProfile queue, refer to HPC Call Profile - CLI.

For more information on configuring HPC callQueuing at a global level, refer to Call Queuing - Global - CLI.

Relevant GETS parameters

Table 4: queue Parameters

ParameterLength/RangeDefaultDescriptionM/O
queueN/AN/AThis parameter configures the HPC call queuing for trunk groups.O
length1-2565<1-256> - Specifies the maximum number of calls that can simultaneously queue at each trunk group.O
timeout1-90

30
 

<1-90> - Specifies the maximum time (in seconds) that an HPC call remains queued before the SBC stops the attempt to connect the call in the associated trunk group.

O
stateN/Adisabled

Use this flag to enable or disable the queuing of HPC calls.

  • disabled (default)
  • enabled
O

Table 5: callQueuing Parameters

ParameterLength/RangeDefaultDescriptionM/O
callQueuingN/AN/AUse this parameter to configure the HPC call queuing at the global level.O
queueLength1-40961024<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
titleCaution

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
Configure rph etsDefaultValue
Configure rph etsDefaultValue
Configure rph etsDefaultValue

Command Syntax

  • Configure the rph etsDefaultValue for the hpcCallProfile 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 the hpcCallProfile 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
titleTip

The rph configuration mentioned above shows only a minimal configuration. It assumes default values for all other parameters and flags. For more information on configuring hpcCallProfile rph, refer to HPC Call Profile - CLI.

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
Configure getsStrings
Configure getsStrings
Configure getsStrings

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
0Table
1Maximum Num of Configurations for Supported GETS String Types


GETS StringLength/Range/ValueMaximum Number of ConfigurationsDescription
accessNumber an3-10 digit number10The SBC classifies HPC calls using digits in the Request-URI of an initial INVITE request that match GETS-AN.
featureCode fc3-10 characters without visual separators4The SBC rejects HPC calls using strings in the Request-URI of an initial INVITE request that match GETS-FC.
numberTranslation nt3-10 digit number10The SBC classifies HPC calls using digits in the Request-URI of an initial INVITE request that match GETS-NT.



Tip
titleTip

For mor information on configuring hpcCallProfile getsStrings, refer to HPC Call Profile - CLI.

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
Display hpcCallProfile
Display hpcCallProfile
Display hpcCallProfile

Info
titleNote

The sample below shows a fully configured hpcCallProfile, as detailed HPC Call Profile - CLI. However, the hpcCallProfile configuration shown in the above sections of this page are minimal configurations.

 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;

anchor


External PSX Configuration

External PSX ConfigurationPSX Configuration

For information on PSX configuration, refer to the following pages:

Anchor


EMS

RAMP Configuration

EMS ConfigurationEMS Configuration

For information on the NW-HPC license, refer to the page Licensed Applications and Features on RAMP.