CLI Changes in This Release

New CLI in 8.1.0R0

SBX-73083 D-SBC should support m=application with "TCP"

Command Syntax

% set profiles media packetServiceProfile <DEFAULT> applicationStream maxNonRtpBandwidth <0...8000>

% set profiles media packetServiceProfile <DEFAULT> qosValues applicationDscp <0...63>

 Command Parameters

maxNonRtpBandwidth

SBX-39186 Support EVS Transcoding

Command Syntax

show profiles media codecEntry EVS
codec                          evs;
packetSize                     <20 | 40 | 60 | 80 | 100>;
preferredRtpPayloadType        <0 - 127>;
dtmf {
    relay       <relay_type>;
    removeDigits <disable | enable>;
}
useCompactHeader               <0 | 1>;
partialRedundancy              < -1 | 0 | 2 | 3 | 5 | 7 >;
EVSAMRWBIOModeSupport          <0 | 1>;
supportAsymmetricBitRate       <0 | 1>;
maxChannels                    <1 - 6>;
minBitRate                     <5.9 | 7.2 | 8 | 9.6 | 13.2 | 16.4 | 24.4 | 32 | 48 | 64 | 96 | 128>;
maxBitRate                     <5.9 | 7.2 | 8 | 9.6 | 13.2 | 16.4 | 24.4 | 32 | 48 | 64 | 96 | 128>;

New Parameter Value

% set profiles media packetServiceProfile <unique_profile_name>  packetToPacketControl
  
    codecsAllowedForTranscoding
        otherLeg <amr | efr | evrc | evs | g711a | g711u | g722 | g726 | g729 | g7221 | g7222 | g7231 | ilbc | opus | silk | t38>
        thisLeg <amr | efr | evrc | evs | g711a | g711u | g722 | g726 | g729 | g7221 | g7222 | g7231 | ilbc | opus | silk | t38>

SBX-70525 Support BFD for Link Detection

Command Syntax

Use the following command to set and configure the bfd parameter in an ipInterface.

set addressContext <addressContext_name> ipInterfaceGroup <lif_group_name> ipInterface <IP_interface_name> bfd <bfd_session_name> remoteIp <remote_IP_address> remotePort <remote_port_number> requiredMinRxInterval <1-50> desiredMinTxInterval <1-50> ceName <ceName> state <disabled | enabled>

Command Parameters

SBX-70668 Capability to Support OCSP Stapling on SBX

Command Syntax

Use the following command to configure the ocspStapling flag in the ocspProfile.

set profiles security ocspProfile <profile name> ocspStapling <disabled | enabled>

Use the following command to configure the ocspResponseCachingTimer parameter in the ocspProfile.

set profiles security ocspProfile <profile name> ocspResponseCachingTimer <1-30>

Command Parameters

SBX-76605 Error Response For INVITE/OPTIONS

Command Syntax

The SBC provisions the internalSipCauseMapProfile   to attach at the trunk group level. In addition, SBC can attach the internalSipCauseMapProfile profile to the signaling zone level. If the trunk group is in a disabled or out-of-service state, the SBC does not use this profile.

Create the internalSipCauseMapProfile and map causeMap to the sipcause by executing the command:

set profiles signaling sipCauseCodeMapping internalSipCauseMapProfile <internalSipCauseMapProfile> causeMap <causemap> sipCause                                                                             
Possible completions:
<SIP Cause value for a given Internal cause>
Enter value in range of 300-606>

Attach the internalSipCauseMapProfile profile to the trunk group by executing the command:

% set addressContext default zone <ZONE_INGRESS> sipTrunkGroup <SipTRunkGroup1> signaling causeCodeMapping                                                                            
Possible completions:
  cpcSipCauseMappingProfile             - The name of the CPC to SIP  mapping profile.                                        
  sipCpcCauseMappingProfile             - The name of the SIP to CPC cause mapping profile                                        .
  sipInternalCauseMappingProfile        - The name of internal cause to SIP mapping profile                                          
  useNonDefaultCauseCodeforARSBlackList - When enabled uses cause code 168 for mapping profile mapping profile

 % set addressContext default zone <ZONE_INGRESS> sipTrunkGroup <SipTRunkGroup> signaling causeCodeMapping sipInternalCauseMappingProfile <sipInternalCauseMappingProfile>

