Page History

Panel
In this section: Table of Contents maxLevel 4 5 minLevel 2

Info
title How to Access Embedded Hyperlinks
Ribbon Communications recommends accessing embedded URLs in a separate browser window/tab. To open embedded URLs in a separate window/tab, Ctrl+Left-click or Right-click with your mouse and select Open Link in New Tab/Open Link in New Window.

Introduction to Yealink Teams Client Local Survivability

Ribbon Communications and Yealink® support uninterrupted voice services if a connectivity loss occurs between an enterprise site hosting Yealink Teams voice-related clients and the Microsoft® Phone System hosted in the Microsoft Azure™ cloud.

Support for Teams Client Survivability

The benefits of voice service survivability between enterprise sites hosting Yealink Teams voice-related clients and Phone System hosted in the Azure cloud include the following:

...

This best practice describes the Teams client survivability services available using Ribbon and Yealink products. The best practice also provides instructions for configuring, activating, and validating the services. For details of the Yealink and Ribbon collaboration, refer to the integrated solution announcement and related links.

Applicable Products

The following Yealink Teams clients collaborate with the Ribbon Communications Communications

Spacevars
0 product

to support survivability:

...

Anchor
Yealink Teams Clients Yealink Teams Clients

 Yealink Yealink Teams Clients

Caption
0 Figure 1 Yealink Teams Clients - Conference and Desk Phones

...

Note
title Required SBC Edge Portfolio Firmware Version
The  Spacevars 0 product firmware versions required to support Teams client survivability are Release 8.0.1 for the Spacevars 0 series3  and Release 8.0.1 for the SBC 1000/SBC 2000. Using earlier firmware versions is not supported and may result in conflicts and unexpected behavior. Contact an authorized Ribbon Communications sales representative or partner to obtain the appropriate firmware release.

Teams Client Survivability Operation

The survivability capabilities available to Teams clients vary based on the accessibility of Phone System and the deployment type (on-premises or Azure).

...

• When incoming calls (intended for a Teams client) from the PSTN or a non-Teams client arrives at the SBC, the SBC validates the availability of the Phone System (latter being of highest priority within the route list). If the Teams System is recognized as being unavailable, the SBC routes the call directly to the subtended registered Yealink Teams client via SIP, as opposed to Phone System. For such an action to occur, the intended call recipient (the Yealink Teams client) must be mapped by the SBC as having a resolvable SIP-based client address. This resolution is possible through the subsequent SBC provisioning instructions.
• Incoming SIP-based calls that arrive from the subtended Yealink Teams client are routed by the SBC as a standard SIP-based registered endpoint. These calls will be routed either to another subtended Yealink client or into the PSTN provided such routes are active and available. If no route is found, the SBC routes the call to the appropriate configured treatment.

Enabling Yealink Teams Client Local Survivability

Anchor
Yealink prerequisites Yealink prerequisites

Yealink Teams Client Device Prerequisites

Yealink Teams client-supporting devices (phones, etc.) must fulfill the following prerequisites prior to undertaking further actions:

1. Devices must be configured and supporting Phone System voice services. To confirm support, please place a call from the Teams client UI to another Teams client within the enterprise. If such a call successfully completes, the device is configured to successfully offer Phone System services.
2. Devices must be configured with a firmware release that supports survivability for Teams deployments.
   

3. As an optionOptionally, Yealink devices may be configured to communicate with the the

   Spacevars
   0 product 1 bold

   using TLS (Transport Layer Security, used for SIP signaling encryption) and SRTP (Secure Real-time Transport Protocol, used for media encryption).

   Anchor
   Azure encryption Azure encryption

   Note
   title Use of Signaling and Media Encryption Strongly Recommended for Azure-based SBC Deployments
   Ribbon Communications and Yealink strongly recommend the use of TLS and SRTP for secure encrypted communication between the Yealink devices and the SBC, especially when the latter is deployed in the Azure public cloud. When the SBC is deployed in Azure, the use of encryption safeguards the communication that transits the public Internet. Please refer to the following links to configure the Yealink devices and the SBC for secure communication: For the Yealink devices, refer to the relevant administrator guide, and undertake the configuration as a prerequisite step (now). An example administrator guide with encryption configuration instructions (for the desk Phone T58A) is available at support.yealink.com. For the Ribbon Spacevars 0 product , configure TLS & SRTP encryption later, within the SIP Local Registrar step and the Signaling Group configuration step. Note the following: The  Spacevars 0 product should possess an X.509 certificate that is acquired during the Teams Direct Routing prerequisite step, including the CA (Certificate Authority) chain of trust. Refer to Configure a Certificate for the SBC Direct Routing Interface for more information regarding the assignment of the certificate during Teams Direct Routing setup.  The  Spacevars 0 product X.509 certificate, exchanged during the TLS handshake with the Yealink device, must be signed by a CA that the Yealink devices will trust for successful communication.  The list of recognized CAs are found in the relevant Yealink device administrator guide posted at support.yealink.com; If the certificate is signed by an unrecognized CA, you must load the relevant sections of the certificate's chain of trust from the SBC into the Yealink devices so that the certificate is subsequently trusted. Refer to Working with Certificates for certificate chains within the SBC.

   
   

...

Info
title Microsoft Teams Phone System Supplementary Information
Refer to the following sources of information for basic Microsoft Phone System features and deployment: Welcome to Teams How to roll out Teams Cloud voice Tutorial: Calling in Teams

Anchor
SBC Edge prerequisites SBC Edge prerequisites

Ribbon 

Spacevars
0 product

Prerequisites

In all cases, the 

Spacevars
0 product

product must be deployed with a supporting firmware image. Once such an image is in place, please also ensure the following conditions are met depending upon the location (enterprise premises or Azure) of the SBC in the network topology.

Spacevars
0 product

 Deployed On-Premises

For 

Spacevars
0 product

devices deployed on-premises, confirm the following:

