Table of Contents


 

Document Overview

This document provides a configuration guide for Ribbon SBC Edge Series (Session Border Controller) when connecting to OBS Business Talk (BTIP) SIP trunk.

This configuration guide supports features given in the BTIP North Profile Compliancy and Compliance tests documents.

Ribbon has configured the BTIP side in a such manner it doesn’t matter the 3rd party system connected on the SBC.

The SBC Edge is certified by Orange Business Services as a ‘certified Enterprise SBC’.

Introduction

The interoperability compliance testing focuses on verifying inbound and outbound call flows between Ribbon SBC Edge and OBS.

Audience

This is a technical document intended for telecommunications engineers with the purpose of configuring both the Ribbon SBC and the third-party product. There will be steps that require navigating the third-party and the Ribbon SBC Command Line Interface (CLI). Understanding the basic concepts of TCP/UDP, IP/Routing, and SIP/RTP are also necessary to complete the configuration and for troubleshooting, if necessary.

This configuration guide is offered as a convenience to Ribbon customers. The specifications and information regarding the product in this guide are subject to change without notice. All statements, information, and recommendations in this guide are believed to be accurate but are presented without warranty of any kind, express or implied, and are provided “AS IS”. Users must take full responsibility for the application of the specifications and information in this guide.

Requirements

The following equipment and software were used for the sample configuration provided:


Equipment

Software Version

Ribbon Communications

Ribbon SBC SWE-Lite

9.0.0

Third-party Equipment

CISCO CUCM 

12.5

Other software

VentaFax

7.3.233.582I

Reference Configuration

The following reference configuration shows the connectivity between the third-party and Ribbon SBC Edge.

SBC Edge IP Diagram

Topology

Support

For any questions regarding this document or the content herein, please contact your maintenance and support provider.

 

Third-Party Product Features

Product Features

  • Basic Call
  • Long Duration Call + CLIR
  • Call Cancellation
  • DTMF + Voicemail
  • Transfer
    • Supervised + MOH

    • Blind

  • Forward
    • Unconditional
    • Busy
    • No Answer
  • Busy Call
  • Not Answered Call
  • Conference X3
  • Prehook
    • With Transfer
    • With Forward
  • Call Parking
  • Call Pickup
  • Hunt Group
  • Second Line
  • CAC
  • Emergency Number
  • Fax

Prerequisites

Prerequisites

  • A Valid SBC Edge License
  • VentaFax Software
  • Voicemail Software

Verify License

A valid SWE-Lite (Key Based) license with the features necessary to run the tests.

Cisco Unified Communications Manager (CUCM)

The following new configurations are included in this section:

  1. SIP Trunk

  2. Route Group

  3. Route List
  4. Route Pattern

SIP Trunk

SIP trunks allow administrators to connect the Cisco Unified Communications Manager to external devices such as SIP gateways, SIP Proxy Servers, Unified Communications applications, remote clusters, or a Session Management Edition. Ribbon uses the SIP trunk to connect the CUCM to the Ribbon SBC SWE-Lite.

Login to the CUCM as an admin user and go to the following path: Device > Trunk

Click on the Add New icon to add a new Trunk.

Add New Trunk


Set the trunk configuration as shown in the figure below.

Trunk Configuration 1


After clicking the Next button, a new screen will be shown. Set the device (trunk) name, the profiles, and the destination IP address used by the trunk. Below is an example.

Trunk Configuration 2

The IP address on the SWE-Lite towards the CUCM is 192.168.191.216.

Trunk Configuration 3

Click the Save button.

Route Group

In Cisco Unified Communications Manager, use the Call Routing > Route/Hunt > Route Group menu path to configure route groups.

A route group allows you to designate the order in which gateways and trunks are selected. It allows you to prioritize a list of gateways and ports for outgoing trunk selection.

Click on the Add New icon to add a Route Group.

Add New Route Group


Specify the Route Group name and select the devices that are going to be used by this Route Group.

In the example below, the device selected is OrangeSBCLite, created in SIP Trunk above.

Route Group Configuration


Click the Save button. 

Route List

In Cisco Unified Communications Manager Administration, use the Call Routing > Route/Hunt > Route List menu path to configure route lists.

A route list associates a set of route groups in a specified priority order. The route list associates the route groups with one or more route patterns and determines the order in which those route groups are accessed. The order controls the progress of the search for available devices for outgoing calls.

A route list can contain only route groups. Each route list should have at least one route group. Each route group includes at least one device.

Click on the Add New icon to add a Route List.

Add New Route List


In the next screen, specify the Route List name, description, and select the Cisco Unified Communications Manager Group used by the Route List.

Route List Configuration 1


Click the Save button.

After saving, you will be able to add the Route Group to the Route List.

Click the Add Route Group icon to add the Route Group to the Route List.

Route List Configuration 2


Click the Save button. At this point the new Routing List has been created.

Route Pattern

In Cisco Unified Communications Manager Administration, use the Call Routing > Route/Hunt > Route Pattern menu path to configure route patterns.

A route pattern comprises a string of digits (an address) and a set of associated digit manipulations that can be assigned to a route list or a gateway. Route patterns provide flexibility in network design. They work in conjunction with route filters and route lists to direct calls to specific devices and to include, exclude, or modify specific digit patterns.

Click the Add New icon to add a Route Pattern.

Add New Route Pattern


In the next screen, specify the Route Pattern, Description, and Gateway/Route List.

Route Pattern Configuration

Cisco Wildcard

The X wildcard matches any single digit in the range 0 through 9. For instance, the route pattern 9XXX routes or blocks all numbers in the range 9000 through 9999.

For more information regarding special characters and settings on the CISCO CUCM, go to Appendix A.

Click the Save button. At this point the new Route Pattern has been created.

All traffic matching this route pattern will be routed through the route list Orange_SBC_Lite.

SBC SWE-Lite Configuration