Attach the sipInternalCauseMappingProfile profile to the zone by executing the command:

% set addressContext default zone <ZONE_INGRESS> causeCodeMapping                                                                            
Possible completions:
 sipInternalCauseMappingProfile - The name of internal cause to SIP mapping profile                                          

% set addressContext default zone <ZONE_INGRESS> causeCodeMapping sipInternalCauseMappingProfile <sipInternalCauseMappingProfile>  

The SBC uses the existing profile InternalSipCauseMapProfile to define the new mapping entries of internal errors/failures to the SIP response code.

View the mapping entries by executing the command:

show profiles signaling sipCauseCodeMapping internalSipCauseMapProfile <internalSipCauseMapProfile> 

Command Parameters

SBX-66742 Custom User Groups on SBC

To overcome adding one rule at a time for a new group, the CLI command "aaarule-display-generatecli" to display the applicable rules for an existing group and get an equivalent output in a file containing CLI commands. The user then edits this file to define the new set of rules and source the updated file in CLI to assign rules to the new custom group.

aaarule-display-generatecli

Command Syntax

To create new rules, refer to Local Authentication - CLI

Create the new rules for the custom group by executing the command:

 aaarule-display-generatecli -h
usage: [--help|-h] [--administrator|-a] [--operator|-o] [--fieldService|-f] [--guest|-g] [--calea|-c] [--securityAuditor|-s] [--group <new group name>] --display|–cli
        --help|-h: Help for usage
        --administrator|-a: Prints Administrator rules
        --operator|-o: Prints Operator rules
        --fieldService|-f: Prints Field Service rules
        --guest|-g: Prints Guest rules
        --calea|-c: Prints Calea rules
        --securityAuditor|-s: Prints Security Auditor rules
        --cli: CLI output for any of the specified groups. At least one group must be given in argument.
        --display: Display rules for any of the specified groups. At least one group must be given in argument.
        --group: New group name. The rules will be applied to this group. Else the name will be derived from default group

The options allow you to display and/or create CLI output files for one or more groups at a time. The user group name is required and/or display (--display) or a cli (--cli) option as mandatory parameters.

If the –cli option is given, the SBC stores the CLI output in the user home directory and can modify it.

SBX-65775 Generate CDRs in Q-Series SBC CDR Format

The SBC Core provides new global configurations to enable generating CDRs in Q-SBC format, to enable checksum validation of the CDR files, and to specify call duration rounding policy. A user must have admin privileges to configure these options.

Command Syntax

The configuration options added to support generating CDRs in Q-SBC format have the following syntax. 

% set oam accounting qSbcCdr admin 
     addChecksum < disabled | enabled >    
     callDurationRoundUp <enabled | disabled>
     checksumKey <key>
     state  <disabled | enabled>

Command Parameters

SBX-74192 - SWe-Estimation-Framework Support

SWe traffic profiles support four parameters when creating custom SWe traffic profiles. These parameters provide additional options to characterize the anticipated call mix for a SWe system. 

Command Syntax

% set system SweTrafficProfiles <profile name>  
      mediaCostFactor <media factor>
      rxPPSFactor <Rx PPS factor> 
      sigCostFactor <signaling factor>
      txPPSFactor <Tx PPS factor>

Command Parameters

The following table describes the new parameters added to SWe traffic profiles.

SBX-86182 OAM Node - Phase 2

For SBC SWe cluster deployments operating in OAM configuration mode, new command parameters provide additional options for managing configuration changes when using the CLI.

The request system admin command supports three new parameters to manage configuration changes on the OAM node and a new show utility that outputs configuration change information in the form of transaction logs.

Command Syntax

The following statements show the syntax for the new request command options for managing configuration on the OAM node.

> request system admin <SYSTEM NAME> 
    discardCandidateConfiguration
    restoreRevision revision <revision number>
    viewConfigurationChanges
       revision <revision number>

The following statements show the syntax for the new show utils command options for listing the candidate configuration or changes for a specific revision.

