Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Add_workflow_for_techpubs
AUTH1UserResourceIdentifier{userKey=8a00a0c85bb25531015bc4122a4f0003, userName='null'}
JIRAIDAUTHCHOR-9807
REV5UserResourceIdentifier{userKey=8a00a02355cd1c2f0155cd26cabc04c3, userName='null'}
REV6UserResourceIdentifier{userKey=8a00a0c85bb25531015bc4122a4f0003, userName='null'}
REV3UserResourceIdentifier{userKey=8a00a02355cd1c2f0155cd26cc2d0797, userName='null'}
REV1UserResourceIdentifier{userKey=8a00a02355cd1c2f0155cd26cef20cbf, userName='null'}

Panel

Table of Contents

Overview

Note
titleCaution

When the 

Spacevars
0product3
is deployed in Azure, the 
Spacevars
0product3
 supports Local Media Optimization.

The Central SBC and the Proxy SBC roles are supported in all deployments as follows:

  1. Confirm that in all deployments, private interfaces are assured between relevant parties, as identified at: https://docs.microsoft.com/en-us/microsoftteams/direct-routing-media-optimization 
  2. Secondly, acceptable network connectivity and performance between all nodes (typically indicated by KPIs) must be maintained for an acceptable level of LMO service.
  3. Exercise caution and ensure a high quality link to the Public Cloud (Azure) to ensure acceptable Central SBC/Proxy SBC roles and LMO behavior. Currently, Ribbon and Microsoft strongly encourage the use of ExpressRoute to ensure proper LMO performance.
  4. Ribbon and Microsoft reserve the right to decline support for LMO issues should proper care and network conditions not meet the requirements listed out in the point above.


Info
titleNote

This best practice uses the term Microsoft Teams Direct Routing, which is also known as Phone System Direct Routing.

This best practice outlines how to use the 

Spacevars
0company
 
Spacevars
0product
to configure the Central SBC with Local Media Optimization for Microsoft Teams Direct Routing. Local Media Optimization allows the Microsoft Teams Direct Routing media flow to always use the shortest path to improve the
Spacevars
0product
's media quality and bandwidth usage. The Microsoft Teams Direct Routing media flow can be directly established between the Teams client and the
Spacevars
0product2
, even if the 
Spacevars
0product2
does not have Microsoft Teams Direct Routing connectivity. The
Spacevars
0series
,
Spacevars
0series2
, and 
Spacevars
0product3
support the Central SBC. For more details about this feature, refer to Local Media Optimization for Direct Routing.

Caption
0Figure
1Microsoft Teams Direct Routing Media Flow


This best practice describes greenfield and migration deployments and explains the requirements for each case. This best practice includes cautions to specify the deployment scenarios.

Though the

Spacevars
0series
,
Spacevars
0series2
, and 
Spacevars
0product3
support the Local Media Optimization Central SBC role for Microsoft Teams Direct Routing, this best practice uses the
Spacevars
0product3
as a Central
Spacevars
0product2
in the central site as an example.

Info
titleNote

For the Central

Spacevars
0product2
Spacevars
0company
recommends that you use the
Spacevars
0product3
because it has higher CPS (up to 10 CPS) and higher session density (up to 1200 simultaneous Direct Routing calls).

Make sure the licensed quantity of sessions on the 

Spacevars
0product3
accommodates the maximum number of Local Media Optimization calls.

Microsoft Considerations

The Ribbon TEAMS Local Media Optimization (LMO) solution supports Teams Music on Hold (MOH). The Microsoft Teams LMO document suggests disabling the MOH feature for an LMO deployment because not all SBC vendors support the Teams MOH feature for LMO deployments.

Microsoft does not support Early 183. You should disable Early 183 for all 

Spacevars
0product2
signaling groups that use Local Media Optimization. For information about Early 183, refer to the Early 183 section in Creating and Modifying SIP Signaling Groups.

Prerequisites

