Page History

New CLI in 7.

1.0R0

SBX

New CLI commands have been introduced, all except gpuStatus are available only on SWe except ssbc SWe.

• show table system gpuTranscodeStatus – Shows codec channel capacities on a per GPU device basis. 
• show table system cpuTranscodeStatus – Shows codec channel capacities specifically for CPU UXPADs. This command is applicable for instances that support hybrid transcoding, in which both CPU UXPADs and GPU UXPADs are used.

• show table system transcodeInfo transcodeType – Shows type of transcoding used: GPU, CPU or Mix of CPU + GPU. This is system level information and we show only 1 entry in case of HA system.

• show table system transcodeInfo cpu – Shows CPU cores used for transcoding. This is system level information and we show only 1 entry in case of HA system.

• show table system transcodeInfo gpu – Shows type of GPU, XPADs/CPU used with this GPU, name of GPU, GPU allocation ratio.

• show table system gpuStatus – Shows data per node for each GPU (attached to the node). Prints server name and GPU number.

.

> show table system gpuTranscodeStatus

> show table system cpuTranscodeStatus

> show table system transcodeInfo transcodeType

> show table system transcodeInfo cpu

> show table system transcodeInfo gpu

> show table system gpuStatus

SBX-23176/25431/41572/45241/47630 Licensing Features

Beginning with SBC Core release 7.0, the SBC is configured in legacy license mode by default. The “local” and “network” options for license mode that were supported on SBC SWe in prior releases are being phased out. Options to change license mode through the CLI are no longer available as of release 7.0. Although some references to local license mode remain in documentation, the CLI, or the EMA UI, local license mode is not supported.

If your SBC SWe deployment was configured to use network license mode in a prior release, the tools to monitor and configure network-mode licensing remain available in release 7.0, but will be phased out in the future. Information needed to maintain network license mode is still provided. Contact your Ribbon Sales Representative for more information and assistance in updating your license.

This release provides visibility in the license utilization within the SBC. SBC provides new statistical information on the types of call traffic occurring on the SBC. Current and interval call counts are provide for a range of session types such as SRTP, NICE, enhanced video, transcoding, and SIPREC.

This release also provides information on license status on a per feature basis through both the CLI and through the EMA user interface.  For more details and an example of the output, see the description of the show table system licenseFeatureStatus command on the Show Table System page in the CLI Reference Guide or the System - License Feature Status page in the EMA User Guide.

.

SBX-46075 Support for Multiple m-lines in SDP

The following flag is added to media parameters within SIP trunk groups to control whether the SBC processes multiple audio m-lines, or a combination of audio and image m-lines, in SDP:

• multipleAudioStreamsSupport

After you enable the multipleAudioStreamsSupport option, then you have the option to enable the following media parameter within SIP trunk groups to disallow SRTP streams when they are present in incoming SDP:

• disallowSrtpStream

% set addressContext <address context name> zone <zone name> sipTrunkGroup <TRUNKGROUP NAME> media multipleAudioStreamsSupport <disabled | enabled>
% set addressContext <address context name> zone <zone name> sipTrunkGroup <TRUNKGROUP NAME> media disallowSrtpStream <disabled | enabled>

SBX-48862 Send All Supported Codecs as OFFER in 200 OK to Late Media Re-INVITE for Pass-Through/Transcoded Calls

The following flag is added to IP Signaling profiles to configure the SBC to respond with an offer in SDP that includes the full set of codec possibilities based on the ingress and egress PSPs, including those enabled by transcoding, when it receives a late media Re-INVITE request.

• sendSBCSupportedCodecsForLateMediaReInvite 

This flag takes precedence over the sendAllAllowedCodecsForLateMediaInviteOrReInvite flag and the sendOnlyPreferredCodec flag in the IP Signaling profile. The SIP trunk group media flag lateMediaSupport must be set to convert for the behavior enabled by the sendSBCSupportedCodecsForLateMediaReInvite  flag to apply.

set profiles signaling ipSignalingProfile <IPSP profile name> commonIpAttributes flags sendSBCSupportedCodecsForLateMediaReInvite <disable | enable>

SBX-51006 IP Peer Statistics Enhancement

The following parameters are added to the zone to provide the current and interval statistics for each IP peer:

• ipPeerCurrentStatistics
• ipPeerIntervalStatistics

> show status addressContext <addressContext> zone <zone> ipPeerCurrentStatistics 
> show table addressContext <addressContext> zone <zone> ipPeerCurrentStatistics

> show table addressContext <addressContext> zone <zone> ipPeerIntervalStatistics 
> show status addressContext <addressContext> zone <zone> ipPeerIntervalStatistics

The teardown parameter is added to message type of the sipAdapterProfile.