1. Initial setup is complete.

   • SBC 1000 and SBC 2000 initial setup steps

   • SBC SWe Edge on-premise deployment initial steps

     Note
     title SBC SWe Lite Deployed On-Premises Initial Setup Clarifications
     The  Spacevars 0 series3 initial setup instructions include content related to feature licensing, trials, and easy configuration. Note the following: You can choose to undertake feature licensing under the initial setup instructions, please ensure the minimum licensing requirements listed in step 2 are addressed; You can choose to configure the  Spacevars 0 series3 for Yealink Teams Client Local Survivability with a trial license and as such, temporarily disregard the instructions in step 2; however, there are considerations: Note the number of registered Yealink devices and session capacity will be limited to the capabilities of the trial license; Ribbon does not support the use of trial licenses for live traffic (production) deployments. Please do not undertake any Easy Configuration Wizard actions at this time; the easy configuration actions in a Teams-related deployment has additional considerations, as defined in step 3

     
     

2. Anchor
   Licensing Licensing

   Licensing has been acquired and properly assigned.

   • The following SIP registration license(s) are required for registering Yealink devices:

     • SBC 1000 and SBC 2000 registration licenses

     • Spacevars
       0 series3

        licenses for on-premises deployments
   • The following SIP session licenses may be required if the 

     Spacevars
     0 product

     connects the IP-based SIP signaling and RTP media to and from subtended Yealink clients to an IP-based client (for example, a SIP trunk or a SIP-based IP PBX) instead of a legacy TDM connection (for example, a PRI/BRI trunk or an analog FXS/FXO destination):

     • SBC 1000 and SBC 2000 SIP session licenses;

     • Spacevars
       0 series3

        licenses for on-premises deployments.

       Info
       For instructions on how to obtain and apply licenses, refer to Node-Locked Licensing - SBC 1000/2000 and SBC SWe Edge.

       
       

3. Anchor
   Teams configuration Teams configuration

   Teams Direct Routing (DR) basic configuration has been undertaken. Teams DR basic configuration is documented in the on-premises best practice. Please ensure all instructions are executed as documented in the following sections of that best practice:

   • Configuration Prerequisites

   • Configure Direct Routing For Greenfield Deployment, including the execution of one of the following easy configuration wizard scenarios related to Teams DR, such as:
     • SIP trunks ↔ Microsoft Phone System Direct Routing
     • ISDN PSTN ↔ Microsoft Phone System Direct Routing
     • IP PBX ↔ Microsoft Phone System Direct Routing
   • Refer to the Teams Direct Routing troubleshooting details for final review and testing of the Teams Direct Routing capable 

     Spacevars
     0 product

     device.
4. Networking device updates have been applied to permit 

   Spacevars
   0 product 1 bold

    ↔ subtended registered Yealink client device communication. The 

   Spacevars
   0 product

   and the Yealink clients that will attempt to register may not be in the same office/LAN; they may be located in different offices accessible through the enterprise's WAN, or may only be accessible through the internet. As such, the following devices must be configured to ensure successful communication between the parties:

...

Once the previous steps have been completed, the 

Spacevars
0 product

device is ready for further configuration for Yealink Teams Client Local Survivability.

...

Anchor
Azure Anchor Azure Anchor

...

Spacevars
0 series3

 Deployed in Azure

For an 

Spacevars
0 series3

deployed in Azure, confirm the following:

1. Initial setup is complete per the instructions applicable for an Azure deployment.

   Note
   title SBC SWe Edge Deployed in Azure Initial Setup Clarifications
   The  Spacevars 0 series3 initial setup instructions include content related to feature licensing, trials, and easy configuration. Note the following: You can choose to undertake feature licensing under the initial setup instructions, please ensure the minimum licensing requirements listed in step 2 are addressed. You can choose to configure the  Spacevars 0 series3 for Yealink Teams Client Local Survivability with a trial license and as such, temporarily disregard the instructions in step 2; however, there are considerations: Note the number of registered Yealink devices and session capacity will be limited to the capabilities of the trial license. Ribbon does not support the use of trial licenses for live traffic (production) deployments. Please do not undertake any Easy Configuration Wizard actions at this time; the easy configuration actions in a Teams-related deployment has additional considerations, as defined below in step 3.

   
   

2. Anchor
   Azure Licensing Azure Licensing

   Licensing has been acquired and properly assigned.

   • SIP registration license(s) (namely one or more instances of the SBC-SWELITE-LIC-RG -CLOUD) are absolutely required, to enable the registration of Yealink devices. 

   • SIP session licenses are required, as the IP-based SIP signaling and RTP media to/from the subtended Yealink clients is connected by the 

     Spacevars
     0 series3

     to an IP-based client (e.g. a SIP trunk, a SIP-based IP PBX, etc.)

     Info
     title SBC Edge Portfolio License Acquisition
     For instructions on how to obtain and apply licenses, refer to Node-Locked Licensing - SBC 1000/2000 and SBC SWe Edge.

     
     

3. Anchor
   Azure Teams configuration Azure Teams configuration

   Teams Direct Routing (DR) basic configuration has been undertaken. Teams Direct Routing basic configuration is documented in the Azure-related best practice. Please ensure all instructions are executed as documented in the following sections of that best practice:

1. • Configuration Prerequisites

   • Configure Azure for Microsoft Teams Direct Routing
   • Run Easy Configuration Wizard for Microsoft Teams Direct Routing
   • Complete SBC SWe Edge Configuration for Microsoft Teams Direct Routing in Azure
   • Place a Test Call.
4. Networking device updates have been applied to permit Azure-based 

   Spacevars
   0 product 1 bold

    ↔ enterprise premises-based Yealink client device communication.  The 

   Spacevars
   0 product

   and the Yealink clients that will attempt to register will likely communicate across the Internet; as such, the following devices/constructs must be configured to ensure successful communication between the parties:

1. • Any enterprise premises-based routers undertaking LAN ↔ WAN addressing conversions, such as those related to NAT;

   • Any enterprise premises-based firewalls undertaking network traffic filtering actions.

   • The Azure-based virtual network and VM (virtual machine) hosting the

     Spacevars
     0 series3

     , especially the network security group (NSG) security rules.

     Note
     title Contact Enterprise IT to Facilitate IP-based Communications
     Please contact your IT administrator to ensure communication can be undertaken between the network segments hosting the Yealink Teams client devices and the  Spacevars 0 product hosted in the Azure cloud. The IT administrator should be knowledgeable regarding the private & public IP addresses assigned to all devices, along with the required routing to achieve inter-device communications.

     
     

     Info
     title Azure Virtual Networking Supplementary Information
     Refer to the following sources of information for basic Azure virtual networking concepts, features and deployment: Azure Products Azure networking Internet Connectivity On-premises connectivity Virtual Network Documentation Security groups Tutorial: Route network traffic with a route table using the Azure portal Tutorial: Filter network traffic with a network security group using the Azure portal Diagnose a virtual machine network traffic filter problem

     
     

After you complete the steps above, the 

Spacevars
0 series3

in Azure is ready for further configuration for Yealink Teams Client Local Survivability.

Configuration Instructions

Anchor
SBC edge final configuration SBC edge final configuration

Spacevars
0 product

 Configuration to Accept Yealink Devices Registration and Undertake Teams Client-Related Survivability Routing

Introduction

The following instructions detail how to configure the Ribbon SBC to accept Yealink Teams client devices registrations and to route calls properly between the devices and the PSTN. Please note the following context prior to the configuration being undertaken:

1. Create a new SIP Local Registrar instance to which the Yealink devices register via SIP, including client registration authentication and potentially a new TLS Profile ID; 

2. Create new call routing for use whenever a Yealink device needs to place calls via the SBC. 

   1. Create a new Call Routing Table instance.

   2. Create two new Transformation Table instances (one for intra-office calling and one for PSTN access), each with an entry to pass the user dialed digits through for routing purposes;

   3. Specify two new call routing entries to identify the final instructions for intra-office and PSTN routing for a Yealink device-originated call.

      Info
      title Intra-Office and PSTN Routing Clarifications
      ● A specific call route entry is required to be configured for intra-office calling between one Yealink device and another Yealink device registered with the same SIP Local Registrar instance. ●  The PSTN-related signaling group will already have been created through the Easy Configuration wizard undertaken in the prerequisites of the SBC setup.

      
      

3. Create a new Signaling Group instance that will be associated with the new local registrar instance you just created;

4. Update the pre-existing Call Routing Table instance (associated with the incoming PSTN trunk) to include updated routing for call processing that uses the newly created Signaling Group instance when Phone System is unavailable:

   1. Create a new Transformation Table instance and entries to modify the incoming dialed digits received from the PSTN for local routing to the newly created SIP local registrar instance.

   2. Specify a new call routing entry to identify the final instructions for routing to an SBC-subtended Yealink device.

      Info
      title Pre-Existing Call Route Table Instance Clarifications
      ● The pre-existing Call Routing Table instance associated with the incoming PSTN trunk was initially created through the use of the Easy Configuration wizard template undertaken in the prerequisites of the SBC setup. This Call Routing Table instance already has a routing entry to support the routing of an incoming call to Phone System. Refer to Using the Easy Configuration Wizard. ●  The soon to be added new routing entry will be prioritized below the Teams-related call routing entry; this new routing entry will only be referenced in the event the Phone System is unavailable (i.e. the Yealink Teams Client Local Survivability scenario ).

      
      

5. Confirm the new Signaling Group instance associated with the new SIP Local Registrar instance is active.

Anchor
Example Example

Example SBC Network Diagram

To aid in the comprehension of the subsequent configuration instructions, please refer to the example network presenting pre-existing attribute values and device identifiers, along with soon to be added (identified in green italic font) attributes and values. Note select values (denoted with an X) are redacted for privacy purposes.

Caption
0 Figure 1 Sample Configuration Attribute Values for Example SBC Network Topology
Image Modified

SBC Configuration