The following new configurations are included in this section:

  1. System Settings
  2. Network Interfaces
  3. Static Routes
  4. SIP Profiles
  5. SIP Server Tables
  6. Message Manipulations
  7. Media Profiles
  8. Media Lists
  9. Q.850 to SIP Override Table
  10. Signaling Groups
  11. Transformations Tables
  12. Call Routing Tables

System Settings

The System > Node-Level settings menu path allows you to set the Host name, the Domain name service, and Time management. Below is an example of the system settings.

System Node-level settings

Network Interfaces

The Networking Interfaces > Logical Interfaces menu path allows you to configure the IP addresses (both IPv4 and IPv6) for the Ethernet ports and VLANs.

The SBC SWe Lite supports five system-created logical interfaces (known as Administrative IP, Ethernet 1 IP, Ethernet 2 IP, Ethernet 3 IP, and Ethernet 4 IP). In addition to the system created logical interfaces, the Ribbon SBC SWe supports user-created VLAN logical sub-interfaces.

Administrative IP

The SBC SWe Lite system supports a logical interface called the Admin IP (Administrative IP, also known as the Management IP). A Static IP or DHCP is used for running Initial Setup of the SBC SWe Lite system.

Admin IP

The Administrative IP interface should be used for Running Initial Setup, as well as all management related functionality from the web browser.

Ethernet IP

The SBC SWe Lite system has four logical interfaces. In most deployments, one of these logical interfaces (typically Ethernet 1 IP) is assigned an IP address used for transporting all the VOIP media packets (e.g., RTP, SRTP) and all protocol packets (e.g., SIP, RTCP, TLS). DNS servers in the customer's network should map the SBC SWe Lite system hostname to this IP address. The hostname, or these IP addresses, may be used by UC-enabling systems such as SIP-phones, IP-PBX and Microsoft Lync Servers and for accessing the SBC SWe Lite WebUI.

In the default software, Ethernet 1 IP is enabled and an IPv4 IP address is acquired via a connected DHCP server. This IP address is used for performing Initial Setup on the SBC SWe Lite. See Running Initial Setup for more information. The default IP address for the logical interface named Ethernet 2 IP is 192.168.129.2. After initial configuration, you may configure this logical interface using Settings or Tasks tabs in the WebUI.

Below are examples of the Admin and Ethernet IP interfaces configuration.

Admin IP Configuration

Ethernet IP Configuration

Static Routes

The Protocols > IP > Static Route Table menu path allows you to manually specify the next hop routers used to reach other networks. This is also where you specify the default routes for the connected IP networks (which use 0.0.0.0 as the Destination and Mask).

DHCP Configuration

When DHCP is configured on an interface, the default Static Route (0.0.0.0/0) will be removed and configured dynamically. To view the dynamically created default route, access the WebUI and navigate to Protocols > IP > Routing Table.

To add a new Static Route, click on the plus (+) icon.

Add New Static Route

Create Static IP Route Entry

  • Destination IP

Specifies the destination IP Address

  • Mask

Specifies the network mask of the destination host or subnet. If the 'Destination IP Address' field and 'Mask' field are both 0.0.0.0, the static route is called 'default static route'.

  • Gateway

Specifies the IP Address of the next-hop router to use for this Static Route.

  • Metric

Specifies the cost of this route and indirectly specifies the preference of the route. Lower values indicate more preferred routes. Typical value is 1 for most static routes, indicating that static routes are preferred to dynamic routes.

SIP Profiles

The SIP > SIP Profiles menu path controls how the SBC Edge communicates with SIP devices. They control important characteristics such as: session timers, SIP header customization, SIP timers, MIME payloads, and option tags.

To add a new SIP Profile, click on the plus (+) icon.

New SIP Profile

OBS SIP Profile Configuration

OBS SIP Profile Configuration 1

OBS SIP Profile Configuration 2

OBS SIP Profile Configuration

The configuration in red was modified to fulfill OBS requirements. The rest of the features use the default settings.

CUCM SIP Profile Configuration

CUCM SIP Profile Configuration 1

CUCM SIP Profile Configuration 2

CUCM SIP Profile Configuration

The CUCM SIP Profile uses the default settings

Ventafax SIP Profile Configuration

Ventafax SIP Profile Configuration 1

Ventafax SIP Profile Configuration 2

SIP Server Tables

The SIP > SIP Server Table menu path contains information about the SIP devices connected to the SBC Edge. The entries in the tables provide information about the IP Addresses, ports, and protocols used to communicate with each server. The Table Entries also contain links to counters that are useful for troubleshooting. The SIP Server supports either an FQDN or IP Address (V4 or V6).

OBS SIP Server Table

BTIP

To add a new SIP Server Table, click on the plus (+) icon.

New SIP Server Table


Set a Description and select SIP Server.

New SIP Server Table Description


Select the SIP server table that has just been created.

SIP Server Table Path


Click on the Create SIP Server > IP/FQDN icon to add a new SIP Server.

New SIP Server

Orange BTIP SIP Servers

BTIP uses two SIP Servers, the first one works as an active server and the second one as a backup.

BTIP SIP Server 1

BTIP SIP Server 2

BTIP SIP Servers Configuration

The configuration in red was modified to fulfill OBS requirements. The rest of the features use the default settings.

BTalk

To add a new SIP Server Table, click on the plus (+) icon.

New SIP Server Table


Set a Description and select SIP Server.

New SIP Server Table Description


Select the SIP server table that has just been created.

SIP Server Table Path


Click on the Create SIP Server > IP/FQDN icon to add a new SIP Server.

New SIP Server

Orange BTalk SIP Servers

BTalk uses two SIP Servers, the first one works as an active server and the second one as a backup.

BTalk SIP Server 1

BTalk SIP Server 2

BTalk SIP Servers Configuration

The configuration in red was modified to fulfill OBS requirements. The rest of the features use the default settings.

CUCM SIP Server Table

To add a new SIP Server Table, click on the plus (+) icon.

New SIP Server Table


Set a Description and select SIP Server.

New SIP Server Table Description


Select the SIP server table that has just been created.

SIP Server Table Path


Click on the Create SIP Server > IP/FQDN icon to add a new SIP Server.

New SIP Server

