This document provides a configuration guide for Ribbon EdgeMarc 6000 when connecting to MS Teams.
This configuration guide supports features given in the Virgin Media SIP Trunk Application.
The interoperability compliance testing focuses on verifying inbound and outbound call flows between Ribbon EdgeMarc 6000 and MS Teams platform.
This is a technical document intended for telecommunications engineers for configuring both the Ribbon SBCs and the third-party product. Users will perform steps to navigate the third-party product as well as the Ribbon SBC Command Line Interface (CLI). Understanding the basic concepts of TCP/UDP/TLS, IP/Routing and SIP/RTP is also necessary for completing 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.
The following equipment and software were used for the sample configuration:
The following reference configuration shows the connectivity between the third-party and Ribbon EdgeMarc 6000.
For any questions regarding this document or its content, contact your maintenance and support provider.
Ribbon supports the following third-party product features:
The following new configurations are included in this section:
Consult Microsoft documentation for detailed information on Direct Routing interface configuration guidelines, including the RFC standards and the syntax of SIP messages.
The following table provides the requirements for configuring the SBC to support Teams Direct Routing:
Table1 : SBC Requirements
Requirement | How it is used |
---|---|
Public IP address of NAT device (must be Static)* Private IP address of the SBC | Required for SBC Behind the NAT deployment. |
Public IP address of SBC | Required for SBC with Public IP deployment. |
Public FQDN | The Public FQDN must point to the Public IP Address. |
*NAT translates a public IP address to a Private IP address.
For the SBC to pair with Microsoft Teams, ensure that the SBC FQDN domain name matches with the name registered in both the Domains and DomainUrlMap fields of the Tenant.
Follow the steps to verify that the correct domain name is configured for the Tenant:
You can configure users from any SIP domain registered for the tenant. For example, you can configure user user@example.com with the SBC FQDN name sbc2.examplevoice.com, as long as both names are registered for the tenant.
Table 2: Domain Name Examples
Domain Name | Use for SBC FQDN | FQDN names - Examples | IPv4 Address |
---|---|---|---|
rbbn.com | Valid names: sbc1.rbbn.com | 203.0.113.100 | |
Valid names: Invalid name: (This requires registering the domain name emea.rbbnvoice.com in “Domains” first.) | - |
Configure Domain Names - Example :
Make sure that the certificate is issued by one of the supported certification authorities (CA). Note that wildcard certificates are supported.
Microsoft Teams Direct Routing allows only TLS connections from the SBC for SIP traffic with a certificate signed by one of the trusted certification authorities.
Follow the steps to request a certificate for the SBC External interface and configure it based on the example using the GlobalSign:
You can obtain the certificate through the Certificate Signing Request (see the following instructions). You can obtain the Trusted Root and Intermediary Signing Certificates from your certification authority.
A Tenant is used within the Microsoft environment as a single independent enterprise that has subscribed to Office 365 services. Through this tenant, administrators can manage projects, users, and roles. Perform the following steps to configure the Tenant. For details on accessing the Tenant, refer to Microsoft Teams Documentation.
2. Configure Teams usage for the user:
a. Enter the User Identity (see example below - user1@domain.com)
Click Network > Static Routes to configure the routes.
The following table provides information about the tests that Ribbon performed to complete all scenarios that Virgin Media needs for its customers.
S.No | Procedure | Observation | Result | Comment |
---|---|---|---|---|
IOP1 | Vendors eSBC response to SIP OPTIONS messages from SBC | No calls are required for this test. Capture the SIP trace for approximately 60 seconds and check for correct signaling. For each eSBC, the SBC periodically sends an OPTIONS request to the vendors eSBC to check if its SIP stack is reachable. If the IP-PBX sends a SIP response 200 OK, the SIP trunk is placed or remains in an In-Service state. Example: OPTIONS sip:ping@<ip-pbx_IP_Addr>:5060 SIP/2.0 | Pass | |
IOP2 | SBC response to SIP OPTIONS messages from vendor eSBC | No calls are required for this test. Capture SIP trace for approximately 60 seconds (depending on agreement) and check for correct signaling. Vendors eSBC setup for Solution IP.Addr Mode
Example:
| Pass | |
IOP4 | Basic test call from IP-PBX to PSTN line through SBC-A (using SBC-A IPV4 ip address) |
Vendors eSBC setup for Solution IP.Addr Mode A call progresses successfully when:
Example:
| Pass | |
IOP5 | Basic test call from IP-PBX to PSTN line through SBC-B (using SBC-B IPV4 ip address) Vendor to configure eSBC so that it used secondary SBC (SBC_B) for this test Once the test completes, eSBC to be configured to use Primary SBC-A for calls to route to |
Vendors eSBC setup for Solution IP.Addr Mode A call progresses successfully when:
Example: Check the Wireshark trace to confirm that the G.711 A law codec with 10ms or 20ms packetization is used. | Pass | |
IOP7b | Called Number format - vendors eSBC to soft switch number normalization - Global Dial Plan Test eSBC capability to send the called number in one of the following Global number formats (user part of Request & To URIs) 0yyyyyyyyyy (where y refers to any number, calling party = national) | Configure the SBC for Global calling plan.
| Pass | |
IOP8b | Calling Number format - vendors eSBC to soft switch number normalization - Global Dial Plan Test eSBC capability to send calling number in one of the following Global number formats (user part of FROM & PAI URIs) 0yyyyyyyyyy (where y refers to any number, calling party = national) | Configure the SBC for Global calling plan.
| Pass | |
IOP9b | Called Number format - soft switch to eSBC number normalization - Global Dial Plan Test eSBC capability of accepting the called number in one of the following Global number formats (user part of Request & To URIs) +44yyyyyyyyy (where y refers to any number, calling party = national) | Configure the SBC for Global calling plan.
| Pass | |
IOP10b | Calling Number format - soft switch to eSBC number normalization - Global Dial Plan Test eSBC capability of accepting the calling number in one of the following Global number formats (user part of FROM & PAI URIs) +44yyyyyyyyy (where y refers to any number, calling party = national) | Configure the SBC for Global calling plan.
| Pass | |
IOP11 | Emergency Call Handling -IP-PBX Line to PSTN - UK Emergency call 999 |
Example: | Pass | |
IOP12 | Emergency Call Handling -IP-PBX Line to PSTN - UK Emergency call 112 |
Example: | Pass | |
IOP13 | Emergency Call Handling -IP-PBX Line to PSTN - UK Emergency call 18000 - Text Direct |
Example: | Pass | |
IOP14 | IP-PBX Line to PSTN - call answer - Originator disconnect |
| Pass | |
IOP15 | PSTN calls SIP #1, SIP #1 conferences in SIP #2 |
| Pass | |
IOP16 | IP-PBX Line to PSTN - Busy subscriber |
| Pass | |
IOP17 | IP-PBX Line to PSTN - No answer timeout test |
| Pass With Caveat | The timeout should be coming from our end, but 90 seconds timeout from MS Teams precedes that. |
IOP18 | IP-PBX Line to PSTN - Subscriber not reachable Vendor to call 01189111111 |
| Pass | |
IOP19 | PSTN Line to IP-PBX - call answer - Originator disconnect. |
| Pass | . |
IOP20 | PSTN Line to IP-PBX - call answer - Terminator disconnect |
| Pass | |
IOP21 | PSTN Line to IP-PBX - busy subscriber |
| Not-executed | SBC team from VM advised to change this to not executed because it would mean a change to MS team server from it default configuration to get busy and we should not be change the default configuration on MS team server. |
IOP22 | PSTN Line to IP-PBX - No answer timeout test, Invoked by PBX |
| Pass | |
IOP23 | PSTN Line to IP-PBX - subscriber not reachable |
| Pass | |
IOP24 | Verify CLIP service on IP-PBX line (incoming call from PSTN) |
| Pass | |
IOP25 | Verify CLIR service on IP-PBX line (incoming call from PSTN) |
| Pass | |
IOP26 | Verify CLIP service on PSTN line (outgoing call from IP-PBX, From) |
| Pass | |
IOP27 | Verify CLIP service on PSTN line (outgoing call from IP-PBX, PAI/PPI) Vendor to ensure PAI number is different to that from which the call originates |
| Pass | |
IOP28 | Verify CLIR service on PSTN line (outgoing call from IP-PBX) |
Example:
| Pass | |
IOP29 | Verify Call Forward Immediate (unconditional) on a IP-PBX line (Incoming call from PSTN, call forward terminates within IP-PBX) |
The IP-PBX does not have configuration settings to send SIP status 181 messages to the soft switch. | Pass | |
IOP30 | Verify Call Forward Immediate (unconditional) on a IP-PBX line (Incoming call from PSTN, call forward terminates PSTN) |
| Pass | |
IOP31 | Verify Call Forward Busy on IP-PBX line (Incoming call from PSTN, call forward terminates within IP-PBX) |
| Pass | |
IOP32 | Verify Call Forward No-answer on IP-PBX line (Incoming call from PSTN, call forward terminates within IP-PBX) |
| Pass | |
IOP33 | Verify Call Hold Service on IP-PBX (Incoming call from PSTN) |
| Pass | |
IOP34 | Verify 3-party conference service on IP-PBX (Incoming call from PSTN, 3rd party within IP-PBX) |
| Pass | |
IOP35 | Verify 3-party conference service on IP-PBX (Incoming call from PSTN, 3rd party PSTN) |
| Pass | |
IOP36 | Verify do-not-disturb service on IP-PBX line (Incoming call from PSTN) |
| Pass | |
IOP37 | Verify Call park service on IP-PBX line (Incoming call from PSTN) |
| Pass | |
IOP38 | Verify Call Waiting on an IP-PBX line, involving a PSTN line |
| Pass | |
IOP39 | Verify DTMF transmission from/to IP-PBX - Inband |
The received DTMF tone is reflective of the length of time the key was pressed. | Not-executed | SBC team from VM changed this to not executed as IN Band DTMF tones is not currently support and it will require a feature to be added to the code. |
IOP40 | Verify DTMF transmission from/to IP-PBX - RFC 2833 - telephone-event |
The received DTMF tone is reflective the length of time the key was pressed. | Pass | |
IOP41 | T.38 Fax transmission mode - PSTN to IP-PBX origination |
| Not-executed | MS Teams does not support Fax. |
IOP42 | T.38 Fax transmission mode - IP-PBX to PSTN origination |
| Not-executed | MS Teams does not support Fax. |
IOP43 | In-band G.711 Fax transmission mode - PSTN to IP-PBX origination |
| Not-executed | MS Teams does not support Fax. |
IOP44 | In-band G.711 Fax transmission mode - IP-PBX to PSTN origination |
| Not-executed | MS Teams does not support Fax. |
IOP45 | Test for call in progress audit function (response to in-call OPTIONS from soft switch to eSBC) & session refresh & response to UPDATE messages. |
| Pass | |
IOP46 | Test for 4 simultaneous calls: 2 inbound, 2 outbound calls Vendor to configure eSBC for Round robin to ensure calls go to both Primary and secondary SBC |
| Not-executed | Round robin outbound calls is not a feature of the EdgeMarc platform. Adding this feature requires a change in the Edgemarc code. |
IOP47 | Test for eSBC endpoint restart-recovery |
| Pass | |
IOP48 | Test for eSBC loss of Ethernet link and reconnection |
| Pass With Caveat | It takes five minutes before Edgmarc EM6000 accepts inbound calls when MS Teams or the SIP Trunk becomes unreachable,. Five consecutive Options (pings) are required from the EdgeMarc before it declares a trunk is available or clears the unreachable alarm.) |
IOP49 | Test for the Primary SBC loss | ** Contact MSL engineer to carry out the following **
** Contact MSL engineer to carry out the following **
| Pass | |
IOP51 | Test for Call forward Internal Busy | Additional test to cover when vendors are using Microsoft Skype for Business 2015:
| Pass | |
IOP52 | Test for Call forward internal on No Answer | Additional test to cover when vendors are using Microsoft Skype for Business 2015:
| Pass | |
IOP53 | Test for making a call from a PBX to a PSTN |
| Not-executed | Since MS Teams does not support Fax, configuring T.38 on the Edgemarc platform when using MS Teams is never required. |