1. Anchor
   Step 1 Step 1

   Access the WebUI, and click the Settings tab.

   1. In the left navigation page, access SIP > Local Registrars Table.

      1. Click the (Plus icon) to add a row.

      2. In the Create SIP Local Registrar dialog box, type the desired identifier name and maximum number of registering clients for your new SIP local registrar instance. For our example deployment, the entered name is  LocalReg .

         Info
         title Registrar Provisioning Reference Information
         For details on SIP local registrar configuration, refer to Creating and Modifying SIP Local Registrars.

         
         

      3. Click OK.

         Caption
         0 Figure 1 Newly Created Example SIP Local Registrar Instance "LocalReg", to Which Yealink Devices Will Register as SIP Endpoints

         
         

   2. In the left navigation page, access SIP > Local/Pass-thru Auth Tables

      1. Click the (Plus icon) to add a local pass-through authorization table.
         

      2. In the  Description dialog box, type the desired  Local Pass-through Authorization Table  name. For  our example deployment, the name specified is  Local registration table .

      3. Click OK.

         Caption
         0 Figure 1 Newly Created Example Local Pass-through Authorization Table instance "Local Registration table", that will shortly define acceptable credentials for successful registration

         
         

         Info
         title Local Pass-through Authorization Tables Provisioning Reference Information
         For details on Local Pass-through Authorization Tables configuration, refer to Managing Local Pass-through Authorization Tables.

         
         

      4. Anchor
         Client Authorization Client Authorization

         In the left navigation page, access SIP > Local/Pass-thru Auth Tables, and select (click) the new Local Pass-through Authorization Table just created. In example deployment, the entered name is  Local registration table . The table displays under the tabs, with the note:   --  Table is empty --

         1. Anchor
            Step 123 Authorization Step 123 Authorization

            Click the Create Local Pass-through Authorization Entry (Plus icon)

         2. Specify the following values for fields:

            Caption
            0 Table 1 Local Pass-through Authorization Entry Attributes
            Field Required Entry Type of Address of Record Local, to signify the SBC is the registrant of record. Address of Record URI Specify the acceptable Address of Record (AOR) URI from a potential valid registering endpoint. In the example deployment, one such AOR URI is  sip:30001 . User Name Specify the acceptable user name from the registering endpoint. In the example deployment, one acceptable User Name is  30001  . Enter Password Specify the password the registering endpoint must submit for successful registration. Confirm Password Type the same password as entered above for confirmation.

            
            

            Info
            title Local Pass-through Authorization Table Entries Provisioning Reference Information
            For details on Local Pass-through Authorization Table Entry configuration, refer to Creating and Modifying Entries to Local Pass-through Authorization Tables.

            
            

         3. Click OK.

            Caption
            0 Figure 1 Highlighted Example New Local Pass-through Authorization Entry

            
            

         4. Pagebreak

            Repeat steps 1, 2, and 3 for each remaining possible valid registering endpoints. In the example deployment, steps 2 and 3 are repeated for Yealink device  30003 .

            Note
            title Use of Local Pass-through Authorization Table is Strongly Recommended
            Ribbon and Yealink strongly recommend the use of the optional Local Passthrough Authorization Table, especially for Azure-based SBC deployments. The use of the Local Passthrough Authorization Table deters the fraudulent use of your enterprise's SIP trunking services by unauthorized users.

            
            

      5. Anchor
         TLS Profile TLS Profile

         Optional Step for encrypted SIP signaling: Create the  TLS profile to define the cryptographic parameters for the SIP signaling between the subtended Yealink devices and the SBC.
         1. In the WebUI, click the Settings tab.

         2. In the left navigation pane, go to Security > TLS Profiles.

         3. Click the CreateTLS Profile (Plus icon) at the top of the TLS Profile page.

         4. Configure the parameters shown below. Leave all other parameters as default.

            Caption
            0 Table 1 New TLS Profile Entry Attributes for Registered Yealink SIP Clients ↔ SBC Communication
            Field Required Entry Description Specify a descriptive name for the entry. A sample name may be Yealink SIP Client SBC Signaling TLS Protocol Set the administrative state to TLS 1.0 - 1.2 Mutual Authentication Specify the authentication as Disabled. Client Cipher List Select a cipher value (this value must be supported by the subtended registered Yealink clients). See above for guidelines. Ribbon recommends TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA384.  Validate Server FQDN Specify the validation as Disabled. All other fields Please leave all default values as-is for basic SIP signaling encryption purposes.

            
            

         5. Click OK , and confirm the presence of the new TLS Profile entry. 

            Note
            title Use of Signaling and Media Encryption Strongly Recommended for Azure-based SBC Deployments
            While optional, Ribbon Communications and Yealink strongly recommend the use of TLS and SRTP for secure encrypted communication between the Yealink devices and the SBC, especially when the latter is deployed in the Azure public cloud. For more information, please refer above.

            
            

            Info
            title TLS Profile Provisioning Reference Information
            For more information about creating new TLS Profile entries, refer to Managing TLS Profiles.

            
            