The figure below depicts the CUCM SIP Server Configuration.

CUCM SIP Server Configuration

Ventafax SIP Server Table

To add a new SIP Server Table, click on the plus (+) icon.

New SIP Server Table


Set a Description and select SIP Server.

New SIP Server Table Description


Select the SIP server table that has just been created.

SIP Server Table Path


Click on the Create SIP Server > IP/FQDN icon to add a new SIP Server.

New SIP Server

The figure below depicts the Ventafax SIP Server Configuration.

Ventafax SIP Server Configuration

Message Manipulations

The SIP > Message Manipulation menu path is used to manipulate the incoming or outgoing messages. This feature is intended to enhance interoperability with different vendor equipment and applications, and for correcting any fixable protocol errors in SIP messages on the fly without any changes to firmware/software.

Although SIP is considered a mature protocol, there are still devices running old firmware and systems that interpret the standard in a non-conforming way. In addition, there are cases where a compliant message may be modified to adapt to an application specific requirement.

This capability consists of two components, condition rules and message rules. Condition rules provide a means to identify which messages and what components in the message must be present before any modifications are performed. For example, I want to modify all INVITE messages with a from uri host of "ribbon.net".

The message rule does the actual modification of a message. Once the conditions of a rule have been met, the message rule(s) are applied. Continuing with the example above, a message rule may change the from uri display name to "Ribbon".

SIP Message Manipulation

For more information regarding SIP Message Manipulation go to Appendix A

Condition Rule Table

Condition rules are simple rules that apply to a specific component of a message (e.g., diversion.uri.host, from.uri.host, etc.) the value of the field specified in the Match Type list box can be matched against a literal value, token, or REGEX.

The Condition Rule Table stores a collection of all the user created Condition Rules.

Match_Content-Type

This Condition Rule matches only if SG User Value 1 = application/sdp. This condition is created to identify whether the SDP is present or not in the SIP messages.

SG User Value 1

The SG User Value 1 is stored using a Message Rule (Store_Content-Type) that will be defined in the next section.

SG User Value 1 is the predefined name used by the SBC.

To add a new Condition Rule, go to SIP > Message Manipulation > Condition Rule Table menu path and click on the plus (+) icon.

Condition Rule Table menu path

New Condition Rule


Set the new entry as per the following picture.

Match_Content-Type

Match_Anonymous

This Condition Rule matches only if from.displayname = Anonymous

It compares whether the display name that is in the From header is equal to Anonymous.

This condition is used by a Message Rule (Modify_From_Anonymous) defined in the next section. That rule is used to set the format requested by OBS (sip:anonymous@anonymous.invalid)


To add a new Condition Rule, go to SIP > Message Manipulation > Condition Rule Table menu path and click on the plus (+) icon.

Condition Rule Table menu path

New Condition Rule


Set the new entry as per the following picture.

Match_Anonymous

Message Rule Tables

Message Rule Tables are simply sets of Condition Rules and are applied in SIP Signaling Groups when Message Manipulation is enabled.

The Message Rule Tables collect SIP Messages Manipulations Rules that are applied according to the Message Type set in the Message Rule Tables. The following tables are defined to set the format requested by OBS.


Table DescriptionRulesResult TypeMessage TypeComments
Add_P-Early-MediaAdd P-Early-Media supportedOptional180, 183

This table applies only to 180 and 183 respond messages.

This table collects the rules used to insert the P-Early-Media header requested by OBS.

Del_P-Early-Media
Add_P-Early-Media sendrecv
Store_Content-TypeStore Content-TypeOptional180, 183

This table applies only to 180 and 183 respond messages.

This table collects the rules used to store the Content-type header value. This value is used to know whether the SIP message contains an SDP or not.

Store_User-Agent_Value

Store_User-Agent_Value

Store_Server_Value

OptionalAll

This table applies to all messages.

This table collects the rules used to store the IPPBX User-Agent and Server headers values

OBS_SIP_Profile_Adaptation_01Remove_SGID_From_HeaderOptionalAll

This table applies to all messages.

This table collects rules used to set the format requested by OBS.

Remove_SGID_To_Header
Modify_User-Agent_Header
Modify_Server_header
Modify_Allow_header
OBS_SIP_Profile_Adaptation_02Modify_PAIOptionalRequests

This table applies only to request messages.

This table collects rules used to set the format requested by OBS.

Add plus P-Asserted-Identity
Modify_From_Anonymous
Modify_Diversion
Add_P-Early-Media Table

This table collects the rules that are used to add the P-Early-Media header in the SIP 180 and SIP 183 responses.

To add a new Message Rule Table, go to the SIP > Message Manipulation > Message Rule Tables menu path and click on the plus (+) icon.

Message Rule Table menu path

New Message Rule Table

Set the new entry as per the following picture.

Add_P-Early-Media Table

Add_P-Early-Media Rules
DescriptionRule TypeResult TypeComments
Add P-Early-Media supportedHeader RuleOptionalIt adds the P-Early-Media header value = supported
Del_P-Early-MediaHeader RuleOptionalIt deletes the P-Early-Media header to avoid duplicate headers
Add_P-Early-Media sendrecvHeader RuleOptionalIt adds the P-Early-Media header value = sendrecv
Add P-Early-Media supported

To add a new Message Rule, go to the left menu path and click on the Add_P-Early-Media table you created, then click on the Create Rule > Header Rule icon.

Add_P-Early-Media menu path

New Rule


Set the new entry as per the following picture.

Add P-Early-Media supported 1


Once you select Add in the Header Action field, the bottom section will change its options.

Select Add in the Header Value field and click on the Add/Edit icon.

Add P-Early-Media supported 2


Once you click on the Add/Edit icon, a popup screen appears.

Set the configuration as per the following picture.

Add P-Early-Media supported 3


Click on the Apply icon to save the changes.

Del_P-Early-Media

To add a new Message Rule, go to the left menu path and click on the Add_P-Early-Media table you created, then click on the Create Rule > Header Rule icon.

Add_P-Early-Media menu path