% set profiles signaling sipAdaptorProfile <sipAdapterProfile> rule <rule index> action <action index> type message operation teardown message teardown responseCode <100 | 699>

 request sbx nrm debug command "setirttaudit [dumpraw enable|disable] [repeat n] [sensit off|mc1|mc2|mc3|badirtt|unconditional]"

% set profiles aorGroupProfile <aorGroupProfile>
   aorDataList <Aor Data>
   aorDialogAttribute <useFirst18x | useLast18x>
   preferredIdentity <Input PreferredIdentity (urischeme:user@host) for AoRs Group>
   waitForAnswer <0 to 300000>

% set profiles voipSubscriber <Input Voip Subscriber(uri-scheme:user@host)>
   aorGroupProfile <AoRGroup ProfileId>
   egressRURIAttribute <aorEgress | calledURI>

% set addressContext <addressContext> zone <zone> sipTrunkGroup <sipTrunkGroup> policy preferredIdentity <disable | enable>

SBX-55466/SBX-63681/SBX-62949 P-Early Media to Alert-Info Header Interworking

The SBC supports interworking between a network supporting P-Early Media (PEM) header to a network supporting Alert-Info (AI) header. To support this functionality, the flag aiToPemInterworking is used in the IP Signaling Profile. 

The following flags are added:

• monitorRTP

•  earlyMediaMethod  


  • withOrWithOutSDP

• monitorRtpOnEgressUpdate

The following flags are modified:

• aiToPemInterworking 
  
• defaultGatingMethod

Monitor RTP

set addressContext <addressContext> zone <zone> sipTrunkGroup <sipTrunkGroup> media earlyMedia method pEarlyMedia monitorRtp <disabled | enabled>

 Early Media Method and With Or WithOut SDP

% set profiles media toneAndAnnouncementProfile <toneAndAnnouncementProfile> localRingBackTone signalingTonePackageState enable flags useThisLrbtForIngress enable
  earlyMediaMethod <none | pEarlyMedia>
       withOrWithOutSDP <disable | enable>

Monitor RTP on Egress Update

set profiles signaling ipSignalingProfile <ipSignalingProfile> egressIpAttributes flags monitorRtpOnEgressUpdate <disable | enable>

AI to PEM Interworking

set profiles signaling ipSignalingProfile <ipSignalingProfile> DEFAULT_SIP commonIpAttributes flags aiToPemInterworking <enable | disable>

Default Gating Method

set addressContext default zone <zone> sipTrunkGroup <sipTrunkGroup> media earlyMedia method pEarlyMedia defaultGatingMethod <inactive | none | recvonly | sendonly | sendrecv>

SBX-56801 Charge Rate Information in J-ISUP to Non-Japanese ISUP Call Scenarios

The following flag is added to the isupSignalingProfile.

• chargeRateInfoForCpcApc

The chargeRateInfoForCpcApc parameter is added to the ISUP Signaling Profile (isupSignalingProfile) to determine whether the SBC checks for specific payphone-related characteristics in J-ISUP to non-Japanese ISUP calls to trigger using different charge rate information (CRI).

set profiles signaling isupSignalingProfile <profile_name> chargerateinfoForCpcApc <unsupported | supported>

SBX-56956 Convert ANM to CPG

The control parameter cpgReleaseTimer is added to the isupSignalingProfile configuration. 

• The cpgReleaseTimer control can have a value of 0 - 300 (seconds)
• Default value for the cpgReleaseTimer  parameter is 0
• Values greater than 0 can be configured only on JAPAN based profiles with revision of nttfcc or nttcom, for other revisions, attempting to set the value to greater than 0 shall give an error message.

set profiles signaling isupSignalingProfile <profile_name> [ cpgReleaseTimer  <0-300>]
   and
show profiles signaling isupSignalingProfile <profile_name> cpgReleaseTimer

SBX-57496 Signaling Only SBC - Phase 1

The following global parameter controls whether the SBC is in signaling-only mode:

• sigOnlyModeValue  <global | off>

set global signaling sigOnlyMode sigOnlyModeValue <global | off>

SBX-58959 Displaying, exporting, and importing configuration committed by users

Three commands have been added to the CLI toolbox in order to:

1. Address the need for users to isolate the user configuration by removing the Sonus-seeded configuration from the display.
2. Manage the configuration as plain XML files.

user-config-export

user-config-export
   <filename>
   <xpath>

user-config-import

user-config-import
   <filename>

user-config-show

user-config-show
   <optional argument XPath>

SBX-60032 NNI-SBC Supports Ping and Traceroute on CLI

The SBC is enhanced to include the native Linux commands ping and traceroute (and their IPv6 variants) from the SBC command line interface. To use the commands at the SBC application level, log on to the SBC as an application administrator.

ping

ping
    [-LRUbdfnqrvVaAD]
    [-c <count>]
    [-i <interval>]
    [-w <deadline>]
    [-p <pattern>]
    [-s <packetsize>]
    [-t <ttl>]
    [-I <interface>]
    [-M <pmtudisc-hint>]
    [-m <mark>]
    [-S <sndbuf>]
    [-T <tstamp-options>]
    [-Q <tos>]
    [hop1 ...]
    <destination_IPv4_or IPv6 address>