This section outlines the prerequisites for Local Media Optimization for Microsoft Teams Direct Routing.

Spacevars
0product2
 Capacity

When deploying Local Media Optimization, the Central

Spacevars
0product2
has to handle the local traffic plus all the traffic from other non-LMO SBCs (SBC not processing the LMO calls), You must ensure the Central
Spacevars
0product2
has the capacity and the license to handle the load. See the following load impacts:

  • Call made to and from a Teams client that is internal to the customer network:
    • The Central
      Spacevars
      0product2
      consumes the Proxy Media Mode with Encryption resource.
    • The non-LMO SBC
      Spacevars
      0product2
      (SBC not processing the LMO calls)  consumes the SIP with corresponding RTP Media resource.
  • Call made to and from a Teams client that is external to the customer network:
    • The Proxy 
      Spacevars
      0product2
      consumes the SIP with corresponding RTP Media resource.
    • The Downstream 
      Spacevars
      0product2
      consumes the
      SIP with corresponding RTP Media resource.

Firmware Requirement

The Central

Spacevars
0product2
requires the following firmware: 9.0.0 and later.

Info
titleNote

This document outlines only the recommended firmware.

Microsoft Direct Routing Configuration

You must configure the following for Microsoft Teams Direct Routing:

  • You must plan the Microsoft Teams tenant for Local Media Optimization usage according to the Local Media Optimization for Direct Routing document.
  • You must configure the Microsoft Teams tenant for Local Media Optimization usage according to the Configure Local Media Optimization for Direct Routing document. When you configure the Microsoft Teams Direct Routing, you must also configure the following items:
    • CsTenantTrustedIPAddress

    • CsTenantNetworkRegion

    • CsTenantNetworkSite

    • CsTenantNetworkSubnet

    • CSOnlinePSTNGateway

    • CsOnlineVoiceRoute

Licensing Requirements

The LMO functionality requires the Downstream SBCs to use a Proxy/Central SBC as a registrar, hence this requires the Proxy/Central SBC to have SIP Registration licenses. This applies for both 1000/2000 and SBC SWe Edge. 

Certificate Usage

The Central

Spacevars
0product2
requires a certificate signed by a public certificate authority.

Public Certificate

The public certificate must be issued by one of the supported certification authorities (CAs). Wildcard certificates are supported.

Anchor
domain
domain
Domain Name

For the 

Spacevars
0product
to pair with Microsoft Teams, the 
Spacevars
0product2
FQDN domain name must match a name registered in both the Domains and DomainUrlMap fields of the Tenant. Verify the correct domain name is configured for the Tenant as follows:

  1. On the Microsoft Teams Tenant side, execute Get-CsTenant.
  2. Review the output.
  3. Verify that the Domain Name configured is listed in the Domains and DomainUrlMap attributes for the Tenant. If the Domain Name is incorrect or missing, the 
    Spacevars
    0product2
    will not pair with Microsoft Teams.

Users may be from any SIP domain registered for the tenant. For example, you can configure user user@SonusMS01.com with the 

Spacevars
0product2
FQDN name sbc1.hybridvoice.org, as long as both names are registered for the tenant.

Caption
0Table
1Domain Name Examples


Domain Name*

Use for 

Spacevars
0product2
FQDN?

FQDN Names - Examples
SonusMS01.com(tick)

Valid names:

  • aepsite6.SonusMS01.com

hybridvoice.org

(tick)

Valid names:

  • sbc1. hybridvoice.org
  • ussbcs15. hybridvoice.org
  • europe. hybridvoice.org

Non-Valid name:

sbc1.europe.hybridvoice.org (requires registering domain name europe. hybridvoice.org in “Domains” first)

*Do not use the *.onmicrosoft.com tenant for the domain name.


Caption
0Figure
1Configure Domain Names - Example
 

Name Resolution

The Central

Spacevars
0product2
FQDN needs to be resolved in a publicly accessible DNS.

Info
titleNote