New Rule


Set the new entry as per the following pictures.

For the Condition Expression field, click on the Add/Edit icon. A popup screen appears. Set the configuration as per the following picture.

Del_P-Early-Media rule 1

Condition Expression field


Click on the Apply icon to save the changes.

Add_P-Early-Media sendrecv

To add a new Message Rule, go to the left menu path and click on the Add_P-Early-Media table you created, then click on the Create Rule > Header Rule icon.

Add_P-Early-Media menu path

New Rule


Set the new entry as per the following pictures.

For the Condition Expression field, click on the Add/Edit icon. A popup screen appears. Set the configuration as per the following picture.

Add_P-Early-Media sendrecv 1

Condition Expression


Once you select Add in the Header Action field, the bottom section will change its options. Select Add in the Header Value field and click on the Add/Edit icon.

Header Value


Once you click on the Add/Edit icon, a popup screen appears. Set the configuration as per the following picture.

Message Field


Click on the Apply icon to save the changes.

Store_Content-Type Table

This table collects the rule that is used to store the Content-Type value in the SG User Value 1. It applies only to 180 and 183 respond messages.

This table must be applied on the Signaling Group facing the IPPBX. Set it as Inbound Message Manipulation.

To add a new Message Rule Table, go to the SIP > Message Manipulation > Message Rule Tables menu path and click on the plus (+) icon.

Message Rule Table menu path

New Message Rule Table


Set the new entry as per the following picture.

Store_Content-Type Table

Store_Content-Type Rules
DescriptionRule TypeResult TypeComments
Store Content-TypeHeader RuleOptionalIt stores the Content-Type value in the SG User Value 1
Store Content-Type

To add a new Message Rule, go to the left menu path and click on the Store_Content-Type table you created, then click on the Create Rule > Header Rule icon.

Store_Content-Type menu path

Create Rule


Set the new entry as per the following picture.

Once you select Modify in the Header Action field, the bottom section will change its options. Select Copy Value to in the Header Value field and click on the Add/Edit icon.

Store Content-Type

Once you click on the Add/Edit icon, a popup screen appears. Set the configuration as per the following picture.

Edit Message Field

Click on the Apply icon to save the changes.

Store_User-Agent Table

This table collects the rules that are used to store the User-Agent and Server headers values sent by the IPPBX.

To add a new Message Rule Table, go to the SIP > Message Manipulation > Message Rule Tables menu path and click on the plus (+) icon.

Message Rule Table menu path

New Message Rule Table


Set the new entry as per the following picture.

Store_User-Agent Table

Store_User-Agent Rules
DescriptionRule TypeResult TypeComments
Store_User-Agent_ValueHeader RuleOptionalIt stores the User-Agent value in the SG User Value 2
Store_Server_ValueHeader RuleOptionalIt stores the Server value in the SG User Value 3
Store_User-Agent_Value

To add a new Message Rule, go to the left menu path and click on the Store_User-Agent table you created, then click on the Create Rule > Header Rule icon.

Left Menu Path

CreateRule


Set the new entry as per the following picture.

Once you select Modify in the Header Action field, the bottom section will change its options. Select Copy Value to in the Header Value field and click on the Add/Edit icon.

Store_User-Agent_Value


Once you click on the Add/Edit icon, a popup screen appears. Set the configuration as per the following picture.

Edit Message Field


Click on the Apply icon to save the changes

Store_Server_Value

To add a new Message Rule, go to the left menu path and click on the Store_User-Agent table you created, then click on the Create Rule > Header Rule icon.

Left Menu Path

CreateRule


Set the new entry as per the following picture.

Once you select Modify in the Header Action field, the bottom section will change its options. Select Copy Value to in the Header Value field and click on the Add/Edit icon.

Store_Server_Value


Once you click on the Add/Edit icon, a popup screen appears. Set the configuration as per the following picture.

Edit Message Field


Click on the Apply icon to save the changes.

OBS_SIP_Profile_Adaptation_01 Table

This table collects rules used to set the format requested by OBS. It applies to all messages.

To add a new Message Rule Table, go to the SIP > Message Manipulation > Message Rule Tables menu path and click on the plus (+) icon.

Message Rule Table menu path

New Message Rule Table


Set the new entry as per the following picture.

OBS_SIP_Profile_Adaptation_01

OBS_SIP_Profile_Adaptation_01 Rules
DescriptionRule TypeResult TypeComments
Remove_SGID_From_HeaderHeader RuleOptionalIt removes the SGDI parameter from the FROM header
Remove_SGID_To_HeaderHeader RuleOptionalIt removes the SGDI parameter from the TO header
Modify_User-Agent_HeaderHeader RuleOptionalIt sets the User-Agent value as per OBS requirements
Modify_Server_headerHeader RuleOptionalIt sets the Server value as per OBS requirements
Modify_Allow_headerHeader RuleOptionalIt sets the Allow value as per OBS requirements
Remove_SGID_From_Header

To add a new Message Rule, go to the left menu path and click on the OBS_SIP_Profile_Adaptation_01 table you created, then click on the Create Rule > Header Rule icon.

Left Menu Path

Create Rule


Set the new entry as per the following picture.

Once you select Modify in the Header Action field, the bottom section will change its options. Select Ignore in the Header Value field and click the plus (+) icon in the Header Parameters section.

Remove_SGID_From_Header


Once you click on the plus (+) icon, a popup screen appears. Set the configuration as per the following picture.

Edit Parameter


Click on the Apply icon to save the changes.

Remove_SGID_To_Header

To add a new Message Rule, go to the left menu path and click on the OBS_SIP_Profile_Adaptation_01 table you created, then click on the Create Rule > Header Rule icon.

Left Menu Path

Create Rule


Set the new entry as per the following picture.

Once you select Modify in the Header Action field, the bottom section will change its options. Select Ignore in the Header Value field and click the plus (+) icon in the Header Parameters section.

Remove_SGID_To_Header


Once you click on the plus (+) icon, a popup screen appears. Set the configuration as per the following picture.

Edit Parameter