> show utils transactionLog 
    revision <revision number>

Command Parameters

> show table system admin <system name>
     haMode <haMode1to1 | haModeNto1>

haMode1to1 

SBX-50090 SIP Priority Call Handling for GETS

• The parameter callQueuing is added to global. For detailed information refer to Call Queuing - Global - CLI.

  set global callQueuing queueLength <1-4096>

  
  

  callQueuing

  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

• The parameter hpcCallLimits is added to sipCacProfile. For detailed information, refer to SIP CAC Profile - CLI.

  set profiles sipCacProfile <profile_name> hpcCallLimits
      maxCalls <unlimited | blockAll | 1-1000>
      maxIngressRate <unlimited | 1-2000>
      ingressRateInterval <1-30>
      bucketSize <1-4000>

  
  

  hpcCallLimts

  Parameters	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 trunk group.	O
  maxCalls	N/A	unlimited	Use this parameter to configure the maximum number of simultaneous HPC calls. blockAll unlimited (default) <1-1000>	O
  maxIngressRate	N/A	unlimited	Use this parameter to configure the maximum rate of ingress HPC calls per interval minute. unlimited (default) <1-2000>	O
  ingressRateInterval	1-30	5	<1-30> - Use this parameter to configure the interval (in minutes) for the ingress rate of HPC calls.	O
  bucketSize	1-4000	10	<1-4000> - Use this parameter to limit the rate of received HPC calls.	O

• A new profile, dscpProfile, is introduced. For detailed information, refer to DSCP Profile - CLI.

  set profiles services dscpProfile <dscp_profile_name>
  	hpcDscpValue <0-63>
      dscpValue <0-63>
      state <disabled | enabled>

  
  

  dscpProfile 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. disabled (default) enabled	O

• The profile dscpProfile is also added under policyServer globalConfig. For detailed information, refer to Policy Server - CLI.

  set system policyServer globalConfig dscpProfile <profile_name>

• Many new parameters are added under hpcCallProfile, as described below. For detailed information, refer to HPC Call Profile - CLI.

  set profiles services hpcCallProfile <hpcCallProfile name>
  	dscp <egress | ingress>
  		useRecvdValue <diabled | enabled>
  	getsStrings            
  		accessNumber an <3-10 digits>
          featureCode fc <3-10 characters>
          numberTranslation nt <3-10 digits>
  	queue        
  		length <1-256>
          state <disabled | enabled>
          timeout <1-90>
  	rph         
  		egress
              nonEtsWps <dontInclude | include>
              validEtsWps <dontInclude | include>
  		ingress            
  			invalidEtsWps <ignore | reject>
              nonEtsWps <accept | ignore>
              validEtsWps <accept | ignore | reject>

  
  

  hpcCallProfile - new parameters

  Parameter	Description
  dscp	The SBC uses the DSCP value received in the initial INVITE for the DSCP marking of the SIP message.   egress - Use to relate dscp to the egress trunk group. Use the following flag for further configuration: useRecvdValue - When the HPC call profile attaches to a trunk group acting as an egress trunk group, use this flag to control DSCP marking for SIP messages the SBC sends forward (for example, INVITE or ACK). disabled (default) enabled ingress - Use to relate dscp to the ingress trunk group. Use the following flag for further configuration: useRecvdValue - When the HPC call profile attaches to a trunk group acting as an ingress trunk group, use this flag to control DSCP marking for SIP messages the SBC sends backward (for example, 18x or 200 OK). disabled (default) enabled
  getsStrings	A set of Government Emergency Telecommunications Service (GETS) Access Number (AN), Number Translation (NT), and Feature Code (FC) strings that the SBC uses to determine whether a call is an HPC call or is rejected. accessNumber an < 3-10 digits> - The SBC classifies HPC calls using digits in the Request-URI of an initial INVITE request that match GETS-AN. You can configure a maximum of 10 GETS-AN strings. featureCode fc < 3-10 characters without visual separators> - The SBC rejects HPC calls using strings in the Request-URI of an initial INVITE request that match GETS-FC. You can configure a maximum of 4 GET-FC strings. numberTranslation nt < 3-10 digits> - The SBC classifies HPC calls using digits in the Request-URI of an initial INVITE request that match GETS-NT. You can configure a maximum of 10 GETS-NT strings.
  queue	Use this parameter to configure HPC call queuing for trunk groups.   length <1-256> - Specifies the maximum number of calls that can simultaneously queue at each trunk group. Default: 5. state - Use this flag to enable or disable the queuing of HPC calls. disabled (default) enabled Note: Do not enable HPC call queuing for ingress and egress trunk groups simultaneously.   timeout<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. Default: 30. Note: When call is queued on the egress trunk group and the queue timer expires, the SBC sends a 408 response towards the ingress side to release the queued call. For the same scenario in a GW-GW call, the ingress SBC sends a 503 response instead of 408.    Note: By default, the SBC sends a response code 600 when the call queue is full. To configure the SBC to send the response code 503 when the call queue is full, execute  similar commands as described below:       % set profiles signaling sipCauseCodeMapping cpcToSipCauseMapProfile TEST baseProfile defaultCpcSip causeMap 161 sipCause 503       % set addressContext default zone ZONE1 sipTrunkGroup INGRESS_TG signaling causeCodeMapping cpcSipCauseMappingProfile TEST       % commit
  rph (not new; the parameters in the description are new)	egress - Determines how the SBC handles the ets and wps namespaces in the RPH (built by the SBC). nonEtsWps - Determines if the SBC includes or does not include namespaces other than ets and wps in the RPH (built by the SBC). dontInclude (default) include validEtsWps - Determines if the SBC includes or does not include valid ets and wps namespaces in the RPH (built by the SBC). dontInclude include (default) ingress - Determines how the SBC handles namespaces in the received RPH. invalidEtsWps - Determines if the SBC ignores or rejects invalid ets and wps namespaces in the RPH of an ingress SIP INVITE request. ignore (default) reject nonEtsWps - Determines if the SBC accepts or ignores namespaces other than ets and wps in the RPH of an ingress SIP INVITE request. accept (default) ignore validEtsWps - Determines if the SBC accepts, ignores, or rejects valid ets and wps namespaces in the received RPH. accept (default) ignore reject