This best practice uses host entries.

Implementation

This best practice uses the FQDN and ports illustrated in the following figure.

Caption
0Figure
1FQDN and Port Usage


Prepare Central
Spacevars
0product2

This section outlines how to prepare the Central

Spacevars
0product2
.

Install 
Spacevars
0product2
and Perform Initial Setup

Note
titleCaution

Perform this procedure only if you are creating a new 

Spacevars
0product2
for the Central role (a greenfield scenario).

Use the following procedure to install the 

Spacevars
0product2
and perform the initial setup: Installing SBC SWe Edge

Info
titleNote

For the

Spacevars
0longproduct
, use the following procedure to install the SBC and perform the initial setup: Installing SBC 1000/2000

Run Easy Config Wizard on Central
Spacevars
0product2

Once your 

Spacevars
0product2
is up and running, you must configure the 
Spacevars
0product2
to connect to the Microsoft Teams Direct Routing Server and allow the Downstream 
Spacevars
0product2
connection.

  1. Access a compatible web browser.
  2. In the browser, enter the IP address of the 
    Spacevars
    0product
    in the URL address bar. The Welcome to
    Spacevars
    0company
    screen is displayed.
  3. Review the Pre-Login message.
  4. Enter the administrator User Name and Password configured during initial setup.
  5. If the Acknowledge Pre-Login Message checkbox is displayed, click on it to acknowledge you have reviewed the pre-login information above. After initial login, this checkbox can be enabled and disabled via the Global Security Options. By default, this checkbox is configured as disabled.
  6. Click Login. The main screen provides all WebUI functions, including tabbed options, menu tree, device name, and the last login date and time of the system.

  7. Select Tasks > SBC Easy Setup > Easy Config Wizard.

    Caption
    0Figure
    1Easy Config Wizard


  8.  In the Application field, select your application. This best practice configures the SIP Trunk  Microsoft Teams.

    Caption
    0Figure
    1Easy Configuration Step 1


  9. Configure the other fields in Step 1 and click Next.
  10. In the SIP Trunk section, configure the Border Element Server with the FQDN or IP of the central SIP Trunk.

  11. In the Teams Connection Type field, select Local Media Optimization.

    Info

    The Easy Configuration Wizard automatically generates two ACL tables for Microsoft Teams Direct Routing. In the table that contains the Teams Direct Routing ACL in the name, Rule #4 was setup for deployments where a single ethernet port was used for both Microsoft Teams Direct Routing and a SIP Trunk; this rule may be too permissive for your configuration. If the SBC was deployed with only Microsoft Teams Direct Routing on an ethernet port, Rule #4 could be modified to have the Source IP Address set to 52.112.0.0 and Source Netmask set to 255.252.0.0. This change allows only SIP Signaling from Microsoft Teams.


  12. Configure the other fields in the Microsoft Teams section and click Next.

  13. Review your configuration information in Step 3 and click Finish.


Import Certificate on Central
Spacevars
0product2

This section outlines how to import a certificate on the Central

Spacevars
0product2
.

Anchor
config_certificate
config_certificate
Configure and Generate Certificates on the
Spacevars
0product2

Expand
titleClick here to expand for how to generate Certificates on the SBC


Warning
titleWarning: Common Encryption Certificate Issues Arise from Missing Root Certificates
  • Did you only install the CA-signed 
    Spacevars
    0product2
    certificate, along with the intermediate certificate(s) sent by your issuing CA?
  • Did you get the following error message from the
    Spacevars
    0product2
    ?



If so, the likely reason is a missing CA Root Certificate. The 

Spacevars
0product2
does not have any pre-installed CA root X.509 certificates, unlike typical browsers found on your PC. Ensure the entire certificate chain of trust is installed on the
Spacevars
0product2
, including the root certificate. Acquire the CA root certificate as follows:

  1. Contact your system administrator or certificate vendor to acquire the root, and any further missing intermediate certificate(s) to provision the entire certificate chain of trust within the
    Spacevars
    0product2
    ;
  2. Load the root certificate, along with the intermediate and 
    Spacevars
    0product2
    certificates, according to Importing Trusted Root CA Certificates.