traceroute

traceroute
    [ -46dFITnreAUV ]
    [ -f <first_ttl> ]
    [ -g gate,... ]
    [ -i <device> ]
    [ -m <max_ttl> ]
    [ -N <squeries> ]
    [ -p <port> ]
    [ -t <tos> ]
    [ -l <flow_label> ]
    [ -w <waittime> ]
    [ -q <nqueries> ]
    [ -s <src_addr> ]
    [ -z <sendwait> ]
    [ --fwmark=<num> ]
    host
    [ <packetlen> ]

SBX-60475 Align access to Amazon Web Services Marketplace

Earlier versions of the SBC were shipped with a hard-coded CLI admin user password. Initial passwords are now changed: 

• The SBC's Linuxadmin has keypair-based ssh access on Port 2024. 
• In an HA pair, the CLI Admin's default password is the name of the  eth0 interface ID of the instance, as assigned by the template. This password must be changed on first use.

In this version, the default CLI admin password is the value of the active role assigned instance's primary interface-id (Mgt0InterfaceIDActive). The active role of the instance is assigned in the cloud formation template (CFT). You can find the active role assigned instance's primary interface-id (Mgt0InterfaceIDActive) on the AWS stack output.

SBX-61252 IPSec/IKE supported on X2 interface when the variant Legacy LI is used

Lawful Intercept is a security process in which the service provider provides law enforcement entities access to communications of individuals or organizations. For details on SBC Core implementation of this process, see Lawful Intercept. The SBC Core platforms now support IPsec/IKE on the X2 interface when the variant "Legacy LI" is used. 

Configure the ipSec Peer

set addressContext <addressContext name> ipsec peer <peer name>
   ipAddress <ipAddress>
   localIdentity <fqdn | ipV4Addr | ipV6Addr>    
   preSharedKey <DES3 encrypted string>

Configure the ipSec SPD

set addressContext <addressContext name> ipsec spd <spd_name>
    action <bypass | discard | protect>
    localIpAddr <ipAddress>
    localIpPrefixLen <0-128>
    localPort <0-65535>
    mode <transport | tunnel>
    precedence <0-65535>
    protocol <0-255>
    remoteIpAddr <ipAddress>
    remoteIpPrefixLen <0-128>
    remotePort <0-65535>
    state <disabled | enabled>

SBX-61693 Additional SIP and RTP Statistics for Ribbon Protect

The SBC is enhanced with additional statistics and alarms for detected signaling and security events. These enhancements are designed to improve Ribbon Protect and SBC security reporting and analysis. Potential SIP and RTP flooding, footprinting, and authentication attacks are reported through new statistics, CDR enhancements, and the introduction of offenders lists that can be configured to report at desired intervals.

srtpDecryptOffendersList

 show table system ipPolicing srtpDecryptOffendersList

srtpDecryptOffendersIntStats

show table system ipPolicing srtpDecryptOffendersIntStats

SBX-62096/SBX-62245: Simultaneous Session Recording of SIP Ingress and Egress Call Legs

SRS Group Cluster added to the Global - Servers object.

The Length/Range parameters for srsGroupProfile and startRecord are changed to account for four recordable streams versus the previous two.

srsGroupProfile

set global servers srsGroupProfile <srs_group_id>
loadDistribution <roundRobin | sequence>
numSimultaneousStream <range 1..2> srsGroupData <Priority range 0..7>
ipAddress <signaling ipv4/ipv6 address of the SRS> ipPort <signaling port of the SRS>
ipTGId <Ip Trunkgroup Id> transport <udp/tcp/tls>

startRecord

request global siprec startRecord numOfStreams <range 1..4> trunkGroup <SIPREC_TrunkGroup_Name>
srsIpAddress <RecordingServerIP> srsPort <RecordingServerPort>
srsIpAddrress2 <SecondaryRecordingServerIP> srsPort2 <SecondaryRecordingPort>
trunkGroup2 <SIPREC_TrunkGroup2_Name> gcid <gcid_value>
callLeg <Ingress|Egress> transport <udp | tcp | tls> transport2 <udp | tcp |tls>

SBX-65229 Add DNS Crankback Details to Documentation

Documentation now includes configuration notes to allow the SBC to use crankback for DNS.

• dnsCrankback needs to be enabled on the egress sipTrunkGroup, and 
• crankbackProfile assigned to the egress sipTrunkGroup is used for DNS crankback, and
• The SBC maps the received SIP response from the egress call leg using the sipToCpcCauseMapProfile from the egress sipTrunkGroup. The CPC cause is then looked up in the egress sipTrunkGroup's crankbackProfile. If a match is found, the SBC attempts a new target. If a match is not found, the SBC skips the DNS crankback and proceeds with the "normal" crankback at CC level using the ingress siptrunkGroup's crankback profile.