• The following new statistics are added under show <table | status > global <callCountCurrentStatistics | callCountIntervalStatistics>:

  callCountCurrentStatistics and callCountIntervalStatistics

  Statistic	Description
  hpcQueueAttempts	The current number of HPC calls that the SBC successfully places in queues for HPC call queuing.
  hpcQueueOverflows	The current number of HPC calls for which the HPC call queuing attempts are unsuccessful because queues are full.
  hpcQueueAbandons	The current number of HPC calls that the SBC places in queues for HPC call queuing, but that the SBC abandons before the calls complete.
  hpcQueueTimeouts	The current number of HPC calls that the SBC removes from queues for HPC call queuing because the queue timeout timer expires.

  For detailed information, refer to Show Table Global.

  
  

• The following new statistics are added under show status addressContext <acName> zone <zoneName> sipPeerCacStatus <ipPeerName> <ipAddress> <port>:

  sipPeerCacStatus Statistics

  Statistic	Description
  totalIngressHpcCallsAllowed	The number of HPC calls allowed from an IP Peer.
  rejectsMaxIngressHpcCallRate	The number of HPC calls rejected from an IP Peer because the calls exceed the call rate limit.
  rejectsIngressMaxHpcCalls	The number of HPC calls rejected from an IP Peer because the calls exceed the maximum number of ingress calls.
  numActiveIngressHpcCalls	The number of ingress HPC calls allowed from an IP Peer.
  totalEgressHpcCallsAllowed	The number of egress HPC calls the SBC allows with an IP Peer.
  rejectsEgressMaxHpcCalls	The number of egress HPC calls the SBC rejects with an IP Peer because the calls exceed the maximum number of ingress calls.
  numActiveEgressHpcCalls	The number of egress HPC calls the SBC allows with an IP Peer.

  For detailed information, refer to Show Status Address Context - Zone.

  
  