2. Anchor
   Step 2 Step 2

   Access the WebUI, click the  Settings  tab.

   1. Anchor
      new call route table new call route table

      In the left navigation pane, go to Call Routing > Call Routing Table. 

      1. Click the (Plus icon).

      2. Enter a descriptive name in the Description text field; for this deployment example, the value is  From Local SIP EP

      3. Click OK.

         Caption
         0 Figure 1 Highlighted Example New Call Routing Table for Registered SIP Client-Initiated Call Processing

         
         

         Info
         title Call Routing Table Provisioning Reference Information
         For more information about creating call routing tables, refer to Managing Call Routing Tables.

         
         

   2. Anchor
      Transformation Table Transformation Table

      In the WebUI, click the Settings tab.

      1. In the left navigation pane, go to Call Routing -> Transformation .

      2. Click the Create (Plus icon).

      3. In the  Description  dialog box, enter the desired Transformation Table name identifier for calling to the PSTN. For our example deployment, the entered name is  from SIP to IMS .

      4. Click OK .

         Caption
         0 Figure 1 Highlighted New Transformation Table for Registered SIP Clients to Call the PSTN

         
         

         Info
         title Transformation Table Provisioning Reference Information
         For details on Transformation Table configuration, refer to Managing Transformation Tables.

         
         

      5. Anchor
         Transformation Table Entry Transformation Table Entry

         Pagebreak

         In the left navigation page, go to Transformation, and select (click) the new Transformation Table just created. In example deployment, the entered name is   from SIP to IMS . The table displays under the tabs, with the note:  --  Table is empty --

         1. Click the Create (Plus icon).

         2. Type or select the following values to specify the passthrough of dialed digits from the subtended registered Yealink Survivability (SIP) client to the PSTN:

            Caption
            0 Table 1 New Transformation Table Entry Attributes for Registered SIP Clients to Reach the PSTN
            Field Required Entry Description Specify a descriptive name for the entry. In the example deployment, the entered name is  SIP to PSTN . Admin State Set the administrative state to Enabled. Type (Input Field) Specify the type for input as Called Address/Number. Value (Input Field) Specify an asterisk (.*) to indicate acceptance of any digits. Type (Output Field) Specify the type for output as Called Address/Number. Value (Output Field) Specify the value of output as \1 to indicate that digits received will be passed through to the outbound route without any change made.

            
            

            Info
            title Transformation Table Entries and Digit Manipulation Provisioning Reference Information
            For details on Transformation Table Entry configuration, refer to Creating and Modifying Entries to Transformation Tables. For call digit matching and manipulation through the use of regular expressions, please reference Creating Call Routing Logic with Regular Expressions.

            
            

         3. Click OK .

            Caption
            0 Figure 1 Highlighted New Transformation Table Entry for Registered SIP Clients to Call the PSTN

            
            

   3. Anchor
      Transformation Table 2 Transformation Table 2

      In the WebUI, click the Settings tab.

      1. In the left navigation pane, go to Call Routing > Transformation.

      2. Click the  Create (Plus icon).

      3. In the  Description  dialog box, enter the desired Transformation Table name identifier for intra-office calling. For our example deployment, the entered name is  from SIP to SIP .

      4. Click OK.

         Caption
         0 Figure 1 Highlighted New Transformation Table for Registered SIP Clients to Call Other SIP Clients in the Office

         
         

         Info
         title Transformation Table Provisioning Reference Information
         For details on Transformation Table configuration, refer to  Managing Transformation Tables .

         
         

      5. Anchor
         Transformation Table Entry 2 Transformation Table Entry 2

         In the left navigation page, go to Transformation , and select (click) the new Transformation Table just created for intra-office calling. In example deployment, the entered name is   from SIP to SIP . The table will appear under the tabs, with a note stating  – Table is empty --

         1. Click the Create (Plus icon).

         2. Enter or select the following values into the pop-up window, to specify the pass through of dialed digits from the subtended registered Yealink Survivability (SIP) client to another subtended registered Yealink Survivability (SIP) client.

            Caption
            0 Table 1 Transformation Table Entry Attributes for Intra-Office Calling
            Field Required Entry Description Please use a descriptive name for the entry. In the example deployment, the entered name is  SIP to SIP . Admin State Enabled Type (Input Field) Called Address/Number Value (Input Field) Please enter a regular expression to confirm a private dial plan number that conforms to the private dial plan assigned to the registered SIP clients. In the example deployment, the entered expression is ^(3\d{4})$, signifying the called digits must be 5 characters in length, and must start with a 3. Type (Output Field) Called Address/Number Value (Output Field)  \1 , signifying matching digits received will be passed through to the outbound route without change.

            
            

            Info
            title Transformation Table Entries and Digit Manipulation Provisioning Reference Information
            For details on Transformation Table Entry configuration, refer to Creating and Modifying Entries to Transformation Tables. For call digit matching and manipulation through the use of regular expressions, please reference Creating Call Routing Logic with Regular Expressions.

            
            

         3. Click OK .

            Caption
            0 Figure 1 Highlighted New Transformation Table Entry for Registered SIP Clients to Call Other Registered SIP Clients

            
            

   4. Anchor
      anchorname100 anchorname100

      In the WebUI, click the Settings tab.

      1. In the left navigation pane, go to Call Routing > Call Routing Table and select the newly created Call Routing Table; for our example deployment, the newly created table is  From Local SIP EP . 

         1. Click the  Create Routing Entry (Plus icon) to create the route for calling into the PSTN.

            1. Enter the following values into the pop-up window:

               Caption
               0 Table 1 Call Routing Entry Attributes for Calling from Registered Yealink Devices to the PSTN
               Field Required Entry Description Enter an informative name in the text field; for our example deployment, the value is  to IMS Admin State Select Enabled Number/Name Transformation Table Select the newly created Transformation Table instance to which calls from a subtended registered Yealink device will be routed to the PSTN. For the example deployment , the value is  from SIP to IMS . Destination Type Select Normal Destination Signaling Groups Select the PSTN-related Signaling Group. For the example deployment , the value is  IMS All other fields Please leave all default values as-is for basic configuration purposes.

               
               

               Info
               title Call Routing Table Entry Provisioning Reference Information
               For details on call routing table entry configuration including modification of fields with default values, refer to Creating and Modifying Entries to Call Routing Tables.

               
               

            2. Click OK .

               Caption
               0 Figure 1 Example Call Routing Entry Attributes for Calling from Registered Yealink Devices to the PSTN

               
               

         2. Click the Create Routing Entry (Plus icon) once again to create the route entry for intra-office calling.

            1. Type or choose the following values:

               Caption
               0 Table 1 Call Routing Entry Attributes for Calling from Registered Yealink Devices to Other Registered Yealink Devices
               Field Required Entry Description Type a descriptive name in the text field; for the example deployment, the value is  SIP TO SIP. Admin State Select Enabled Number/Name Transformation Table Select the newly created Transformation Table instance to which calls from a subtended registered Yealink device will be routed when attempting to reach another subtended registered Yealink device. For the example deployment , the value is  from SIP to SIP . Destination Type Select Registrar Table Destination Signaling Groups Select the newly created SIP Local Registrar-related Signaling Group to which the subtended registered Yealink devices are associated. For the example deployment , the value is  LocalReg All other fields Leave all other default values as-is for basic configuration purposes.

               
               

            2. Click OK.

               Caption
               0 Figure 1 Example Call Routing Entry Attributes for Calling from Registered Yealink Devices to Other Registered Yealink Devices

               
               

      2. Review and confirm the two new Call Routing Table entries in the newly created Call Routing Table.

         Caption
         0 Figure 1 New Priority Call Routing Table Entry

         
         