SBX-67416 Limit default admin to local auth only / show radius user details

The following flag is added to the system admin table to specify whether the default admin user must be authenticated using local authentication.

• defaultAccountLocalOnly

For this flag to be set to true, the system admin options localAuthenticationEnabled and externalAuthenticationEnabled must also be set to true to enable the use of local authentication on the SBC.

defaultAccountLocalOnly

set system admin <system name> defaultAccountLocalOnly < false | true >

show table system admin <system name> defaultAccountLocalOnly

SBX-67602 Remove Unhide System From the SBC

The parameter deviceSmartAttrib is added to system serverAdmin <server name>.

serverAdmin

set system serverAdmin <name> deviceSmartAttrib <integer>

Deprecated CLI

-1372 Support for NASS-IMS-Bundled Authentication

NASS-IMS-Bundled-Authentication (NBA) is used to provide access to the IMS (IP Multimedia Subsystem) network for legacy equipment that cannot support IMS access security (IMS AKA). The authentication algorithm is enhanced to include and select NBA authentication. 

The main objective of the NBA is to gain access to the IMS network, based on successful access level authentication. This is achieved by associating an IMS identity with a fixed specific location from where it is authorized to access from. The SBC Core infers an authentication scheme applicable to the user based on response from S-CSCF for initial REGISTER request. If S-CSCF selects NBA, it either sends 200 OK or 403 response. The SBC infers an NBA authentication scheme on receipt of 200 OK and follows procedures associated with NBA. So, P-CSCF switches to either NBA or SIP Digest w/o TLS based on S-CSCF's response. When NBA is in use, receiving a 401 (Unauthorized) response to the REGISTER request is not expected.

When P-CSCF receives a REGISTER from the UE, and once NBA is selected as the authentication scheme, P-CSCF contacts CLF over the e2 interface. P-CSCF performs a"Location Information Query" towards CLF using the E2 interface User-Data-Request and User-Data-Answer message exchange to learn the location information. CLF sends the response to P-CSCF including location information of UE using the given IP address / User-Name. Upon getting a response from CLF, P-CSCF inserts PANI header, appends NASS location information to SIP REGISTER message, and forwards REGISTER message towards IMS core, in order to authenticate UE. 

The following parameters configure this feature:

• container <nassImsAuth> allows configuration related to NASS
• under container <nassImsAuth>, under <accessType>, <xDSL>, <ethernet> and <fiber> provision IP connectivity access associated with TISPAN NASS
• The <accessClass> parameter, when configured to <tispan-NASS>, allows the SBC to identify if the request arrived on TISPAN NASS
• value e2 enhances <appId> to provision the diameter e2 interface
• <clfRealm> allows configuration so the UDR message sent has a destination realm AVP with a CLF realm value
• <ueDefaultLocation> specifies the default UE location name

The <nassImsAuth> parameter is a new container, allowing configuration related to NASS. Under <nassImsAuth> are:

• <accessType>
  • <ethernet>
  • <xDsl>
  • <fiber>
• <clfRealm>
• <ueDefaultLocation>

The existing <accessClass> is enhanced with a new value, tispan-NASS

The existing <appId> is enhanced with a new value, e2

 % set addressContext <addressContext name> zone <zone name> sipTrunkGroup <sipTrunkGroup name> signaling accessClass
  ac-3GPP 
  none 
  tispan-NASS
 
 
% set addressContext <addressContext name> zone <zone name> sipTrunkGroup <sipTrunkGroup name> signaling nassImsAuth      
  accessType         
  clfRealm          
  ueDefaultLocation
   
  
% set addressContext <addressContext name> zone <zone name> sipTrunkGroup <sipTrunkGroup name> signaling nassImsAuth accessType
  ethernet  <ieee-802-3 | ieee-802-3a | ieee-802-3ab | ieee-802-3ae | ieee-802-3ak | ieee-802-3an | ieee-802-3aq | ieee-802-3e | ieee-802-3i | ieee-802-3j | ieee-802-3u | ieee-802-3y | ieee-802-3z>
  fiber   <g-pon | ieee-802-3ah | xgpon1>
  none 
  xdsl <adsl | adsl2 | adsl2Plus | g-hdsl | hdsl | hdsl2 | idsl | radsl | sdsl | vdsl>
  
  
% set addressContext <addressContext name> zone <zone name> sipTrunkGroup <sipTrunkGroup name> signaling nassImsAuth clfRealm  <1-128 chars>
  
  
% set addressContext <addressContext name> zone <zone name> sipTrunkGroup <sipTrunkGroup name> signaling nassImsAuth ueDefaultLocation <1-64 chars>
  
  
% set addressContext <addressContext name> diamNode <diameterNode name> realmRoute <realmRoute name> appId <e2 | rf | rx>