• The following statistics are added under show status addressContext <acName> zone <zoneName> <sipIntervalStatistics | sipCurrentStatistics>:

  sipCurrentStatistics and sipIntervalStatistics

  Statistic	Description
  inHpcAccept	The number of received initial INVITEs that the SBC processes as an HPC call. The SBC counts this number regardless of whether the call succeeds or fails.
  outHpcAccept	The number of sent initial INVITEs that the SBC processes as an HPC call.
  hpc403Out	The number of HPC calls that the SBC rejects with a SIP 403 message.
  hpcOverloadExempt	The number of HPC calls that the SBC exempts from dropping because of overload processing.

  For detailed information, refer to Show Status Address Context - Zone.
  
  

  
  

SBX-76034 Support for CPU+GPU Hybrid Transcoding Instances

The following changes are applicable for SBC SWe on Openstack and KVM, particularly GPU-ISBC and GPU-TSBC:

• A new codec G7112G711 is introduced in the list of supported codecs in sweCodecMixProfile . The percentage value of this parameter indicates the proportion of total number of sessions designated for pure G711 transcoding (G711-G711). This is applicable for Hybrid Transcoding, as well as pure CPU transcoding solutions.

  Note

  The percentage value for G7112G711 is used for estimating transcode and bandwidth cost.

  The percentage value for G711 is not used for estimating transcode cost, but is used for bandwidth calculation of PXPAD scenarios.

  The percentage value for G711 cannot be greater than the percentage value of non-G711 codecs.

  The sum of all codec percentages is 100.

  Note

  DSP-based Tone detection is supported only on GPU-ISBC profile.

• The existing codec T38 is added as a supported codec in sweCodecMixProfile.

  Note

  With the enhancements mentioned above, the following CPU and GPU codecs are supported for SBC SWe on Openstack and KVM:

          GPU + CPU codecs : AMR-NB, AMR-WB, EVRC, EVRCB, G729, G722, G711

          CPU only codecs :  G723, G726, G7221, ILBC, OPUS, SILK_8, SILK_16, EVS, G7112G711, T38

  Note that you can provision CPU codecs in the codec profile and associate it with the GPU traffic profile; however, you must provision at least one GPU codec in the sweCodecMixProfile.

• For sweCodecMixProfile:
  

  • p80 and p100 are added to the list of supported packetization time values (ptime value), indicating 80ms and 100ms of packetization times respectively.

    Note

    For SBC SWe Cloud 8.1, ptime values p80 and p100 are not tested.

  • Floating point values are supported as percentage values; the allowed percentage range is 0.00-100.00. Prior to the enhancement, only integers were supported.
    
    
• For sweTrafficProfiles, a new parameter useGPUForTranscoding is added.

Command Syntax

For the enhancements mentioned above, the following syntax shows a valid configuration:

• sweCodecMixProfile

  % set system sweCodecMixProfile <profile_name>
      < codec: all_cuurently_applicable_codecs | G7112G711 | T38 > 
      < ptime value: p10 | p20 | p30 | p40 | p60 | p80 | p100 >
      percentage < percentage value range: 0.00 - 100.00 >

  Note

  For SBC SWe Cloud 8.1, ptime values p80 and p100 are not tested.

• sweTrafficProfiles

  % set system sweTrafficProfiles <profile_name> 
      transcodePercent <percent>
      transcodingCodecProfile <profile_name>
      useGPUForTranscoding <false | true>

Command Parameters

SBX-73700 IMS LI Server Load Sharing

The CLI changes are as follows:

• You can configure a maximum of 16 mediation servers.
• The parameter dsrProtocolVersion is added to callDataChannel
• groupTwoThousand is added as a vendorId

Command Syntax

% set addressContext <address_context> intercept callDataChannel <CDC_name>
    mediationServer <server_1> ... <server_16>
    dsrProtocolVersion <protocol_version>
	vendorId <existing vendor ids | groupTwoThousand>
	mediaIpInterfaceGroupName <media_Ip_Interface_Group_Name> 
	ipInterfaceGroupName <ip_Interface_Group_Name>

Command Parameters

SBX-71966 Call Trace to Capture SIPREC Legs

The flag sipRecLegsCapture is introduced under callFilter parameter of the global callTrace object. 

Command Syntax

