Page History

New CLI in

7.

0.

0R0

SBX-

A new profile retryProfile is added to the profiles object to configure a trigger/action rule to specify that when a particular response code (and optional warning code) is received (the trigger), the SBC performs a fallback action (fallback SRTP to RTP, fallback to IPV4 or fallback to IPV6). The SBC then reattempts an INVITE with the updated Session Description Protocol (SDP) offer based on the action configured for the received error response and warning code.

% set profiles services retryProfile <retryProfile name>
  attemptRecordGeneration <[disabled] | enabled>
  state <[disabled] | enabled>
  triggerActionRule <1-16>
       sipResponseCode <300-699>
       sipWarningCode <300-399>
       action <1-16>
              actionType <fallBackSrtpToRtp | fallBackToIPV4 | fallBackToIPV6>

SBX-54065 and SBX-35444 SWe Capacity Improvement and Estimation

The performance of the SBC VM can be optimized by providing the call mix while configuring the SBC SWe instance. The SBC includes a set of predefined call mixes also known as standard traffic profiles. Additionally, a user can create custom traffic profiles containing a call mix that is more appropriate for the SBC SWe.

The following system profiles are added/updated in this release:

% set system sweTrafficProfiles <profile name> accessScenario true callHoldTime 125 passthroughCodecProfile cmix1 transcodePercent 30 transcodingCodecProfile G711_G729_20ms

SBX-60738 Capacity License for Network Wide Licenses

Several licenses of the SBC are "count-based;" the features dependent on those licenses (known as count-based features) can scale only up to the count permitted by the available number of corresponding licenses. The Service Capacity License, referred as the "SBC-CAPACITY" license, allows the count-based features to use the full capacity of the SBC.  The following changes are made to the SBC CLI:

• The set system licenseRequired command now includes SBC-CAPACITY license as a possible option. Since SBC-CAPACITY is an "on/off" license, configuration of the the minCount and maxCount parameters is not required. 
• On successful activation of the SBC-CAPACITY license, the show commands display the license status.
• Two statistics are added to the show table global command:
  • serviceAuthorisedCurStats
  • serviceAuthorisedIntStats

To configure SBC-CAPACITY:

To display the table for serviceAuthorisedCurStats:

To display the table for serviceAuthorisedIntStats:

SBX-61136 Add 1:1 HA option support for AWS and non D-SBC Cloud

The parameter mgmtMode is added to the system admin status command in this release, and  specifies whether SBC SWe instances are managed manually or through EMS/VNFM.

Two modes for managing the HA/Redundancy of SBC SWe Cloud Network Functions Virtualization (NFV) are supported:

Centralized (default) - Use this mode for traditional HA/redundancy model (1:1 scenario) where one active instance is backed up by one standby instance. In Centralized mode, the SBC configuration is synchronized between active and standby SBCs. The Centralized mode is preferred for deployments where the scale/sessions requirements are low.

Distributed - Use this mode for SBC SWe Cloud deployments where up to N active SBC instances are backed up by a single standby SBC instance (N:1). In this mode, each node is configured separately, and the configuration on active and standby instances are not synchronized. 

The changes in CLI are:

• The parameter mgmtMode is added to system. This parameter specifies whether the instances are managed either manually, or through EMS/VNFM. There are two supported modes:
  • centralized (default)
  • distributed
• The rgstatus, serverStatus, and serverAdmin commands are supported on AWS for 1:1 redundancy group. For centralized mode, the commands display details of both active and standby volumes.

> show table system admin <system name> mgmtMode

New CLI in 6.2.0R0

SBX-30086 SBC7K/5K sharedCacLimitsPool Enhancement to Encompass Gateway Trunk Group

The SBC in enhanced with the following CLI to support Gateway CAC functionality. 

35800 GPU Transcoding

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> gwTrunkGroup <gateway_trunk_group_name> parentSharedCacLimitsPoolName <shared_Cac_limits_pool_name>

% set addressContext <name> zone <name> gwTrunkGroup <name> cac
    bandwidthLimit <0-2147483647>
    callLimit <0-2147483647>
    egress
    emergencyOversubscription <0-1000>
    hpcOversubscription <0-100>
    ingress

SBX-43651 SBC Supports Pushing Audit Records to Remote Server Using rsyslog.conf File

The SBC is enhanced with the following CLI in support of configuring a remote server IP address, port, and protocol type to push the audit logs to the remote server.

% set oam eventLog platformAuditLogs auditLogRemoteHost <IPv4/IPv6 address>
% set oam eventLog platformAuditLogs auditLogPort <1 to 65535>
% set oam eventLog platformAuditLogs auditLogProtocolType <relp | [tcp] | udp>
 
> show table oam eventLog platformAuditLogs

SBX-44333 SIPREC Forking to two Recorders

