Yealink SIP-T2 Series Provisioning Manual
  1. Manuals
  2. Brands
  3. Yealink Manuals
  4. IP Phone
  5. SIP-T2 Series
  6. Provisioning manual

Yealink SIP-T2 Series Provisioning Manual

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

Advertisement

Quick Links

Download this manual See also: Administrator's Manual, Provisioning Manual
Table of Contents
iii

Advertisement

Table of Contents
loading

Related Manuals for Yealink SIP-T2 Series

Summary of Contents for Yealink SIP-T2 Series

  • Page 1 Table of Contents...

  • Page 3: Table Of Contents

    Introduction ................1 Getting Started ................. 3 Obtaining Configuration Files..................... 3 Obtaining Phone Information ..................... 4 Provisioning Yealink IP Phones ..........5 Auto Provisioning Process ....................5 Major Tasks for Auto Provisioning ..................7 An Instance of Auto Provision Configuration ..............8 Managing Configuration Files ..........
  • Page 4 Yealink IP Phones Auto Provisioning Guide Zero Touch ........................... 21 Plug and Play (PnP) Server ....................23 DHCP Options ........................25 Phone Flash ......................... 26 Configuring Wildcard of the Provisioning Server URL ............ 27 Triggering the IP Phone to Perform the Auto Provisioning ..31 Power On ..........................
  • Page 5 This version is updated to incorporate CP860 IP phones. Documentations of the newly released SIP-T40P IP phones have also been added. Documentations of the newly released SIP-T19(P) E2 IP phones have been added. The following sections are new: Provisioning Yealink IP Phones on page  Creating a New CFG File on page ...
  • Page 6 Yealink IP Phones Auto Provisioning Guide released SIP-T27P and SIP-T21(P) E2 IP phones have also been added. Major updates have occurred to the following sections: Editing Common CFG File on page  Editing MAC-Oriented CFG File on page  Customizing Resource Files on page ...

  • Page 7: Introduction

    This guide provides instructions on how to provision Yealink IP phones with the minimum settings required. Yealink IP phones support FTP , TFTP , HTTP , and HTTPS protocols for auto provisioning and are configured by default to use the TFTP protocol.
  • Page 8 Yealink IP Phones Auto Provisioning Guide...

  • Page 9: Getting Started

    MAC-local CFG file on the IP phone. You can ask the distributor or Yealink FAE for Common CFG and MAC-Oriented files. You can also obtain the Common CFG file and MAC-Oriented file online: http://support.yealink.com/documentFront/forwardToDocumentFrontDisplayPage.
  • Page 10 Yealink IP Phones Auto Provisioning Guide For example, the following illustration shows the template files available for SIP-T23G IP phones running firmware version 80. Open the folder you extracted and identify the files you will edit. Before beginning provisioning, you also need the IP phone information. For example, MAC address and the SIP account information of the IP phone.

  • Page 11: 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 12 Yealink IP Phones Auto Provisioning Guide When IP DECT phone is triggered to perform auto provisioning, the base station will requeset to download the configuration files from the provisioning sever. During the auto provisioning process, the base station will download and update configuration files to the phone flash, and then deliver the handset configurations to the registered handset.

  • Page 13: An Instance Of Auto Provision Configuration

    For more information on how to perform the auto provisioning process, refer to Triggering the IP Phone to Perform the Auto Provisioning on page 31. If you are not familiar with auto provisioning process on Yealink IP phones, you can refer An Instance of Auto Provision Configuration on page 8.

  • Page 14: Managing Configuration Files

    Yealink IP Phones Auto Provisioning Guide This section shows an instance of auto provision configuration. Manage configuration files. Add/Edit the desired configuration parameters in the CFG file (e.g., y000000000044.cfg) you want the IP phone to download. For more information on...
  • Page 15 Provisioning Yealink IP Phones 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 on page 17.
  • Page 16 Yealink IP Phones Auto Provisioning Guide Trigger the IP phone to perform the auto provisioning. For more information on how to trigger the phone to perform the auto provisioning, refer Triggering the IP Phone to Perform the Auto Provisioning on page 31.
  • Page 17 Managing Configuration Files Auto provisioning enables Yealink IP phones to update themselves automatically via downloading Common CFG, MAC-Oriented CFG and MAC-local CFG files. Before beginning provisioning, you may need to edit and customize your configuration files. You can edit the template files directly or create a new CFG file as required. Open each configuration file with a text editor such as UltraEdit.
  • Page 18 Yealink IP Phones Auto Provisioning Guide same model, such as language and volume. The following figure shows a portion of the common CFG file: When editing the Common CFG file, learn the following: The line beginning with “#” is considered to be a comment.

  • Page 19: Editing Common Cfg File

    Managing Configuration Files The following figure shows a portion of the MAC-Oriented CFG file: When editing the MAC-Oriented CFG file, learn the following: The line beginning with “#” is considered to be a comment.  The file header “#!version:1.0.0.1” is not a comment and must be placed in the first ...
  • Page 20 Yealink IP Phones Auto Provisioning Guide Copy configuration parameters from the template configuration files and set the valid values for them. Save the changes and close the CFG file. MAC-local CFG file automatically stores configurations modified via web user interface or phone/handset user interface.
  • Page 21 Yealink Configuration Encryption Tool User Guide 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:...
  • Page 22 Firmware X.80.0.XX.rom For example, 44.80.0.60.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_CP860_IP_Phones_Administrator_Guide . For Yealink IP Dect Phones Administrator Guide...

  • Page 23: Configuring A Provisioning Server

    Configuring a Provisioning Server Yealink IP phones support using FTP , TFTP , HTTP and HTTPS protocols to download 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 24 Yealink IP Phones Auto Provisioning Guide An example of configuration on the Windows platform is shown as below: If you have a 3CDaemon application installed on your local system, use it directly. Otherwise, download and install it. To configure a TFTP server: Double click 3CDaemon.exe to start the application.
  • Page 25 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://192.168.1.100/”) is where the IP phone downloads configuration files from.
  • Page 26 Yealink IP Phones Auto Provisioning Guide...

  • Page 27: Zero Touch

    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 28 Yealink IP Phones Auto Provisioning Guide Enter the desired wait time in the Wait Time(1~100s) field. The default value is 5. Click Confirm to accept the change. When Zero Touch is enabled, there will be a configuration wizard during startup: Press the OK soft key.
  • Page 29 After the above configuration is completed, the IP phone will connect to the configured provisioning server and perform the auto provisioning process during startup. 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...
  • Page 30 Yealink IP Phones Auto Provisioning Guide To configure PnP via web user interface: Click on Settings->Auto Provision. Mark the On radio box in the PNP Active field. Click Confirm to accept the change. Any PnP server activated in the network responses with a SIP NOTIFY message,...
  • Page 31 Yealink IP phones support obtaining the provisioning server address by detecting DHCP options during startup. The phone will automatically detect the option 66 and option 43 for obtaining the provisioning server address.
  • Page 32 Copy->Bytes->Printable Text Only. Paste the copied text in your favorite text editor to check the address, for example, tftp://192.168.1.100/. 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 33 URL for different phone models. On the provisioning server, many directories need to be configured for different phone models, each with a unique directory name. 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 ...
  • Page 34 Yealink IP Phones Auto Provisioning Guide The parameter “auto_provision.url_wildcard.pn” is used to configure the directory name the configuration files located. For more information on the parameter, refer to Yealink_SIP-T2_Series_T19(P) E2_T4_Series_CP860 IP phones_Description of Configuration Parameters in CFG Files.xlsx Yealink IP Dect Phones Description of .
  • Page 35 Obtaining the Provisioning Server Address 00156543ec97.cfg file from the provisioning server address “tftp://192.168.1.100/T42G”.
  • Page 36 Yealink IP Phones Auto Provisioning Guide...

  • Page 37: 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  Auto Provision Now  Multi-mode Mixed  SIP NOTIFY Message ...
  • Page 38 Yealink IP Phones Auto Provisioning Guide Mark the On radio box in the Power On field. Click Confirm to accept the change. 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 39 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. The IP phone performs the auto provisioning process at the fixed time every week. You can configure what time of the day and which day of the week to trigger the IP phone to perform the auto provisioning process.
  • Page 40 Yealink IP Phones Auto Provisioning Guide Check one or more checkboxes in the Day of Week field. Click Confirm to accept the change. You can use auto provision now mode to manually trigger the IP phone to perform the auto provisioning process immediately.
  • Page 41 “reboot=true”, the IP phone will reboot immediately. For more information on the parameter “sip.notify_reboot_enable”, refer to Yealink_SIP-T2_Series_T19(P) E2_T4_Series_CP860 IP phones_Description of Configuration Parameters in CFG Files.xlsx Yealink IP Dect Phones . For W56P, refer to Description of Configuration Parameters in CFG Files.xlsx This method requires server support.
  • Page 42 Yealink IP Phones Auto Provisioning Guide The following figure shows the message flow: In addition to the updating modes introduced above, users can trigger IP phones to perform auto provisioning by dialing an activation code. To use this method, the activation code and the provisioning server address need to be pre-configured on the IP phones.
  • Page 43 Triggering the IP Phone to Perform the Auto Provisioning configuration files for different IP phones. To access the specified directory, you need to provide the correct user name and password configured for the directory. Configure unique activation codes and the provisioning server URLs on IP phones. The activation code can be numeric characters, special characters “#”, “*”...
  • Page 44 Yealink IP Phones Auto Provisioning Guide The IP phone downloads the Common CFG file and the corresponding <MAC>.cfg files from the provisioning server to complete phone configurations. The entered user name and password will be saved to the IP phone for next auto provisioning.

  • Page 45: Downloading And Verifying Configurations

    “auto_provision.reboot_force.enable”, refer to Yealink_SIP-T2_Series_T19(P) E2_T4_Series_CP860 IP phones_Description of Configuration Parameters in CFG Files.xlsx Yealink IP Dect Phones Description of . For W56P , refer to Configuration Parameters in CFG Files.xlsx 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.
  • Page 46 Yealink IP Phones Auto Provisioning Guide User Guide Uploading and downloading the <MAC>-local.cfg file You can configure whether the IP phone periodically uploads the <MAC>-local.cfg file to the provisioning server to back up this file, and downloads the <MAC>-local.cfg file from the provisioning server during auto provisioning to override the one stored on the phone.

  • Page 47: Verifying Configurations

    Downloading and Verifying Configurations Example1: Yealink SIP-T23G IP phone downloads configuration files from the TFTP server. Example 2: Yealink SIP-T23G IP phone downloads configuration files from the FTP server.
  • Page 48 Yealink IP Phones Auto Provisioning Guide Example 3: Yealink SIP-T23G IP phone downloads configuration files from the HTTP server.

  • Page 49: 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 50 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, ...

  • Page 51: 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 52 Yealink IP Phones Auto Provisioning Guide...

  • Page 53: Appendix

    Appendix 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. We recommend that you use vsftpd as an FTP server for Linux platform if required.
  • Page 54 Yealink IP Phones Auto Provisioning Guide To configure a wftpd server: Download the compressed file of the wftpd application to your local directory and extract it. 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 55 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 fields respectively, and then click OK. Click Browse to locate the FTP root directory from your local system.
  • Page 56 Yealink IP Phones Auto Provisioning Guide 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. The server URL “ftp://username:password@IP/” (Here “IP” means the IP address of the provisioning server, “username”...
  • Page 57 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: 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 58 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 59 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 60 Check the server URL (e.g., http:// 10.2.11.101:8088/ProvisioningDir) by clicking “Open in browser”. 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. For more information on installing and configuring an Apache HTTPS Server, refer to the network resource.
  • Page 61 Appendix Click the Login button (the login password is blank) to log in. Right click Scopes and select New Scope. Configure the DHCP server name, the DHCP IP range and the subnet mask. Click OK to accept the change.
  • Page 62 Set the custom DHCP option (custom DHCP option tag number ranges from 128 to 254) and select the option type (Yealink supports String and IP Address option types only). Click the OK button to finish setting the option properties. Click...
  • Page 63 Appendix Click Named Policies-->Global, right click the blank area on the right of the main page and then select New Option. Scroll down and double click the custom option 128. 10. Fill the provisioning server address in the input field.
  • Page 64 Yealink IP Phones Auto Provisioning Guide 11. Click the OK button to finish setting a custom option. 12. Click to save the change. You can add the option 66 via DHCP Turbo. The following shows the detailed processes. Click Named Policies-->Global, right click the blank area on the right of the main page and then select New Option.
  • Page 65 Appendix Scroll down and double click MS option 66. 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. You can also add the option 43. The following shows the detailed processes. Click Named Policies-->Global, right click the blank area on the right of the main page and then select New Option.
  • Page 66 Yealink IP Phones Auto Provisioning Guide 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 67 Appendix We are striving to improve our documentation quality and we appreciate your feedback. Email your opinions and comments to DocsFeedback@yealink.com.

This manual is also suitable for:

T19 e2T19p e2Cp860W56pT4 series

Table of Contents