SBX-3281 ARP Probes for Link Failure Detection for SWe

The SBC SWe supports two levels of link detection for both standby and active Ethernet ports to monitor the health of the ports and to ensure the health of a standby port before initiating a switchover to it. By default, physical link detection is enabled on all ports configured in Link Monitor. This default mechanism checks for the presence of the cable and that the adjacent device is powered on. If hardware failures are detected they are reported to the SBC processes that monitor ports and a switchover can be triggered if the standby port is available.

A second level of link detection can be enabled that checks connectivity between a port and and a configured destination. The specific mechanism used to check the port depends on the whether the port is in an active or standby state. These probing mechanisms for link detection are available regardless of the number of ports attached to the SWe instance.

The current description for the probeOnStandby flag (under linkMonitor) is expanded to account for port redundancy as shown below. This description covers both SWe and non-SWe use of the option.

SBX-40513 Independent Crankback Control for Route list and 3XX contact list

Crankback functionality is triggered based on the presence, absence, or value of a SIP information element, for example, a proprietary header, parameter, or response code. This is provided by enhancing SMM capabilities. 

To invoke crankback functionality, SMM is enhanced to include a predefined SMM variable for crank-back invocation. The SMM variable is assigned to one of the predefined action values. To invoke crank-back functionality, the SMM rule is added so that "nextRouteActionOnCrankBack" is set to a predefined action value. Whenever the SMM rules are met, the SBC takes crankback action based on the action value. The user can assign value to this using SMM rules. 

The parameter nextRouteActionOnCrankBack is a predefined SMM operation parameter that configures crankback invocation for this feature. 

Under this parameter are two options, <actionType> and <generateAttemptRec>.

Under <actionType>, the options <none>, <SkipRemainingRoutes>, <DisconnectCall>, and <AttemptNextRoute> determine how crankback is performed. 

Under <generateAttemptRec>, the options <true> and <false> determine if the attempt record will be generated for crankback attempts. 

The nextRouteActionOnCrankBack SMM operation parameter is added. Under it are:

• <actionType>
  • <skipRemainingRoutes>
  • <disconnectCall>
  • <attemptNextRoute>


• <generateAttemptRec> 
  • <true> 
  • <false> 

% set profiles signaling sipAdaptorProfile <profile name> rule <index> action <index> operation nextRouteActionOnCrankBack
  
% set profiles signaling sipAdaptorProfile <profile name> rule <index> action <index> message
  
% set profiles signaling sipAdaptorProfile <profile name> rule <index> action <index> message nextRouteActionOnCrankBack actionType < None | AttemptNextRoute | SkipRemainingRoutes | DisconnectCall>
  
% set profiles signaling sipAdaptorProfile <profile name> rule <index> action <index> message nextRouteActionOnCrankBack generateAttemptRec <true | false>

SBX-42524 and SBX-53799 Emergency Call Handling for the Roaming Users in S8HR Model

The S8 Home Routing (S8HR) uses the LTE S8 interface for transporting VoLTE traffic between the visited and home network as data traffic. The S8HR does not require IMS in the visited LTE network. In S8HR roaming architecture model of VoLTE, the Packet Data Network Gateway (PGW), Policy Charging and Rules Function (PCRF), and Proxy Call Session Control Function (P-CSCF) are in the Home Public Land Mobile Network (HPLMN) when the UE is roaming in a Visited Public Land Mobile Network (VPLMN). The S8HR roaming architecture provides all the IMS services to the UEs roaming in the VPLMN. In this scenario, the UE does not require any IMS network to network interface (NNI) between the VPLMN and HPLMN. A roaming user receives all the services of the home network in the S8HR model. In S8HR roaming model, the IMS/SIP/RTP traffic is tunneled back to the HPLMN like data traffic.

The visited S8HR user is authenticated using the GPRS-IMS-Bundled Authentication (GIBA) procedure and handles the emergency call. The flags s8hrSupport and gibaSupportForS8hrInboundUserare added to the SIP Trunk Group to support the emergency call handling for S8HR model.

To support the emergency call in S8HR model, execute the following command:

% set addressContext <addressContext> zone <zone> sipTrunkGroup <sipTrunkGroup> signaling s8hrSupport <disabled | enabled>

To configure the VPLMN  and HPLMN profiles, execute the following command:

% set profiles services
  hplmnProfile <profileName> hplmnId <plmn id>
  vplmnProfile <profileName> vplmnId <plmn id> emergencyPrefix <prefix id>

To configure the flag gibaSupportForS8hrInboundUser, execute the following command:

% set addressContext <addressContext> zone <zone> sipTrunkGroup <sipTrunkGroup> signaling gibaSupportForS8hrInboundUser <disabled | enabled>

To attach the hplmnProfile to the SIP Trunk Group, execute the following command:

% set addressContext <addressContext> zone <zone> sipTrunkGroup <sipTrunkGroup> services hplmnProfile <hplmnProfile>

To attach the vplmnProfile to the SIP Trunk Group, execute the following command:

 % set addressContext <addressContext> zone <zone> sipTrunkGroup <sipTrunkGroup> services vplmnProfile <vplmnProfile>

SBX-49335 MRF Based Transcoding Support for T.140 Text

Previously, the SBC invoked Media Resource Function (MRF) only for audio streams to achieve transcoding. Non-audio streams were relayed end-to-end even when the audio was sent to MRF.

Teletype (TTY) is the legacy service offered through encoding text characters as tones that are embedded in a carrier (PCMU, PCMA, or EVRC) media stream. The T.140 streams carry text as a separate payload.

With this feature, the SBC invokes MRF for T.140 and TTY interworking to achieve transcoding (see the following call flow). When T.140 and TTY interwork, text characters exchange between the T.140 stream and the tones carried inband with the audio.

This feature modifies the callDetailStatus parameter by enhancing the mediaTypeStream<X> statistic to transcode for text streams when the SBC invokes MRF for T.140 and TTY interworking.

SBX-51244 SBC SWe and SWe Cloud CLI Support for Configuring Provisioning Limits

The SBC SWe and SBC SWe Cloud are enhanced to provide the configuration provisioning support using CLI and EMA. The provisioning limits can be configured based on the available RAM capacity. To achieve this functionality, the table sweConfigProfileSelection is configured under system.

The SBC supports following two configuration profiles to configure the provisioning limits:

• small: applicable to the VM RAM >=10 GiB
• large: applicable to the VM RAM >=18 GiB

% set system sweConfigProfileSelection name <small | large>

SBX-51324 Fax Transmissions Cannot Perform with T.38 Relay Mode when Trunk Group is T.38FallbackToG711 and use Voice Codec is G.711

The media codecEntry configuration for G.711 adds the honorToneDetection flag in the fax and modem parameters.

% set profiles media codecEntry <codecEntryName> codec g711 fax honorToneDetection <disable | enable>

% set profiles media codecEntry <codecEntryName> codec g711 modem honorToneDetection <disable | enable>

SBX-51327 SIP Requests Max-Forwards Header

A new Flag rfc7332ValidateMaxForwards is added in SipTrunkGroup signaling configuration in INGRESS side.

The default value for rfc7332ValidateMaxForwards is disable. If rfc7332ValidateMaxForwards is enabled, the SBC will use the Max-Forwards header value received from the end-user, and decrements this header value by 1 before forwarding it to the other end-user. If the value received from the end-user is 0 or 1, the SBC will discard that request with an error response of "483 - Too Many Hops."

% set addressContext <addressContext -name> zone <zone -name>  sipTrunkGroup < TG- name> signaling rfc7332ValidateMaxForwards <disable | enable>

SBX-52875 b=AS Support for AMR/AMR-WB/EVS

The sipTrunkGroup media configuration adds appSpecificBandwidth.

% set addressContext <addressContext name> zone <zone name> sipTrunkGroup <sipTrunkGroup name> media appSpecificBandwidth <disabled | enabled>

SBX-56400 VZW GETS - egress DSCP marking for SIP signaling

The hpcCallProfile configuration adds the dscpValue parameter.

% set profiles services hpcCallProfile <hpcCallProfile name> dscpValue <X>

SBX-59457/SBX-64007/SBX-58494 Robust Rsyslog Implementation for At-scale CDR and TRC file transport

The SBC supports Rsyslog as a method of sending event messages to a syslog server. It now has enhanced Rsyslog service with a number of new features:

• Spooling to reduce message loss. In the event that the connection is down to the syslog Server, support to spool log entries locally is used to reduce message loss for all log types.
• Adding future support to broadcast to multiple syslog servers
• Support sending additional Linux logs to syslog servers
  

  • Allow new configuration to specify which /var/log/ files to transfer over syslog

  • Allow a mechanism to capture Linux session console logs and transfer via syslog

• Introduce IPv4/IPv6 validation to the Rsyslog Remote Host fields

> show table oam eventLog platformRsyslog
 
% set oam eventLog platformRsyslog servers server<no> remoteHost<host_ip> protocolType<protocol> port <port>

> show configuration oam eventLog platformRsyslog

% set oam eventLog platformRsyslog syslogState <disabled | enabled>
 

SBX-60609 Hyperthreading support on SWe

New hyperthreading support affects various table options, parameters, and profiles in:

• sweTrafficProfiles
• sweActiveProfile
• show table system

SBX-61552 JITC - Need to use cryptographic mechanisms to protect audit information at rest

JITC requires the audit (.AUD) and security (.SEC) logs to be cryptographically protected. Since both logs are required to be hashed, this functionality is extended to support the hashing of all Event Logs on the SBC.

