SBC Core 07.02.00R000 Release Notes

Table of Contents

About SBC Release Notes

This document describes new features, the latest hardware and software requirements, known limitations and other pertinent release information for the latest release of SBC Core.

Related Documentation

The SBC Core 07.01.xx documentation is located at the following Wiki space: SBC Core Documentation.

Release Notes Use and Distribution

Ribbon Release Notes are protected under the copyright laws of the United States of America. This work contains proprietary information of Ribbon Communications, Westford, MA-01886, USA. Use, disclosure, or reproduction in any form is strictly prohibited without prior authorization from Ribbon Communications.

Associated Ribbon Bulletins

The following Ribbon Bulletins are referenced in this release note:

• Warning-18-00028230: LSWU for SBC SWe (running on VMWare or KVM) with greater than 10 vCPUs
• Warning-18-00028165: SBC 5110 uses wrong encryption key intermittently SRTP
  
• Warning-17-00022847: The DNS configuration parameters within the address contexts may cause certain configurations to fail during an upgrade to the SBC 6.2.0
• Warning-17-00022689: Duplicate Trunk Group or Zone names can cause unexpected behavior
• Warning-14-00020748: Verify system and databases are fully in sync prior to Live Software Upgrade (LSWU)

Problems or Questions

For problems or questions, contact Ribbon Support through telephone or fax: 

Worldwide Voice: 

USA Toll-free: 

Worldwide Fax: 

About SBC Core

The SBC Core platforms address the next-generation needs of SIP communications by delivering media transcoding, robust security and advanced call routing in a high-performance, 2RU, and 5RU form-factor devices enabling service providers and enterprises to quickly and securely enhance their network by implementing services like SIP trunking, secure Unified Communications and Voice over IP (VoIP).

For more product information, refer to the section About SBC Core in the main documentation space.

Interoperability

The SBC Core software interoperates with the following:

• SIP/H.323 compliant IADs and IP-PBXs
• PSX Policy Server Softswitch via SIP redirects and/or Diameter+ protocol
• SBC 9000 through SIP call signaling and Networks MCS protocol
• NetScore collection, analysis, monitoring, and reporting of selected Key Performance Indicators (KPIs) on a near-real time basis
  
  

H.323-SIP and SIP-H323 Calls

When using H.323-SIP and SIP-H.323 call flows, an additional Re-invite/Update may get generated towards the SIP side. To suppress this, enable the IP Signaling Profile (IPSP) flag Minimize Relaying Of Media Changes From Other Call Leg at the SIP side.

• For CLI IPSP flag details, refer to Flags - CLI.
• For EMA IPSP flag details, refer to Common Ip Attributes - Flags.

Compatibility with Ribbon Products

Refer to SBC 5000-7000-SWe Interoperability Matrices for the latest and minimum compatible product versions supporting the 07.02.00R000 release.

Sample Heat Templates Included in This Release

To instantiate the SBC instances, the following template can be used:

SBC SWe Cloud Requirements for OpenStack

The system hosting the SBC SWe Cloud must meet the below requirements for OpenStack:

The system hosting the SBC SWe must meet the following requirements to achieve the performance targets listed: 

OpenStack Requirements

This section details the OpenStack requirements.

SBC SWe Cloud Requirements for AWS

• The system hosting AWS requires 65GiB of disk size.
• AMI ID required to launch an instance is ami-05109212. Contact your Ribbon sales representative to get access to AMI ID.

SBC SWe Requirements for KVM

The following table lists the server hardware requirements.

SBC SWe Requirements for VMWare

The following table lists the server hardware requirements:

Required Software and Firmware Versions

The following SBC 5000 series (51x0/52x0), SBC 5400 and SBC 7000 software and firmware versions are required for this release. For 5xx0 the BIOS can be installed during app install, whereas for 5400 and 7000 the BIOS is included in the firmware package and is installed during the firmware upgrade. 

How to Verify Currently Installed Software/Firmware Versions

Use the EMA to verify the currently installed software and firmware versions.

Log on to the EMA, and from the main screen navigate to Monitoring > Dashboard >  System and Software Info.

Software Bundles

The following software release bundles are available for download from the Customer Portal:

• SBCSWe_7.2
• SBC5x7x_7.2