% set global callTrace callFilter <callFilterName> sipRecLegsCapture <disable | enable>

Command Parameters

SBX-70429 IMS LI: Buffering DSR Messages when Mediation Server Connection is Down

The CLI changes are as follows:

• The show command described below displays signaling and media statistics information for a maximum of 16 mediation servers, as configured by an authorized CALEA user. Note that no new statistics are added; the existing statistics display for up to 16 configured mediation servers.
• The parameter dsrProtocolVersion is added to callDataChannel
• groupTwoThousand is added as a vendorId
  

Command Syntax

For signaling status:

> show status addressContext <address_context> intercept callDataChannel <CDC_name> mediationServerSignalingStatus <mediation_server_1> ... <mediation_server_16>

For media status:

> show status addressContext <address_context> intercept callDataChannel <CDC_name> mediationServerMediaStatus <mediation_server_1> ... <mediation_server_16>

For Call Data Channel, the show command displays the parameter dsrProtocolVersion:

> show addressContext <address_context> intercept callDataChannel <CDC_name>

interceptStandard         threeGpp;
vendorId                  groupTwoThousand;
ipInterfaceGroupName      LIF2;
liPolDipForRegdOodMsg     enabled;
rtcpInterception          enabled;
mediaIpInterfaceGroupName LIF2;
dsrProtocolVersion        1;

Command Parameters

SBX-53178 D-SBC: Support Legacy LI, IMS LI and P-DCS-LAES LI

The CLI of D-SBC (S-SBC and M-SBC) is enhanced with commands to configure Default LI and IMS LI. This enhancement is in addition to the existing support for PSCI LI.

Command Syntax

To provision IMS LI on S-SBC, configure the Signaling (X2) interface using the two commands shown below:

% set addressContext <address context name> intercept callDataChannel <CDC Name> 
    interceptStandard <IMS LI supported Value> 
    vendorId <IMS LI Supported Values> 
    ipInterfaceGroupName <LIF Group information>

% set addressContext <address context name > intercept callDataChannel <CDC Name> 
    mediationServer <mediation server name> signaling
      ipAddress <ip address of mediation server> 
      portNumber <port number of mediation server> 
      protocolType <tcp | udp>

To configure IMS LI on M-SBC, configure the Media (X3) interface using the two commands shown below:

% set addressContext <address context name> intercept callDataChannel <CDC Name> 
    interceptStandard <IMS LI flavor> 
    vendorId <IMS LI Falvour> 
    mediaIpInterfaceGroupName <LIG1 from where data is sent>

% set addressContext <address context name> intercept callDataChannel <CDC Name> 
    mediationServer <mediation server name> media <transport type> 
      ipAddress <ip address of mediation server> 
      portNumber <port number of mediation server>

To configure Default LI on S-SBC:

% set addressContext <address context name> intercept callDataChannel <CDC Name>
    interceptStandard <Default LI supported Value> 
    vendorId <Default LI Supported Values>
    ipInterfaceGroupName <LIG1 from where data is sent>
    priIpAddress <IPv4 address> 
    priPort <port>
    priState <disbled | enabled>
    priMode <active | outofservice | standby>

To configure Default LI on M-SBC:

% set addressContext <address context name> intercept callDataChannel <CDC Name> 
    interceptStandard <Default LI supported Value> 
    vendorId <Default LI Supported Values>

SBX-50524 Prioritize GETS-related Ingress Packets Based on Provisioned DSCP

A new profile, dscpProfile, is added to services. The parameters associated with dscpProfile are as follows:

• dscpValue
• hpcDscpValue
• state

For DSCP marking of DIAMETER+ packets, associate the DSCP profile with the policy server (policyServer globalConfig).

Command Syntax

To configure DSCP values for HPC and non-HPC calls, use the following syntax:

% set profiles services dscpProfile <dscp_profile_name> 
    dscpValue <dscp_value> 
    hpcDscpValue <hpc_dscp_value> 
    state <disable | enable>

To associate the DSCP profile with the policy server for DSCP marking of DIAMETER+ packets, use the following syntax:

% set system policyServer globalConfig dscpProfile <dscp_profile_name>