> show table system security hashEventLogs
 
> show configuration system security hashEventLogs

% request system security eventLogValidation generateDefaultKeys

% request system security eventLogValidation showPublicKey <default/user>

% request system security eventLogValidation setUserPrivateKey <uniqueUserPrivateKeyName> <userPrivateKey>

% request system security eventLogValidation deleteUserPrivateKey

SBX-61963 SIP Response Code Statistics

The SBC can be configured to provide counts of the number of times different SIP responses codes are either sent or received during a statistics interval. Statistics of this type can provide insight into call-related or registration-related failures within the network. You can enable collection of current and interval SIP response code statistics on specific SIP trunk groups or IP peers. By default collecting SIP response code statistics is disabled on SIP trunk groups and IP peers.  

When enabled, the statistics are stored in the following four tables. Refer to Interval Statistics - CLI for information on the parameters that control collection of interval statistics.

• sipTrunkGroupResponseCurrentStatistics
• sipTrunkGroupResponseIntervalStatistics
• sipIpPeerResponseCurrentStatistics
• sipIpPeerResponseIntervalStatistics

In addition to identifying the specific trunk group or IP peer to which they apply, entries in the table include:

• direction (either SENT or RECEIVED)
• response code number (one of the standard SIP response codes such as 100, 180, 200)
• response count (The number of instances of the specified response code in the specified direction)

Two new flags are added, one within IP peer and one within trunk group configuration, to enable collecting SIP response code statistics on specific objects of that type.

% set addressContext <acName> zone <zoneName> ipPeer <ipPeerName> sipResponseCodeStats <enabled|disabled>
% set addressContext <acName> zone <zoneName> id <zoneId> sipTrunkGroup <tgName> sipResponseCodeStats <enabled|disabled>

SBX-61999 SIPREC RFC Compliance Support for Dynamically Programmable Metadata Content

The SBC supports SIPREC when the SIPREC specifications were in early drafts (draft-ietf-siprec-xx-06). With the implementation of this feature, the SIPREC standard has evolved to RFCs (RFC 7245, RFC 7865, RFC 7866, and RFC 8068), and provides capability for supporting "dynamically programmable" selection of metadata content.

The profile sipRecMetaDataProfile is introduced to the services to provide the capability to configure the headers that are mapped from the target call leg to the XML and the corresponding metadata XML element name.
In case of a basic call, all information is copied from the initial-INVITE message on the leg where the tap is, to the metadata XML. However, "To" header and "to-tag" is copied additionally from the local information (as to-tag does not present in the INVITE).
In case of SIPREC trigger during REFER based transfer, irrespective of where the SIPREC tap is, all information is copied from the initial-INVITE of the new call leg towards the transfer target (C party).
In case of CLI triggered recording, the existing implementation of sending predefined information in metadata XML remains same (gcid, call-id, from, to). The new configuration of header-metadata mapping is not considered in this scenario.

The profile sipRecMetadataProfile is added to the SRS Trunk Group to configure the metadata format.

The following parameters are added to the profile sipRecMetadataProfile:

• version
• sipHeader
  • sipToXmlTagName
• state

% set profiles services sipRecMetadataProfile <sipRecMetadataProfile>

SBX-62052 Enhancement to Capture Decrypted Signaling

The SBC, which continuously captures encrypted signaling packets of SIP over TLS at layer 2, has been enhanced to to capture decrypted signaling packets as well.

The SIP PDUs (Protocol Data Units) are captured at the application layer and continuously streamed to the monitoring server. Configurable Headers are included in SIP PDUs to enable the monitoring server to decode SIP signaling properly. Headers have source and destination IP address/Port information along with additional information which is configurable – this information is needed by the monitoring server in order to correlate the stream received.

The packet is captured at ingress leg without SMM applied and with SMM applied on egress leg, which is essentially what is being sent on the wire. To lessen performance impact, all socket-management activities to the monitoring server use a separate SIPSM (SIP Signaling Monitor ) process receives all signaling packets from the SIP Signaling Gateway (SIPSG) and streams to the configurable external monitoring server either over UDP or TCP.

A profile attached to the signaling port is a trigger for this feature. All feature-related configuration can be set in this profile.

The CLI adds a Monitoring Profile to configure monitoring server, filters, header names and select from the fixed set of information. 

% set profiles services monitoringProfile <monitoring profile name>

SBX-62097 SRTP Support for SIPREC Towards SRS

The SBC is enhanced to support sending encrypted media streams (Secure Real-Time Transport Protocol (SRTP)) towards the SIPREC recorders.

The following parameters are added to the SRS Group Data to support whether the Secure Real-Time Transport Protocol (SRTP) is enabled for the call or not. The cryptoSuiteProfile is an existing parameter. The parameter cryptoSuiteProfile is configured under profile and security and can be attached to the SRS Group Data.