3. Anchor
   Step 3 Step 3

   Access the WebUI, click the  Settings  tab.

   1. In the left navigation pane, go to Signaling Groups.

   2. From the top menu bar, click Create Signaling Group and select SIP Signaling Group (note: for the

      Spacevars
      0 series3

      , select Add SIP SG )

   3. Create the SIP Signaling Group using the following configuration:

      Caption
      0 Table 1 SIP Signaling Group Attribute Values for Registered Yealink Devices
      Field Required Entry Description Enter an informative name in the  Description  text field; for the  example deployment , the value is  LocalReg . Admin State Select Enabled Call Routing Table Select the recently created Call Routing Table Instance that will define routing for calls that originate from the subtended registered Yealink devices. For the example deployment, the value is  from Local SIP EP . SIP Mode Select the Local Registrar value. Registrar Select the recently created SIP Local Registrar instance to which subtended Yealink devices will advertise their presence. For the   example deployment , the value is  LocalReg . Challenge Request Select Enable Local/Pass-thru Auth Table Select the recently created Local Pass-through Authorization Table that defines the credentials the subtended Yealink devices must present to the SBC to be successfully recognized (registered). For the   example deployment , the value is  Local registration table . Media List ID (Optional Step for encrypted media) If you specified a new TLS Profile ID , please select the Media List ID value associated with Phone System Signaling Group for SRTP communication with the registered subtended Yealink client devices. The value to be selected should be MS Teams Media List , originally created through the use of the Teams DR-related easy configuration wizard during the SBC setup . The contains SRTP cryptographic settings that can be used for Spacevars 0 product  ↔ subtended registered Yealink client device encrypted media exchange. NOTE: For details on Media List ID configuration including the setup of attributes related to media encryption, please refer to Managing Media Lists and Managing SDES-SRTP Profiles . Listen Port Click the (Plus icon) to create a new instance of the SIP Listen Port, and update as follows: Option 1: For unencrypted Spacevars 0 product  ↔ subtended registered Yealink client device communication, please enter the Port value as 5060, the Protocol value as UDP, and the TLS Profile ID as N/A. Option 2: For encrypted  ↔ subtended registered Yealink client device communication (you must have specified a new TLS Profile ID entry earlier), please enter the Port value as 5061, the Protocol value as TLS, and the TLS Profile ID as the new entry created earlier (e.g. Yealink SIP Client SBC Signaling ) . Federated IP/FQDN Click the (Plus icon) to create a new instance of the Federated IP/FQDN, and specify as follows to identify the networking IP addresses of your Yealink Teams client devices, supplied by the enterprise IT administrator. For our   example deployment , the IP/FQDN is entered as XXX .0.0.0 , with the Netmask/Prefix as 255.0.0.0 , meaning the signaling group will accept communication with any host (i.e. Yealink device) that presents a host IP of anywhere from XXX.0.0.1 → XXX.255.255.254 All other fields Please leave all default values as-is for basic configuration purposes.

      
      

      Info
      title Signaling Group Provisioning Reference Information
      For details on Signaling Group configuration attributes described above including modification of fields with default values, refer to Creating and Modifying SIP Signaling Groups.

      
      

   4. Click OK . The  new SIP Signaling Group (in the  example deployment , named  LocalReg ) may be expanded to present the following sample attributes.

      Caption
      0 Figure 1 Example SIP Signaling Group Configuration for Connection to Registered Yealink Teams Devices; Key User-Supplied values Highlighted

      
      

4. Anchor
   Step 4 Step 4

   In the WebUI, click the Settings tab.

   1. Anchor
      Transformation Table 3 Transformation Table 3

      In the left navigation pane, Call Routing -> Transformation .

      1. Click the Create (Plus icon).

      2. In the  Description  dialog box, enter the desired Transformation Table name identifier for calls received from the PSTN and destined for a subtended Yealink device. For our example deployment, the entered name is  from IMS to SIP .

      3. Click OK .

         Caption
         0 Figure 1 Highlighted New Transformation Table for PSTN Call Routing to Registered Yealink Devices

         
         

         Info
         title Transformation Table Provisioning Reference Information
         For details on Transformation Table configuration, refer to Managing Transformation Tables.

         
         

      4. Anchor
         Transformation Entry 3 Transformation Entry 3

         In the left navigation page, go to Transformation , and select (click) the new Transformation Table just created. In example deployment, the entered name is   from IMS to SIP . The table will appear under the tabs, with a note stating  – Table is empty --

         1. Anchor
            New 1 2 3 New 1 2 3

            Click the Create (Plus icon).

         2. Enter or select the following values into the pop-up window, to specify the modification of dialed digits from the PSTN to reach a subtended registered Yealink Survivability (SIP) client:

            Caption
            0 Table 1 New Transformation Table Entry Attributes for a PSTN Call to Reach a Specific Registered Yealink Device
            Field Required Entry Description Please use a descriptive name for the entry. In the example deployment, the entered name is  Entry ID 1 Admin State Enabled Type (Input Field) Called Address/Number Value (Input Field) Please enter a regular expression to define the Teams Phone Number assigned to the Yealink device with the survivability. In the example deployment, the entered expression is \+86XXXX604392, the Teams Phone Number assigned to the Yealink device that also carries the SIP phone number 30001 (latter used in the Survivability UI). Type (Output Field) Called Address/Number   Value (Output Field) Enter a regular expression to replace the Teams Phone Number dialed by the PSTN user to the assigned to the SIP phone number assigned to the Yealink device with the survivability. In the example deployment, the entered expression is 30001 , the Teams Phone Number assigned to the Yealink device that also carries the Teams Phone Number +86XXXX604392 (latter used in the Teams client UI).

            
            

            Info
            title Transformation Table Entries and Digit Manipulation Provisioning Reference Information
            For details on Transformation Table Entry configuration, refer to Creating and Modifying Entries to Transformation Tables. For call digit matching and manipulation through the use of regular expressions, please reference Creating Call Routing Logic with Regular Expressions.

            
            

         3. Click OK.

            Caption
            0 Figure 1 New Transformation Table Entry for PSTN Calls to Reach Registered Yealink Device

            
            

         4. Repeat  steps 1, 2 & 3  for each remaining possible  registered  Yealink device with both the Teams client and the Survivability (SIP) client. In the example deployment, steps 1, 2, and 3 are repeated for the Yealink device with the SIP phone number  30003 .

            Caption
            0 Figure 1 Completed Example New Transformation Table for PSTN Calls to Reach Registered Yealink Devices

            
            

   2. Anchor
      updated route entry 100 updated route entry 100

      In the left navigation pane, go to Call Routing > Call Routing Table and select the Call Routing Table originally created through the use of the Easy Configuration wizard (refer to Using the Easy Configuration Wizard) template for processing calls originating from the PSTN . For our example deployment, the table requiring the new entry is  From IMS  .

      1. Click the Create Routing Entry (Plus icon).

      2. Enter the following values into the pop-up window:

         Caption
         0 Table 1 Key Call Routing Entry Attribute Values That Must be Explicitly Submitted by User
         Field Required Entry Description Enter an informative name in the text field; for our example deployment, the value is  from IMS TO SIP Admin State Select Enabled Number/Name Transformation Table Select the newly created Transformation Table instance to which calls from the PSTN will be routed during survivability scenarios (i.e. when Phone System is unavailable). For the example deployment , the value is  from IMS to SIP . Destination Type Select Registrar Table Destination Signaling Groups Select the newly created SIP Local Registrar-related Signaling Group to which the subtended Yealink devices are associated. For the example deployment , the value is  LocalReg All other fields Leave all default values as-is for basic configuration purposes.

         
         

         Caption
         0 Figure 1 Call Route Entry Attributes for Example Teams Survivability-Related Call Route Entry
         Image Modified

         
         

         Info
         title Call Routing Table Entry Provisioning Reference Information
         For details on call routing table entry configuration including modification of fields with default values, refer to Creating and Modifying Entries to Call Routing Tables.

         
         

      3. Click OK and review the new Call Routing Table Entry related to survivability in the updated PSTN-related Call Routing Table from the left navigation pane.

         Caption
         0 Figure 1 Newly Created Teams Survivability Call Routing Entry in PSTN-Originated Call Routing Table

         
         