Download the appropriate software packages for your desired configuration from the Customer Portal (https://ribboncommunications.com/services/ribbon-support-portal-login) to your PC:

SBC 5000 Series (51x0/52x0) Firmware

• firmware-5XX0-V03.16.00-R000.img

• firmware-5XX0-V03.16.00-R000.img.md5

SBC 5400 Firmware

• firmware-5400-V03.16.00-R000.img
• firmware-5400-V03.16.00-R000.md5

SBC 7000 Series Firmware

• firmware-7X00-V03.16.00-R000.img
• firmware-7X00-V03.16.00-R000.md5

SBC Core Operating System Installation Package

The ConnexIP Operating System installation package for SBC Core:

• sbc-V07.02.00R000-connexip-os_06.01.00-R000_9_amd64.iso
• sbc-V07.02.00R000-connexip-os_06.01.00-R000_9_amd64.iso.md5

SBC Core Application Package

The SBC Application installation and upgrade package for SBC Core:

• sbc-V07.02.00R000-connexip-os_06.01.00-R000_9_amd64.qcow2
• sbc-V07.02.00R000-connexip-os_06.01.00-R000_9_amd64.qcow2.md5
• sbc-V07.02.00-R000.x86_64.tar.gz
• sbc-V07.02.00-R000.x86_64.md5
• sbc-V07.02.00-R000.x86_64.signature

For detailed information on installation and upgrade procedures, refer to SBC Core Software Installation and Upgrade Guide.

Cloud Service Archive (CSAR) Packages for VNFM Deployment on OpenStack

These files are for SBC SWe deployments in the OpenStack cloud using VNFM.

For VNFM deployment, the VNF Descriptor (VNFD) file is provided in a Cloud Service Archive (CSAR) package for the type of SBC cluster being deploying.  VNFs are independent and CSAR definitions are imported into the VNFM via an Onboarding mechanism.  The SBC has several different CSAR variants, for different personalities (S-SBC, M-SBC) and interface types (virtio, sriov). The supported CSAR packages for the SBC are:

• ssbc_virtio_7.1.csar
• ssbc_sriov_7.1.csar
• msbc_virtio_7.1.csar
• msbc_sriov_7.1.csar

For detailed information on installation and upgrade procedures, refer to SBC Core Software Installation and Upgrade Guide.

Upgrade Notes

07.02.00R000 Upgrade Information

Support of maddr Post-Upgrade

When upgrading SBC Core to release 5.0.0 (and above) from a pre-4.2.4 release, complete the "Action to take" immediately after the upgrade if either condition that follows is applicable:

• If you are using the SBC with a Broadsoft system and SBC is configured for registration access (where SBC sits between SIP phones and the Broadworks System. Otherwise no new REGISTER will be processed (phones will lose registration).
• If you are using the SBC with other feature servers that require maddr processing.

Action to take: On the SIP trunk group facing Broadsoft (or other feature server), set the SIP Trunk Group signaling flag, honorMaddrParam, to enabled on the Trunk Group(s) requiring maddr handling. Default is ‘disabled’.

set addressContext <addressContext name> zone <zone name> sipTrunkGroup <TG name> signaling honorMaddrParam <disabled | enabled> 

See the following pages for configuration details:

• SIP Trunk Group - Signaling - CLI
• SIP Trunk Group - Signaling (EMA)

SBC SWe Pre-Upgrade Requirements

VM CPU resource allocation requirements

Starting with 4.2.4R0 release, CPU resource allocation requirements for SBC SWe VM are strictly enforced contrary to previous releases. You must review and verify these VM settings (including co-hosted VMs) against the documented "VM Configuration Recommendations" on the For VMware page in the Hardware and Software Requirements section before upgrading. If you encounter a problem, correct the CPU reservation settings as specified in step 6 of "Adjust Resource Allocations" procedure on the page Creating a New SBC SWe VM Instance with VMXNET3. CPU reservation should be set as “number of vCPUs assigned to VM * physical processor CPU frequency". If VM uses the same number of vCPUs as the number of physical processors on the server, this reservation may not be possible. In this case, reduce the number of vCPUs assigned to VM by one and set the CPU reservation to the appropriate value.

When using the show table system serverSoftwareUpgradeStatus command during the upgrade, the Standby server's LSWU status will always display "Upgrading" even though the upgrade may have failed due to host checker validation. To check if host validation failed for the Standby, check for HostCheck Validation Failed message in the upgrade.out log.

Disable Call Trace feature prior to LSWU/upgrade

As a prerequisite for SWe LSWU/upgrade, disable the Call Trace feature prior to performing the LSWU/upgrade and re-enable it once the LSWU/upgrade is completed.

Manually check for Hostcheck Validation Failed message

Perform the following procedure on the Standby to check for the Hostcheck Validation Failed message in the upgrade.out log.

1. Log on to ESXi of the Standby SBC SWe.
   
   
2. Check in/opt/sonus/staging/upgrade.out (this log shows the Hostcheck Validation Failed error).
   
   
3. Power off the VM.
   
   
4. Reduce the number of vCPUs assigned to VM by one and set the CPU reservation to the appropriate value.
   
   
5. Power on the VM. The SBC SWe successfully upgrades to the latest version 6.2.0.
   
   
6. Run the command show table system serverSoftwareUpgradeStatus to confirm the successful upgrade.
   
   
7. Perform similar procedure for LSWU on Active.

Preparing for Upgrade (All Platforms)

Please read the following information and take necessary actions before starting your upgrade to this release.

Since the release 4.1.4, the cryptographic key pair used to sign and verify the package has been changed to enhance security. When installing/upgrading from all 4.0.x releases, all pre-4.1.4 releases (4.1.3 and earlier), and all pre-4.2.3 releases (4.2.2R00x and earlier), do one of the following, depending upon your upgrade method:

• LSWU through CLI: Skip the integrity check during LSWU by using the CLI command below.
  
  During LSWU, use the integrityCheck skip option when upgrading from CLI:

  > request system serverAdmin <server> startSoftwareUpgrade integrityCheck skip package <package>

  Note

  Integrity check works as expected only when upgrades are started from 4.1.x releases (4.1.4R000 or later) or from 4.2.3R000 or later releases.

• Upgrade through Platform Manager: If upgrading using Platform Manager, simply ignore the "Wrong Signature" warning message and continue the upgrade normally.

Supported Live Software Upgrade (LSWU) Paths

The SBC Core supports Live Software Upgrade from releases listed in the table below:

New Features

New Features in 07.02.00R000 Release

SBX-50672 STIR-SHAKEN: Support for signing via 3rd party Signature Server 3rd party Verification Server and Tagging

SBX-51418 Increase in the Number of Rules in SMM Profile  

An SMM profile is currently limited up to 64 rules. This limit can be reached if a carrier requires a lot of adaptations so the customer requires an increase in this limit to 256. 

For more information, refer to:

SBX-52861 Add a Dynamic SIP Signaling Port

The SBC uses port 5060 as the default signaling port. The default system-wide port range is 1024 - 65148. When the sigport is modified and falls outside the media port range, the NP layer is able to process as control packet and same is forwarded to application and call established successfully.

If the default signalling port is configured to other than 5060 or 5061 and falls inside the system-level media port range, then the packets received on the port will be part of the rogue media list because NP will not find any XRes activated for the port and the call will fail.

To complete the calls, you must reconfigure the system-level media port range or sipsig port so that the configured sigport falls outside the media port range.

This feature allows the admin to configure the sipsigport inside the media port range as well. 

For more information, refer to:

SBX-54420 Create Different Triggers Based on TLD (Top Level Domain)

For more information, refer to:

SBX-56399 DSCP Marking for T.140 Text Media

In previous releases, the SBC supported Differentiated Services Code Point (DSCP) marking for non-audio streams (video and T.140 text) for both High Priority Calls (HPC) and non-HPC calls. The SBC Core is enhanced to support alternative DSCP marking for T.140 text media stream types from what is used for video and audio media stream types irrespective if the request has an RPH header.

For Government Emergency Telecommunications Service (GETS) / Wireless Priority Service (WPS) calls ( high priority calls), DSCP markings are associated with the provisioned ETS value and in the outgoing message includes an RPH containing the provisioned ETS.x. When the message is destined for the internal network,  there is a single DSCP associated with that ETS value and assigned to all associated signaling and media packets. When it is destined for an external network, there is a single DSCP associated for every peer. In other words, there is a set of DSCP values rather than a single DSCP value in each case, one each for signaling, audio, video and text.

To support this feature, a new parameter "T140 DSCP" is added to QosValues for DSCP marking of T.140 text .The  DSCP value for T.140 packets is configured on Packet Service Profile (PSP) basis.

For more information, refer to:

•  SBC Support of GETS and WPS
• QoS-Based Routing Support
• Media - Packet Service Profile - QOS Values
• SBC Support of GETS and WPS

SBX-57592 Need Trap to Notify Users of a DB out of Sync Condition

An entity, dbSyncCheckProfile, is added. A parameter, syncCheckInterval is added to dbSyncCheckProfile to configure the time interval for verifying the database integrity. It will raise an existing TRAP "sonusDatabaseConfigPolicyDataOutOfSyncNotification" when a DB Out of Sync condition arises. If a subsequent DB out of sync condition arises then it should increment the TRAP counter unless it is cleared by the clear trap. Also, the application shall raise a clear state TRAP, the existing "sonusDatabaseConfigPolicyDataInSyncNotification" when CDB and Oracle are back in sync state. A DB Out of Sync condition is a state when there is a mismatch between the count of trunkgroups, ippeer and relayPort between CDB and oracle DB.

The value range for this parameter is either 0, or between 5-30 minutes. The default value is 5. If the user wishes to not receive the automated db sync state traps, they can disable it by configuring the syncCheckInterval parameter to 0. If it is configured to 0, then no traps will be generated. However, integrity is still checked in 1 minute intervals and is logged into the .SYS file at /var/log/sonus/sbx/evlog path. Since there should only be one sync interval timer, there is only one entity of this profile, which is "DEFAULT", and it cannot be deleted. 

For more information, refer to:

• Profiles - CLI

SBX-62287 EVS Pass-Through Support

For more information, refer to:

SBX-62919 SILK Transcoding Support

For more information, refer to:

SBX-64225 SBC SWe - Count Out of Dialog Messages for Reporting and Billing

For more information, refer to:

SBX-65402 RTCP Relay Feature With RTCP Generation

For more information, refer to:

SBX-65508 Domain-based Licensing on SBC SWe Cloud

For more information, refer to:

SBX-66050 Individual RTP Inactivity Timer for Audio and Video Stream

In sessions with video and audio streams, the SBC now distinguishes between “audio” and “video” so that calls will not be discontinued due to call-hold RTP inactivity. This solution allows enabling/disabling of the RTP inactivity timer on audio and video individually. This means that sessions with an audio stream, but no video stream, the session will stay live.

For more information, refer to:

• AMR and RTCP Enhancements

SBX-67358 Copy All Direct MediaSDP Information on Incoming INVITE to Outgoing INVITE

For more information, refer to:

SBX-67789 Disable/OOS per Peer with DNS Query

For more information, refer to:

SBX-67797 Multiple Bindings per SIP Line (several phones share same number)

When a subscriber registers from multiple devices with the same username, there is an inherent issue on the private side of the SBC. In Access mode, the SBC traditionally does not manipulate the username for the AOR, but does manipulate the host portion. The host portion is changed to the private side IP of the SBC when sending to the Registrar. If a subscriber registers from multiple devices it causes the same AOR to be created from the SBC to the registrar. 

To make this unique, the SBC inserts a parameter called reg-info and inserts a unique value in this parameter. Some registrars do not cache the parameters inserted by the SBC which causes this use case to fail.

To remediate this type of failure, the SBC privately assigns a unique new value to the username. The SBC maintains a mapping from this unique username value on the private side, and the original username on the public side.

For more information, refer to:

• CLI Changes in This Release
  
• New child page under SIP Trunk Group - Signaling - CLI
• Show Table Address Context - Zone
  
  

SBX-67830 Remove enumdi Parameter Inserted in Egress R-URI after ENUM Query from PSX

For more information, refer to:

SBX-68156 Verizon Wireless SBC Orchestration and Life Cycle Management Through VNFM

For more information, refer to:

SBX-69299 Support OpenStack Queens

For more information, refer to:

SBX-69807 503 Response Behavior on ARS

For more information, refer to:

SBX-69821 Update MetaVariables Table to Add New SIP Signaling Port

For more information, refer to:

SBX-70047 D-SBC Performance Testing on RHEL 7.5 - Performance Optimization

For more information, refer to:

SBX-70226 Early Media Interworking between Verizon Networks (VzCDMA VzVoLTE) with Direct Indirect Peering Networks

For more information, refer to:

Resolved Issues

Resolved Issues in 07.02.00R000 Release 

The following issues are resolved in this release:

Known Issues

Known Issues in 07.02.00R000 Release

The following issues exist in this release:

Known Limitations

The following limitations exist in this release:

• Due to a known EMA GUI issue, it can take up to 10 minutes to process each SMM rule when provisioning SMM on the SBC using the EMA. This will be fixed in a future release.

• The Access Control List (ACL) is not installed to configure SNMP traps for accepting traffic. A dynamic ACL is added to configure SNMP traps. An ACL must be installed for SNMP traps for accepting traffic.
  
• The physical NIC connectivity must be in active state at the hypervisor level before starting the SWe instance on the SBC SWe platforms. In case of SWe instance with SR-IOV interfaces, manual restart of the SWe instance is required if physical NIC connectivity goes down while the instance is in progress.

• The HA interface must not be configured with link local address or subnet. For example, do not configure it with 169.254.0.0/16 subnet. 

• The Antitrombone feature is not supported on the D-SBC.
• EMS identifies the nodes based on the VNFC-ID. While instantiating SBC/PSX cloud nodes, ensure that you use a unique VNFC-ID only. If you reuse an existing VNFC-ID, EMS treats this as a re-registration request and overwrites the existing data on the cloud node.
• While configuring the SBC SWe Cloud instances, the CLIs commits successfully even if any metaVariable provided is incorrect. The SBC SWe Cloud instance cannot validate the CLIs, as the CDB configuration file is stored in the SBC Configurator and is shared among all the other SBC SWe Cloud instances in the cluster.
• Editing IP Interface is not reflected in the if configuration (ifConfig). This behavior is observed only on the S-SBC when action is set to "dryup" mode on the IP Interface. The IP address changes are not updated in the kernel and will not be displayed when ifconfig linux command is executed. In case of S-SBC, if the ipInterface configuration needs to be modified and if the action is set to "dryup" in ipInterface configuration, it must be set to "force" before disabling the ipInterface and making any changes.
• A LSWU on an SBC 7000 should only be performed when the total number of active calls on the system is below 18,000. If the criteria is not met, a double failure during the upgrade may occur thereby losing all active calls. If such a failure occurs, both active and standby SBC services will go down.  Contact Ribbon Support immediately.
  
  

Performing Heat Stack Update when userdata is Updated with SSH Keys

When upgrading SBC SWe cloud instances to release 7.1, you must update your Heat template userdata section to include mandatory SSH key information. An issue in OpenStack requires that you use the stack-update process rather than re-launch after updating the template, which leads to a new UUID for the instance. As a result, you must regenerate and apply new license bundles to the upgraded instances during the upgrade.

Refer to Upgrading M-SBCs in an N:1 Redundancy Group for the relevant procedure. 

Restricted Functionality with SBC

The following functionalities are not supported with SBC Microservices:

• SRTP
• Far end NAT traversal
• DTMF inter-working
• RTCP termination for pass-through calls
• Direct Media and Antitrombone
  
• NICE, SIP-REC
• Rx, Rf interfaces
• Multimedia - MSRP, BFCP  
• Fax detection
• ICE/STUN
• SIP REFER
• SIP REPLACE

• Two stage calls

• H323 support
• GW signaling support
  

Restricted Functionality with SBC for AWS

The following functionalities are not supported with SBC for AWS:

• The EC2 does not support VM console. The SSH must be used to access the VM.
• The smarctl disk status is not supported on Amazon instance.
• All the networking ports must be in different subnets.
• The instance creation and reboot process take approximately 4 to 6 minutes to complete.
• IP spoofing or L2 learning is not supported.
• It is required to associate an EIP on MGT0 for an HA, and the CFN template automatically assigns the EIP. This is required for communicating with AWS servers while instance switchover. The EIP switchover takes 15-20 seconds.

Network Licensing Limitations

After switchover during grace period, when the new standby SBC comes up and establishes itself as standby, there is a short period (a few minutes) when the standby is synchronized for normal operation, but the new standby has not yet completed establishing its licensing state using the grace license information. If there is a second SBC switchover during that window, the new active SBC (which became active before completing license state synchronization) will lose calls until it re-acquires the grace licenses.