Modified: for 8.1.5
Overview
When the
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
Microsoft Teams Direct Routing Media Flow
This best practice uses greenfield and migration deployments and explains the requirements for each case. This best practice includes cautions to specify the deployment scenarios.
Though the
the
Unable to show "metadata-from": No such page "_space_variables"as a ProxyUnable to show "metadata-from": No such page "_space_variables"in the central site- the Unable to show "metadata-from": No such page "_space_variables"as a DownstreamUnable to show "metadata-from": No such page "_space_variables"in a local branch office
You can use the Prepare Proxy SBC procedure to configure the
The Proxy
For the Proxy
Make sure the licensed quantity of sessions on the
Microsoft Limitations
Microsoft does not support Music on Hold. You should disable Music on Hold for all users that use Local Media Optimization. To disable Music on Hold, refer to Set-CsTeamsCallingPolicy.
Microsoft does not support Early 183. You should disable Early 183 for all
Prerequisites
This section outlines the prerequisites for Local Media Optimization for Microsoft Teams Direct Routing.
Unable to show "metadata-from": No such page "_space_variables" Capacity
When deploying Local Media Optimization, the Proxy
- Call made to and from a Teams client that is internal to the customer network:
- The Proxy Unable to show "metadata-from": No such page "_space_variables"consumes the Proxy Media Mode with Encryption resource.
- The Downstream Unable to show "metadata-from": No such page "_space_variables"consumes the SIP with corresponding RTP Media resource.
- The Proxy
- Call made to and from a Teams client that is external to the customer network:
- The Proxy Unable to show "metadata-from": No such page "_space_variables"consumes the SIP with corresponding RTP Media resource.
- The Downstream Unable to show "metadata-from": No such page "_space_variables"consumes the SIP with corresponding RTP Media resource.
- The Proxy
Firmware Requirement
The Proxy
- Unable to show "metadata-from": No such page "_space_variables": Release 8.1.5 Build 239
- Unable to show "metadata-from": No such page "_space_variables": TEAMS_MEDIAOP build 13
- Unable to show "metadata-from": No such page "_space_variables": Release 8.1.5 Build 239
- Unable to show "metadata-from": No such page "_space_variables": TEAMS_MEDIAOP build 13
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
Certificate Usage
The Proxy
The Downstream
Since the Proxy
Public Certificate
The public certificate must be issued by one of the supported certification authorities (CAs). Wildcard certificates are supported.
Refer to Microsoft documentation for the supported CAs.
- See Domain Name for certificate formats.
Domain Name
For the
- On the Microsoft Teams Tenant side, execute Get-CsTenant.
- Review the output.
- 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 Unable to show "metadata-from": No such page "_space_variables"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
Domain Name Examples
Domain Name* | Use for Unable to show "metadata-from": No such page "_space_variables" FQDN? | FQDN Names - Examples |
---|---|---|
SonusMS01.com | Valid names:
| |
hybridvoice.org | Valid names:
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.
Configure Domain Names - Example
Name Resolution
The Proxy
The Proxy
This best practice uses host entries.
- host entries
- The Proxy Unable to show "metadata-from": No such page "_space_variables"has a host entry resolve each DownstreamUnable to show "metadata-from": No such page "_space_variables"FQDN.
- The Downstream Unable to show "metadata-from": No such page "_space_variables"has a host entry resolve the ProxyUnable to show "metadata-from": No such page "_space_variables"FQDN to its private IP address.
- The Proxy
- private DNS
- The Proxy Unable to show "metadata-from": No such page "_space_variables"and DownstreamUnable to show "metadata-from": No such page "_space_variables"use a split DNS to resolve each other's FQDN with their private IP address.
- The Proxy
Implementation
This best practice uses the FQDN and ports illustrated in the following figure.
FQDN and Port Usage
Prepare Proxy Unable to show "metadata-from": No such page "_space_variables"
This section outlines how to prepare the Proxy
You can use the procedures in this section if you want to configure a Central
For more information about configuring a Central
Install Unable to show "metadata-from": No such page "_space_variables" and Perform Initial Setup
Perform this procedure only if you are creating a new
Use the following procedure to install the
Run Easy Config Wizard on Proxy Unable to show "metadata-from": No such page "_space_variables"
Once your
- Access a compatible web browser.
- In the browser, enter the IP address of the Unable to show "metadata-from": No such page "_space_variables"in the URL address bar. The Welcome toUnable to show "metadata-from": No such page "_space_variables"screen is displayed.
- Review the Pre-Login message.
- Enter the administrator User Name and Password configured during initial setup.
- 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.
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.
Select Tasks > SBC Easy Setup > Easy Config Wizard.
Easy Config Wizard
In the Application field, select your application. This best practice configures the SIP Trunk ↔ Microsoft Teams.
Easy Configuration Step 1
- Configure the other fields in Step 1 and click Next.
In the SIP Trunk section, enter the information for the central SIP Trunk provider.
NoteFor a Central
Unable to show "metadata-from": No such page "_space_variables"configuration, configure the Border Element Server with the FQDN or IP of the central SIP Trunk.In the Teams Connection Type field, select Local Media Optimization.
Easy Configuration Step 2
Configure the other fields in the Microsoft Teams section and click Next.
CautionThe
Unable to show "metadata-from": No such page "_space_variables"will not support the Outbound NAT Traversal field until theUnable to show "metadata-from": No such page "_space_variables"9.0.0 release.Review your configuration information in Step 3 and click Finish.
Easy Configuration Step 3
Import Certificate on Proxy Unable to show "metadata-from": No such page "_space_variables"
This section outlines how to import a certificate on the Proxy
Configure and Generate Certificates on the Unable to show "metadata-from": No such page "_space_variables"
Update the Current Call Routing
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
If you configured a SIP Trunk or PSTN Access on this
Unable to show "metadata-from": No such page "_space_variables", 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).Call Routing Setup to old PSTN - Proxy SBC
Select Settings > Call Routing > Call Routing Table.
- Select the call routing table for Microsoft Teams Direct Routing.
Select the To Outside (Passthrough) route entry.
In the Destination Signaling Groups field, select the Border Element signaling group and click Remove.
Remove Border Element for Teams Direct Routing
In the Destination Signaling Groups field, click Add and add your previously created SIP Trunk or PSTN Access.
Add SIP Trunk or PSTN Access for Teams Direct Routing
In the Audio Stream Mode field, select Direct Preferred over DSP.
Audio Stream Mode for Teams Direct Routing
Click Apply.
- Click Signaling Groups.
- 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).
Call Routing Setup to new Teams - Proxy SBC
Disable Validate Server FQDN in TLS Profile
This section applies to only the Proxy SBC for the
Use the following procedure to disable the Validate Server FQDN in the TLS Profile.
- Access a compatible web browser.
- In the browser, enter the IP address of the Unable to show "metadata-from": No such page "_space_variables"in the URL address bar. The Welcome toUnable to show "metadata-from": No such page "_space_variables"screen is displayed.
- Review the Pre-Login message.
- Enter the administrator User Name and Password configured during initial setup.
- 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.
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.
Select Settings > Security.
- From the TLS Profiles drop-down menu, select the TLS profile for the Teams Direct Routing TLS.
- In the Validate Server FQDN field, select Disabled.
Verify the Deployment
After you configure the Proxy
- Access a compatible web browser.
- In the browser, enter the IP address of the Unable to show "metadata-from": No such page "_space_variables"in the URL address bar. The Welcome toUnable to show "metadata-from": No such page "_space_variables"screen is displayed.
- Review the Pre-Login message.
- Enter the administrator User Name and Password configured during initial setup.
- 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.
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.
Select Settings > Signaling Groups.
Make sure the Service Status for all signaling groups is Up.
Signaling Group Verification
- If the Service Status for the Teams Direct Routing signaling group is Down, refer to Best Practice - Troubleshoot Issues with Microsoft Teams Direct Routing.
Prepare Downstream Unable to show "metadata-from": No such page "_space_variables"
You must perform the procedures in this section for each Downstream
The information to prepare a Downstream SBC applies to both the
Install Unable to show "metadata-from": No such page "_space_variables" and Perform Initial Setup
Perform this procedure only if you are creating a new
Use the following procedure to install the
For the
Run Easy Config Wizard on Downstream Unable to show "metadata-from": No such page "_space_variables"
Once your
- Access a compatible web browser.
- In the browser, enter the IP address of the Unable to show "metadata-from": No such page "_space_variables"in the URL address bar. The Welcome toUnable to show "metadata-from": No such page "_space_variables"screen is displayed.
- Review the Pre-Login message.
- Enter the administrator User Name and Password configured during initial setup.
- 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.
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.
Select Tasks > SBC Easy Setup > Easy Config Wizard.
In the Application field, select your application. This best practice configures SIP Trunk ↔ Microsoft Teams.
In the Teams Connection field, select Teams Downstream SBC.
Easy Configuration for Teams Downstream SBC
- Configure the other fields in Step 1 and click Next.
In the SIP Trunk section, enter the information for the Branch 1 SIP Trunk provider.
CautionYou must target the Proxy with an FQDN for the TLS to properly establish.
Easy Configuration Step 2 for Teams Downstream SBC
- Configure the other fields in the Microsoft Teams section and click Next.
Review your configuration information in Step 3 and click Finish.
Easy Configuration Step 3 for Teams Downstream SBC
Import Certificate on Downstream Unable to show "metadata-from": No such page "_space_variables"
Since the Proxy
If your deployment requires a different certificate for the Downstream
Configure Proxy FQDN Resolution on Downstream Unable to show "metadata-from": No such page "_space_variables"
- Access a compatible web browser.
- In the browser, enter the IP address of the Unable to show "metadata-from": No such page "_space_variables"in the URL address bar. The Welcome toUnable to show "metadata-from": No such page "_space_variables"screen is displayed.
- Review the Pre-Login message.
- Enter the administrator User Name and Password configured during initial setup.
- 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.
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.
Select Settings > Protocols > DNS > Hosts.
Hosts Settings
Click the + icon to create a host entry.
Enter the FQDN and IP address for the Proxy
Unable to show "metadata-from": No such page "_space_variables".Create Host Entry for Proxy SBC
Configure Downstream FQDN Resolution on Proxy Unable to show "metadata-from": No such page "_space_variables"
- Access a compatible web browser.
- In the browser, enter the IP address of the Unable to show "metadata-from": No such page "_space_variables"in the URL address bar. The Welcome toUnable to show "metadata-from": No such page "_space_variables"screen is displayed.
- Review the Pre-Login message.
- Enter the administrator User Name and Password configured during initial setup.
- 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.
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.
Select Settings > Protocols > DNS > Hosts.
Click the + icon to create a host entry.
Enter the FQDN and IP address for the Downstream
Unable to show "metadata-from": No such page "_space_variables".Create Host Entry for Downstream SBC
Update the Current Call Routing
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
If you configured a SIP Trunk or PSTN Access on this
Unable to show "metadata-from": No such page "_space_variables", you must perform the following procedure to select the previously created signaling group in the FromUnable to show "metadata-from": No such page "_space_variables"as Teams Downstream table (see the following example call flow).Call Routing Setup to old PSTN - Downstream SBC
Select Settings > Call Routing > Call Routing Table.
- Select the call routing table for the Unable to show "metadata-from": No such page "_space_variables"as Teams Downstream.
Select the To Outside (Passthrough) route entry.
In the Destination Signaling Groups field, select the Border Element signaling group and click Remove.
Remove Border Element for Downstream SBC
In the Destination Signaling Groups field, click Add and add your previously created SIP Trunk or PSTN Access.
- Click Apply.
- Click Signaling Groups.
- 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).
Call Routing Setup to new Teams - Downstream SBC
Verify the deployment
After you configure the Downstream
- Access a compatible web browser.
- In the browser, enter the IP address of the Unable to show "metadata-from": No such page "_space_variables"in the URL address bar. The Welcome toUnable to show "metadata-from": No such page "_space_variables"screen is displayed.
- Review the Pre-Login message.
- Enter the administrator User Name and Password configured during initial setup.
- 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.
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.
Select Settings > Signaling Groups.
Make sure the Service Status for all signaling groups is Up.
Signaling Group Verification for Downstream SBC
Place a Test Call
Use the following procedure to place a test call.
- Access a compatible web browser.
- In the browser, enter the IP address of the Unable to show "metadata-from": No such page "_space_variables"in the URL address bar. The Welcome toUnable to show "metadata-from": No such page "_space_variables"screen is displayed.
- Review the Pre-Login message.
- Enter the administrator User Name and Password configured during initial setup.
- 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.
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.
In the WebUI, click the Diagnostics tab.
In the left navigation pane, click Test a Call.
Configure the parameters according to your SBC.
Use the following table to configure the parameters for a Proxy SBC.
Test Call for a Proxy SBC - Parameters
Parameter Value 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 Proxy
Unable to show "metadata-from": No such page "_space_variables".See the following example configuration of testing a call for a Proxy SBC.
Test Call for a Proxy SBC - Configuration
Use the following table to configure the parameters for a Central SBC.
See the following example configuration of testing a call for a Central SBC.Test Call for a Central SBC - Parameters
Parameter Value 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
Unable to show "metadata-from": No such page "_space_variables".Test Call for a Central SBC - Configuration
Use the following table to configure the parameters for a Downstream SBC.
See the following example configuration of testing a call for a Downstream SBC.Test Call for a Downstream SBC - Parameters
Parameter Value 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 Downstream
Unable to show "metadata-from": No such page "_space_variables".Test Call for a Downstream SBC - Configuration
Click OK.
Place a Test Call - Example