5. Anchor
   Step 5 Step 5

   Access the WebUI, click the Monitor  tab. Confirm the new SIP Signaling Group instance associated with the new SIP Local Registrar instance is active. For our   example deployment , the new SIP Signaling Group instance is  LocalReg .

   Caption
   0 Figure 1 Example SIP Signaling Group Linked to Registered Yealink Devices Shows Active

   
   

Update Yealink Teams Client Devices to Register with the 

Spacevars
0 product 1 bold

for Survivability

Prerequisites

This section assumes the following actions are complete:

1. Yealink client device prerequisites for Phone System Integration;

2. Spacevars
   0 product

    Teams DR prerequisites and configuration.

Yealink Teams Client Device Configuration Commands

CLI (Command Line Interface) Instructions

...

Info
title Yealink Teams Client Reference Material
Anchor Yealink reference Yealink reference Product manuals that describe the configuration and operation of the Teams clients may be found at support.yealink.com

Proceed to Testing

Anchor
Testing Testing

Testing Yealink Teams Client Local Survivability

Summary

Five key tests are required to confirm the Yealink Teams client devices can successfully offer users survivability services in the event that Phone System is unavailable, while defaulting to Teams-related services when Phone System is available. 

1. Successful registration with the SBC via SIP;
2. Successful call placed from the Yealink device to the PSTN via the SBC, without Phone System participation;
3. Successful call placed from the Yealink device to another Yealink device via the SBC;
4. Successful call placed from the Yealink device to the PSTN via Phone System;
5. Successful call from the PSTN routed to the correct Yealink device via the SBC, when Phone System is unavailable;
6. Successful call from the PSTN routed to the correct Yealink device when Phone System is available.

Anchor
survive 1 survive 1

Confirm Yealink Teams Client Devices Registration with 

Spacevars
0 product

Yealink Device Confirmation

Confirm the phone icons in the device's Survivability (SIP) UI are green signifying successful registration and availability with a remote SIP server (in this case, the SBC's SIP Local Registrar). Note the 30001 phone number assigned to the Yealink device.

Caption
0 Figure 1 Yealink Device Survivability (SIP) UI with Green Phone Icons
Image Modified

SBC Confirmation

Access the WebUI, click the Settings tab.

1. In the left navigation page, access SIP > Local Registrars Table.

2. Confirm the SIP Local Registrar instance created to support survivability appears in the main body of the WebUI. For our example deployment, the the SIP Local Registrar instance is identified as  LocalReg .

3. From the SIP Local Registrar instance presented in step 2, click  Registered Users. 

   Caption
   0 Figure 1 Registered Yealink Phones with Example SIP Local Registrar

   
   

4. Confirm the presence of the Yealink device. For the example deployment, the correct user name (phone number) is 30001 and is clearly visible in the first row of the table.

   Info
   title SIP Local Registrar Registered Users Reference Information
   For details surrounding the information available on the registered users, refer to Managing SIP Local Registrars.

   
   

Anchor
survive 2 survive 2

Confirm Yealink Device Calling to the PSTN via 

Spacevars
0 product

Place Call from Yealink Device Survivability UI into PSTN

Anchor
survive 3 survive 3

Confirm Yealink Teams Client Devices Calling the PSTN via 

Spacevars
0 product

Place Call from Yealink Device Teams UI into PSTN

Anchor
survive 4 survive 4

Confirm Survivability Operation when Phone System is Unavailable

...

Disable the Teams Phone System Signaling Group From SBC

  Access the WebUI , click by clicking the Settings tab.

1. In the left navigation pane, go to Signaling Groups

2. From the main display, select the check box next to the Teams Phone System-related signaling group (for our example deployment, the  Microsoft Teams signaling group) and click the Out of Service ( Image Removed ) icon.

3. Confirm that the Phone System-related signaling group is out of service, through the Down indication in the Service Status field. 

   Caption
   0 Figure 1 Example Teams Phone System-Related SIP Signaling Group in Out of Service State

   
   

   Info
   title SIP Signaling Group Operations Reference Information
   For details on SIP Signaling Group operation including enablement and disablement, refer to Creating and Modifying SIP Signaling Groups.

   
   

Place Call from PSTN to Yealink Device

...

Place a call from PSTN to the Yealink device and confirm call alerting on the Yealink

...

device's Survivability UI and the SBC's WebUI.

1. Access the Yealink device's Survivability (SIP) UI.

   Caption
   0 Figure 1 Yealink Device Survivability (SIP) UI Prior to Incoming Call

   
   