Click on the Apply icon to save the changes.

Modify_User-Agent_Header

To add a new Message Rule, go to the left menu path and click on the OBS_SIP_Profile_Adaptation_01 table you created, then click on the Create Rule > Header Rule icon.

Left Menu Path

Create Rule


Set the new entry as per the following picture.

Once you select Modify in the Header Action field, the bottom section will change its options. Select Modify in the Header Value field and click on the Add/Edit icon.

Modify_User-Agent_Header


Once you click on the Add/Edit icon a popup screen appears. Set the configuration as per the following picture.

Edit Message Field


Click on the Apply icon to save the changes.

Modify_Server_Header

To add a new Message Rule, go to the left menu path and click on the OBS_SIP_Profile_Adaptation_01 table you created, then click on the Create Rule > Header Rule icon.

Left Menu Path

Create Rule


Set the new entry as per the following picture.

Once you select Modify in the Header Action field, the bottom section will change its options. Select Modify in the Header Value field and click on the Add/Edit icon.

Modify_Server_Header


Once you click on the Add/Edit icon, a popup screen appears. Set the configuration as per the following picture.

Edit Message Field


Click on the Apply icon to save the changes.

Modify_Allow_header

To add a new Message Rule, go to the left menu path and click on the OBS_SIP_Profile_Adaptation_01 table you created, then click on the Create Rule > Header Rule icon.

Left Menu Path

Create Rule


Set the new entry as per the following picture.

Once you select Modify in the Header Action field, the bottom section will change its options. Select Modify in the Header Value field and click on the Add/Edit icon.

Modify_Allow_Header


Once you click on the Add/Edit icon, a popup screen appears. Set the configuration as per the following picture.

Edit Message Field

Edit Message Field

The Value field should contains the following information:

INVITE, ACK, BYE, CANCEL, OPTIONS, UPDATE


Click on the Apply icon to save the changes.

OBS_SIP_Profile_Adaptation_02 Table

This table collects rules used to set the format requested by OBS. It applies to all messages.

To add a new Message Rule Table, go to the SIP > Message Manipulation > Message Rule Tables menu path and click on the plus (+) icon.

Message Rule Table menu path

New Message Rule Table


Set the new entry as per the following picture.

OBS_SIP_Profile_Adaptation_02

OBS_SIP_Profile_Adaptation_02 Rules
DescriptionRule TypeResult TypeComments
Modify_PAIHeader RuleOptionalIt sets the host part of the URI as the local SWeLite IP address
Add plus P-Asserted-IdentityHeader RuleOptionalIt adds a plus (+) in the user part of the URI
Modify_From_AnonymousHeader RuleOptionalWhen the SBC receives an anonymous call, the FROM header is modified according to OBS requirements
Modify_DiversionHeader RuleOptionalIt adds a plus (+) in the user part of the URI and adds the counter parameter
Modify_PAI

To add a new Message Rule, go to the left menu path and click on the OBS_SIP_Profile_Adaptation_02 table you created, then click on the Create Rule > Header Rule icon.

Left Menu Path

Create Rule


Set the new entry as per the following picture

Modify_PAI


Once you select Modify in the Header Action field, the bottom section will change its options. Click on the arrow next to Header Value, then click on the arrow next to URI . Select Modify in the URI Host field and click on the Add/Edit icon

URI Host


Once you click on the Add/Edit icon, a popup screen appears. Set the configuration as per the following picture.

Edit Message Field


Click on the Apply icon to save the changes.

Add plus P-Asserted-Identity

To add a new Message Rule, go to the left menu path and click on the OBS_SIP_Profile_Adaptation_02 table you created, then click on the Create Rule > Header Rule icon.

Left Menu Path

Create Rule


Set the new entry as per the following picture

Once you select Modify in the Header Action field, the bottom section will change its options. Select Modify in the Header Value field and click on the Add/Edit icon.

Add plus P-Asserted-Identity


Once you click on the Add/Edit icon, a popup screen appears. Set the configuration as per the following picture.

Edit Message Field


Click on the Apply icon to save the changes.

Modify_From_Anonymous

To add a new Message Rule, go to the left menu path and click on the OBS_SIP_Profile_Adaptation_02 table you created, then click on the Create Rule > Header Rule icon.

Left Menu Path

Create Rule


Set the new entry as per the following picture.

Modify_From_Anonymous


Click on the Add/Edit icon next to Condition Expression to set the Message Rule Condition.

Condition Expression

Set the Message Rule Condition as per the following picture

Message Rule Condition


Once you select Modify in the Header Action field, the bottom section will change its options. Select Modify in the Header Value field and click on the Add/Edit icon.

Header Value


Once you click on the Add/Edit icon, a popup screen appears. Set the configuration as per the following picture.

Edit Message Field

Edit Message Field

The Replace Regex field should contain the following value:

<sip:anonymous@anonymous.invalid>


Click on the Apply icon to save the changes.

Modify_Diversion

To add a new Message Rule, go to the left menu path and click on the OBS_SIP_Profile_Adaptation_02 table you created, then click on the Create Rule > Header Rule icon.

Left Menu Path

Create Rule


Set the new entry as per the following picture

Once you select Modify in the Header Action field, the bottom section will change its options. Select Modify in the Header Value field and click on the Add/Edit icon.

Add plus P-Asserted-Identity


Once you click on the Add/Edit icon, a popup screen appears. Set the configuration as per the following picture.

Edit Message Field


Click on the plus (+) icon in the Header Parameters section.

Header Paremeters


Once you click on the plus (+) icon, a popup screen appears. Set the configuration as per the following picture.

Counter Parameter


Click on the Apply icon to save the changes.

Media Profiles

The Media > Media Profiles menu path allows you to specify the individual voice and fax compression codecs and their associated settings, for inclusion in a Media List. Different codecs provide varying levels of compression, allowing one to reduce bandwidth requirements at the expense of voice quality.

OBS codecs

DescriptionCodecPayload Size
G.722G.72220 ms
Default G711AG.711 A-Law20 ms
G.729G.72920 ms
Default G711UG.711 U-Law20 ms
T38T.38 Fax