• srtp
• cryptoSuiteProfile

% set global servers srsGroupProfile <srsGroupProfile> srsGroupData <priority index>
 srtp <disable | enable>
  cryptoSuiteProfile <cryptoSuiteProfile>

SBX-62422 Remove Default Passwords and Support Two Privilege Levels With Key Injection

The Ribbon SBC is enhanced to secure management of user accounts and passwords on its OpenStack versions. Default passwords have been eliminated in favor of injected credentials. SSH keys for users linuxadmin and admin are now pushed using the User Data section of the HEAT template.

Because the sftpadmin account is deleted, the associated CLI is also removed.

SBX-62769 LCQ To Header Transparency flag on PSX is also affecting RURI Transparency

This feature implementation globalizes the Request-URI. Currently, when the To-Header Transparency flag is set, it is also sending the Request-URI transparently even when the globalization flag is enabled. When set, the To-Header Transparency should not send the called number in the Request-URI locally. Request-URI globalization should be independent of the To-Header Transparency.

For this feature, Request-URI is globalized when globalization for the called number is enabled and if the To-Header Transparency flag is enabled, Request-URI called number will not be transmitted transparently to the egress leg. To-Header transparency flag will not affect Request-URI globalization.

Enables flag to transparently copy the Request URI from the incoming message to the outgoing message for INVITE, REGISTER, SUBSCRIBE/NOTIFY. Provision this flag on the egress leg (with respect to the message direction).

% set profiles signaling ipSignalingProfile <profile_name> commonIpAttributes transparencyFlags requestURI

SBX-64339 Need Control to Disable Sending eDNS OPT Record in ENUM Query by ERE

The enumDomainName forwardersData configuration adds the eDNSType flag and eDNSBufferSize parameter. The servers lwresdProfile configuration adds the eDnsGlobalBufferSize and eDnsMonitorInterval parameters.

SBX-65796 Need ENUM Queries to use the SIP Signaling Interface on the SBC

The SBC uses the signaling interface to send ENUM queries, in addition to sending ENUM queries from the management interface. ENUM queries are properly marked, and packets from the signaling interface receive higher priority, when ENUM queries are sent through the signaling interface.

The signalingIp parameter is added to the type field of the servers lwresdProfile configuration. Set the servers lwresdProfile type to signalingIp to send the ENUM queries through the signaling interface using the sipSigPort IP address. The signaling interface uses port 988 to send and receive the queries.

When lwresdProfile type is configured as signalingIp, configure the addressContext, zone, sipSigPort, and ipInterfaceGroupName parameters with the correct combinations as configured during sipSigPort.

• The addressContext updates the staticRoute for the ENUM server, and this configuration includes the <pkt0 ip> parameter.
• The servers lwresdProfile type configuration adds the signalingIp parameter. The signalingIp includes the addressContext, zone, sipSigPort, and ipInterfaceGroupName parameters.
• The lwresdProfile can attach the enumArsProfileId. Configure this profile ID for black listing and white listing in the enumArsProfile, which is added to the global servers configuration.

SBX-66074 Registration Statistics per Domain

A new parameter, sipRegCountDomainStats, is added and can be used with both show status and show table commands. An address context must be specified and specifying a domain is optional. If a specific domain is not specified the command returns per-domain statistics for up to 256 domains. The command returns no data if there are no domain names found.

show status addressContext <AC_Name> sipRegCountDomainStats <DomainName>

show table addressContext <AC_Name> sipRegCountDomainStats <DomainName>

The following existing CLI command is extended to also reset the cumulative domain-based statistics (countAttempt, countCumCompletion, emergAcceptTotal) for all domains:

request addressContext <AC_Name> sipRegCountReset

> show status addressContext <AC_Name> sipRegCountDomainStats <DomainName>
    countAttempts
    countCumCompletions
    countPending
    countStable
    countTotal
    emergAcceptTotal
    emergActiveTotal
 
> show table addressContext <AC_Name> sipRegCountDomainStats <DomainName>
    countAttempts
    countCumCompletions
    countPending
    countStable
    countTotal
    emergAcceptTotal
    emergActiveTotal

SBX-67977 Enhance Privacy Info for User and ID

With the implementation of this feature, the SBC is enhanced to support:

• The privacy handling on the "P-Asserted-Id (PAI)" header when the "privacy: id" is received and applies this privacy handling on the "From" header when "privacy: user" is received.
• The new privacy profile configuration to apply privacy services independently on each leg.

• Remove any non-essential headers that are added by the user agent, including the Subject, Call-Info, Organization, User-Agent, Reply-To, and In-Reply-To.

To configure this feature, the privacyProfile is added to the services.

The following flags are added to the privacyProfile:

• applyPrivacyId
• applyPrivacyUser
• passThruPrivacyInfo
• supportPrivacyId
• supportPrivacyUser

Deprecated CLI