Yealink T58A Teams User manual

Table of Contents
iii
11

Table of Contents
iii
Table of Contents
Table of Contents..........................................................................iii
Introduction....................................................................................1
Getting Started...............................................................................3
Obtaining Boot, Configuration and Resource Files ....................................................................................3
Boot Files.................................................................................................................................................................3
Configuration Files ..............................................................................................................................................3
Resource Files........................................................................................................................................................4
Obtaining Template Files..................................................................................................................................4
Obtaining Phone Information.............................................................................................................................4
Provisioning Yealink Teams IP phones ........................................5
Interoperating with Provisioning Server .........................................................................................................5
Auto Provisioning Process....................................................................................................................................6
Without Boot Files(Old Mechanism) ............................................................................................................6
With Boot Files(New Mechanism) .................................................................................................................7
Major Tasks for Auto Provisioning....................................................................................................................8
An Instance of Auto Provision Configuration ...............................................................................................9
Managing Boot Files ....................................................................13
Editing Common Boot File ................................................................................................................................ 13
Creating MAC-Oriented Boot File .................................................................................................................. 15
Managing Configuration Files ....................................................17
Editing Common CFG File.................................................................................................................................. 17
Editing MAC-Oriented CFG File....................................................................................................................... 19
Creating a New CFG File..................................................................................................................................... 20
Managing MAC-local CFG File......................................................................................................................... 20
Encrypting Configuration Files......................................................................................................................... 21
Managing Resource Files.............................................................23
Customizing Resource Files .............................................................................................................................. 23
Configuring a Provisioning Server .............................................25

Auto Provisioning Guide for Yealink Teams IP Phones
iv
Preparing a Root Directory ............................................................................................................................... 25
Configuring a TFTP Server................................................................................................................................. 26
Obtaining the Provisioning Server Address ..............................29
DHCP Options ........................................................................................................................................................ 29
Phone Flash ............................................................................................................................................................. 31
Triggering the Phone to Perform the Auto Provisioning ........33
Power On.................................................................................................................................................................. 33
Repeatedly............................................................................................................................................................... 34
Weekly....................................................................................................................................................................... 35
Auto Provision Now ............................................................................................................................................. 35
Multi-mode Mixed................................................................................................................................................ 36
Downloading and Verifying Configurations .............................37
Downloading Boot, Configuration and Resource Files .......................................................................... 37
Resolving and Updating Configurations ..................................................................................................... 37
Using MAC-local CFG File.................................................................................................................................. 38
Verifying Configurations .................................................................................................................................... 38
Troubleshooting...........................................................................41
Glossary.........................................................................................43
Appendix.......................................................................................45
Configuring an FTP Server................................................................................................................................. 45
Preparing a Root Directory ........................................................................................................................... 45
Configuring an FTP Server............................................................................................................................. 46
Configuring an HTTP Server ............................................................................................................................. 48
Preparing a Root Directory ........................................................................................................................... 48
Configuring an HTTP Server ......................................................................................................................... 49
Configuring a DHCP Server............................................................................................................................... 53
Configuring the DHCP Turbo....................................................................................................................... 53
Add the Option 66 via DHCP Turbo .......................................................................................................... 57
Add the Option 43 via DHCP Turbo .......................................................................................................... 59

Introduction
1
Introduction
Yealink IP phones with Teams firmware enable a new era in unified communications. It is
designed to work with Microsoft®Teams.
Yealink Teams IP phones are full-featured telephones that can be plugged directly into an IP
network and can be used easily without manual configuration.
This guide provides instructions on how to configure Yealink Teams IP phones with the
minimum settings required. Yealink Teams IP phones support FTP, TFTP, HTTP, and HTTPS
protocols for auto provisioning and are configured to use the TFTP protocol by default.
The purpose of this guide is to serve as a basic guidance for provisioning Yealink Teams IP
phones, including:
Yealink T58A
Yealink T56A
Yealink T55A
Yealink CP960
Yealink VP59
The auto provisioning process outlined in this guide applies to Yealink
T58A/T56A/T55A/CP960 Teams phones running firmware version x.15.0.20 or later and VP59
Teams phones running firmware version x.15.0.16 or later. We recommend that Teams phones
running the latest firmware CANNOT be downgraded to an earlier firmware version. The new
firmware is compatible with old configuration parameters, but not vice versa.

Auto Provisioning Guide for Yealink Teams IP Phones
2