To create a new Media Profile, go to Media > Media Profiles on the left menu path.

Left Menu Path

G.722

Click on the Create Media Profile > Voice Codec Profile icon.

Create Media Profile


Set the new G.722 codec as per the following picture.

G722


Click on the Apply icon to save the changes.

Default G711A

Click on the Create Media Profile > Voice Codec Profile icon.

Create Media Profile


Set the G.711 A-law codec as per the following picture.

G711A


Click on the Apply icon to save the changes.

G.729

Click on the Create Media Profile > Voice Codec Profile icon.

Create Media Profile


Set the G.729 codec as per the following picture.

G729


Click on the Apply icon to save the changes.

Default G711U

Click on the Create Media Profile > Voice Codec Profile icon.

Create Media Profile


Set the  G.711 U-law codec as per the following picture.

G711U


Click on the Apply icon to save the changes.

T38

Click on the Create Media Profile > Fax Codec Profile icon.

Create Media Profile


Set the T.38 codec as per the following picture.

T38


Click on the Apply icon to save the changes.

Media Lists

The Media > Media List menu path allows you to specify a set of codecs and fax profiles that are allowed on a given SIP Signaling Group. They contain one or more Media Profiles, which must first be defined in Media Profiles. These lists allow you to accommodate specific transmission requirements, and SIP devices that only implement a subset of the available voice codecs.

Media Lists

DescriptionMedia Profiles ListSDES-SRTP ProfileMedia DSCPSilence SuppressionModem PassthroughFax Passthrough
Fax Tone Detection
CUCM_MediaList

Default G711A

G.729

None46DisabledEnabledEnabledEnabled
Orange_MediaList-UDP

Default G711A

G.729

T38

None46DisabledEnabledEnabledEnabled

CUCM_MediaList

To add a Media List, go to Media > Media List on the left menu path.

Media List Menu Path


Click on the plus (+) icon to add a new entry.

New Media List


Configure the new entry as per the following picture.

CUCM_MediaList


Click on the Apply icon to save the changes.

Orange_MediaList-UDP

To add a Media List, go to Media > Media List on the left menu path.

Media List Menu Path


Click on the plus (+) icon to add a new entry.

New Media List


Configure the new entry as per the following picture.

Orange_MediaList-UDP


Click on the Apply icon to save the changes.

Q.850 to SIP Override Table

SIP and ISDN use different response messages to communicate why a call failed or could not be connected (Q.850 for ISDN and SIP Responses for SIP). By default, the SBC Edge uses RFC 4497 to map these to each other. The Telephony Mapping Tables > Q.850 to SIP Override Tables menu path allows you to override one or more of these mappings to a different message, which is useful for inter-operating with nonstandard equipment.

To add a new Q.850 to SIP Override Table, go to Telephony Mapping Tables > Q.850 to SIP Override Tables on the left menu path.

Q.850 to SIP Override Menu Path

To add a new Q.850 to SIP Override Table, click on the plus (+) icon.

New Q.850 to SIP Override Table

Set the Description as per the following picture.

Table Description

On the left menu path, click on the OBS Mapping Table.

OBS Mapping Table Menu Path

To add a new entry click on the plus (+) icon.

New Entry


Configure the new entry as per the following picture.

Q.850 to SIP

Click on the Apply icon to save the changes.

Signaling Groups

Signaling groups allow telephony channels to be grouped together for the purposes of routing and shared configuration. They are the entity to which calls are routed, as well as the location from which Call Routes are selected. They are also the location from which Tone Tables and Action Sets are selected.

From-To_CUCM

CUCM Signaling Group Parameters

DescriptionCall Routing TableSIP ProfileSIP Server TableMedia List IDFederated IP/FQDNSignaling DSCPInbound Message ManipulationOutbound Message Manipulation
From-To_CUCMTo_OrangeCUCM_SIPProfileCUCMCUCM_MediaList<CUCM IP Address>40

Store_Content-Type

Store_User-Agent



To add a new Signaling Group, go to the Signaling Groups menu path.

Signaling Groups Menu Path

New Signaling Group


Set the new entry as per the following picture.

From-To_CUCM


Click on the Apply icon to save the changes.

From-To_OrangeBTIP

From-To_OrangeBTIP Signaling Group Parameters

DescriptionCall Routing TableSIP ProfileSIP Server TableMedia List IDFederated IP/FQDNSignaling DSCPQ.850 to SIP Override TableOutbound Message Manipulation
From-To_OrangeBTIPTo_PrivateOrange_SIPProfile-UDPOrange_BTIPOrange_MediaList-UDP<OBS IP Addresses>46

OBS Mapping Table

OBS_SIP_Profile_Adaptation_02

OBS_SIP_Profile_Adaptation_01

Add_P-Early-Media

To add a new Signaling Group, go to Signaling Groups menu path.

Signaling Groups Menu Path

New Signaling Group


Set the new entry as per the following picture.

From-To_OrangeBTIP


Click on the Apply icon to save the changes.

From-To_OrangeBtalk

From-To_OrangeBtalk Signaling Group Parameters

DescriptionCall Routing TableSIP ProfileSIP Server TableMedia List IDFederated IP/FQDNSignaling DSCPQ.850 to SIP Override TableOutbound Message Manipulation
From-To_OrangeBtalkTo_PrivateOrange_SIPProfile-UDPOrange_BtalkOrange_MediaList-UDP<OBS IP Addresses>46

OBS Mapping Table

OBS_SIP_Profile_Adaptation_02

OBS_SIP_Profile_Adaptation_01

Add_P-Early-Media

To add a new Signaling Group, go to Signaling Groups menu path.

Signaling Groups Menu Path

New Signaling Group


Set the new entry as per the following picture.

From-To_OrangeBtalk


Click on the Apply icon to save the changes.

Transformations Tables

Transformation Tables facilitate the conversion of names, numbers and other fields when routing a call. They can, for example, convert a public PSTN number into a private extension number, or into a SIP address (URI). Every entry in a Call Routing Table requires a Transformation Table, and they are selected from there.

