Yealink SIP-T2 Series Auto Provisioning Manual

Yealink SIP-T2 Series Auto Provisioning Manual

Hide thumbs Also See for SIP-T2 Series:
Table of Contents

Advertisement

Table of Contents
iii

Advertisement

Table of Contents
loading
Need help?

Need help?

Do you have a question about the SIP-T2 Series and is the answer not in the manual?

Questions and answers

Summary of Contents for Yealink SIP-T2 Series

  • Page 1 Table of Contents...
  • Page 3: Table Of Contents

    Obtaining the Boot File ............................3 Obtaining Configuration Files ..........................3 Obtaining Phone Information ..........................4 Provisioning Yealink IP Phones ............ 5 Auto Provisioning Process ............................ 5 Major Tasks for Auto Provisioning ........................6 An Instance of Auto Provision Configuration ....................7 Managing Boot Files ..............
  • Page 4 Yealink IP Phones Auto Provisioning Guide Obtaining the Provisioning Server Address ......25 Zero Touch ................................25 Plug and Play (PnP) Server ..........................26 DHCP Options ................................ 27 Phone Flash ................................29 Configuring Wildcard of the Provisioning Server URL ................30 Triggering the IP Phone to Perform the Auto Provisioning ..
  • Page 5 Table of Contents Add the Option 43 via DHCP Turbo ......................64...
  • Page 7: Summary Of Changes

    Summary of Changes Summary of Changes This section describes the changes to this guide for each release and guide version. Changes for Release 81, Guide Version 81.72 Documentations of the newly released CP960 IP phones have also been added. Changes for Release 81, Guide Version 81.71 Documentations of the newly released CP860/SIP-T54S/T52S IP phones have also been added.
  • Page 9: Changes For Release 81, Guide Version 81.72

    Yealink IP phones support FTP, TFTP, HTTP, and HTTPS protocols for auto provisioning and are configured by default to use the TFTP protocol. The purpose of this guide is to serve as a basic guidance for provisioning Yealink IP phones, including: Yealink SIP-T58V/A ...
  • Page 10 Yealink IP Phones Auto Provisioning Guide...
  • Page 11: Getting Started

     Common boot file (y000000000000.boot)  You can ask the distributor or Yealink FAE for the template boot file. Obtaining Configuration Files Before beginning 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.
  • Page 12: Obtaining Phone Information

    MAC-local CFG file on the IP phone. You can ask the distributor or Yealink FAE for template configuration files. You can also obtain the template configuration files online: http://support.yealink.com/documentFront/forwardToDocumentFrontDisplayPage.
  • Page 13: Provisioning Yealink Ip Phones

    Provisioning Yealink IP Phones Provisioning Yealink IP Phones This section provides instructions on how IP phones interoperate with provisioning server for auto provisioning, and shows you four major tasks to provision the phones. It will help users who are not familiar with auto provisioning to understand this process more easily and quickly.
  • Page 14: Major Tasks For Auto Provisioning

    For more information on how to perform the auto provisioning process, refer to Triggering the IP Phone to Perform the Auto Provisioning on page 33. If you are not familiar with auto provisioning process on Yealink IP phones, you can refer to Instance of Auto Provision Configuration on page 7.
  • Page 15: An Instance Of Auto Provision Configuration

    Provisioning Yealink IP Phones An Instance of Auto Provision Configuration This section shows an instance of auto provision configuration. Manage boot files. Specify the desired download path (e.g., tftp://10.2.5.193/network.cfg) of the configuration files in the boot file (e.g., y000000000000.boot). For more information, refer to...
  • Page 16 Yealink IP Phones Auto Provisioning Guide Start the TFTP sever. The IP address of the TFTP server is shown as below: 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...
  • Page 17 Provisioning Yealink IP Phones Configure the provisioning server address on the IP phone. For more information on how to obtain the provisioning server address, refer to Obtaining the Provisioning Server Address on page 25. Trigger the IP phone to perform the auto provisioning.
  • Page 18 Yealink IP Phones Auto Provisioning Guide...
  • Page 19: Managing Boot Files

    Managing Boot Files Managing Boot Files Yealink IP phones support downloading CFG files referenced in the boot files in sequence. Before beginning provisioning, you may need to edit and customize your boot files. 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.
  • Page 20: Creating Mac-Oriented Boot File

    Yealink IP Phones Auto Provisioning Guide new downloaded configuration files will override the duplicate parameters in files downloaded earlier. “overwrite_mode = 1” means overwrite mode is enabled. The overwrite mode will be  applied to the configuration files specified to download. This parameter can only be used in boot files.
  • Page 21 Managing Boot Files To create a MAC-Oriented boot file: Create a boot file for your phone. Ensure the file complies with the guidelines that are listed Editing Common Boot File on page 11. Copy the contents from the common boot file and specify the configuration files to be downloaded.
  • Page 22 Yealink IP Phones Auto Provisioning Guide...
  • Page 23: Managing Configuration Files

    Managing Configuration Files Managing Configuration Files Auto provisioning enables Yealink IP phones to update themselves automatically via downloading Common CFG, MAC-Oriented CFG, custom CFG and MAC-local CFG files. Before beginning provisioning, you may need to edit and customize your configuration files.
  • Page 24 Yealink IP Phones Auto Provisioning Guide Phone Model Common CFG File SIP-T40P y000000000054.cfg SIP-T40G y000000000076.cfg SIP-T29G y000000000046.cfg SIP-T27P y000000000045.cfg SIP-T27G y000000000069.cfg SIP-T23P/G y000000000044.cfg SIP-T21(P) E2 y000000000052.cfg SIP-T19(P) E2 y000000000053.cfg CP860 y000000000037.cfg W52P/W56P y000000000025.cfg Common CFG file contains configuration parameters which apply to phones with the same model, such as language and volume.
  • Page 25: Editing Mac-Oriented Cfg File

    Managing Configuration Files Set only one configuration parameter per line. Put the configuration parameter and value on the same line, and do not break the line. Editing MAC-Oriented CFG File The MAC-Oriented CFG file is only effectual for the specific phone. It use the 12-digit MAC address of the IP phone as the file name.
  • Page 26: Creating A New Cfg File

    Yealink IP Phones Auto Provisioning Guide Creating a New CFG File If you want to create a new CFG file for your phone, follow these steps: To create a new CFG file: Create a CFG file for your phone. Ensure the file complies with the guidelines that are listed...
  • Page 27: Encrypting Configuration Files

    Configuration Encryption Tool User Guide Customizing Resource Files When configuring some particular features, you may need to upload resource files to IP phones, such as personalized ring tone file, language package file and logo file. Yealink supplies the following resource file templates: Feature Template File Name AutoDST.xml...
  • Page 28 44.81.0.15.rom For SIP-T58V/T58A/T56A/CP960: X.80.0.XX.rom For example, 58.80.0.10.rom Ask the distributor or Yealink FAE for resource file templates. For more information on an explanation of the configuration parameters that relate to these features, refer to Yealink_SIP-T2_Series_T19(P) E2_T4_Series_T5_Series_CP860_IP_Phones_Administrator_Guide_V81 Yealink IP DECT Phone...
  • Page 29: Configuring A Provisioning Server

    Configuring a Provisioning Server Configuring a Provisioning Server Yealink IP phones support using FTP, TFTP, HTTP and HTTPS protocols to download boot files and configuration files. You can use one of these protocols for provisioning. The TFTP protocol is used by default. The following section provides instructions on how to configure a TFTP server.
  • Page 30: Configuring A Tftp Server

    Yealink IP Phones Auto Provisioning Guide An example of configuration on the Windows platform is shown as below: Configuring a TFTP Server If you have a 3CDaemon application installed on your local system, use it directly. Otherwise, download and install it.
  • Page 31 Configuring a Provisioning Server Select Configure TFTP Server. Click the button to locate the TFTP root directory from your local system: Click the Confirm button to finish configuring the TFTP server. The server URL “tftp://IP/” (Here “IP” means the IP address of the provisioning server, for example, ”tftp://10.2.5.193/”) is where the IP phone downloads configuration files from.
  • Page 32 Yealink IP Phones Auto Provisioning Guide...
  • Page 33: Obtaining The Provisioning Server Address

    Obtaining the Provisioning Server Address Obtaining the Provisioning Server Address Yealink IP phones support obtaining the provisioning server address in the following ways: Zero Touch  Plug and Play (PnP) Server  DHCP Options  Phone Flash  Configuring Wildcard of the Provisioning Server URL ...
  • Page 34: Plug And Play (Pnp) Server

    Plug and Play (PnP) Server Yealink IP phones support obtaining the provisioning server address from the PnP server. The IP phone broadcasts the PnP SUBSCRIBE message to obtain the provisioning server address during startup.
  • Page 35: Dhcp Options

    After the IP phone obtains the provisioning server address from the PNP server, it will connect to the provisioning server and perform the auto provisioning process during startup. DHCP Options Yealink IP phones support obtaining the provisioning server address by detecting DHCP options during startup.
  • Page 36 Yealink IP Phones Auto Provisioning Guide The phone will automatically detect the option 66 and option 43 for obtaining the provisioning server address. DHCP option 66 is used to identify the TFTP server. DHCP option 43 is a vendor-specific option, which is used to transfer the vendor-specific information.
  • Page 37: Phone Flash

    Phone Flash Yealink IP phones support obtaining the provisioning server address from the IP phone flash. To obtain the provisioning server address by reading the IP phone flash, make sure the configuration is set properly.
  • Page 38: Configuring Wildcard Of The Provisioning Server Url

    Yealink IP phones support the following wildcards in the provisioning server URL: $PN: it is used to identify the directory name of the provisioning server directory where the ...
  • Page 39 Obtaining the Provisioning Server Address configuration files from the identified directory on the provisioning server. static. The value of the parameter “ auto_provision.url_wildcard.pn” must be configured in accordance with the directory name of the provisioning server directory where the boot files and configuration files of the IP phones are located.
  • Page 40 Yealink IP Phones Auto Provisioning Guide...
  • Page 41: Triggering The Ip Phone To Perform The Auto Provisioning

    Triggering the IP Phone to Perform the Auto Provisioning Triggering the IP Phone to Perform the Auto Provisioning This chapter introduces the following methods to trigger the IP phone to perform the auto provisioning process: Power On  Repeatedly  Weekly ...
  • Page 42: Repeatedly

    Yealink IP Phones Auto Provisioning Guide Mark the On radio box in the Power On field. Click Confirm to accept the change. Repeatedly The IP phone performs the auto provisioning process at regular intervals. You can configure the interval for the repeatedly mode. The default interval is 1440 minutes.
  • Page 43: Weekly

    Triggering the IP Phone to Perform the Auto Provisioning Enter the desired interval time (in minutes) in the Interval(Minutes) field. Click Confirm to accept the change. Weekly The IP phone performs the auto provisioning process at a random time every week/month/quarter.
  • Page 44: Flexible Auto Provision

    Yealink IP Phones Auto Provisioning Guide Check one or more checkboxes in the Day of Week field. Click Confirm to accept the change. Flexible Auto Provision The IP phone performs the auto provisioning process at a random time on a random day within a specific period of time.
  • Page 45: Auto Provision Now

    Triggering the IP Phone to Perform the Auto Provisioning Enter the desired start time and end time in the Flexible Time field. Click Confirm to accept the change. Auto Provision Now You can use auto provision now mode to manually trigger the IP phone to perform the auto provisioning process immediately.
  • Page 46: Multi-Mode Mixed

    Yealink IP Phones Auto Provisioning Guide Click Autoprovision Now. The IP phone will perform the auto provisioning process immediately. Multi-mode Mixed You can activate more than one method for auto provisioning. For example, you can activate the “Power On” and “Repeatedly” modes simultaneously. The IP phone will perform the auto provisioning process when it is powered on and at a specified interval.
  • Page 47: Auto Provisioning Via Activation Code

    Triggering the IP Phone to Perform the Auto Provisioning Description of Configuration Parameters in CFG Files.xlsx Yealink_SIP-T5_Series_CP960_IP_Phones_Description of Configuration Parameters in CFG Files.xlsx This method requires server support. The following figure shows the message flow: Auto Provisioning via Activation Code In addition to the updating modes introduced above, users can trigger IP phones to perform auto provisioning by dialing an activation code.
  • Page 48 Yealink IP Phones Auto Provisioning Guide The following lists the processes for triggering auto provisioning via activation code: Create multiple directories (e.g., T23G_1 and T23G_2) on the provisioning server. Store boot files and configuration files to each directory on the provisioning server.
  • Page 49 Triggering the IP Phone to Perform the Auto Provisioning process. The IP phone downloads the specified configuration files in sequence in boot files from the provisioning server to complete phone configurations. For more information on boot files and configuration files, refer to Managing Boot Files on page Managing...
  • Page 50 Yealink IP Phones Auto Provisioning Guide...
  • Page 51: Downloading And Verifying Configurations

    For more information on the specific configurations which require a reboot during auto provisioning and the parameter “static.auto_provision.reboot_force.enable”, refer to Yealink_SIP-T2_Series_T19(P) E2_T4_Series IP Phones_Description of Configuration Parameters in Yealink IP DECT Phones Description of Configuration Parameters in CFG CFG Files_V81.xlsx Files.xlsx Yealink_SIP-T5_Series_CP960_IP_Phones_Description of Configuration Parameters in CFG Files.xlsx...
  • Page 52: Using Mac-Local Cfg File

    Yealink IP Phones Auto Provisioning Guide If configuration files have been AES encrypted, the IP phone will uses the Common AES key to decrypt the Common CFG file and the MAC-Oriented AES key to decrypt the <MAC>.cfg file after downloading the configuration files. For more information on how the IP phone decrypts...
  • Page 53 Example1: Yealink SIP-T23G IP phone downloads the boot file and configuration files from the TFTP server. Example 2: Yealink SIP-T23G IP phone downloads the boot file and configuration files from the FTP server. Example 3: Yealink SIP-T23G IP phone downloads boot file and configuration files from the...
  • Page 54 Yealink IP Phones Auto Provisioning Guide...
  • Page 55: Troubleshooting

    Troubleshooting Troubleshooting This chapter provides general troubleshooting information to help you solve problems you might encounter when deploying phones. If you require additional information or assistance with the deployment, contact your system administrator. Why does the IP phone fail to download configuration files? Ensure that auto provisioning feature is configured properly.
  • Page 56 Yealink IP Phones Auto Provisioning Guide Why is the permission denied when uploading files to the root directory of the FTP server? Ensure that the complete path to the root directory of the FTP server is authorized.  Check security permissions on the root directory of the FTP server, if necessary, change the ...
  • Page 57: Glossary

    Glossary 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.
  • Page 58 Yealink IP Phones Auto Provisioning Guide...
  • Page 59: Appendix

    Appendix Appendix Configuring an FTP Server Wftpd and FileZilla are free FTP application software for Windows. This section mainly provides instructions on how to configure an FTP server using wftpd for Windows. You can download wftpd online: http://www.wftpd.com/products/products.html or FileZilla online: https://filezilla-project.org.
  • Page 60: Configuring An Ftp Server

    Yealink IP Phones Auto Provisioning Guide Configuring an FTP Server To configure a wftpd server: Download the compressed file of the wftpd application to your local directory and extract Double click the Wftpd.exe. The dialogue box of how to register is shown as below: Check the check box and click OK in the pop-up dialogue box.
  • Page 61 Appendix Click New User. Enter a user name (e.g., test1) in the User Name field and then click OK. Enter the password of the user (e.g., test1) created above in the New Password and Verify Password field respectively, and then click OK. Click Browse to locate the FTP root directory from your local system.
  • Page 62: Configuring An Http Server

    Yealink IP Phones Auto Provisioning Guide 10. Check the check boxes of Read, Create Files/Dirs, List Directories and Overwrite/Delete to make sure the FTP user has the read and write permission. 11. Click Done to save the settings and finish the configurations.
  • Page 63: Configuring An Http Server

    Appendix You need to define a user or group name and set the permissions: read, write, and modify. Security permissions vary by organizations. An example of configuration on the Windows platform is shown as below: Configuring an HTTP Server HFS tool is an executable application, so you don’t need to install it. To configure an HTTP server: Download the application file to your local directory, double click the hfs.exe.
  • Page 64 Yealink IP Phones Auto Provisioning Guide 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 65 Appendix The default HTTP port is 8080. You can also reset the HTTP port (make sure there is no port conflict). Right click the icon on the left of the main page, select Add folder from disk to add the HTTP Server root directory.
  • Page 66: Configuring A Dhcp Server

    (Optional.) Enter the desired user name and password for the root directory in the corresponding fields and then click OK. Yealink IP phones also support the Hypertext Transfer Protocol with SSL/TLS (HTTPS) protocol for auto provisioning. HTTPS protocol provides the encrypted communication and secure identification.
  • Page 67: Configuring The Dhcp Turbo

    Appendix Configuring the DHCP Turbo Before configuring the DHCP Turbo, make sure: The firewall on the PC is disabled.  There is no DHCP server in your local system.  To configure the DHCP Turbo: To start the DHCP Turbo application, double click localhost. Click the Login button (the login password is blank) to log in.
  • Page 68 Yealink IP Phones Auto Provisioning Guide Click OK to accept the change. You can add a custom option via DHCP Turbo. Select Option Types, right click one of the options on the right of the main page, and then select New Option Type.
  • Page 69 Appendix Set the custom DHCP option (custom DHCP option tag number ranges from 128 to 254) and select the option type (Yealink supports string and ipaddress option types only). Click the OK button to finish setting the option properties. Click to save the change.
  • Page 70: Add The Option 66 Via Dhcp Turbo

    Yealink IP Phones Auto Provisioning Guide 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 71 Appendix Click Named Policies-->Global, right click the blank area on the right of the main page and then select New Option. Select TFTP Options from the pull-down list of Filter. Scroll down and double click MS option 66.
  • Page 72 Yealink IP Phones Auto Provisioning Guide Fill the provisioning server IP address in the input field. Click the OK button to finish setting a custom option. Click to save the change. Add the Option 43 via DHCP Turbo You can also add the option 43. The following shows the detailed processes.
  • Page 73 Appendix Scroll down and double click 43. 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 74 Yealink IP Phones Auto Provisioning Guide Customer Feedback We are striving to improve our documentation quality and we appreciate your feedback. Email your opinions and comments to DocsFeedback@yealink.com.

Table of Contents