Table of Contents Changes from Previous Versions ..........v Changes from Version 1.2 ....................v Introduction ................1 Getting Started ................. 3 Obtaining Configuration Information ................3 Obtaining Configuration Files ..................3 Obtaining Phone Information ..................4 Managing Configuration Files .................... 4 Editing Common CFG File ....................
Page 4
Yealink Auto provisioning User Guide Verifying Configurations ....................29 Troubleshooting ..............31 Glossary .................. 33 Appendix ................35 Configuring a FTP Server....................35 Preparing a Root Directory .................... 35 Configuring a FTP server ....................36 Configuring a HTTP Server ....................38 Preparing a Root Directory ....................
Page 5
Changes from Previous Versions The following sections are new for this version: Customizing a Wallpaper on page Customizing a Screensaver on page Customizing Replace Rule File on page Customizing Dial-now File on page Major updates have occurred to the following sections: Customizing Local Contact File on page ...
This guide shows you how to provision Yealink IP phones with the minimum settings required. Yealink IP phones support the FTP , TFTP , HTTP , and HTTPS protocols for file provisioning and are configured by default to use Trivial File Transfer Protocol (TFTP).
The names of the Common CFG file for each phone model are: Phone Model Common Configuration File VP530 y000000000023.cfg SIP-T38G y000000000038.cfg SIP-T32G y000000000032.cfg SIP-T28(P) y000000000000.cfg SIP-T26(P) y000000000004.cfg SIP-T22(P) y000000000005.cfg SIP-T20(P) y000000000007.cfg You can ask the distributor or the Yealink FAE for configuration files.
Page 10
Although SIP accounts may not be required to get the phone working, we strongly recommend using them. Auto provisioning enables Yealink IP phones to update automatically via downloading the Common CFG file and MAC-Oriented CFG file. Before provisioning you may need to edit and customize your configuration files.
Page 11
Getting Started The parameters commonly edited in the Common CFG file (T2xP as an example) are detailed as following: #################################################### Common CFG File #################################################### #!version:1.0.0.1 ##File header "#!version:1.0.0.1" cannot be edited or deleted and must be placed in the first line.## #Configure the WAN port type;...
Page 12
Yealink Auto provisioning User Guide network.dchp.end_ip = 10.0.0.100 #Enable or disable the Plug and Play feature; 0-Disabled, 1-Enabled (default) auto_provision.pnp_enable = 1 #Configure the domain name of the PNP server. auto_provision.pnp_domain_name = #Configure the value (manufacturer of the device) of the PNP subscribe message.
Page 13
Getting Started auto_provision.server.username = auto_provision.server.password = #Configure the name of the common file. #T28P: y000000000000.cfg, T26P: y000000000004.cfg, T22P: y000000000005.cfg, #T20P: y000000000007.cfg-T20P; auto_provision.common_file_name = #Enable or disable DHCP option mode; 0-Disabled, 1-Enabled (default); auto_provision.dhcp_option.enable = #Configure the value (manufacturer of the device) of DHCP option 60. auto_provision.dhcp_option.option60_value = #Configure the custom DHCP option number.
Page 14
Yealink Auto provisioning User Guide network.port.https = 443 #Set the new password (admin123) for the administrator security.user_password = admin:admin123 #Set the new password (user123) for the user security.user_password = user:user123 MAC-Oriented CFG file contains configuration parameters which are expected to be updated per phone, such as the registration information.
Page 15
Getting Started #Configure the display name of account1 account.1.display_name = #Configure the user name and password for register authentication account.1.auth_name = account.1.password = #Configure the register user name account.1.user_name = #Configure the SIP server address and port (5060 by default) account.1.sip_server_host = account.1.sip_server_port = 5060 #Line2 settings...
Page 16
Yealink Auto provisioning User Guide account.3.user_name = #Configure the SIP server address and port (5060 by default) account.3.sip_server_host = account.3.sip_server_port = 5060 #Line4 settings (For SIP-T28P , SIP-T38G and VP530 IP phones only) #Enable or disable the account4, 0-Disabled (Default), 1-Enabled account.4.enable =...
Page 17
Yealink IP phones have built-in system ringtones and the default ring type is Ring1. You can change the ring type, or you can customize your personal ringtone and make it take effect via auto provisioning.
Yealink Auto provisioning User Guide You’d better check that the ringtone file has been uploaded to the root directory of the server before provisioning. For more information about customizing a ringtone file, you can refer to Customizing a Ringtone Using Cool Edit Pro in this guide.
Page 19
Getting Started Yealink SIP-T2xP IP phones allow you to customize the logo displayed on the phone LCD screen (The SIP-T20P IP phones only support displaying the text logo). Ask the distributor for the logo file, or you can customize a .dob logo file. Upload the logo file to the root...
Page 20
.jpg/.png/.bmp <=480*272 Yealink SIP-T3xG IP phones allow you to customize the screensaver displayed on the phone LCD screen. The screensaver will automatically start each time your phone is idle a certain period of time. You can stop the screensaver at any time by pressing any key.
Page 21
Getting Started Yealink IP phones allow you to batch upload contact data by auto provisioning. You can create multiple contacts using the supplied template local contact file. When editing the template local contact file, remember the following: <contactData> indicates the start of a contact file and </contactData> indicates ...
Page 22
Yealink Auto provisioning User Guide sMobilNumber=””/mobile_number=”” specifies the mobile number of the contact. sOtherNumber=””/other_number=”” specifies the other number of the contact. sLine=””/line=”” specifies the line you want to add this contact to. sRing=””/ring=”” specifies the ring tone for this contact.
Page 23
Getting Started The following shows an example of the contactData.xml file used for SIP-T2xP and SIP-T3xG IP phones: <contactData> <group> <contact sDisplayName="Mary" sOfficeNumber="123" sMobilNumber="456" sOtherNumber="2201" sLine="0" sRing="Auto" group="Family" photoDefault=”Config:family.png” photoSelect=”0”/> <contact sDisplayName="Damy" sOfficeNumber="124" sMobilNumber="789" sOtherNumber="2202" sLine="1" sRing="Resource:Ring2.wav" group="" photoDefault=”” photoSelect=”3”/>...
Page 24
LineID=””/lines=”” specifies the desired line(s) for this rule. When leaving it blank, this replace rule will apply to all lines. Specify the values within double quotes. Save the change. The following is an example of a replace rule file used for SIP-T2xP and SIP-T3xG IP phones: <DialRule> <Data Prefix="1" Replace="05928665234" LineID=""/>...
Page 25
LineID=""/ lines="" specifies the desired line(s) for this rule. When leaving it blank, this rule will apply to all lines. Specify the values within double quotes. Save the change. The following is an example of a dial-now file used for SIP-T2xP and SIP-T3xG IP phones: <DialNow> <Data DialNowRule="1234" LineID="1"/> <Data DialNowRule="52[0-6]" LineID="1"/>...
Page 26
During the auto provisioning process, the phone connects to the provisioning server “192.168.1.100”, and downloads the dial-now file “DialNow.xml”. Yealink IP Phones allow you to update the firmware manually via web user interface, or batch update the firmware via the auto provisioning. To batch update the phones’...
Configuring a TFTP Server Yealink IP Phones support using the FTP , TFTP , HTTP and HTTPS protocols to download the configuration files. TFTP server is used by default. You can use any protocol for provisioning. The following section takes the TFTP server as an example.
Page 28
Yealink Auto provisioning User Guide If you have a 3CDaemon application installed on your computer, use it directly. Otherwise, download and install it. To configure a TFTP server Double click the 3CDaemon.exe to start the application. A configuration page shows as below: Select Configure TFTP Server.
Obtaining the Address of Provisioning Server Yealink IP phones support to obtain the provisioning server address during bootup process in the following ways: Zero Touch Plug and Play (PNP) Server DHCP Options Phone Flash When the phone boots up, it will go by the above process to try to obtain the provisioning server address.
Page 30
Yealink Auto provisioning User Guide Click Confirm to accept the change. When the Zero Touch is enabled, there will be a configure wizard during the bootup: Press the OK soft key. Then you can configure the network via phone user interface: Press the Next soft key after finishing the network configuration.
Page 31
Obtaining the Address of Provisioning Server Yealink IP phones support obtaining the provisioning server address from the PNP server. The phone broadcast the PNP subscribe message to obtain a provisioning server address during bootup. To use Plug and play, make sure this feature is enabled.
Page 32
A valid Custom Option is from 128 to 254. The Custom Option Type must be in accordance with the one defined in the DHCP server. Yealink IP phones support obtaining a provisioning server address from the phone flash. To obtain a provisioning server address by reading the phone flash, make sure the...
Page 33
Obtaining the Address of Provisioning Server To configure the Phone Flash via web user interface: Click on Upgrade ->Advanced. Enter the URL, username and password of the provisioning server in the Provisioning Server, User Name and Password fields (the authentication username and password is optional).
After auto provisioning, the phone boots up. You can then verify the update via phone user interface, or you can verify it via web user interface of the phone. For more information, refer to the user guide of the Yealink IP phones. During the auto provisioning process, you can monitor the downloading request and...
Page 36
Yealink Auto provisioning User Guide Example 2: Yealink IP phone downloads the configuration files from the FTP server. Example 3: Yealink IP phone downloads the configuration files from the HTTP server.
Troubleshooting This chapter provides general troubleshooting information to help you solve the problems you might encounter when deploying the phones. If you require additional information or assistance with the deployment, contact your system administrator. Why does the phone fail to download the configuration file? Ensure that the Auto Provisioning feature is enabled.
Page 38
Yealink Auto provisioning User Guide Why does not the phone download the ringtone? Make sure that the ringtone file’s type is .wav format. Make sure that the size of the ringtone file is no larger than the phone support.
Glossary MAC Address: A Media Access Control address (MAC address) is a unique identifier assigned to network interfaces for communications on the physical network segment. MD5: The MD5 Message-Digest Algorithm is a widely used cryptographic hash function that produces a 128-bit (16-byte) hash value. DHCP: Dynamic Host Configuration Protocol (DHCP) is a network configuration protocol for hosts on Internet Protocol (IP) networks.
Appendix This chapter shows you how to configure a FTP server using 3CDaemon and how to configure a HTTP server using HFS tool. You can download the 3CDaemon software at: http://www.oldversion.com/3Com-Daemon.html and HFS at: http://www.snapfiles.com/get/hfs.html To prepare a root directory: Create a root FTP directory on the local computer.
Page 42
Yealink Auto provisioning User Guide If you have a 3CDaemon application installed on your computer, open it now, or otherwise, download and install it. To configure a FTP server: Double click the 3CDaemon.exe to start the application. Click the FTP Server button on the left of the main page.
Page 43
Appendix dialogue box. Click the OK button to save. Mark the check boxes of Login, Download and Upload to make sure the FTP user has the login, download and upload permission. Click the Save Profile button to save the settings and finish the configurations. 10.
Page 44
Yealink Auto provisioning User Guide To prepare a root directory: Create a root HTTP directory on the local computer. Place the configuration files to this root directory. Set the security permissions for the HTTP directory folder. You need to define a user or group name and set the permissions: read, write, and modify files.
Page 45
Appendix The main configuration page is shown as below: Click Menu in the main page and select the IP address of the PC from IP address.
Page 46
Yealink Auto provisioning User Guide The default HTTP port is 8080. You can also reset the HTTP port (make sure the port isn’t used before you reset). Right click the icon on the left of the main page, select Add folder from disk to...
Page 47
We recommend that you can fill the server URL in the address bar of the web browser and then press <Enter> key to check the HTTP server before provisioning. Hypertext Transfer Protocol SSL/TLS Yealink IP phones also support the with (HTTPS) protocol for auto provisioning. HTTPS protocol provides the encrypted communication and secure identification.
Page 48
Yealink Auto provisioning User Guide Click the Login button (the login password is blank) to log in. You can then edit the existed DHCP server, or you can right click the localhost and select “New Server” to add a new DHCP server.
Page 49
Appendix Right click the Scopes and select New Scope. Configure the DHCP server name, the DHCP IP range and the subnet mask. You can add a custom option via DHCP Turbo. Click Option Type, right click and select the New Option Type on the right of the main page.
Page 50
Set the custom DHCP option (custom DHCP option tag number ranges from 128 to 254) and select the option type (Yealink support the String and IP Address option type only). Click the OK button to finish setting the option properties. Click save the change.
Page 51
Appendix Scroll down and double click the custom option 128. 10. Fill the provisioning server address in the input field. 11. Click the OK button to finish setting a custom option. 12. Click to save the change.
Page 52
Yealink Auto provisioning User Guide You can add the option 66 via DHCP Turbo. The following figures show the detailed processes. Click Named Policies-->Global, right click and select New Option on the left of the main page. Select the TFTP Options in the Filter field.
Page 53
Appendix Fill the provisioning server address in the input field. Click the OK button to finish setting a custom option. Click to save the change. You also can add the option 44. The following figures show the detailed processes. Click Named Policies-->Global, right click and select New Option on the left of the main page.
Page 54
Yealink Auto provisioning User Guide Fill the provisioning server address in the input field. Click the OK button to finish setting a custom option. Click to save the change.
Page 55
Appendix If you have installed the Cool Edit application, double click to open it. Otherwise, you can download the installation package from the website: http://www.toggle.com/lv/group/view/kl36218/Cool_Edit_Pro.htm and install it. To customize a ringtone using Coo Edit Pro: Open the Cool Edit Pro application. Click File to open an audio file.
Page 56
Yealink Auto provisioning User Guide select the file format as A/mu-law wave. The original picture format must be .bmp or .gif. We recommend placing all files and the PictureExDemo application to the root directory of the PC. Double click the PictureExDemo.exe.
Need help?
Do you have a question about the SIP-T2xP and is the answer not in the manual?
Questions and answers