Command Parameters

Configuration Examples

To configure DSCP values for HPC and non-HPC calls, refer to the following example:

% set profiles services dscpProfile test_dscp_profile dscpValue 36 hpcDscpValue 18 state enabled

To associate the DSCP profile with the policy server for DSCP marking of DIAMETER+ packets, refer to the following example:

% set system policyServer globalConfig dscpProfile test_dscp_profile

To reserve a part of the Media Port Range (MPR) and LIF bandwidth for GETS/HPC calls on media-bearing SBC platforms, use the following command syntax:

% set system media mediaPortRange highPriorityPortRangeLocation <bottom | top> highPriorityPortRangeSize <0-25>

The percentage specified as highPriorityPortRangeSize is used as the High Priority reserve for both MPR and LIF bandwidth.

For more information on Media Port Range, refer to Media System - CLI.

Best Practice

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.

SBX-50523 SIP Call Queuing for GETS

The SBC CLI is enhanced with the following:

• The queue object, with its parameters and flags, are added to the profile services hpcCallProfile:
  • queue
    • length
    • timeout
    • state
• The callQueuing object, with its parameter queueLength, are added to global:
  • callQueuing
    • queueLength

• The commands show status global callCountCurrentStatistics and show status global callCountIntervalStatistics displays the following new statistics related to this feature:

  • hpcQueueAttempts

  • hpcQueueOverflows

  • hpcQueueAbandons

  • hpcQueueTimeouts

Command Syntax

hpcCallProfile queue

% set profile services hpcCallProfile <hpc_call_profile> 
    queue 
      length <queue_length_value> 
      timeout <queue_timeout_value> 
      state <disable | enable>

global callQueuing

% set global callQueuing queueLength <queue_length_value>

Command Parameters

• The parameters and flags for the new object queue under hpcCallProfile are as follows:

  hpcCallProfile queue

  Parameter	Length/Range	Default	Description	M/O
  queue	N/A	N/A	Use this object to configure queuing of HPC calls at the trunk group level. The associated parameters and flags are as follows: length - Specifies the maximum number of calls that can be simultaneously queued at each trunk group. The allowed values are integers in the range 1-256; default is 5. timeout - Specifies the maximum time (in seconds) for which a HPC call remains queued, before the attempt to connect the call in the associated trunk group is abandoned. The allowed values are integers in the range 1-90; default is 30. state - Enable the state to start queuing HPC calls. The options are: disable (default) enable	O

• The parameters for the new object callQueuing under global are as follows:

  global callQueuing

  Parameter	Length/Range	Default	Description	M/O
  callQueuing	N/A	N/A	Use this object to configure queuing of HPC calls at the global level. The associated parameters and flags are as follows: queueLength - Specifies the maximum number of HPC calls that can be queued by the SBC, combining all trunk groups. The allowed values are integers in the range 1-4096; default is 1024.	O

SBX-86049 SLB Phase 2

Enables, disables, and configures the SBC for use with the SIP Aware Front End Load Balancer (SLB). See SIP-Aware Front-End Load Balancer for a feature overview.

Command Syntax

% set system slb
    usage <disabled | enabled>
    commInterface <>
    slbIpAddress <>
     
  
% set system addressContext <zone> <slbZoneName

Command Parameters

SBX-85753 Remove Policing Function From the SBC

New CLI lets you:

• allow or deny overflow packets based on certain criteria (spikeAction), and
• configure a timer (bwOverloadAlarmTimer) to trigger an alarm every "X" seconds when non-conforming packets are detected..

Command Syntax

Command Parameters

Configuration Example

% set oam traps admin sonusSbxMediaOverFlowPacketsNotification state disable
% set oam traps admin sonusSbxMediaOverFlowPacketsCleared state disable

Deprecated CLI

SBX-86182 OAM Node - Phase 2

Only the clusterComm parameters under system clusterAdmin remain user-configurable and these options apply only to M-SBC instances within a distributed SBC deployment. The clusterAdmin options listed below are no longer visible in the CLI.

% set system clusterAdmin  
      dataComm    
      discoveryComm
      seedFqdn    
      seedIpAddress
      state