Regular Expressions

Regular Expressions (REGEX) is a basic topic to set Transformation Tables. To know more about REGEX go to Appendix A


CUCM_Prefixes

CUCM_Prefixes entries

DescriptionMatch TypeInput FieldOutput Field
TypeValueTypeValue
To_CUCMOptionalCalled Address / Number(\+?)(33.*)Called Address / Number\2

To add a new Transformation Table, go to Call Routing > Transformation on the left menu path.

Transformation Menu Path

Set the Description as per the following picture.

Table Description

On the left menu path, click on the CUCM_Prefixes Table.

CUCM_Prefixes Table

To_CUCM

To add a new entry click on the plus (+) icon.

New Entry


Configure the new entry as per the following picture.

Transformation Entry

Click on the Apply icon to save the changes.

Orange_Btalk

Orange_Btalk entries

DescriptionMatch TypeInput FieldOutput Field
TypeValueTypeValue
Add plus calling numberOptionalCalling Address / Number(\+)?(.*)Calling Address / Number+\2
To_BtalkOptionalCalled Address / Number(\+)?(63|64|65|66|67)(.*)Called Address / Number+\2\3
To add a new Transformation Table, go to Call Routing > Transformation on the left menu path.

Transformation Menu Path

Set the Description as per the following picture.

Table Description

On the left menu path, click on the Orange_Btalk Table.

Orange_Btalk Table

Add plus calling number

To add a new entry click on the plus (+) icon.

New Entry


Configure the new entry as per the following picture.

Transformation Entry

Click on the Apply icon to save the changes.

To_Btalk

To add a new entry click on the plus (+) icon.

New Entry


Configure the new entry as per the following picture.

Transformation Entry

Click on the Apply icon to save the changes.

Orange_BTIP

Orange_BTIP entries

DescriptionMatch TypeInput FieldOutput Field
TypeValueTypeValue
Add plus Calling numberOptionalCalling Address / Number(\+)?(.*)Calling Address / Number+\2
To_BTIPOptionalCalled Address / Number(\+)?(96|33|039910)(.*)Called Address / Number+\2\3
To add a new Transformation Table, go to Call Routing > Transformation on the left menu path.

Transformation Menu Path

Set the Description as per the following picture.

Table Description

On the left menu path, click on the Orange_BTIP Table.

Orange_BTIP Table

Add plus Calling number

To add a new entry click on the plus (+) icon.

New Entry


Configure the new entry as per the following picture.

Transformation Entry

Click on the Apply icon to save the changes.

To_BTIP

To add a new entry click on the plus (+) icon.

New Entry


Configure the new entry as per the following picture.

Transformation Entry

Click on the Apply icon to save the changes.


Call Routing Tables

Call Routing allows calls to be carried between signalling groups, thus allowing calls to be carried between ports, and between protocols. Routes are defined by Call Routing Tables, which allow for flexible configuration of which calls are carried, and how they are translated. These tables are one of the central connection points of the system, linking Transformation Tables, Message Translations, Cause Code Reroute Tables, Media Lists and Signaling Groups.

Call Routing Tables

To_Private

Call Route Entry Parameters

DescriptionNumber/Name Transformation TableDestination Signaling GroupsAudio Stream ModeMedia List
To_CUCMCUCM_PrefixesFrom-To_CUCMDSP Preferred over ProxyCUCM_MediaList

To add a new Call Routing Table, go to Call Routing > Call Routing Table on the left menu path.

Call Routing Table Menu Path

Set the Description as per the following picture.

Table Description

On the left menu path, click on the To_Private Table.

To_Private Table


To_CUCM

To add a new entry click on the plus (+) icon.

New Entry


Configure the new entry as per the following picture.

Call Route Entry

Click on the Apply icon to save the changes.

To_Orange

Call Route Entry Parameters

DescriptionNumber/Name Transformation TableDestination Signaling GroupsAudio Stream ModeMedia TranscodingMedia List
To_OrangeBtalkOrange_BtalkFrom-To_OrangeBtalkDSP Preferred over ProxyEnabledOrange_MediaList-UDP
To_OrangeBTIPOrange_BTIPFrom-To_OrangeBTIPDSP Preferred over ProxyEnabledOrange_MediaList-UDP

To add a new Call Routing Table, go to Call Routing > Call Routing Table on the left menu path.

Call Routing Table Menu Path

Set the Description as per the following picture.

Table Description

On the left menu path, click on the To_Orange Table.

To_Orange Table

To_OrangeBtalk

To add a new entry click on the plus (+) icon.

New Entry


Configure the new entry as per the following picture.

Call Route Entry

Click on the Apply icon to save the changes.

To_OrangeBTIP

To add a new entry click on the plus (+) icon.

New Entry


Configure the new entry as per the following picture.

Call Route Entry

Click on the Apply icon to save the changes.

Test Results

Test Results