NOTE: Root certificates are easily acquired from the certificate authorities. For example, the root certificate for the GoDaddy Class 2 Certification Authority may be found at https://ssl-ccp.godaddy.com/repository?origin=CALLISTO . For more information about root certificates, intermediate certificates, and the 

Spacevars
0product2
server (“leaf”) certificates, refer to this tutorial.

For other certificate-related errors, refer to Common Troubleshooting Issues with Certificates in SBC Edge Portfolio.

Microsoft Teams Direct Routing allows only TLS connections from the 

Spacevars
0product2
for SIP traffic with a certificate signed by one of the trusted certification authorities.

Request a certificate for the 

Spacevars
0product2
External interface and configure it based on the example using GlobalSign as follows:

  • Generate a Certificate Signing Request (CSR) and obtain the certificate from a supported Certification Authority.
  • Import the Public CA Root/Intermediate Certificate on the
    Spacevars
    0product2
    .
  • Import the Microsoft CA Certificate on the
    Spacevars
    0product2
    .
  • Import the 
    Spacevars
    0product2
    Certificate.
Info
titleNote

The certificate is obtained through the Certificate Signing Request (instructions below). The Trusted Root and Intermediary Signing Certificates are obtained from your certification authority.

Step 1: Generate a Certificate Signing Request and obtain the certificate from a supported Certification Authority (CA)

Many CA's do not support a private key with a length of 1024 bits. Validate with your CA requirements and select the appropriate length of the key.

  1. Access a compatible web browser.
  2. In the browser, enter the IP address of the 
    Spacevars
    0product
    in the URL address bar. The Welcome to
    Spacevars
    0company
    screen is displayed.
  3. Review the Pre-Login message.
  4. Enter the administrator User Name and Password configured during initial setup.
  5. If the Acknowledge Pre-Login Message checkbox is displayed, click on it to acknowledge you have reviewed the pre-login information above. After initial login, this checkbox can be enabled and disabled via the Global Security Options. By default, this checkbox is configured as disabled.
  6. Click Login. The main screen provides all WebUI functions, including tabbed options, menu tree, device name, and the last login date and time of the system.

  7. Access Settings > Security > SBC Certificates.
  8. Click Generate 

    Spacevars
    0product
    1bold
    CSR.

  9. Enter data in the required fields.

  10. Click OK. After the Certificate Signing request finishes generating, copy the result to the clipboard.

  11. Use the generated CSR text from the clipboard to obtain the certificate. 

Step 2: Deploy the 
Spacevars
0product2
and Root/Intermediate Certificates on the
Spacevars
0product2

After receiving the certificates from the certification authority, install the 

Spacevars
0product2
Certificate and Root/Intermediate Certificates as follows:

  1. Obtain Trusted Root and Intermediary signing certificates from your certification authority.
  2. Access a compatible web browser.
  3. In the browser, enter the IP address of the 
    Spacevars
    0product
    in the URL address bar. The Welcome to
    Spacevars
    0company
    screen is displayed.
  4. Review the Pre-Login message.
  5. Enter the administrator User Name and Password configured during initial setup.
  6. If the Acknowledge Pre-Login Message checkbox is displayed, click on it to acknowledge you have reviewed the pre-login information above. After initial login, this checkbox can be enabled and disabled via the Global Security Options. By default, this checkbox is configured as disabled.
  7. Click Login. The main screen provides all WebUI functions, including tabbed options, menu tree, device name, and the last login date and time of the system.

  8. To install Trusted Root Certificates, click Settings > Security > SBC Certificates > Trusted Root Certificates.
  9. Click Import and select the trusted root certificates.
  10. To install the 
    Spacevars
    0product2
    certificate, open Settings > Security > SBC Certificates > SBC Primary Certificate.
  11. Validate the certificate is installed correctly.

  12. Click Import  and select X.509 Signed Certificate.
  13. Validate the certificate is installed correctly.