Getting Started
3
Getting Started
This section provides instructions on how to get ready for auto provisioning. To begin the auto
provisioning process, the following steps are required:
Obtaining Boot, Configuration and Resource Files
Obtaining Phone Information
Obtaining Boot, Configuration and Resource Files
Boot Files
The phone tries to download the boot file first, and then download the configuration files
referenced in the boot file during auto provisioning. You can select whether to use the boot file
or not according to your deployment scenario. If required, you need to obtain the template
boot file named as “y000000000000.boot” before auto provisioning.
You can use a boot file to specify which configuration files to be downloaded for specific phone
groups by phone model identity, and customize the download sequence of configuration files.
It is efficient for you to provision phones in different deployment scenarios, including all
phones, specific phone groups, or a single phone.
The configuration files referenced in the boot file are flexible: you can rearrange the
configuration parameters within the Yealink-supplied template configuration files or create
your own configuration files from configuration parameters you want. You can create and name
as many configuration files as you want and your own configuration files can contain any
combination of configuration parameters.
Configuration Files
Before provisioning, you also need to obtain template configuration files. There are two
configuration files both of which are CFG-formatted. We call these two files Common CFG file
and MAC-Oriented CFG file.
The configuration files contain parameters that affect the features of the phone. You can use
the configuration files to deploy and maintain a mass of Yealink IP phones automatically.
You can create and name as many configuration files as you want (e.g., features.cfg) by using
the template configuration files. The custom configuration files can contain the configuration
parameters of the same feature modules for all phones.

Auto Provisioning Guide for Yealink Teams IP Phones
4
Resource Files
When configuring some particular features, you may need to upload resource files to the
phones, such as personalized AutoDST file and language package file. Resource files are
optional, but if the particular feature is being employed, these files are required.
Yealink supplies the following resource file templates:
Feature
Template File Name
DST
AutoDST.xml
Language Packs
For example,
000.GUI.English.lang
1.English_note.xml
1.English.js
Obtaining Template Files
You can ask the distributor or Yealink FAE for template files. You can also obtain them online:
http://support.yealink.com/documentFront/forwardToDocumentFrontDisplayPage.
To download template boot, configuration and resource files:
1. Go to Yealink Document Download page and select the desired phone model.
2. Download and extract the combined template files to your local system.
3. Open the folder you extracted and identify the files you want to edit.
Obtaining Phone Information
Before beginning provisioning, you also need the phone information. For example: MAC
address, hardware version and account information of the Teams IP phone.
MAC Address: The unique 12-digit serial number of the Teams IP phone. You can obtain it
from the bar code on the back of the phone.
Hardware version: The current hardware version of the Teams IP phone. You can view it via
phone user interface or web user interface.
Online Account Information: Ask your system administrator Teams online account
information.

Provisioning Yealink Teams IP Phones
5
Provisioning Yealink Teams IP phones
This section provides instructions on how Teams IP phones interoperate with provisioning
server for auto provisioning, and shows you four major tasks to configure the phones. It will
help users who are not familiar with auto provisioning to understand this process more easily
and quickly.
Interoperating with Provisioning Server
When Teams IP phones are triggered to perform auto provisioning, it will request to download
the configuration files from the provisioning server. During the auto provisioning process, the
phone will download and update configuration files to the phone flash.
The following figure shows how the phone interoperates with the provisioning server:

Auto Provisioning Guide for Yealink Teams IP Phones
6
Auto Provisioning Process
Without Boot Files (Old Mechanism)
The following flowchart shows how Teams IP phones perform auto provisioning when using
configuration files only:

Provisioning Yealink Teams IP Phones
7
With Boot Files (New Mechanism)
The following figure shows auto provisioning flowcharts for Teams IP phones when using boot files:
Scenario A –Do Not Support Exclude Mode

Auto Provisioning Guide for Yealink Teams IP Phones
8
Scenario B –Support Exclude Mode
Major Tasks for Auto Provisioning
You need to complete four major tasks to configure Yealink Teams IP phones.
The following figure shows an overview of four major provisioning tasks:
For more information on how to manage boot files, refer to Managing Boot Files.
For more information on how to manage configuration files, refer to Managing Configuration
Files.

Provisioning Yealink Teams IP Phones
9
For more information on how to configure a provisioning server, refer to Configuring a
Provisioning Server.
For more information on how to obtain the provisioning server address, refer to Obtaining the
Provisioning Server Address.
For more information on how to perform the auto provisioning process, refer to Triggering the
Phone to Perform the Auto Provisioning.
If you are not familiar with auto provisioning process on Yealink Teams IP phones, you can refer
to An Instance of Auto Provision Configuration.
An Instance of Auto Provision Configuration
This section shows an instance of auto provision configuration.
1. Manage boot files.
Specify the desired URL (e.g., http://10.82.24.5/y000000000058.cfg) of the configuration
files in the boot file (e.g., y000000000000.boot). For more information, refer to Managing
Boot Files.
2. Manage configuration files.
Add/Edit the desired configuration parameters in the CFG file (e.g., y000000000058.cfg)
you want the phone to download. For more information on how to manage configuration
files, refer to Managing Configuration Files.

Auto Provisioning Guide for Yealink Teams IP Phones
10
3. Configure the TFTP server.
1) Place configuration files to TFTP root directory (e.g., D:\TFTP Directory).
2) Start the TFTP sever. The IP address of the TFTP server is shown as below:
3) Select Configure TFTP Server. Click the button to locate the TFTP root directory
from your local system.
For more information on how to configure a provisioning server, refer to Configuring a
Provisioning Server.