Preliminary Phase
Use CaseTest IDTest CaseTest ResultComments
Basic CallBC01BC01_[Phone_1]_[OFFNET]OK
BC02BC02_[OFFNET]_[Phone_1]OK
Long Duration Call + CLIRLCLIR01LCLIR01_[Phone_1]_[OFFNET]OK
LCLIR02LCLIR02_[OFFNET]_[Phone_1]OK
Call CancellationCANC01CANC01_[Phone_1]_[OFFNET]OK
CANC02CANC02_[OFFNET]_[Phone_1]OK
DTMF + VoicemailDTMF03DTMF03_[Phone_1]_[OFFNET-IVR]OK
DTMF04DTMF04_[OFFNET-voicemail]_[Phone_1]OK
TransferSupervised + MOHTRMOH01TRMOH01_[OFFNET]_[Phone_1]_[OFFNET]OK
BlindTRAB01TRAB01_[OFFNET]_[Phone_1]_[OFFNET]OK
TRAB04TRAB04_[OFFNET]_[Phone_1]_[OFFNET-IVR]OK
ForwardUnconditionalFWDU01FWDU01_[OFFNET]_[Phone_1]_[OFFNET]OK
FWDU04FWDU04_[OFFNET]_[Phone_1]_[OFFNET-IVR]OK
No AnswerFWDNA01FWDNA01_[OFFNET]_[Phone_1]_[OFFNET]OK
SVAIPSVAIP02SVAIP02_[IPBX-ForcedONNET]_[SAN-SVAIP+33296084273]N/AOut of scope as it is currently not possible to perform those tests
Advanced Phase
Use CaseTest IDTest CaseTest ResultComments
Busy CallBUSY01BUSY01_[Phone_1]_[OFFNET]OK
BUSY02BUSY02_[OFFNET]_[Phone_1]OK
Not Answered CallNA01NA01_[Phone_1]_[OFFNET]OK
NA02NA02_[OFFNET]_[Phone_1]OK
TransferSupervisedTRAS02TRAS02_[OFFNET]_[Phone_1]_[Phone_2]OK
TRAS03TRAS03_[Phone_1]_[Phone_2]_[OFFNET]OK
BlindTRAB02TRAB02_[OFFNET]_[Phone_1]_[Phone_2]OK
TRAB03TRAB03_[Phone_1]_[Phone_2]_[OFFNET]OK
ForwardUnconditionalFWDU02FWDU02_[OFFNET]_[Phone_1]_[Phone_2]OK
BusyFWDB02FWDB02_[OFFNET]_[Phone_1]_[Phone_2]OK
No AnswerFWDNA02FWDNA02_[OFFNET]_[Phone_1]_[Phone_2]OK
FWDNA03FWDNA03_[Phone_1]_[Phone_2]_[OFFNET]OK
FWDNA04FWDNA04_[OFFNET]_[Phone_1]_[OFFNET-IVR]OK
Conference X3CONF01CONF01_[OFFNET]_[Phone_1]_[OFFNET]OK
Prehook(with) Transfer Sup.PREHOOK01PREHOOK01_[OFFNET]_[Phone_1]_[OFFNET]N/A
PREHOOK02PREHOOK02_[OFFNET]_[Phone_1]_[Phone_2]N/A
PREHOOK03PREHOOK03_[Phone_1]_[Phone_2]_[OFFNET]N/A
(with) ForwardPREHOOK04PREHOOK04_[OFFNET]_[Phone_1]_[OFFNET]N/A
Call FeaturesCall ParkingCPA01CPA01_[Phone_1]_[OFFNET]_[Phone_2]OK
Call PickupPKU01PKU01_[OFFNET]_[Phone_1]_[Phone_2]OK
Hunt GroupHUG01HUG01_[OFFNET]_[Phone_1]OK
Second LineSL01SL01_[OFFNET]_[Phone_1]OK
DTMFDTMF03DTMF03_[Phone_1]_[OFFNET-IVR]OK
E2E OverflowOVF01

OVF01_[NBI-Int+670012144326845]_[cSBCRibbon+33296031233]_[]

OK
OVF02

OVF02_[Offnet-Devil+ +960012144326845]_[cSBCRibbon+33296086974]_[]

OK
OVF03

OVF03_[NBI-Fr+33399106845]_[cSBCRibbon+33296031233]_[]

OK
OVF04

OVF04_[OFFNET]_[select device]_[]

N/A
OVF05

OVF05_[OFFNET]_[select device]_[]

N/A
OVF06

OVF06_[OFFNET]_[select device]_[]

N/A
OVF07

OVF07_[NBI-Int+670012144326845]_[cSBCRibbon+33296039150]_[]

OK
OVF08

OVF08_[cSBCRibbon+33296031233]_[Offnet-NBI-Fr+33399106845]_[]

OK
OVF09

OVF09_[cSBCRibbon+33296031233]_[Offnet-NBI-Fr+33399106845]_[]

OK
CACCAC01CAC01_[OFFNET]_[Phone_1]N/A
CAC02CAC02_[Phone_1]_[OFFNET]N/A
CAC03CAC03_[Phone_1]_[Phone_2]N/A
CAC04CAC04_[OFFNET]_[Phone_1]_[Phone_2]N/A
CAC05CAC05_[OFFNET]_[Phone_1]_[Phone_2]N/A
Emergency NumberEMN01EMN01_[Phone_1]_[OFFNET-EMN]OK
EMN02EMN02_[Phone_1]_[OFFNET-EMN]N/A
EMN03EMN03_[Phone_1]_[OFFNET-EMN]OK
Attendant ConsoleAC01AC01_[OFFNET]_[Phone_1]_[Phone_2]N/A
AC02AC02_[OFFNET]_[Phone_1]_[Phone_2]N/A
AC03AC03_[OFFNET]_[Phone_1]_[Phone_2]N/A
AC04AC04_[OFFNET]_[Phone_1]_[Phone_2]N/A
Fax Tests
Use CaseTest IDTest CaseTest ResultComments
FaxOffnet -> HQFax_01Devil+_IPTEL_G3OK
Fax_02Devil+_IPTEL_SG3N/A
Fax_03Neo_IPTEL_G3OK
Fax_04Neo_IPTEL_SG3N/A
Fax_05NBI-France_IPTEL_G3OK
Fax_06NBI-France_IPTEL_SG3N/A
Fax_07NBI-International_IPTEL_G3OK
Fax_08NBI-International_IPTEL_SG3N/A
HQ -> OffnetFax_09IPTEL_Devil+_G3OK
Fax_10IPTEL_Devil+_SG3N/A
Fax_11IPTEL_Neo_G3OK
Fax_12IPTEL_Neo_SG3N/A
Fax_13IPTEL_NBI-France_G3OK
Fax_14IPTEL_NBI-France_SG3N/A
Fax_15IPTEL_NBI-International_G3OK
Fax_16IPTEL_NBI-International_SG3N/A

Conclusion

These Application Notes describe the configuration steps required for Ribbon to successfully interoperate with OBS. All feature and serviceability test cases were completed and passed with the exceptions/observations noted in Test Results.

Appendix A