The SBC is enhanced with the following CLI in support of SIPREC on multiple recorders.

The following parameters are added to startRecord of SIPREC object:

The parameter recorderAddress is added to stopRecord.

> request global siprec
    startRecord
        callLeg
            egress
            ingress
        gcid <0-2147483647>
        numOfStreams
        srsIpAddress <SRS IP ADDRESS>
        srsIpAddress2
        srsPort <IP port number>
        srsPort2 <Ip port number>
        transport <tcp | udp>
        transport2  <tcp | udp>
        trunkGroup <TRUNK GROUP NAME>
        trunkGroup2
    stopRecord
        gcid <0-2147483647>
        recorderAddress
        recorderPort

Additionally, the srsGroupProfile is added to the global servers object.

% set global servers srsGroupProfile <profile name>
    description <0-199 characters>
    loadDistribution <roundRobin | sequence>
    numSimultaneousStream <1-2>
    srsGroupData <0-7>
        ipAddress <IP address>
        ipPort <IP port>
        ipTGId <IP TG Id>
        transport <tcp | udp> 

SBX-45806 Pathcheck Ping using ICMP

The SBC is enhanced with the following configurations in support of Pathcheck ping enhancements:

• The Path Check Path configuration is added to the System object.
• The parameter, replyTimeout, is added to the pathCheckProfile configuration.

% set system pathCheckPath <Path Check Path name>
    addressContext <addressContext name>
    ipInterface <IP Interface name>
    ipInterfaceGroup <IPIG name>
    pathCheckProfile <Patch Check Profile name>
    reportSignalIpAddress <IP address>
    reportSignalIpPort <Port Id>
    sourceIpAddress <Ip address>
    state <[disabled] | enabled>
    targetIpAddress <IP address>
    zone <Zone name>
 
% set profiles services pathCheckProfile <profile name>
    failureResponseCodes <400-699 | all |all4xx | all5xx | all6xx>
    protocol <icmp | sipOptions>
    recoveryCount <1-10>
    replyTimeoutCount <1-10>
    sendInterval <1-600>
    transportPreference <preference1 | preference2 | preference3 | preference4>

SBX-46173 CLI Implementations Improvements

The SBC is enhanced to populate the encapsulated Integrated Service Digital Network User Part (ISUP) calling party even when it is not mapped to P-Asserted_ID in the INPUT DATA that is sent to the PSX. In support of this, the following flags are added to the SIP Trunk Group Signaling object.

• mapFromHeaderToIsupGap

• mapIsupCgpnToPAI 

% set addressContext <name> zone <name> sipTrunkGroup <name> signaling callingParty
    cpcParamFromHeader <[default] | fromheader | paitel>
    fromHdrForCallingParty <disabled | [enabled]>
    mapFromHeaderToIsupGAP <[disabled] | enabled>
    mapIsupCgpnToPAI <[disabled] | enabled>
    paiForCallingParty <disabled | [enabled]>
    ppiForCallingParty <disabled | [enabled]>
    rpiForCallingParty <disabled | [enabled]>
    trustedSourceForIsup <disabled | [enabled]>

% set system policyServer globalConfig dnsGroup <dnsGroupServer_name>

SBX-54065 and SBX-35444 SWe Capacity Improvement and Estimation - Phase 1

The SBC is enhanced with the addition of the following  configuration and status commands in support of SBC SWe capacity improvements.

% set system sweActiveProfile name <profile name>
    default
    standard_callmix_profile
    standard_msbc_profile
    standard_passthrough_profile
    standard_signaling_profile
    standard_transcoding_profile 
 
> show table system sweTrafficProfiles
> show table system sweActiveProfile
> show table system sweCodecMixProfile
> show table system sweProcessorCapacity
> show table system sweCapacityEstimate

SBX-54575 Remove Direct Log Access from sftproot

The SBC is enhanced with the addition of the following flag sftpadminLoginEnabled to the Account Management object to enable or disable the sftpadmin user.

% set system admin <admin-name> accountManagement sftpadminLoginEnabled <false | [true]>

SBX-56559 Alert-Info and P-Early Media Headers Interworking

The SBC is enhanced with the addition of the following SIP Trunk Group flags:

% set addressContext <addressContext name> zone <zone name> sipTrunkGroup sipTrunkGroup name> signaling
      aiToPemInterworking <[disabled] | enabled>
      convertAlertToProgress <[disabled] | enabled>

SBX-58385 SMM Switch Semantics

The SBC is enhanced with the addition of the switch parameter  to the sipAdaptorProfile. 

% set profiles signaling sipAdaptorProfile <name> rule <Index> criterion <Index> switch <Index>
	switchAction <1-128>
	switchValue <value>
	switchRegexpString <regular expression>

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 | 

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

Deprecated CLI