2. Place a call from the PSTN to the Yealink device, using the Teams phone number assigned to the Yealink device. For the example deployment, the Teams phone number assigned to the Yealink device with the 30003 SIP-related number is +86XXXX604393.

   Note
   title Please use Teams Phone Number to Reach Yealink Device's Survivability (SIP) UI
   Please dial from the PSTN the phone number required to reach the Teams client on the Yealink device, as opposed to the phone number associated with the Survivability (SIP) client. By using the Teams client phone number, the test confirms that the transformation table entries associated with the PSTN signaling group (for our example deployment, the  IMS signaling group)  have been correctly provisioned for survivability routing.

   
   

3. Confirm an incoming call is presented in the Survivability (SIP) UI. Note the alerting indication.

   Caption
   0 Figure 1 Yealink Device Displaying Incoming Call from PSTN Client

   
   

4. Access the SBC's WebUI, and click the  Monitor  tab. 

   1. Expand the three signaling groups (that pertain to the survivability scenario) so all channels become visible. For our example deployment, the three signaling groups identifiers are  LocalReg  (the signaling group to which the Yealink devices are  registered),  IMS (the PSTN-related signaling group), and Microsoft Teams .

   2. Review the channel states for each signaling group, and confirm correct operation:

      1. The PSTN-related signaling group (for our example deployment, the  IMS signaling group)  presents an alerting indication ( magenta ) in  a single channel. Double-click the seized channel to ensure consistency between the channel details and the call placed from the PSTN (e.g. call direction is incoming, called digits are the Teams client number of the 30003 endpoint, calling party number is the PSTN endpoint, etc.).

      2. The SIP local registrar-related signaling group (for our example deployment, the   LocalReg  signaling group)  presents an alerting indication ( magenta ) in  a single channel. Double-click the seized channel to ensure consistency between the channel details and the call placed from the PSTN (e.g. call direction is incoming, called digits are the Teams client number of the 30003 endpoint, calling party number is the PSTN endpoint, etc.). 

      3. All channels remain out of service ( gray )  in the Phone System-related signaling group (for our example deployment, the  Microsoft Teams signaling group).

         Caption
         0 Figure 1 SBC displaying (from the Monitor) a call attempt from the PSTN to a Yealink device, Using a Teams client #

         
         

Answer Call and Confirm the Connection

1. From the Yealink device's survivability (SIP) UI, answer the call and confirm two-way audio. Note the following indicators in the UI: 

   1. The  green handset icon indicating a live call; 

   2. The Talking text indicating a live audio path.

      Caption
      0 Figure 1 Yealink Device Displaying Active Call in Survivability Mode with PSTN Client

      
      

2. Access the SBC's WebUI, and click the  Monitor  tab. 

   1. Expand the three signaling groups (that pertain to the survivability scenario) so all channels become visible. For our example deployment, the three signaling groups identifiers are  LocalReg  (the signaling group to which the Yealink devices are  registered),   IMS (the PSTN-related signaling group), and Microsoft Teams .

   2. Review the channel states for each signaling group, and confirm correct operation:

      1. The PSTN-related signaling group (for our example deployment, the  IMS signaling group)  presents a connected indication ( blue ) in the channel that previously presented the alerting indication. Double-click the seized channel to ensure consistency between the channel details and the call placed from the PSTN (e.g. call direction is incoming, called digits are the Teams client number of the 30003 endpoint, calling party number is the PSTN endpoint, etc.).

      2. The SIP local registrar-related signaling group (for our example deployment, the   LocalReg  signaling group)  presents a connected indication ( blue ) in the channel that previously presented the alerting indication. Double-click the seized channel to ensure consistency between the channel details and the call placed from the PSTN (e.g. call direction is incoming, called digits are the Teams client number of the 30003 endpoint, calling party number is the PSTN endpoint, etc.). 

      3. All channels remain out of service ( gray )  in the Phone System-related signaling group (for our example deployment, the  Microsoft Teams signaling group).

         Caption
         0 Figure 1 SBC displaying the connected call from the PSTN to a Yealink device, Using a Teams client #

         
         

Anchor
survive 5 survive 5

Confirm Teams Calling when Phone System is Available

...

Enable the Phone System Signaling Group From SBC

  Access the WebUI, click the Settings tab.

1. In the left navigation pane, go to Signaling Groups

2. From the main display, select the check box next to the Phone System-related signaling group (for our example deployment, the  Microsoft Teams signaling group) and click the Enable ( ) icon.

3. Confirm the Phone System-related signaling group is active, through the Up indication in the Service Status field. 

Place Call from PSTN to Yealink Device and Confirm Two-Way Audio

...

Confirm Call Completion via Phone System From SBC

Access the WebUI, and then click the  Monitor  tab. 

1. Expand the three signaling groups (that pertain to the survivability scenario) so all channels become visible. For our example deployment, the three signaling groups identifiers are  LocalReg  (the signaling group to which the Yealink devices are  registered),  IMS (the PSTN-related signaling group), and Microsoft Teams.

2. Review the channel states for each signaling group, and confirm correct operation:

   1. One channel is seized ( blue ) in the PSTN-related signaling group (for our example deployment, the  IMS signaling group).  Double-click the seized channel to ensure consistency between the channel details and the call placed from the Yealink device (e.g. call direction is incoming, called party number has the same phone number as the Yealink device, calling party number is the PSTN number from which you made the call, etc.).

   2. One channel is seized ( blue ) in the Phone System-related signaling group (for our example deployment, the  Microsoft Teams signaling group).   Double-click the seized channel to ensure consistency between the channel details and the call placed from the Yealink device.

   3. All channels remain idle ( light green ) in the SIP local registrar-related signaling group (for our example deployment, the   LocalReg  signaling group). 

      Caption
      0 Figure 1 SBC Displaying (from the Monitor) an Active Call Between Yealink Client (in Teams Mode of Operation) with PSTN Client via the SIP Trunk

      
      

Success

If all test cases are successfully completed, Teams client survivability is correctly provisioned and operational. If any test cases fail, please revisit all prerequisites and provisioning. 

...