Provisioning Yealink Teams IP Phones
11
4. Configure the provisioning server address on the phone.
For more information on how to obtain the provisioning server address, refer to Obtaining
the Provisioning Server Address.

Auto Provisioning Guide for Yealink Teams IP Phones
12
5. Trigger the phone to perform the auto provisioning.
For more information on how to trigger the phone to perform the auto provisioning, refer to
Triggering the Phone to Perform the Auto Provisioning.

Managing Boot Files
13
Managing Boot Files
Yealink IP phones can download CFG files referenced in the boot files. Before provisioning, you
may need to edit and customize your boot files.
Yealink supports the following two types of boot files:
Common boot file (y000000000000.boot)
MAC-Oriented boot file (e.g., 00156574b150.boot)
You can edit the template boot file directly or create a new boot file as required. Open each
boot file with a text editor such as UltraEdit.
Editing Common Boot File
The common boot file is effective for all phones. It uses a fixed name “y000000000000.boot” as
the file name.
The following figure shows the contents of the common boot file:
The following table lists guidelines you need to know when editing the boot file:
Item
Guidelines
#!version:1.0.0.1
It must be placed in the first line.
Do not edit and delete.
## The header above
must appear as-is in the
first line
The line beginning with “#” is considered to be a comment.
You can use “#” to make any comment in the boot file.
include:config <xxx.cfg>
include:config "xxx.cfg"
1) Each “include” statement can specify a URL where a
configuration file is stored. The configuration file format must be
*.cfg.
2) The URL in <> or “” supports the following two forms:
Relative URL (relative to the boot file):

Auto Provisioning Guide for Yealink Teams IP Phones
14
Item
Guidelines
For example, sip.cfg, HTTP Directory/sip.cfg
Absolute URL:
For example, http://10.2.5.258/HTTP Directory/sip.cfg
The URL must point to a specific CFG file. The CFG files are
downloaded in the order listed (top to bottom). The parameters
in the new downloaded configuration files will override the
duplicate parameters in files downloaded earlier.
3) The “include” statement can be repeated as many times as
needed.
4) The [$MODEL] can be added to specify settings for specific
phone models. $MODEL represents the phone model name. The
valid phone model names are: T58A, T56A, T55A, VP59 and
CP960. Multiple phone models are separated by commas. For
example, [T58A, CP960]
overwrite_mode
Enable or disable the overwrite mode. The overwrite mode is applied
to the configuration files specified to download. Note that it only
affects the parameters pre-provisioned via central provisioning.
1-(Enabled) - If the value of a parameter in configuration files is left
blank, or if a non-static parameter in configuration files is deleted or
commented out, the factory default value takes effect.
0-(Disabled) - If the value of a parameter in configuration files is left
blank, deleted or commented out, the pre-configured value is kept.
Note: This parameter can only be used in boot files. If a boot file is
used but the value of the parameter “overwrite_mode” is not
configured, the overwrite mode is enabled by default.
specific_model.excluded_
mode
Enable or disable the exclude mode. The exclude mode applies to the
configuration files specified in the boot file.
0-Disabled (Append Mode), the phone downloads its own model-
specific configuration files, and downloads other model-unspecified
configuration files.
1-Enabled (Exclude Mode), the phone attempts to download its own
model-specific configuration files; if there is no own model-specific
configuration files found on the server, it downloads model-
unspecified configuration files.
Note: Exclude mode can only be used in boot files. If a boot file is
used but the value of the parameter “specific_model.excluded_mode”
is not configured, the exclude mode is disabled by default.

Managing Boot Files
15
Creating MAC-Oriented Boot File
The MAC-Oriented boot file is only effective for the specific phone. It uses the 12-digit MAC
address of the IP phone as the file name. For example, if the MAC address of the phone is
805EC0319692, the MAC-Oriented boot file has to be named as 805EC0319692.boot (case-
sensitive) respectively.
If you want to create a MAC-Oriented boot file for your phone, follow these steps:
To create a MAC-Oriented boot file:
1. Create a boot file for your phone. Ensure the file complies with the guidelines that are
listed in Editing Common Boot File.
2. Copy the contents from the common boot file and specify the configuration files to be
downloaded.
One or more configuration files can be referenced in the boot file. The following takes two
configuration files for example:
3. Save the changes and close the MAC-Oriented boot file.
You can also make a copy of the common boot file, rename it and then edit it.

Auto Provisioning Guide for Yealink Teams IP Phones
16