Update the Current Call Routing

Note
titleCaution

Perform this procedure only if you are using a node that is already configured with another signaling group (a migration scenario).

If this is not a newly deployed 

Spacevars
0product2
and you have already configured one of the following, follow the corresponding instructions:

  • If you configured a SIP Trunk or PSTN Access on this

    Spacevars
    0product2
    , you must perform the following procedure to select the previously created signaling group in the From Microsoft Teams Direct Routing table (see the following example call flow).

    Caption
    0Figure
    1Call Routing Setup to old PSTN - Proxy SBC


    1. Select Settings > Call Routing > Call Routing Table.

    2. Select the call routing table for Microsoft Teams Direct Routing.
    3. Select the To Outside (Passthrough) route entry.

    4. In the Destination Signaling Groups field, select the Border Element signaling group and click Remove.

    5. In the Destination Signaling Groups field, click Add and add your previously created SIP Trunk or PSTN Access.

    6. In the Audio Stream Mode field, select Direct Preferred over DSP.

    7. Click Apply.

    8. Click Signaling Groups.
    9. Delete the Border Element signaling group.
  • If you configured a connection to Teams Direct Routing or Skype for Business, you must remove the previously created signaling group (see the following example call flow).

    Caption
    0Figure
    1Call Routing Setup to new Teams - Proxy SBC


Verify the Deployment

After you configure the Central

Spacevars
0product2
, use the following procedure to verify that the 
Spacevars
0product2
works properly.

  1. Access a compatible web browser.
  2. In the browser, enter the IP address of the 
    Spacevars
    0product
    in the URL address bar. The Welcome to
    Spacevars
    0company
    screen is displayed.
  3. Review the Pre-Login message.
  4. Enter the administrator User Name and Password configured during initial setup.
  5. If the Acknowledge Pre-Login Message checkbox is displayed, click on it to acknowledge you have reviewed the pre-login information above. After initial login, this checkbox can be enabled and disabled via the Global Security Options. By default, this checkbox is configured as disabled.
  6. Click Login. The main screen provides all WebUI functions, including tabbed options, menu tree, device name, and the last login date and time of the system.

  7. Select Settings > Signaling Groups.

  8. Make sure the Service Status for all signaling groups is Up.

  9. If the Service Status for the Teams Direct Routing signaling group is Down, refer to Best Practice - Troubleshoot Issues with Microsoft Teams Direct Routing.

Place a Test Call

Use the following procedure to place a test call.

  1. Access a compatible web browser.
  2. In the browser, enter the IP address of the 
    Spacevars
    0product
    in the URL address bar. The Welcome to
    Spacevars
    0company
    screen is displayed.
  3. Review the Pre-Login message.
  4. Enter the administrator User Name and Password configured during initial setup.
  5. If the Acknowledge Pre-Login Message checkbox is displayed, click on it to acknowledge you have reviewed the pre-login information above. After initial login, this checkbox can be enabled and disabled via the Global Security Options. By default, this checkbox is configured as disabled.
  6. Click Login. The main screen provides all WebUI functions, including tabbed options, menu tree, device name, and the last login date and time of the system.

  7. In the WebUI, click the Diagnostics tab.

  8. In the left navigation pane, click Test a Call.

  9. Use the following table to configure the parameters for your Central SBC.

    Caption
    0Table
    1Test Call for a Central SBC - Parameters


    ParameterValue

    Destination Number

    Number assigned to a Teams user.

    Origination/Calling Number

    Number assigned to a Local user.

    Call Routing Table

    The routing table that handles the call from the Central

    Spacevars
    0product2
    .


    See the following example configuration of testing a call for a Central SBC.

    Caption
    0Figure
    1Test Call for a Central SBC - Configuration


  10. Click OK.