This section describes the changes to this guide for each release and guide version.
Changes for Release V83, Guide Version V83.80
The following sections are new for this version:
l Emergency Alarm
l Hearing Aid Compatibility (HAC) Volume Control Configuration
l Account Registration File Customization
l Account Registration File Upload
l Device Management
l Obtaining the DM IP Address via DHCP Option 43
l Finding the MAC Address and IP Address of the Device
l Web Page Display
Major updates have occurred to the following section:
l Web Statistics
2
Administrator’s Guide for W80 DECT IP Multi-Cell System
3
Table of Contents
Table of Contents
Summary of Changes
Changes for Release V83, Guide Version V83.80
Table of Contents
W80 DECT IP Multi-Cell System Introduction
Components of the DECT IP Multi-Cell System
Deployments of the DECT IP Multi-Cell System
Related Documentations
First Steps
Preparing to Use the Multi-Cell System
Defining the Device Role
LED Indicators on the W80DM/W80B
Finding the MAC Address and IP Address of the Device
Configuring the System via Web User Interface
Accessing Web User Interface
Navigating the Web User Interface
Logging out of the Web User Interface
Initialization Instructions
Initialization Process Overview
Loading the ROM File
Configuring the VLAN
Querying the DHCP (Dynamic Host Configuration Protocol) Server
Contacting the Provisioning Server
Updating Firmware
Downloading the Resource Files
Verifying Startup
2
2
1
13
13
14
14
16
16
16
17
18
19
19
19
20
21
21
21
21
21
21
21
22
22
Setting up the Base Stations
Base Station Pre-registration
Base Station Pre-registration Configuration
Manually Registering Base Stations to the DM
DM IP
DM IP Configuration
Obtaining the DM IP Address via DHCP Option 43
Base Station Settings
Base Station Settings Configuration
Managing the Connected Base Stations
Base Station Synchronization
Synchronization Planning
Managing the Handsets
Registering Handsets via Web User Interface
23
23
23
24
24
24
25
26
26
28
29
29
31
31
1
Administrator’s Guide for W80 DECT IP Multi-Cell System
IPUI Registration
Obtaining the IPUI Code of the Handset
Notes on Configuring IPUI
IPUI Code Configuration
Handset Registration Center
Registering Handsets Time-Controlled
Registering Handsets at Once
Manually Closing the Registration
De-registering a Handset
Account Settings
Account Registration
Supported Accounts
SIP Server Template Configuration
Accounts Registration Configuration
Registration Settings Configuration
Account Registration File Customization
Account Registration File Elements
Customizing Account Registration File
Account Registration File Upload
Outbound Proxy in Dialog
Outbound Proxy in Dialog Configuration
Server Redundancy
Behaviors When Working Server Connection Fails
Registration Method of the Failover/Fallback Mode
Fallback Server Redundancy Configuration
Failover Server Redundancy Configuration
SIP Server Name Resolution
SIP Server Name Resolution Configuration
Static DNS Cache
Behave with a Configured DNS Server
Static DNS Cache Configuration
Number of Active Handsets Per Base
Administrator’s Guide for W80 DECT IP Multi-Cell System
Call Log Display
Call Log Configuration
Call Features
Dial Plan
Basic Regular Expression Syntax for Four Patterns
Replace Rule File Customization
Replace Rule File Attributes
Customizing the Replace Rule File
Dial Now File Customization
Dial Now File Attributes
Customizing the Dial Now File
Replace Rule Configuration
Dial Now Configuration
Area Code Configuration
Block Out Configuration
Example: Adding Replace Rules Using a Replace Rule File
Difference between a remote phone book and a local phone book
Audio Issues
Increasing or decreasing the volume
Get poor sound quality during a call
There is no sound when the other party picks up the call
Play the local ringback tone instead of media when placing a long-distance number without plus 0
Firmware and Upgrading Issues
Fail to upgrade the phone firmware
Verifying the firmware version
The IP phone does not update the configurations
System Log Issues
Fail to export the system log to a provisioning server (FTP/TFTP server)
Fail to export the system log to a syslog server
Password Issues
Restore the administrator password
The web screen displays "Default password is in use. Please change!"
Power and Startup Issues
Both PoE cable and power adapter is connected to the phone
The power LED indicator has no lights
Other Issues
The difference among user name, register name, and display name
On code and off code
The difference between RFC 2543 Hold enabled and disabled
How does the DM configuration changes take effect when the handset is in the call?
Base Issue
Why doesn’t the power indicator on the base station light up?
Why doesn’t the network indicator on the base station slowly flash?
Handset Issues
How to check which area the handset is used for?
Register Issue
Why cannot the handset be registered to the base station?
Display Issue
Why does the handset prompt the message “Not Subscribed”?
Why does the handset prompt the message “Not in Range” or “Out Of Range”?
Why does the handset prompt the message “Network unavailable”?
Why does the handset display “No Service”?
Upgrade Issue
Why doesn’t the DECT IP phone upgrade firmware successfully?
Administrator’s Guide for W80 DECT IP Multi-Cell System
RFC and Internet Draft Support
W80DM Menu Structure Overview
W80B Menu Structure Overview
253
256
257
12
W80 DECT IP Multi-Cell System Introduction
W80 DECT IP Multi-Cell System Introduction
The DECT IP multi-cell system is used for connecting multiple DECT base stations to a VoIP PBX. It supports the
roaming & handover feature, and provides a wider DECT signal coverage, and more handsets and simultaneous
calls than the single-cell.
Topics
Components of the DECT IP Multi-Cell System
Deployments of the DECT IP Multi-Cell System
Related Documentations
Components of the DECT IP Multi-Cell System
The following illustration shows the components of the DECT IP multi-cell system and the way the system is embedded in the IP phone environment:
ComponentsDescription
W80DM DECT Manager
(sometimes just
referred to as DM)
W80B Base Stations
Management unit for a group of base stations. At least one DECT manager must be used
for each installation.
• Manages base stations synchronization within the clusters.
• Enables the account registration and centrally stores the account configuration.
• Enables centralized configuration and deployment.
Up to 30 base stations can be supported by one DECT manager.
• Provide cell site DECT features.
• Provide media processing from handsets directly towards PBX.
• Provide connection channels for the handsets, the number depends on various factors
such as the approved bandwidth.
13
Administrator’s Guide for W80 DECT IP Multi-Cell System
ComponentsDescription
Up to 100 handsets can be supported by one DECT manager. Up to 100 DECT calls can
Handsets
(Mobile Devices)
PBX
be made simultaneously for VoIP call.
Subscribers can accept or initiate calls in all base stations with their handsets (Roaming),
and can also switch handsets DECT connection between the base stations during a call
(Handover). A handover is only possible if base stations are synchronized.
IP PBX or Provider with VoIP (SIP) connections.
• Establishes the connection to a public phone network.
• Enables the centralized management of phone connections, remote phone book, and
voice mail.
Deployments of the DECT IP Multi-Cell System
The DECT IP multi-cell system can be deployed in the multi-story office building, supermarket, store, warehouse,
hotel, and so on.
DeviceDescription
W80DM DECT ManagerAt least one
W80B Base StationsUp to 30 per DECT manager
Handsets
(Mobile Devices)
Up to 100 per DECT manager
Related Documentations
The following related documents are available:
14
W80 DECT IP Multi-Cell System Introduction
l Quick Start Guide, describes how to install the W80DM/W80B and obtain the device's IP address.
l User Guide, describes how to configure and use the basic and advanced features available in the DECT IP
multi-cell system.
l Deployment Guide, explains the necessary preparatory work for the installation and describes how to carry out
measurements in order to find the best positions for your base stations.
For support or service, please contact your Yealink reseller or go to Yealink Technical Support online: http://sup-
port.yealink.com/.
Read the Yealink Products Regulatory Notices guide for all regulatory and safety guidance.
15
First Steps
First Steps
This chapter provides the information you need to prepare to configure your multi-cell system at the DECT manager.
Topics
Preparing to Use the Multi-Cell System
Defining the Device Role
Configuring the System via Web User Interface
Preparing to Use the Multi-Cell System
Defining the Device Role
The W80DM is shipped as a DECT Manager (DM) and the W80B is shipped as a base station.
The W80DM/W80B device supports the following roles:
l
Base: The device works as a base station. You can configure the IP address of the DM via the web user interface or RPS.
16
Administrator’s Guide for W80 DECT IP Multi-Cell System
l
DM: The device works as a DECT manager.
If you want to change the device role of the W80DM/W80B, you can upgrade the firmware.
Related Topics
Firmware Upgrade
LED Indicators on the W80DM/W80B
LAN LED: indicates the LAN connection status.
LAN LEDDescription
GreenSuccessful connection to LAN
Slowly flashing green (1s)No connection to LAN or no IP address available/ assigned
OffPower off
ROLE LED: indicates the device role.
ROLE LEDDescription
Orange
Green
Slowly flashing orange (1s)Active calls in the system
DECT LED: indicates the connection status to the DM.
DECT LEDDescription
Green
Off
Slowly flashing green (1s)Active calls on the base station
LED indicators (some common status)
LAN LEDROLE LEDDECT LEDDescription
Slowly flashing
green (1s)
Slowly flashing
green (1s)
GreenOff
OrangeOff
Device role: DM.
Device role: Base.
Successful connection to DM, status: Active and synced
Successful connection to DM, status: Active, Deactive, or Offline
Device role: Base, no connection to LAN
Device role: DM, no connection to LAN
GreenGreenGreen
GreenGreenOff
GreenGreen
17
Slowly flashing
green(1s)
Synchronized, status: Active and synced
Not synchronized, status: Active, Deactive, or Offline
Successful connection to DM, active calls on the base
station
LAN LEDROLE LEDDECT LEDDescription
GreenOrangeGreenFirst-level base station connected
GreenOrangeOffNo connected base on the DM
First Steps
Green
Fast flashing green
(0.5s)
Slowly flashing
orange (1s)
Fast flashing
green(0.5s)
GreenActive calls in the system
Fast flashing green
(0.5s)
Firmware update in progress
Finding the MAC Address and IP Address of the Device
You can find the MAC address and IP address of all Yealink DECT devices in the LAN through a PC scanning tool Yealink Discovery Tool. Ask the distributor or Yealink FAE for the tool.
Procedure
1.
Run the scanning tool.
2.
Enter the IP search rules.
Follow the following rules:
The first two digits: match the first two digits of your IP network segment.
The last two digits: indicate the search rule for the last two digits of the IP network segment. The dash “-” can be
used to match a range of digits. The comma “,” can be used as a separator.
Example:
a. Enter 10.81.6.1-254 to search all network segments with 10.81.6.xx;
b. Enter 10.81.1,6.1-254 to search all network segments with 10.81.1.xx and 10.81.6.xx.
3. Click Scan.
18
Administrator’s Guide for W80 DECT IP Multi-Cell System
Configuring the System via Web User Interface
System settings are made via the web user interface of the W80DM and cannot be changed using the handsets.
This applies in particular for:
l De-registering the handset at the phone system.
l Renaming the handset.
l All settings for the VoIP account used by a handset for calls.
l Rebooting or restarting the base station.
l Configuration of the remote phone book.
Handset-specific settings are changed on your handset individually. For example, language, wallpaper, ring tones,
and volume.
Topics
Accessing Web User Interface
Navigating the Web User Interface
Logging out of the Web User Interface
Accessing Web User Interface
You can configure and manage features of the multi-cell system via the web user interface.
When configuring via the web user interface, you require a user name and password for access. For a user - who
has only limited access to some settings, the default user name and password are “user” (case-sensitive). For an
administrator - who has unlimited access to call features of the web user interface, the default user name and password are “admin” (case-sensitive).
Procedure
1.
Find the current IP address of the device.
2.
Open a web browser on your computer, enter the IP address into the address bar (for example,
"https://192.168.0.10" or "192.168.0.10"), and then press the Enter.
3. Enter the user name and password on the login page and click Login.
Related Topics
Accessing Web User Interface
Navigating the Web User Interface
When you log into the web user interface successfully, the device status is displayed on the first page of the web
user interface.
The following figure is an example when you navigate to Settings > Preference:
19
First Steps
Logging out of the Web User Interface
By default, the device will automatically log out of the web user interface after five minutes of inactivity. You can also
manually log out of the web user interface.
Procedure
1. Click Logout at the top right of each web page.
20
Initialization Instructions
Initialization Instructions
This chapter provides basic initialization instructions of devices.
Topics
Initialization Process Overview
Verifying Startup
Initialization Process Overview
The initialization process of the device is responsible for network connectivity and operation of the device in your
local network. Once you connect your device to the network and to an electrical supply, the device begins its initialization process.
Topics
Loading the ROM File
Configuring the VLAN
Querying the DHCP (Dynamic Host Configuration Protocol) Server
Contacting the Provisioning Server
Updating Firmware
Downloading the Resource Files
Loading the ROM File
The ROM file resides in the flash memory of the device. The device comes from the factory with a ROM file preloaded. During initialization, the device runs a bootstrap loader that loads and executes the ROM file.
Configuring the VLAN
If you connect the device to a switch, the switch notifies the device of the VLAN information defined on the switch (if
using LLDP or CDP). The device can then proceed with the DHCP request for its network settings (if using DHCP).
Querying the DHCP (Dynamic Host Configuration Protocol) Server
The device is capable of querying a DHCP server.
After establishing network connectivity, the device can obtain the following network parameters from the DHCP
server during initialization:
l IP Address
l Subnet Mask
l Default Gateway
l Primary DNS (Domain Name Server)
l Secondary DNS
By default, the devices obtain these parameters from a DHCPv4. You can configure network parameters of the
device manually if any of them are not supplied by the DHCP server.
Contacting the Provisioning Server
If you configure the device to obtain configurations from the provisioning server, it will be connected to the provisioning server, and then download the boot file and configuration file(s) during startup. The device will be able to
resolve and update configurations written in the configuration file(s). If the device does not obtain configurations
from the provisioning server, it will use the configurations stored in the flash memory.
Updating Firmware
If you define the access URL of firmware in the configuration file, the device will download the firmware from the provisioning server. If the MD5 value of the downloaded firmware file differs from that stored in the flash memory, the
21
Administrator’s Guide for W80 DECT IP Multi-Cell System
device will perform a firmware update.
You can manually upgrade the firmware if the device does not download the firmware from the provisioning server.
Downloading the Resource Files
In addition to the configuration file(s), the device may require resource files before it provides service. These
resource files are optional, but if you deploy some particular features, these files are required.
Verifying Startup
After connected to the power and available network, the LAN LED indicator glows green. As a base station, the
ROLE LED indicator glows green; as a DECT manager, the ROLE LED indicator glows orange.
22
Setting up the Base Stations
Setting up the Base Stations
The W80B device must be registered to the DM for normal use.
In the multicast network, the DM automatically recognizes the base stations within the network. In the non-multicast
network, the DM recognizes the base stations only when the IP address of DM is configured to the base stations via
the web user interface, RPS, or DHCP option.
After recognized, the base stations need to be registered, activated, and synchronized.
Topics
Base Station Pre-registration
DM IP
Base Station Settings
Base Station Synchronization
Base Station Pre-registration
In the multicast network, you can pre-register all base stations at the DM. After that, the base stations will be automatically registered at the DM once being detected in the network.
If the detected base station has not been pre-registered at the DM, you need to manually register the base stations
via the web user interface.
Topics
Base Station Pre-registration Configuration
Manually Registering Base Stations to the DM
Base Station Pre-registration Configuration
The following table lists the parameters you can use to pre-register the base station.
Parameter
Description
Permitted
Values
Default
Parameter
Description
Permitted
Values
Default
Parameter
station.allowed.X.mac
It sets the MAC address of the pre-registration base station.
String within 32 characters
Blank
station.allowed.X.name
It sets the name of the pre-registration base station.
String within 32 characters
Blank
station.allowed.X.sync.cluster
[1]
[1]
[1]
<y0000000000xx>.cfg
<y0000000000xx>.cfg
<y0000000000xx>.cfg
Description
Permitted
Values
It sets the sync cluster of the pre-registration base station.
Integer from 1 to 10
23
Administrator’s Guide for W80 DECT IP Multi-Cell System
Default
Parameter
Description
Permitted
Values
Default
[1]
X is the pre-registration ID. X=1-30.
Blank
station.allowed.X.sync.level
It sets the sync level of the pre-registration base station.
Integer from 1 to 10
Blank
[1]
<y0000000000xx>.cfg
Manually Registering Base Stations to the DM
You are allowed to manually register the base stations to the DM in the base station standby list.
Procedure
1.
Access the web user interface of the device.
2. Go to Base Station > Base Station Registration.
3.
Clicknext to the base station.
4. Complete the corresponding information of the base station, and click OK.
The base station is successfully registered to the DM.
Related Topic
Accessing Web User Interface
DM IP
In the non-multicast network, the DM can detect and connect the base station only when you have configured the IP
address of the DM on the W80B base station.
The W80B base station can also dynamically receive the DM IP address via DHCP option 43 and then automatically connect to the DM.
Note: You can configure the IP address of the DM for all base stations using RPS.
Topics
DM IP Configuration
Obtaining the DM IP Address via DHCP Option 43
DM IP Configuration
The following table lists the parameter you can use to configure the DM IP.
You can configure the value of option 43 on the DHCP server as the DM IP address. The base reads the value of
option 43 and the obtained IP address is automatically filled in the "DM IP" configuration.
Before you begin
The base obtains IP address through DHCP instead of static IP.
Procedure
1.
Configure option 43 on the DHCP server.
25
Administrator’s Guide for W80 DECT IP Multi-Cell System
The valid format of the configuration value: W80DM_DMMAC_DMIP, for example: W80DM_001565FEFE3E_
10.82.9.231.
Note: If you need to configure the option 43 for both DM IP and provisioning server address, the valid format is
http://192.168.10.25/W80DM_001565FEFE3E_10.82.9.231_W80DM or http://192.168.10.25/W80DM_
001565FEFE3E_10.82.9. 231_W80DM.cfg, that is, the directory name of the configuration file or the file name is
"W80DM_001565FEFE3E_10.82.9.231_W80DM".
2.
Connect the base to the network in the DHCP environment.
While obtaining the IP address, base can read the DM IP address in option 43 and automatically fill it into "DM
IP" configuration.
Base Station Settings
You can modify all settings of the registered base stations at the DECT manager.
Topics
Base Station Settings Configuration
Managing the Connected Base Stations
Base Station Settings Configuration
The following table lists the parameters you can use to modify the base station settings.
Parameter
Description
Permitted
Values
Default
26
station.X.name
It sets the name of the base station.
String within 32 characters
Base station X
[1]
<y0000000000xx>.cfg
Setting up the Base Stations
Web UI
Parameter
Description
Permitted
Values
Default
Web UI
Parameter
Description
Permitted
Values
Default
Web UI
Parameter
Description
Base Station > Base Station Settings > Edit > Name / Location
station.X.sync.cluster
[1]
It sets the sync cluster to which the base station belongs.
Integer from 1 to 10
1
Base Station > Base Station Settings > Edit > Cluster
station.X.sync.level
[1]
It sets the sync level of the base station.
Integer from 1 to 10
1
Base Station > Base Station Settings > Edit > Sync Level
station.X.sync.type
[1]
It sets the sync type of the base station.
<y0000000000xx>.cfg
<y0000000000xx>.cfg
<y0000000000xx>.cfg
Permitted
Values
Default
Parameter
Description
Permitted
Values
Default
Web UI
Parameter
Description
Permitted
Values
Default
Web UI
Parameter
Description
0-Disabled
2-Over the air synchronization
2
station.X.active
[1]
<y0000000000xx>.cfg
It triggers the active base station feature to on or off.
0-OFF
1-ON
1
Base Station > Base Station Settings > Edit > Active Base Station
static.station.X.network.type
[1]
<y0000000000xx>.cfg
It configures the type of network.
0-DHCP
2-Static IP
0
Base Station > Base Station Settings > Edit > IP Address Type
static.station.X.network.ip
[1]
<y0000000000xx>.cfg
It configures the IPv4 address.
Note: It works only if "static.station.X.network.type" is set to 2 (Static IP).
27
Administrator’s Guide for W80 DECT IP Multi-Cell System
Permitted
Values
Default
Web UI
Parameter
Description
Permitted
Values
Default
Web UI
Parameter
Description
Permitted
Values
Default
Web UI
String within 64 characters
Blank
Base Station > Base Station Settings > Edit > IP Address
static.station.X.network.mask
It configures the IPv4 subnet mask.
Note: It works only if "static.station.X.network.type" is set to 2 (Static IP).
String within 64 characters
Blank
Base Station > Base Station Settings > Edit > Subnet Mask
static.station.X.network.gateway
It configures the IPv4 default gateway.
Note: It works only if "static.station.X.network.type" is set to 2 (Static IP).
String within 64 characters
Blank
Base Station > Base Station Settings > Edit > Default Gateway
[1]
[1]
<y0000000000xx>.cfg
<y0000000000xx>.cfg
[1]
X is the registration location ID. X=1-30.
Managing the Connected Base Stations
You can edit the data for a base station or manage a base station that is already registered to the DM.
You can customize the following information of the connected base stations:
ItemDescription
Base Station
RPN
Cluster
Sync Level
Status
Active
Name of the base station. When added to the list, Base Station X (X ranges from 1 to 30) is used
as the name.
Radio Fixed Part Number. The base station identity allocated by the DECT system.
Note: This cannot be edited.
Number of the cluster to which the base station belongs.
Sync level within the sync hierarchy.
Synchronization status of the base station.
• Offline: not available.
• Deactive: available but not activated.
• Active: activated but not synchronized.
• Active and synced: activated and synchronized.
Activates or deactivates the base station.
Note: A base station must be active to manage calls of the connected handsets. If it is deactivated, it will no longer connect handsets but it still stays in the list of connected base stations.
28
Setting up the Base Stations
Procedure
1.
You can do the following:
l
Select ON or OFF to activate or deactivate the base station.
Note: Please ensure that the base station you want to deactivate is not with sync level 1. Check your sync set-
tings before deactivating the base station. Otherwise, your system may no longer work properly.
l Click, and enter a descriptive name, assign the cluster, and set the sync level for the base station.
l
Clickand select OK to reboot the base station.
All existing connections managed by the base station are terminated.
l
Clickand select OK to delete the base station.
l
Click Reboot All to reboot all connected base stations.
Base Station Synchronization
Base station synchronization is the prerequisite for the functioning of the multi-cell system, inter-cell handover, and
overload balancing. Overload balancing means that a handset can roam to another available base when the current base is fully loaded and cannot accept further handset connections.
Base stations can be synchronized "over the air", meaning that they are synchronized via DECT.
Note: Synchronization always refers to a cluster. In case you set up several clusters that are not synchronized with one
another, these will be no possibility of a handover or overload balancing between them.
Topic
Synchronization Planning
Synchronization Planning
Base stations in the multi-cell system must synchronize with one another to ensure a smooth transition of the handsets from cell to cell (handover). No handover and no overload balancing are possible between cells that are not
synchronized.
The synchronization within a cluster takes place in a master/slave procedure. It means that one base station (sync
master) defines the synchronization cycle for one or more additional base stations (sync slaves). A base station can
synchronize with each base station on a higher sync level. The sync level concept allows base stations to automatically select the best suitable base station (having a lower sync level number) to receive synchronization signal
from.
During configuration, assign one sync level to each base. Sync level 1 is the highest level, which is the level of the
sync master and appears only once in each cluster. A base station always synchronizes itself with a base station
that has a better sync level. If it sees several base stations with a better sync level, it synchronizes itself with the
base station that provides the best signal quality. If it does not see any base station with a higher sync level, it cannot synchronize.
To ensure the synchronization, you should plan the level 1 base station in the center as much as possible, and
place the next sync level's base stations around the center.
The following is an example of a synchronization scenario:
29
Administrator’s Guide for W80 DECT IP Multi-Cell System
30
Managing the Handsets
Managing the Handsets
You can use the web user interface to register all handsets or delete them from the multi-cell system.
Topics
Registering Handsets via Web User Interface
IPUI Registration
Handset Registration Center
De-registering a Handset
Registering Handsets via Web User Interface
Procedure
1.
Access the web user interface of the DM.
2. Go to Handset & Account > Handset Registration.
3. Click Add Handset.
4. Click Start Register Handset to set the DM to the registration mode.
5.
On the handset, do one of the following:
l
Press the Reg soft key on the handset to register quickly.
l
Press OK > Register Handset and then select the desired base to register the handset.
l
Press OK > Settings > Registration > Register Handset and then select the desired base to register the
handset.
On the DD phone, navigate to Menu > Settings >Registration > Register Handset.
After registration, the handset prompts “Handset Subscribed”.
Note: The default base PIN is 0000.
Related Topic
Accessing Web User Interface
IPUI Registration
You can register handsets in batches by the IPUI code.
Topics
Obtaining the IPUI Code of the Handset
Notes on Configuring IPUI
IPUI Code Configuration
Obtaining the IPUI Code of the Handset
IPUI is a random code that includes 10 characters mixed with numbers and letters.
There are three ways to obtain the IPUI code:
l
Handset UI: on the W56H/W53H/W59R handset, go to OK > Status > Handset > IPUI Code; on the CP930W, go
to Menu > Status > Phone Status > IPUI Code; on the DD phone, go to Menu > Status > Dongle Status > IPUICode.
l
Giftbox: Obtain it from the sticker label on the handset's giftbox.
l
Shipping system: Check it in the shipping system.
31
Administrator’s Guide for W80 DECT IP Multi-Cell System
Notes on Configuring IPUI
A few notes you should know when registering handsets using IPUI code:
l The registration status will not be disabled automatically if you enable it by "handset.X.reg.enable".
l If you duplicate the IPUI code during the configuration, only the IPUI with the smaller handset number takes
effect.
l If you configure another IPUI code for another handset but the handset number is the same as an existing one,
the existing IPUI will be overwritten.
l If you configure the IPUI code for the registered handset, the handset will be unregistered.
l When the handset is deleted, the handset and its IPUI code will be deleted at the same time.
l You cannot directly modify the IPUI code via the web user interface. The IPUI code can only be modified via auto
provisioning, or re-entered after deleted via the web user interface.
IPUI Code Configuration
The following table lists the parameters you can use to import the IPUI code.
Parameter
handset.X.reg.enable
It enables or disables the registration status for handset X.
Description
Note: The value of X corresponds to that of "account.X.user_name". When the IPUI code is invalid or
not configured, the registration status cannot be enabled by this parameter.
The registration center allows you to register groups of handsets in one registration process. During this time, the
system will automatically register the handset and assign the corresponding account according to the IPUI code.
You can find the following information from the registration center:
l
Total Handsets: Shows how many handsets are registered in the current system.
l
Registered Handsets: Shows how many handsets are registered through the registration center this time
l
Current Time: Shows the current system time. It is updated in real time.
Topics
32
Managing the Handsets
Registering Handsets Time-Controlled
Registering Handsets at Once
Manually Closing the Registration
Registering Handsets Time-Controlled
A registration process is started automatically according to the time you set.
Procedure
1.
Access the web user interface of the DM.
2. Go to Handset & Account > Registration Center.
3. In the Registration Start Time field, enter the time when the next registration process should be started.
Valid value: at least 1 minute later than the current time but no more than 24 days.
3. In the Registration Duration field, enter the duration that the DM should stay in registration mode.
Default: 3 minutes.
4. Click Confirm.
Related Topic
Manually Closing the Registration
Registering Handsets at Once
Procedure
1.
Access the web user interface of the DM.
2. Go to Handset & Account > Registration Center.
3. In the Registration Duration field, enter the duration that the DM should stay in registration mode.
Default: 3 minutes.
4. Click Start Now.
The DM starts registration at once.
Related Topic
Manually Closing the Registration
Manually Closing the Registration
When the time is up, the system will automatically disable the registration status. You can also manually close the
registration.
Procedure
1. Click Close.
The screen prompts you whether to close the registration.
2. Click OK.
33
Administrator’s Guide for W80 DECT IP Multi-Cell System
Related Topic
Registering Handsets Time-Controlled
De-registering a Handset
You can only delete a handset from the multi-cell system via the web user interface.
Procedure
1.
Access the web user interface of the DM.
2. Go to Handset & Account > Handset Registration.
3.
Click.
4. Click OK to delete a handset.
All registration information for the handset is deleted.
34
Account Settings
Account Settings
This chapter shows you how to register accounts and configure account settings on Yealink devices.
Topics
Account Registration
Outbound Proxy in Dialog
Server Redundancy
SIP Server Name Resolution
Static DNS Cache
Number of Active Handsets Per Base
Account Registration
Any handset must get assigned an individual SIP account. After registering the handset to the system, the handset
can be assigned an account for receiving and sending VoIP connection.
The number of registered accounts must meet the following:
Registered Accounts on W80DMAssigned Account per Handset
100Only one
SIP Server Template Configuration
You can use up to ten different SIP servers in the system. You can pre-configure up to 10 SIP server templates for
choose when registering SIP accounts.
The following table lists the parameters you can use to configure the SIP server template.
Parameter
Description
Permitted
Values
Default
Web UI
Parameter
template.X.name
It sets the name of the SIP server template.
String within 64 characters
Blank
Handset & Account > SIP Server Settings > Edit > Template Name
template.X.sip_server.Y.address
[1]
[1][2]
<y0000000000xx>.cfg
<y0000000000xx>.cfg
Description
Permitted
It configures the IP address or domain name of the SIP server Y in which the account is registered.
String within 64 characters
35
Administrator’s Guide for W80 DECT IP Multi-Cell System
Values
Default
Web UI
Parameter
Description
Permitted
Values
Default
Web UI
Parameter
Description
Permitted
Values
Default
Web UI
Parameter
Blank
Handset & Account > SIP Server Settings > Edit > SIP Server Y
template.X.sip_server.Y.port
[1][2]
[2]
> Server Host
<y0000000000xx>.cfg
It configures the port of SIP server Y.
Integer from 0 to 65535
5060
Handset & Account > SIP Server Settings > Edit > SIP Server Y
template.X.sip_server.Y.transport_type
[1][2]
[2]
> Port
<y0000000000xx>.cfg
It configures the type of transport protocol.
0-UDP
1-TCP
2-TLS
3-DNS-NAPTR, if no server port is given, the device performs the DNS NAPTR and SRV queries for
the service type and port.
0
Handset & Account > SIP Server Settings > Edit > SIP Server Y
template.X.sip_server.Y.expires
[1][2]
[2]
> Transport
<y0000000000xx>.cfg
Description
Permitted
Values
Default
Web UI
Parameter
Description
Permitted
Values
Default
Web UI
Parameter
Description
It configures the registration expiration time (in seconds) of SIP server Y.
Integer from 30 to 2147483647
3600
Handset & Account > SIP Server Settings > Edit > SIP Server Y
template.X.sip_server.Y.retry_counts
[1][2]
[2]
> Server Expires
<y0000000000xx>.cfg
It configures the retry times for the device to resend requests when the SIP server Y is unavailable or
there is no response from the SIP server Y.
The handset moves to the next available server after three failed attempts.
Integer from 0 to 20
3
Handset & Account > SIP Server Settings > Edit > SIP Server Y
template.X.outbound.enable
[1]
[2]
> Server Retry Counts
<y0000000000xx>.cfg
It enables or disables the device to send requests to the outbound proxy server.
36
Account Settings
Permitted
Values
Default
Web UI
Parameter
Description
Permitted
Values
Default
Web UI
Parameter
Description
Permitted
Values
Default
Web UI
Parameter
0-Disabled
1-Enabled
0
Handset & Account > SIP Server Settings > Edit > Enable Outbound Proxy Server
template.X.outbound.Y.address
[1][2]
<y0000000000xx>.cfg
It configures the IP address or domain name of the outbound proxy server Y.
Note: It works only if “template.X.outbound.enable” is set to 1 (Enabled).
String within 64 characters
Blank
Base Station > SIP Server Settings > Edit > Outbound Proxy Server Y
template.X.outbound.Y.port
[1][2]
<y0000000000xx>.cfg
[2]
It configures the port of the outbound proxy server Y.
Note: It works only if “template.X.outbound.enable” is set to 1 (Enabled).
Integer from 0 to 65535
5060
Handset & Account > SIP Server Settings > Edit > Outbound Proxy Server Y
template.X.outbound.fallback_interval
[1]
<y0000000000xx>.cfg
[2]
> Port
Description
Permitted
Values
Default
Web UI
[1]
X is the template ID. X=1-10.
[2]
Y is the server ID. Y=1-2.
It configures the time interval (in seconds) for the device to detect whether the working outbound proxy
server is available by sending the registration request after the fallback server takes over call control.
It configures the base time to wait (in seconds) for the phone to retry to re-register after the account
registration fails.
Description
Note: It is used in conjunction with the parameter "account.X.reg_failed_retry_max_time" to determine
how long to wait. The algorithm is defined in RFC 5626. We recommend that you set this value to an
integer between 10 to 120 if needed. If the values of this parameter and the parameter "account.X.reg_failed_retry_max_time" are set to 0, the interval configured by "account.X.reg_fail_retry_interval" will be used.
Permitted
Values
Default
Parameter
Integer greater than or equal to 0
0
account.X.reg_failed_retry_max_time
It configures the maximum time to wait (in seconds) for the phone to retry to re-register after the
account registration fails.
Description
Note: It is used in conjunction with the parameter "account.X.reg_failed_retry_min_time" to determine
how long to wait. The algorithm is defined in RFC 5626. We recommend that you set this value to an
integer between 60 to 1800 if needed. If the values of this parameter and the parameter "account.X.reg_failed_retry_min_time" are set to 0, the interval configured by "account.X.reg_fail_retry_interval" will be used.
Permitted
Values
Default
[1]
X is the account ID. X=1-100.
[2]
Y is the server ID. Y=1-2.
Integer greater than or equal to 0
60
[1]
<MAC>.cfg
Registration Settings Configuration
The following table lists the parameters you can use to change the registration settings.
Parameter
Description
Permitted
Values
Default
Web UI
Parameter
Description
Permitted
account.X.enable_user_equal_phone
It enables or disables the phone to add “user=phone” to the SIP header of the INVITE message.
It enables or disables the phone to disable the account whose username is empty.
0-Disabled
1-Enabled
0
account.X.register_expires_overlap
It configures the renewal time (in seconds) away from the registration lease.
Positive integer and -1
-1
account.X.subscribe_expires_overlap
It configures the renewal time (in seconds) away from the subscription lease.
Positive integer and -1
-1
[1]
[1]
<MAC>.cfg
<MAC>.cfg
[2]
If you change this parameter, the phone will reboot to make the change take effect.
Account Registration File Customization
You can ask the distributor or Yealink FAE for the account registration template. You can also obtain the template
online: http://support.yealink.com/documentFront/forwardToDocumentFrontDisplayPage.
Topics
Account Registration File Elements
Customizing Account Registration File
Account Registration File Elements
The following table lists the elements and attributes you can use to assign accounts for handsets in the account
registration file. We recommend that you do not edit these attributes.
AttributesDescription
account
ipuiSpecify the IPUI of the handset to which you want to assign the account.
reg.enableEnable or disable the registration status for the handset.
auth_nameSpecify the register name of the account.
user_nameSpecify the user name of the account.
Specify the account ID (1-100).
This is required. If not filled, the line will not take effect.
passwordSpecify the password of the account.
41
Administrator’s Guide for W80 DECT IP Multi-Cell System
AttributesDescription
display_nameSpecify the display name of the account.
labelSpecify the label of the account.
enableSpecify the activation status of the account.
sip_server.templateSpecify the SIP server template.
Customizing Account Registration File
1.
Open the account registration file.
2.
Specify the account information.
For example:
3.
Save the changes.
Account Registration File Upload
You can upload account registration file to register accounts in batches and associate the account with the handset
IPUI.
The following table lists the parameter you can use to upload the account registration file.
Parameter
Description
Permitted
Values
Default
Web UI
ipui_account.data.url<y0000000000xx>.cfg
It configures the access URL of the custom account registration file (*.csv).
String within 512 characters
Blank
Handset & Account > Handset Registration > Import
Outbound Proxy in Dialog
An outbound proxy server can receive all initiating request messages and route them to the designated destination.
If the device is configured to use an outbound proxy server within a dialog, all SIP request messages from the
device will be sent to the outbound proxy server as a mandatory requirement.
Note: To use this feature, make sure the outbound server has been correctly configured on the device. For more information
on how to configure the outbound server, refer to Server Redundancy.
Topic
Outbound Proxy in Dialog Configuration
Outbound Proxy in Dialog Configuration
The following table lists the parameter you can use to configure the outbound proxy in dialog.
Parameter
Description
42
sip.use_out_bound_in_dialog<y0000000000xx>.cfg
It enables or disables the phone to send all SIP requests to the outbound proxy server mandatorily in
a dialog.
Note: It works only if "template.X.outbound.enable" is set to 1 (Enabled).
Permitted
Values
Default
Account Settings
0-Disabled, only the new SIP request messages from the phone will be sent to the outbound proxy
server in a dialog.
1-Enabled, all the SIP request messages from the phone will be sent to the outbound proxy server in
a dialog.
0
Web UI
Features > General Information > Use Outbound Proxy In Dialog
Server Redundancy
Server redundancy is often required in VoIP deployments to ensure continuity of phone service, for example, take
the call server offline for maintenance, the server fails, or the connection between the device and the server fails.
Two types of redundancy are possible. In some cases, a combination of the two may be deployed:
l
Failover: In this mode, the full phone system functionality is preserved by having a second equivalent capability
call server take over from the one that has gone down/off-line. This mode of operation should be done using the
DNS mechanism from the primary to the secondary server. Therefore, if you want to use this mode, the server
must be configured with a domain name.
l
Fallback: In this mode, a second less featured call server with SIP capability takes over call control to provide
the basic calling capability, but without some advanced features (for example, shared line and MWI) offered by
the working server. The phones support configuration of two servers per SIP registration for the fallback purpose.
Note: For concurrent registration mode, it has a certain limitation when using some advanced features, and for successive
registration mode, the phone service may have a brief interrupt while the server fails. So we recommend that you use the failover mode for server redundancy because this mode can ensure the continuity of the phone service and you can use all the
call features while the server fails.
Phone Configuration for Redundancy Implementation
To assist in explaining the redundancy behavior, an illustrative example of how an IP phone may be configured is
shown below. In the example, server redundancy for fallback and failover purposes is deployed. Two separate servers (a working server and a fallback server) are configured for per line registration.
43
Administrator’s Guide for W80 DECT IP Multi-Cell System
l
Working Server: Server 1 is configured with the domain name of the working server. For example yealink.p-
bx.com. DNS mechanism is used such that the working server is resolved to multiple servers with different IP
addresses for failover purpose. The working server is deployed in redundant pairs, designated as primary and
secondary servers. The primary server (for example, 192.168.1.13) has the highest priority server in a cluster of
servers resolved by the DNS server. The secondary server (for example, 192.168.1.14) backs up a primary
server when the primary server fails and offers the same functionality as the primary server.
l
Fallback Server: Server 2 is configured with the IP address of the fallback server. For example 192.168.1.15. A
fallback server offers less functionality than the working server.
Yealink devices support Failover and Fallback server redundancy types. In some cases, you can deploy a combination of the two server redundancy types.
Topics
Behaviors When Working Server Connection Fails
Registration Method of the Failover/Fallback Mode
Fallback Server Redundancy Configuration
Failover Server Redundancy Configuration
Behaviors When Working Server Connection Fails
For Outgoing Call
When you initiate a call, the phone will go through the following steps to connect the call:
1.
Sends the INVITE request to the primary server.
2.
If the primary server does not respond correctly to the INVITE (that is, the primary server responds to the INVITE
with 503 message or the request for responding with 100 Trying message times out (64*T1 seconds, defined in
RFC 3261)), then tries to make the call using the secondary server.
3.
If the secondary server is also unavailable, the phone will try the fallback server until it either succeeds in making a call or exhausts all servers at which point the call will fail.
At the start of a call, server availability is determined by SIP signaling failure. SIP signaling failure depends on
the SIP protocol being used as described below:
l If TCP is used, then the signaling fails if the connection or the send fails.
l If UDP is used, then the signaling fails if ICMP is detected or if the signal times out. If the signaling has been
attempted through all servers in the list (this list contains all the server addresses resolved by the DNS
server) and this is the last server, then the signaling fails after the complete UDP timeout defined in RFC
3261. If it is not the last server in the list, the maximum number of retries depends on the configured retry
counts (configured by "template.X.sip_server.Y.retry_counts").
Registration Method of the Failover/Fallback Mode
Registration method of the failover mode:
The IP phone must always register to the primary server first except in failover conditions. If this is unsuccessful, the
phone will re-register as many times as configured until the registration is successful. When the primary server registration is unavailable, the secondary server will serve as the working server. As soon as the primary server registration succeeds, it returns to be the working server.
Registration methods of the fallback mode include (not applicable to outbound proxy servers):
l
Concurrent registration (default): The IP phone registers to SIP server 1 and SIP server 2 (working server and
fallback server) at the same time. Note that although the IP phone registers to two SIP servers, only one server
works at the same time. If it fails, a fallback server can take over the basic calling capability, but without some
advanced features (for example, shared lines and MWI) offered by the working server.
l
Successive registration: The IP phone only registers to one server at a time. The IP phone first registers to the
working server. In a failure situation, the phone registers to the fallback server, and the fallback server can take
over all calling capabilities.
44
Fallback Server Redundancy Configuration
The following table lists the parameters you can use to configure fallback server redundancy.
Account Settings
Parameter
Description
Permitted
Values
Default
Parameter
Description
Permitted
Values
Default
[1]
X is the account ID. X=1-100.
account.X.fallback.redundancy_type
It configures the registration mode in fallback mode.
Note: It is not applicable to outbound proxy servers.
0-Concurrent registration
1-Successive registration
0
account.X.fallback.timeout
It configures the time interval (in seconds) for the phone to detect whether the working server is available by sending the registration request after the fallback server takes over call control.
Note: It is not applicable to outbound proxy servers.
Integer from 10 to 2147483647
120
[1]
[1]
<MAC>.cfg
<MAC>.cfg
Failover Server Redundancy Configuration
The following table lists the parameters you can use to configure failover server redundancy.
Parameter
Description
Permitted
Values
Default
account.X.sip_server.Y.register_on_enable
It enables or disables the phone to send registration requests to the secondary server when encountering a failover.
0-Disabled, the phone will not attempt to register to the secondary server, since the phone assumes
that the primary and secondary servers share registration information. So the phone will directly send
the requests to the secondary server.
1-Enabled, the phone will register to the secondary server first, and then send the requests to it.
0
[1][2]
<MAC>.cfg
Parameter
Description
Permitted
Values
Default
Parameter
Description
Permitted
Values
Default
sip.skip_redundant_failover_addr<y0000000000xx>.cfg
It enables or disables the phone only to send requests to the servers with different IP addresses when
It enables or disables the phone to only send requests to the registered server when encountering a
failover.
Note: It works only if “account.X.sip_server.Y.register_on_enable” is set to 1 (Enabled) and “account.X.sip_server.Y.failback_mode” is set to 1, 2 or 3.
0-Disabled
1-Enabled
0
[1][2]
<MAC>.cfg
45
Administrator’s Guide for W80 DECT IP Multi-Cell System
Parameter
Description
Permitted
Values
Default
Parameter
Description
Permitted
Values
Default
Parameter
[1][2]
[1][2]
[1][2]
<MAC>.cfg
<MAC>.cfg
<MAC>.cfg
account.X.sip_server.Y.invite_retry_counts
It configures the number of retries attempted before sending requests to the next available server
when encountering a failover.
Integer from 1 to 10
3
account.X.sip_server.Y.failback_mode
It configures the mode for the phone to retry the primary server in failover.
Note: It works only if "template.X.sip_server.Y.address" is set to the domain name of the SIP server.
0-newRequests: all requests are sent to the primary server first, regardless of the last server that was
used.
1-DNSTTL: the phone will send requests to the last registered server first. If the time defined by
DNSTTL on the registered server expires, the phone will retry to send requests to the primary server.
2-Registration: the phone will send requests to the last registered server first. If the registration
expires, the phone will retry to send requests to the primary server.
3-duration: the phone will send requests to the last registered server first. If the time defined by the
“account.X.sip_server.Y.failback_timeout” parameter expires, the phone will retry to send requests to
the primary server.
0
account.X.sip_server.Y.failback_timeout
It configures the timeout (in seconds) for the phone to retry to send requests to the primary server after
failing over to the current working server.
Description
Permitted
Values
Default
Parameter
Description
Permitted
Values
Default
[2]
Y is the server ID. Y=1-2.
If you set the parameter to 0, the phone will not send requests to the primary server until a failover
event occurs with the current working server.
If you set the parameter between 1 and 59, the timeout will be 60 seconds.
Note: It works only if “account.X.sip_server.Y.failback_mode” is set to 3 (duration).
0, Integer from 60 to 65535
3600
account.X.sip_server.Y.failback_subscribe.enable
It enables or disables the phone to retry to re-subscribe after registering to the secondary server with
different IP addresses when encountering a failover.
Note: It works only if "account.X.sip_server.Y.failback_mode" is set to 1, 2 or 3.
0-Disabled
1-Enabled, the phone will immediately re-subscribe to the secondary server, for ensuring the normal
use of the features associated with the subscription (for example, BLF, SCA).
0
[1][2]
<MAC>.cfg
SIP Server Name Resolution
If a domain name is configured for a server, the IP address(es) associated with that domain name will be resolved
through DNS as specified by RFC 3263. The DNS query involves NAPTR, SRV and A queries, which allows the IP
46
Account Settings
phone to adapt to various deployment environments. The IP phone performs NAPTR query for the NAPTR pointer
and transport protocol (UDP, TCP, and TLS), the SRV query on the record returned from the NAPTR for the target
domain name and the port number, and the A query for the IP addresses.
If an explicit port (except 0) is specified, A query will be performed only. If a server port is set to 0 and the transport
type is set to DNS NAPTR, NAPTR and SRV queries will be tried before falling to A query. If no port is found through
the DNS query, 5060 will be used.
Topic
SIP Server Name Resolution Configuration
SIP Server Name Resolution Configuration
The following table lists the parameters you can use to configure the SIP server name resolution.
Parameter
Description
Permitted
Values
Default
Web UI
Parameter
Description
Permitted
Values
Default
Parameter
Description
Permitted
Values
Default
Parameter
template.X.sip_server.Y.transport_type
[1][2]
<y0000000000xx>.cfg
It configures the type of transport protocol.
0-UDP
1-TCP
2-TLS
3-DNS NAPTR, if no server port is given, the device performs the DNS NAPTR and SRV queries for
the service type and port.
0
Handset & Account > SIP Server Settings > Edit > SIP Server Y
account.X.naptr_build
[4]
<MAC>.cfg
[2]
> Transport
It configures the way of SRV query for the phone to be performed when no result is returned from the
NAPTR query.
0-SRV query using UDP only
1-SRV query using UDP, TCP, and TLS.
0
sip.dns_transport_type<y0000000000xx>.cfg
It configures the transport protocol the phone uses to perform a DNS query.
0-UDP
1-TCP
0
static.network.dns.query_timeout
[3]
<y0000000000xx>.cfg
Description
Permitted
Values
Default
Parameter
It configures the interval (in seconds) at which the phone retries to resolve a domain name when the
DNS server does not respond.
Integer from 0 to 65535
3
static.network.dns.retry_times
[3]
<y0000000000xx>.cfg
47
Administrator’s Guide for W80 DECT IP Multi-Cell System
Description
Permitted
Values
Default
[1]
X is the template ID. X=1-10.
[2]
Y is the server ID. Y=1-2.
[3]
If you change this parameter, the phone will reboot to make the change take effect.
[4]
X is the account ID. X=1-100.
It configures the retry times when the DNS server does not respond.
Integer from 0 to 65535
2
Static DNS Cache
Failover redundancy can only be utilized when the configured domain name of the server is resolved to multiple IP
addresses. If the IP phone is not configured with a DNS server, or the DNS query returns no result from a DNS
server, you can statically configure a set of DNS NAPTR/SRV/A records into the IP phone. The phone will attempt to
resolve the domain name of the SIP server with static DNS cache.
Support for negative caching of DNS queries as described in RFC 2308 is also provided to allow faster failover
when prior DNS queries have returned no results from the DNS server.
Topics
Behave with a Configured DNS Server
Static DNS Cache Configuration
Behave with a Configured DNS Server
When the phone is configured with a DNS server, it will behave as follows to resolve the domain name of the
server:
l The phone performs a DNS query to resolve the domain name from the DNS server.
l If the DNS query returns no results for the domain name, or the returned record cannot be contacted, the values
in the static DNS cache (if configured) are used when their configured time intervals are not elapsed.
l If the configured time interval is elapsed, the phone will attempt to perform a DNS query again.
l If the DNS query returns a result, the phone will use the returned record from the DNS server and ignore the stat-
ically configured cache values.
When the phone is not configured with a DNS server, it will behave as follows:
l The phone attempts to resolve the domain name within the static DNS cache.
l The phone will always use the results returned from the static DNS cache.
Static DNS Cache Configuration
The following table lists the parameters you can use to configure static DNS cache.
Parameter
Description
Permitted
Values
Default
Parameter
account.X.dns_cache_type
It configures whether the phone uses the DNS cache for domain name resolution of the SIP server
and caches the additional DNS records.
0-Perform real-time DNS query rather than using DNS cache.
1-Use DNS cache, but do not record the additional records.
2-Use DNS cache and cache the additional DNS records.
1
account.X.static_cache_pri
[1]
[1]
<MAC>.cfg
<MAC>.cfg
48
Account Settings
Description
Permitted
Values
Default
Parameter
Description
Permitted
Values
Default
Parameter
Description
Permitted
Values
Default
Parameter
Description
Permitted
Values
Default
Parameter
It configures whether preferentially to use the static DNS cache for domain name resolution of the SIP
server.
0-Use domain name resolution from server preferentially
1-Use static DNS cache preferentially
0
dns_cache_naptr.X.name
[2]
<y0000000000xx>.cfg
It configures the domain name to which NAPTR record X refers.
Domain name
Blank
dns_cache_naptr.X.order
[2]
<y0000000000xx>.cfg
It configures the order of NAPTR record X.
NAPTR record with the lower order is more preferred.
Integer from 0 to 65535
0
dns_cache_naptr.X.preference
[2]
<y0000000000xx>.cfg
It configures the preference of NAPTR record X.
NAPTR record with lower preference is more preferred.
Integer from 0 to 65535
0
dns_cache_naptr.X.replace
[2]
<y0000000000xx>.cfg
Description
Permitted
Values
Default
Parameter
Description
Permitted
Values
Default
Parameter
Description
Permitted
Values
Default
Parameter
It configures a domain name to be used for the next SRV query in NAPTR record X.
Domain name
Blank
dns_cache_naptr.X.service
[2]
<y0000000000xx>.cfg
It configures the transport protocol available for the SIP server in NAPTR record X.
SIP+D2U-SIP over UDP
SIP+D2T-SIP over TCP
SIPS+D2T-SIPS over TLS
Blank
dns_cache_naptr.X.ttl
[2]
<y0000000000xx>.cfg
It configures the time interval (in seconds) that NAPTR record X may be cached before the record
should be consulted again.
Integer from 30 to 2147483647
300
dns_cache_srv.X.name
[2]
<y0000000000xx>.cfg
49
Administrator’s Guide for W80 DECT IP Multi-Cell System
Description
Permitted
Values
Default
Parameter
Description
Permitted
Values
Default
Parameter
Description
Permitted
Values
Default
Parameter
Description
Permitted
Values
Default
Parameter
Description
Permitted
Values
Default
Parameter
Description
Permitted
Values
Default
Parameter
It configures the domain name in SRV record X.
Domain name
Blank
dns_cache_srv.X.port
[2]
<y0000000000xx>.cfg
It configures the port to be used in SRV record X.
Integer from 0 to 65535
0
dns_cache_srv.X.priority
[2]
<y0000000000xx>.cfg
It configures the priority for the target host in SRV record X.
Lower priority is more preferred.
Integer from 0 to 65535
0
dns_cache_srv.X.target
[2]
<y0000000000xx>.cfg
It configures the domain name of the target host for an A query in SRV record X.
Domain name
Blank
dns_cache_srv.X.weight
[2]
<y0000000000xx>.cfg
It configures the weight of the target host in SRV record X.
When priorities are equal, weight is used to differentiate the preference. Higher weight is more preferred.
Integer from 0 to 65535
0
dns_cache_srv.X.ttl
[2]
<y0000000000xx>.cfg
It configures the time interval (in seconds) that SRV record X may be cached before the record should
be consulted again.
Integer from 30 to 2147483647
300
dns_cache_a.X.name
[2]
<y0000000000xx>.cfg
Description
Permitted
Values
Default
Parameter
50
It configures the domain name in A record X.
Domain name
Blank
dns_cache_a.X.ip
[2]
<y0000000000xx>.cfg
Account Settings
Description
Permitted
Values
Default
Parameter
Description
Permitted
Values
Default
Parameter
Description
Permitted
Values
Default
Parameter
Description
It configures the IP address that the domain name in A record X maps to.
IP address
Blank
dns_cache_a.X.ttl
[2]
<y0000000000xx>.cfg
It configures the time interval (in seconds) that A record X may be cached before the record should be
consulted again.
Integer from 30 to 2147483647
300
static.network.dns.ttl_enable
[3]
<y0000000000xx>.cfg
It enables or disables the phone to use TTL (Time To Live) in the A record.
0-Disabled
1-Enabled
1
static.network.dns.last_cache_expired<y0000000000xx>.cfg
It configures the validity period of the expired DNS cache.
Note: It works only if "static.network.dns.last_cache_expired.enable" is set to 1 (Enabled).
Integer from 0 to 65535
Permitted
Values
0-the expired DNS cache can only be used once. After using, the phone will perform a DNS query
again.
1 to 65535-the phone will use the expired DNS cache during the specified period. After that, the
phone will perform a DNS query again.
Default
Parameter
Description
Permitted
Values
Default
[1]
X is the account ID. X=1-100.
[2]
X is the record ID. X=1-12.
[3]
If you change this parameter, the phone will reboot to make the change take effect.
3600
static.network.dns.last_cache_expired.enable<y0000000000xx>.cfg
It enables or disables the phone to use the DNS cache (even if the cache has expired) when the DNS
server fails to resolve the domain name.
0-Disabled
1-Enabled
0
Number of Active Handsets Per Base
You can limit the max number of active handsets per W80B base station. The active handsets are free to communicate, access menu, configure features and so on. Operation is restricted on the inactive handsets, and the idle
screen of the handset prompts "Path Busy".
The number of active handsets will also affect the number of simultaneous active calls on the base station.
51
Administrator’s Guide for W80 DECT IP Multi-Cell System
Call Supported
Wide-band Calls448
Narrow-band Calls888
Related Topics
Number of Active Handsets Per Base Configuration
Number of Active
Handsets Per Base
Maximum Number of Sim-
ultaneous Active Calls
Maximum Number of Sim-
ultaneous Calls
Number of Active Handsets Per Base Configuration
The following table lists the parameter you can use to configure the number of active handsets per base.
Parameter
Description
Permitted
Values
Default
Web UI
[1]
If you change this parameter, the phone will reboot to make the change take effect.
base.active_handset.number
It configures the maximum number of active handsets per base in the DECT multi-cell system.
4, 8
8
Features > General Information > Number Of Active Handset Per Base
[1]
<y0000000000xx>.cfg
52
Network Configurations
Network Configurations
You can make custom network configurations.
Topics
IPv4 Network Settings
DHCP Option for IPv4
VLAN
Real-Time Transport Protocol (RTP) Ports
Network Address Translation (NAT)
VPN
Quality of Service (QoS)
802.1x Authentication
TR-069 Device Management
IPv4 Network Settings
You can configure the devices to operate in IPv4 mode.
After establishing network connectivity, the devices obtain the IPv4 network settings from a Dynamic Host Configuration Protocol (DHCPv4) server.
You can also configure IPv4 network settings manually.
Note: Yealink devices comply with the DHCPv4 specifications documented in RFC 2131, and ICMPv6 specifications doc-
umented in RFC 4443.
Topics
IPv4 Configuration
IPv4 Configuration
The following table lists the parameters you can use to configure IPv4.
[1]
[1]
<y0000000000xx>.cfg
<y0000000000xx>.cfg
Parameter
Description
Permitted
Values
Default
Web UI
Parameter
Description
Permitted
Values
Default
static.network.internet_port.type
It configures the Internet port type for IPv4.
0-DHCP
2-Static IP
0
Network > Basic > IPv4 Config > Configuration Type
static.network.internet_port.ip
It configures the IPv4 address.
Note: It works only if "static.network.internet_port.type" is set to 2 (Static IP).
IPv4 Address
Blank
Web UI
Parameter
Description
Network > Basic > IPv4 Config > Configuration Type (Static IP) > IP Address
static.network.internet_port.mask
It configures the IPv4 subnet mask.
[1]
<y0000000000xx>.cfg
53
Administrator’s Guide for W80 DECT IP Multi-Cell System
Note: It works only if "static.network.internet_port.type" is set to 2 (Static IP).
The following table lists common DHCP options for IPv4 supported by Yealink phones.
Network Configurations
Parameters
Subnet Mask1Specify the client’s subnet mask.
Time Offset2
Router3Specify a list of IP addresses for routers on the client’s subnet.
Time Server4Specify a list of time servers available to the client.
Domain Name Server6Specify a list of domain name servers available to the client.
Host Name12Specify the name of the client.
Domain Server15
Network Time Protocol
Servers
Vendor-Specific Information
Vendor Class Identifier60Identify the vendor type.
TFTP Server Name66
DHCP
Option
Specify the offset of the client's subnet in seconds from Coordinated Universal
Time (UTC).
Specify the domain name that the client should use when resolving hostnames via DNS.
42Specify a list of NTP servers available to the client by IP address.
43Identify the vendor-specific information.
Identify a TFTP server when the 'sname' field in the DHCP header has been
used for DHCP options.
Description
DHCP Option 66, Option 43 and Custom Option
During the startup, the phone automatically detects the DHCP option for obtaining the provisioning server address.
The priority is as follows: custom option > option 66 (identify the TFTP server) > option 43.
The phone can obtain the Auto Configuration Server (ACS) address by detecting option 43 during startup.
Note: If you fail to configure the DHCP options for discovering the provisioning server on the DHCP server, enable the phone
to automatically discover the provisioning server address. One possibility is that connecting to the secondary DHCP server
that responds to DHCP INFORM queries with a requested provisioning server address. For more information, refer to RFC
3925.
Related Topic
DHCP Provision Configuration
DHCP Option 42 Option 2
Yealink phones support using the NTP server address offered by DHCP.
55
Administrator’s Guide for W80 DECT IP Multi-Cell System
DHCP option 42 is used to specify a list of NTP servers available to the client by IP address. NTP servers should be
listed in order of preference.
DHCP option 2 is used to specify the offset of the client’s subnet in seconds from Coordinated Universal Time
(UTC).
Related Topic
NTP Settings
DHCP Option 12
You can specify a hostname for the phone when using DHCP. The DHCP client uses option 12 to send a predefined hostname to the DHCP registration server.
See RFC 1035 for character set restrictions.
Topic
DHCP Option 12 Hostname Configuration
DHCP Option 12 Hostname Configuration
The following table lists the parameter you can use to configure DHCP option 12 hostname.
Parameter
Description
Permitted
Values
Default
Web UI
[1]
If you change this parameter, the phone will reboot to make the change take effect.
static.network.dhcp_host_name
It specifies a hostname for the phone when using DHCP.
String within 99 characters
SIP-W80B
Features > General Information > DHCP Hostname
[1]
<y0000000000xx>.cfg
DHCP Option 60
DHCP option 60 is used to indicate the vendor type. Servers can use option 43 to return the vendor-specific information to the client.
You can set the DHCP option 60 type.
Topic
DHCP Option 60 Configuration
DHCP Option 60 Configuration
The following table lists the parameters you can use to configure DHCP option 60.
It configures the vendor class identifier string to use in the DHCP interaction.
Network Configurations
Permitted
Values
Default
Web UI
String within 99 characters
yealink
Settings > Auto Provision > IPv4 DHCP Option Value
VLAN
The purpose of VLAN configurations on the phone is to insert a tag with VLAN information to the packets generated
by the phone. When VLAN is properly configured for the ports (Internet port and PC port) on the phone, the phone
will tag all packets from these ports with the VLAN ID. The switch receives and forwards the tagged packets to the
corresponding VLAN according to the VLAN ID in the tag as described in IEEE Std 802.3.
In addition to manual configuration, the phone also supports the automatic discovery of VLAN via LLDP, CDP or
DHCP. The assignment takes effect in this order: assignment via LLDP/CDP, manual configuration, then assignment via DHCP.
LLDP (Linker Layer Discovery Protocol) is a vendor-neutral Link Layer protocol, which allows the phones to advertise its identity and capabilities on the local network.
When LLDP feature is enabled on the phones, the phones periodically advertise their own information to the directly connected LLDP-enabled switch. The phones can also receive LLDP packets from the connected switch and
obtain their VLAN IDs.
The following table lists the parameters you can use to configure LLDP.
Parameter
Description
Permitted
Values
Default
Web UI
Parameter
Description
Permitted
Values
Default
Web UI
static.network.lldp.enable
It enables or disables the LLDP feature.
0-Disabled
1-Enabled, the phone attempts to determine its VLAN ID through LLDP.
1
Network > Advanced > LLDP > Active
static.network.lldp.packet_interval
It configures the interval (in seconds) that how often the phone sends the LLDP request.
Note: It works only if “static.network.lldp.enable” is set to 1 (Enabled).
If you change this parameter, the phone will reboot to make the change take effect.
57
Administrator’s Guide for W80 DECT IP Multi-Cell System
CDP Configuration
CDP (Cisco Discovery Protocol) allows the phones to receive and/or transmit device-related information from/to directly connected devices on the local network.
When CDP feature is enabled on the phones, the phones periodically advertise their own information to the directly
connected CDP-enabled switch. The phones can also receive CDP packets from the connected switch and obtain
their VLAN IDs.
The following table lists the parameters you can use to configure CDP.
Parameter
Description
Permitted
Values
Default
Web UI
Parameter
Description
Permitted
Values
Default
Web UI
[1]
If you change this parameter, the phone will reboot to make the change take effect.
static.network.cdp.enable
It enables or disables the CDP feature.
0-Disabled
1-Enabled, the phone attempts to determine its VLAN ID through CDP.
1
Network > Advanced > CDP > Active
static.network.cdp.packet_interval
It configures the interval (in seconds) that how often the phone sends the CDP request.
Note: It works only if “static.network.cdp.enable” is set to 1 (Enabled).
You can configure VLAN for the Internet port manually. Before configuring VLAN on the phones, you need to obtain
the VLAN ID from your network administrator.
The following table lists the parameters you can use to configure VLAN manually.
[1]
[1]
<y0000000000xx>.cfg
<y0000000000xx>.cfg
Parameter
Description
Permitted
Values
Default
Web UI
Parameter
Description
Permitted
Values
Default
58
static.network.vlan.internet_port_enable
It enables or disables the VLAN for the Internet port.
0-Disabled
1-Enabled
0
Network > Advanced > VLAN > WAN Port > Active
static.network.vlan.internet_port_vid
It configures the VLAN ID for the Internet port.
Note: It works only if “static.network.vlan.internet_port_enable” is set to 1 (Enabled).
Integer from 1 to 4094
1
Network Configurations
Web UI
Parameter
Description
Permitted
Values
Default
Web UI
[1]
If you change this parameter, the phone will reboot to make the change take effect.
Network > Advanced > VLAN > WAN Port > VID (1-4094)
static.network.vlan.internet_port_priority
It configures the VLAN priority for the Internet port.
7 is the highest priority, 0 is the lowest priority.
Note: It works only if “static.network.vlan.internet_port_enable” is set to 1 (Enabled).
Integer from 0 to 7
0
Network > Advanced > VLAN > WAN Port > Priority
[1]
<y0000000000xx>.cfg
DHCP VLAN Configuration
When the VLAN discovery method is set to DHCP, the phone examines the DHCP option for a valid VLAN ID. You
can customize the DHCP option used to request the VLAN ID.
The following table lists the parameters you can use to configure DHCP VLAN discovery.
Parameter
Description
Permitted
Values
Default
static.network.vlan.dhcp_enable
It enables or disables the DHCP VLAN discovery feature.
0-Disabled
1-Enabled
1
[1]
<y0000000000xx>.cfg
Web UI
Parameter
Description
Permitted
Values
Default
Web UI
[1]
If you change this parameter, the phone will reboot to make the change take effect.
Network > Advanced > VLAN > DHCP VLAN > Active
static.network.vlan.dhcp_option
It configures the DHCP option from which the phone will obtain the VLAN settings.
Multiple DHCP options (at most five) are separated by commas.
The following table lists the parameter you can use to configure the VLAN change.
Parameter
Description
Permitted
Values
static.network.vlan.vlan_change.enable
It enables or disables the phone to obtain VLAN ID using lower preference of VLAN assignment
method, or to close the VLAN feature when the phone cannot obtain VLAN ID.
The priority of each method is LLDP/CDP > Manual > DHCP VLAN.
0-Disabled
1-Enabled, the phone attempts to use the lower priority method when failing to obtain the VLAN ID
using higher priority method. If all the methods are attempted, the phone will disable VLAN feature.
[1]
<y0000000000xx>.cfg
59
Administrator’s Guide for W80 DECT IP Multi-Cell System
Default
[1]
If you change this parameter, the phone will reboot to make the change take effect.
0
Real-Time Transport Protocol (RTP) Ports
Since the phone supports conferencing and multiple RTP streams, it can use several ports concurrently. You can
specify the phone’s RTP port range.
The UDP port used for RTP streams is traditionally an even-numbered port. If the port 11780 is used to send and
receive RTP for the first voice session, additional calls would then use ports 11782, 11784, 11786, and so on. The
phone is compatible with RFC 1889 - RTP: A Transport Protocol for Real-Time Applications - and the updated RFC
3550.
Topic
RTP Ports Configuration
RTP Ports Configuration
The following table lists the parameters you can use to configure RTP ports.
Parameter
Description
Permitted
Values
Default
static.network.port.min_rtpport
It configures the minimum local RTP port.
Integer from 1024 to 65535
11780
[1]
<y0000000000xx>.cfg
Web UI
Parameter
Description
Permitted
Values
Default
Web UI
Parameter
Description
Permitted
Values
Default
[1]
If you change this parameter, the phone will reboot to make the change take effect.
Network > Advanced > Local RTP Port > Min RTP Port (1024~65535)
static.network.port.max_rtpport
It configures the maximum local RTP port.
Integer from 1024 to 65535
12780
Network > Advanced > Local RTP Port > Max RTP Port (1024~65535)
features.rtp_symmetric.enable<y0000000000xx>.cfg
It configures the symmetrical RTP feature.
0-Disabled
1-reject RTP packets arriving from a non-negotiated IP address
2-reject RTP packets arriving from a non-negotiated port
3-reject RTP packets arriving from a non-negotiated IP address or a non-negotiated port
0
[1]
<y0000000000xx>.cfg
60
Network Configurations
Network Address Translation (NAT)
NAT enables phones with private unregistered addresses to communicate with devices with globally unique
registered addresses.
Topics
NAT Traversal Configuration
Keep Alive Configuration
Rport Configuration
SIP Port and TLS Port Configuration
NAT Traversal Configuration
The phones can traverse NAT gateways to establish and maintain connections with external devices.
Yealink phones support three NAT traversal techniques: manual NAT, STUN and ICE. If you enable manual NAT
and STUN, the phone will use the manually-configured external IP address for NAT traversal. The TURN protocol is
used as part of the ICE approach to NAT traversal.
The following table lists the parameters you can use to configure NAT traversal.
Parameter
Description
Permitted
Values
Default
Web UI
Parameter
Description
Permitted
Values
Default
Web UI
Parameter
account.X.nat.nat_traversal
It enables or disables the NAT traversal for a specific account.
Note: If it is set to 1 (STUN), it works only if “static.sip.nat_stun.enable” is set to 1 (Enabled); if it is set
to 2 (Manual NAT), it works only if “static.network.static_nat.enable” is set to 1 (Enabled).
Rport allows a client to request that the server sends the response back to the source IP address and port from
which the request originated. It helps the phone traverse symmetric NATs.
Rport feature depends on support from a SIP server. For more information, refer to RFC 3581.
The following table lists the parameter you can use to configure rport.
Parameter
Description
Permitted
64
account.X.nat.rport
It enables or disables the phone to add the "rport" parameter in the Via header.
0-Disabled
[1]
<MAC>.cfg
Values
Default
Network Configurations
1-Enabled, the INVITE Contact header uses the port in the "rport" parameter but does not use the
source IP address in the "received" parameter in the Via header of server's response.
2-Enable Direct Process, the INVITE Contact header uses the port in the "rport" parameter and uses
the source IP address in the "received" parameter in the Via header of server's response.
You can configure the SIP and TLS source ports on the phone. Otherwise, the phone uses default values (5060 for
UDP/TCP and 5061 for TLS).
If NAT is disabled, the port number shows in the Via and Contact SIP headers of SIP messages. If NAT is enabled,
the phone uses the NAT port number (and NAT IP address) in the Via and Contact SIP headers of SIP messages,
but still using the configured source port.
The following table lists the parameters you can use to configure SIP port and TLS port.
Parameter
Description
Permitted
Values
Default
Parameter
Description
Permitted
Values
sip.listen_port<y0000000000xx>.cfg
It specifies the local SIP port.
If it is set to 0, the phone will automatically listen to the local SIP port.
0, Integer from 1024 to 65535
5060
sip.tls_listen_port<y0000000000xx>.cfg
It specifies the local TLS listen port.
If it is set to 0, the phone will not listen to the TLS service.
0, Integer from 1024 to 65535
Default
5061
VPN
Yealink phones use OpenVPN to achieve VPN feature. To prevent disclosure of private information, tunnel endpoints must authenticate each other before a secure VPN tunnel is established. After you configure VPN feature on
the IP phone, the phone will act as a VPN client and use the certificates to authenticate with the VPN server.
Topics
OpenVPN Related Files
VPN Configuration
OpenVPN Related Files
To use OpenVPN, you should collect the VPN-related files into one archive file in .tar format and then upload this tar
file. The VPN-related files include certificates (ca.crt and client.crt), key (client.key) and the configuration file
(vpn.cnf) of the VPN client.
The following table lists the unified directories of the OpenVPN certificates and key in the configuration file (vpn.cnf)
for Yealink phones:
65
Administrator’s Guide for W80 DECT IP Multi-Cell System
client.keyPrivate key of the client/config/openvpn/keys/client.key
VPN Configuration
The following table lists the parameters you can use to configure the VPN.
Parameter
Description
Permitted
Values
Default
Web UI
Parameter
Description
Permitted
Values
Default
Web UI
[1]
If you change this parameter, the phone will reboot to make the change take effect.
static.network.vpn_enable
It enables or disables the OpenVPN feature.
0-Disabled
1-Enabled
0
Network > Advanced > VPN > Active
static.openvpn.url<y0000000000xx>.cfg
It configures the access URL of the *.tar file for OpenVPN.
URL within 511 characters
Blank
Network > Advanced > VPN > Upload VPN Config
[1]
<y0000000000xx>.cfg
Quality of Service (QoS)
VoIP is extremely bandwidth and delay-sensitive. QoS is a major issue in VoIP implementations, regarding how to
guarantee that packet traffic is not delayed or dropped due to interference from other lower priority traffic. VoIP can
guarantee high-quality QoS only if the voice and the SIP packets are given priority over other kinds of network
traffic. The phones support the DiffServ model of QoS.
Voice QoS
In order to make VoIP transmissions intelligible to receivers, voice packets should not be dropped, excessively
delayed, or made to suffer varying delay. DiffServ model can guarantee high-quality voice transmission when the
voice packets are configured to a higher DSCP value.
SIP QoS
The SIP protocol is used for creating, modifying, and terminating two-party or multi-party sessions. To ensure good
voice quality, SIP packets emanated from the phones should be configured with a high transmission priority.
DSCPs for voice and SIP packets can be specified respectively.
Note: For voice and SIP packets, the phone obtains DSCP info from the network policy if LLDP feature is enabled, which
takes precedence over manual settings. For more information on LLDP, refer to LLDP Configuration.
Topic
Voice and SIP QoS Configuration
66
Voice and SIP QoS Configuration
The following table lists the parameters you can use to configure voice QoS and SIP QoS.
Network Configurations
Parameter
Description
Permitted
Values
Default
Web UI
Parameter
Description
Permitted
Values
Default
Web UI
[1]
If you change this parameter, the phone will reboot to make the change take effect.
static.network.qos.audiotos
It configures the DSCP (Differentiated Services Code Point) for voice packets.
The default DSCP value for RTP packets is 46 (Expedited Forwarding).
Integer from 0 to 63
46
Network > Advanced > QoS > Voice QoS (0~63)
static.network.qos.signaltos
It configures the DSCP (Differentiated Services Code Point) for SIP packets.
The default DSCP value for SIP packets is 26 (Assured Forwarding).
Integer from 0 to 63
26
Network > Advanced > QoS > SIP QoS (0~63)
[1]
[1]
<y0000000000xx>.cfg
<y0000000000xx>.cfg
TR-069 Device Management
TR-069 is a technical specification defined by the Broadband Forum, which defines a mechanism that encompasses secure auto-configuration of a CPE (Customer-Premises Equipment), and incorporates other CPE management functions into a common framework. TR-069 uses common transport mechanisms (HTTP and HTTPS) for
communication between CPE and ACS (Auto Configuration Servers). The HTTP(S) messages contain XML-RPC
methods defined in the standard for configuration and management of the CPE.
Topics
Supported RPC Methods
TR-069 Configuration
Supported RPC Methods
The following table provides a description of RPC methods supported by the phones.
RPC MethodDescription
GetRPCMethodsThis method is used to discover the set of methods supported by the CPE.
SetParameterValuesThis method is used to modify the value of one or more CPE parameters.
GetParameterValuesThis method is used to obtain the value of one or more CPE parameters.
GetParameterNamesThis method is used to discover the parameters accessible on a particular CPE.
GetParameterAttributes This method is used to read the attributes associated with one or more CPE parameters.
SetParameterAttributes This method is used to modify attributes associated with one or more CPE parameters.
RebootThis method causes the CPE to reboot.
Download
This method is used to cause the CPE to download a specified file from the designated loc-
67
Administrator’s Guide for W80 DECT IP Multi-Cell System
RPC MethodDescription
ation.
File types supported by the phones are:
l Firmware Image
l Configuration File
This method is used to cause the CPE to upload a specified file to the designated location.
Upload
ScheduleInform
File types supported by the phones are:
l Configuration File
l Log File
This method is used to request the CPE to schedule a one-time Inform method call (separate from its periodic Inform method calls) sometime in the future.
FactoryResetThis method resets the CPE to its factory default state.
TransferComplete
This method informs the ACS of the completion (either successful or unsuccessful) of a file
transfer initiated by an earlier Download or Upload method call.
AddObjectThis method is used to add a new instance of an object defined on the CPE.
DeleteObjectThis method is used to remove a particular instance of an object.
TR-069 Configuration
The following table lists the parameters you can use to configure TR-069.
Parameter
Description
Permitted
Values
Default
static.managementserver.enable<y0000000000xx>.cfg
It enables or disables the TR-069 feature.
0-Disabled
1-Enabled
0
Web UI
Parameter
Description
Permitted
Values
Default
Web UI
Parameter
Description
Permitted
Values
Default
Web UI
Settings > TR069 > Enable TR069
static.managementserver.username<y0000000000xx>.cfg
It configures the TR-069 ACS server user name used to authenticate the phone.
Leave it blank if no authentication is required.
String within 128 characters
Blank
Settings > TR069 > ACS Username
static.managementserver.password<y0000000000xx>.cfg
It configures the TR-069 ACS server password used to authenticate the phone.
Leave it blank if no authentication is required.
String within 64 characters
Blank
Settings > TR069 > ACS Password
68
Network Configurations
Parameter
Description
Permitted
Values
Default
Web UI
Parameter
Description
Permitted
Values
Default
Web UI
Parameter
Description
Permitted
Values
Default
static.managementserver.url<y0000000000xx>.cfg
It configures the access URL of the TR-069 ACS server.
It enables or disables the phone to periodically report its configuration information to the ACS server.
0-Disabled
1-Enabled
1
Settings > TR069 > Enable Periodic Inform
static.managementserver.periodic_inform_interval<y0000000000xx>.cfg
It configures the interval (in seconds) at which the phone reports its configuration to the ACS server.
Description
Note: It works only if “static.managementserver.periodic_inform_enable” is set to 1 (Enabled).
Yealink phones support the following protocols for 802.1x authentication:
l EAP-MD5
l EAP-TLS (requires Device and CA certificates, requires no password)
l EAP-PEAP/MSCHAPv2 (requires CA certificates)
l EAP-TTLS/EAP-MSCHAPv2 (requires CA certificates)
69
Administrator’s Guide for W80 DECT IP Multi-Cell System
l EAP-PEAP/GTC (requires CA certificates)
l EAP-TTLS/EAP-GTC (requires CA certificates)
l EAP-FAST (supports EAP In-Band provisioning, requires CA certificates if the provisioning method is Authentic-
ated Provisioning)
Topic
802.1x Authentication Configuration
802.1x Authentication Configuration
The following table lists the parameters you can use to configure 802.1x authentication.
It configures the EAP In-Band provisioning method for EAP-FAST.
Note: It works only if “static.network.802_1x.mode” is set to 7 (EAP-FAST).
0-Unauthenticated Provisioning, EAP In-Band provisioning is enabled by server unauthenticated PAC
(Protected Access Credential) provisioning using the anonymous Diffie-Hellman key exchange.
1-Authenticated Provisioning, EAP In-Band provisioning is enabled by server authenticated PAC provisioning using certificate-based server authentication.
0
Web UI
Parameter
Description
Permitted
Values
Default
Web UI
70
Network > Advanced > 802.1x > Provisioning Mode
static.network.802_1x.anonymous_identity
[1]
<y0000000000xx>.cfg
It configures the anonymous identity (user name) for 802.1X authentication.
It is used for constructing a secure tunnel for 802.1X authentication.
Note: It works only if “static.network.802_1x.mode” is set to 2, 3, 4, 5, 6 or 7.
String within 512 characters
Blank
Network > Advanced > 802.1x > Anonymous Identity
Network Configurations
Parameter
Description
Permitted
Values
Default
Web UI
Parameter
Description
Permitted
Values
Default
Web UI
Parameter
Description
Permitted
Values
Default
static.network.802_1x.identity
[1]
<y0000000000xx>.cfg
It configures the identity (user name) for 802.1x authentication.
String within 32 characters
Blank
Network > Advanced > 802.1x > Identity
static.network.802_1x.md5_password
[1]
<y0000000000xx>.cfg
It configures the password for 802.1x authentication.
Note: It is required for all methods except EAP-TLS.
String within 32 characters
Blank
Network > Advanced > 802.1x > MD5 Password
static.network.802_1x.root_cert_url<y0000000000xx>.cfg
It configures the URL for uploading the 802.1x CA certificate.
The format of the certificate must be *.pem, *.crt, *.cer or *.der.
Note: It works only if “static.network.802_1x.mode” is set to 2, 3, 4, 5, 6 or 7. If the authentication
method is EAP-FAST, you also need to set “static.network.802_1x.eap_fast_provision_mode” to 1
(Authenticated Provisioning).
URL within 511 characters
Blank
Web UI
Parameter
Network > Advanced > 802.1x > CA Certificates
static.network.802_1x.client_cert_url<y0000000000xx>.cfg
It configures the URL for uploading the 802.1x client certificate.
Description
The format of the certificate must be *.pem.
Note: It works only if “static.network.802_1x.mode” is set to 2 (EAP-TLS).
Permitted
Values
Default
Web UI
[1]
If you change this parameter, the phone will reboot to make the change take effect.
URL within 511 characters
Blank
Network > Advanced > 802.1x > Device Certificates
71
Administrator’s Guide for W80 DECT IP Multi-Cell System
Web Statistics
Web statistics is the measurement, collection, analysis and reporting of system data for purposes of understanding
and optimizing the multi-cell system. When an abnormality occurs in the system, you can preliminarily check and
locate the problem through the Statistics page.
Topics
Base Station Group
All Calls
Base Stations Calls
Handsets Calls
Abnormal Calls
Upgrade Information
DECT Signal
Base Station Group
The module of base station group shows the synchronization information among base stations. It can display the
information of up to 30 base stations.
Topics
Base Station Statistics
Cluster Graph Statistics
Viewing Base Station Group Statistics
Base Station Statistics
The properties are shown below:
ItemDescription
Base Station
RPN
IP
MAC
Sync Level
Name of the base station.
Radio Fixed Part Number. The base station identity allocated by the DECT system.
IP address of the base station.
MAC address of the base station.
Sync level within the sync hierarchy.
Synchronization status of the base station.
• Offline: not available.
Base Status
RSSI
72
• Deactive: available but not activated.
• Active: activated but not synchronized.
• Active and synced: activated and synchronized.
• Upgrading: firmware upgrading.
RPN and signal value of the synchronous base.
For example, "RPN3 (-76dBm)" indicates that the current base is synchronized with the base
ItemDescription
that is numbered RPN3 and the signal value is -76dBm.
Note: RSSI refreshes automatically every 20 seconds.
Web Statistics
Interference
Number of interferences detected by base.
Fre: frequency band where the base on a higher sync level is located.
Slot: slot where the base on a higher sync level is located.
For example, "8/6 (Good)" indicates that the frequency band of the base on a higher sync
Fre/Slot
level is 8, the slot is 6, and the synchronization with the base is Good.
Note: The synchronization with the base on a higher sync level includes Good, Normal,
Weak, Unknown, and "-", where Unknown is displayed when the information is not updated,and "-" is displayed when the base is offline.
Signal Num
Network Drop
The number of signals that is greater or equal to -88dbm (RSSI > =-0x48) detected by base.
The number of network disconnections.
The latest startup time of the base.
Start Time
Note: It will not be reset even if you manually clear the statistical data.
Due to the different base statuses, the following items are specially explained:
l
Async、Network Drop: Corresponding values are displayed for any base status.
l
Signal Num、 Start Time: A value is displayed only when the base status is Active or Active and synced, and
"—" is displayed for other base statuses.
l
RSSI、Fre/Slot: A value is displayed only when the base status is Active and synced, and "—" is displayed for
other base statuses.
l
For the base with sync level 1, the following items always display "-": RSSI, Async, and Fre/Slot.
Cluster Graph Statistics
The tree map is described as follows:
(1) Cables
Different cables are used between the bases to indicate the synchronized base signal.
l
Solid blue line (): -85dBm <= RSSI <= -28dBm
l
Red dotted line (): -99dBm < RSSI <= -86dBm
l
Gray dotted line (): No data available
Note: When the base status is not Active and synced, the base does not display the synchronized RSSI value. Both are
connected with a gray dotted line.
If the previous base on a higher sync level cannot be found (such as the base was deleted), there is no connection line, it is
displayed individually and placed under the base with sync level 1.
(2) Circles
Different circles are used to indicate different base status.
73
Administrator’s Guide for W80 DECT IP Multi-Cell System
l
White hollow circle (): Active and synced
l
Red solid circle (): Offline, Active, Upgrading
l
Gray solid circle (): Deactive
Hovering the mouse over the corresponding base will display the base details in the floating window, as shown
below:
Viewing Base Station Group Statistics
Procedure
1.
Access the web user interface of the DM.
2. Go to Status > Base Station Group.
3.
You can do the following:
l
Select the desired cluster from the Base Station Cluster drop-down menu, and click Show Cluster Graph to
view the synchronization information of the base.
74
Web Statistics
To save the tree map, click Save Image.
The picture is stored in PNG format by default.
l
Select the desired cluster from the Base Station Cluster drop-down menu, select the search type and enter
the search criteria to perform a search.
l
Click Export to export statistics.
l
Click Reset to clear and restart the statistics.
l
Click Refresh to refresh the current statistics.
Related Topics
Base Station Statistics
Cluster Graph Statistics
All Calls
The module of all calls shows the call information of all handsets in the system. Up to 100 call records can be displayed, and the oldest one will be automatically deleted if the max limit has been reached.
Topics
All Calls Statistics
Viewing All Calls Statistics
75
Administrator’s Guide for W80 DECT IP Multi-Cell System
All Calls Statistics
The properties are shown below:
ItemDescription
Call Time
Duration
Time when the call was established.
Call duration.
Call TypeCall type, including Placed Calls, Received Calls, and Missed Calls.
Local identity of the call. Local User is the local account, and Handset is the local handset number.
Local User (Handset)
For example, 5707 (H7) indicates that the local account is 5707 and the handset number
is H7.
Remote User
Far-site information of the call.
Call performance during a call, including Transfer, Conference, and Forward.
Operation
Note: Only when a network conference is performed during a call will it be recorded as
Conference.
Viewing All Calls Statistics
Procedure
1.
Access the web user interface of the DM.
2. Go to Statistics > All Calls.
3. Select the desired call type from the Call Type drop-down menu.
4.
You can do the following:
l
Clickto customize the properties displayed in the statistics table.
l
Click Export to export statistics.
l
Click Reset to clear and restart the statistics.
l
Click Refresh to refresh the current statistics.
Related Topics
76
Web Statistics
All Calls Statistics
Base Stations Calls
The module of base station calls shows the call information on each base station in the system. Up to 100 call
records can be displayed, and the oldest one will be automatically deleted if the max limit has been reached.
Topics
Base Stations Calls Statistics
Viewing Base Stations Calls Statistics
Base Stations Calls Statistics
The following shows base stations calls information:
ItemDescription
Base Station
IP
MAC
Active
Max Active
Busy
Handover In
Handover Out
Name of the base station.
IP address of the base station.
MAC address of the base station.
Number of active handsets on the base station.
Maximum number of active handsets that have appeared on the base station.
Note: The maximum number of active handsets in narrowband is 8 and in wideband is 4.
Number of busy-state the base station has entered. The busy-state indicates that the number
of active handsets under the base station reaches the limit (narrowband: 8; wideband: 4).
Number of incoming handovers
Number of outgoing handovers
Note: If a call is established on a base, the outgoing handovers are all recorded by this base.
For example, if H1 establishes a call on Base1, roams to Base2 during the call, and then
roams to Base3, the number of outgoing handovers on Base1 is 2, and the number of incoming handovers on Base1, Base2, and Base3 is 1.
Number of lost connections, for example, interrupted calls
Call Drops
No Audio
Note: The "Sum" line is the sum of all base call statistics.
Format: number of lost connections / total number of calls
For example, "1/4 (25%)" indicates that the total number of calls is 4, and the call is interrupted
once.
Number of silent calls on the base.
Format: number of silent calls / total number of calls
For example, "1/4 (25%)" indicates that the total number of calls is 4, and the silent call occurs
once.
Note: The number of silent times during a call is counted as one, and only the silent that
occurs when the handset is not roaming during the call can be counted.
77
Administrator’s Guide for W80 DECT IP Multi-Cell System
Viewing Base Stations Calls Statistics
Procedure
1.
Access the web user interface of the DM.
2. Go to Statistics > Base Stations Calls.
3.
You can do the following:
l
Clickto customize the properties displayed in the statistics table.
l
Click Export to export statistics.
l
Click Reset to clear and restart the statistics.
l
Click Refresh to refresh the current statistics.
Related Topics
Base Stations Calls Statistics
Handsets Calls
The module of handsets calls shows the call information on each handset in the system. It can display the information of up to 100 handsets.
The following shows all handsets call information:
FieldDescription
Handset
Handset name
The registered handsets are displayed in ascending order.
Account
Abnormal Calls /
Total
Average Call
78
Account number of the handset.
All abnormal calls / total calls of the handset.
Average call duration of all calls on the handset.
FieldDescription
Web Statistics
Max Call
Min Call
Maximum call duration for all calls on the handset.
Minimum call duration for all calls on the handset, including the number of calls with a duration of 0, such as Missed Call, Outgoing Rejection, and Incoming Call Rejection.
Note: The "Sum" line is the sum of all handset call statistics. Handsets that have not yet established a call are not counted.
Viewing Handsets Calls Statistics
Procedure
1.
Access the web user interface of the DM.
2. Go to Statistics > Handsets Calls.
3.
You can do the following:
l Select the search type and enter the search criteria to perform a search.
l
Clickto customize the properties displayed in the statistics table.
l
Click Export to export statistics.
l
Click Reset to clear and restart the statistics.
l
Click Refresh to refresh the current statistics.
Related Topics
Handsets Calls Statistics
Abnormal Calls
The module of abnormal calls shows the abnormal call information in the system. Up to 30 call records can be displayed, and the oldest one will be automatically deleted if the max limit has been reached.
The following shows all abnormal calls information:
79
Administrator’s Guide for W80 DECT IP Multi-Cell System
ItemDescription
Call Time
Handset
Account
Time when the call was established.
Handset which has an abnormal call.
Account number for the current handset.
Call TypeCall type, including Placed Calls, Received Calls, and Missed Calls.
Duration
Base Handover
Codec
Remote User
Status
Call duration.
Base received a handover during the call.
SIP codec used for the call negotiation.
Far-site information of the call.
Final state of the call.
Reason why the abnormality occurs during the call.
l OTA upgrading
Reason
l Not found
l Not in range
l Unknown:
Packet loss rate of the call.
Packet Loss Rate
Note: This function is not supported for the time being, it is displayed as "—".
Viewing Abnormal Calls Statistics
Procedure
1.
Access the web user interface of the DM.
2. Go to Statistics > Abnormal Calls.
3. Select the desired call type from the Call Type drop-down menu.
4.
You can do the following:
l Select the search type and enter the search criteria to perform a search.
l
Clickto customize the properties displayed in the statistics table.
l
Click Export to export statistics.
l
Click Reset to clear and restart the statistics.
l
Click Refresh to refresh the current statistics.
Related Topics
Abnormal Calls Statistics
80
Web Statistics
Upgrade Information
The module of upgrade information shows the information about handset upgrade, including upgrading via web
user interface, auto provisioning, or the handset. Up to 6 records will be displayed and the oldest will be automatically deleted.
Topics
Upgrade Information Statistics
Viewing Upgrade Information Statistics
Upgrade Information Statistics
The following shows all the upgrade information:
FieldDescription
Upgrade Time
Upgrade Method
Duration
Devices
Total
Successed
Failed
No Upgrade
Description
Start time of the upgrade.
Upgrade mode, including Normal and Grayscale Upgrade.
Note: When upgrading via the web user interface, you can choose to upgrade in normal or
grayscale mode, and the default upgrade mode for the handset upgrade is the grayscale
mode.
How long the upgrade process lasts.
Type of the device that is upgraded at this time, including W59R, W53H, W56H, T41S +DD10K, and CP930W.
Total number of handsets to be upgraded this time.
Number of handsets successfully upgraded this time.
Number of handsets that failed to upgrade this time.
Number of handsets that are not upgraded this time.
Handset that failed to upgrade.
If there are more than 3, the first 3 will be displayed, and the following will be displayed as an
ellipsis. Such as "H1, H2, H3 ...", when you hover your mouse to this place, all the information
of the handsets that failed to upgrade will be displayed.
If all handsets are successfully upgraded, it displays nothing.
Note: It will not be recorded if the handset is not upgraded due to the same firmware version.
You may need to know the following statistical rules for the same version upgrade:
l If all handsets involved in this upgrade are the same as the upgraded version, there is no upgrade record.
l If some of the handsets involved in this upgrade are the same as the upgraded version, records of no upgrade
caused by the same version will be recorded in the No Upgrade field.
Viewing Upgrade Information Statistics
Procedure
81
Administrator’s Guide for W80 DECT IP Multi-Cell System
1.
Access the web user interface of the DM.
2. Go to Statistics > Upgrade Information.
3.
You can do the following:
l Select the search type and enter the search criteria to perform a search.
l
Clickto customize the properties displayed in the statistics table.
l
Click Export to export statistics.
l
Click Reset to clear and restart the statistics.
l
Click Refresh to refresh the current statistics.
Related Topics
Upgrade Information Statistics
DECT Signal
The module of DECT signal shows signal interference around each base station in the system.
Topics
DECT Signal Statistics
Viewing DECT Signal Statistics
DECT Signal Statistics
The following shows some special values:
dBmRSSIDescription
0FF
The meaning of each color in the statistical table is as follows.
RSSIdBmRSSI
The position of the base or the position of the handset under the base.
[-73,-27][70,D8]
82
[-88,-73)[48,70)
[-97,-88)[30,48)
Web Statistics
RSSIdBmRSSI
[-99,-97)&0[0,30)&FF
Note: The data presented in the statistics table includes the signal data transmitted by the base of the same system and the
calls under the base.
The frequency bands in different regions of different versions are different. The frequency bands here start from 0. The actual
number of frequency bands is based on actual conditions. For example, the frequency band used by Korea is Freq6-Freq8, but
Freq0- Freq2 are displayed instead.
Viewing DECT Signal Statistics
Procedure
1.
Access the web user interface of the DM.
2. Go to Statistics > DECT Signal.
3.
Select the desired base station.
4.
Select the desired unit.
5. Click Export to export statistics.
6. Click Refresh to refresh the current statistics.
Related Topics
DECT Signal Statistics
83
Phone Provisioning
Phone Provisioning
You can provision multiple phones with the same settings for large-scale deployments.
For more information, refer to Yealink SIP IP Phones Auto Provisioning Guide.
Topics
Boot Files, Configuration Files, and Resource Files
Provisioning Methods
Setting Up a Provisioning Server
Keeping User’s Personalized Settings after Auto Provisioning
Boot Files, Configuration Files, and Resource Files
You can use boot files, configuration files, and resource files to configure phone features and apply feature settings
to phones. You can create or edit these files using a text editor such as Notepad++.
You can ask the distributor or Yealink FAE for template files. You can also obtain the template files online: http://sup-
Boot Files
Configuration Files
Resource Files
Files Download Process
Boot Files
Yealink phones support boot files. The boot files maximize the flexibility to allow you to customize features and settings for multiple phones.
With the boot file, you can specify which configuration files should be downloaded. It is effective for you to provision
the phones in different deployment scenarios:
l For all phones
l For a group of phones
l For a single phone
Yealink phones support two types of boot files: common boot file and MAC-Oriented boot file. You can use the
default boot template file “y000000000000.boot” to create MAC-Oriented boot file by making a copy and renaming
it.
Note: You can select whether to use the boot file or not according to your deployment scenario. If you do not want to use the
boot file, please go to Configuration Files.
Topics
Common Boot File
MAC-Oriented Boot File
Boot File Attributes
Customizing a Boot File
Common Boot File
Common boot file, named y000000000000.boot, is effective for all phones. You can use a common boot file to
apply common feature settings to all of the phones rather than a single phone.
84
Administrator’s Guide for W80 DECT IP Multi-Cell System
MAC-Oriented Boot File
MAC-Oriented boot file, named <MAC>.boot. It will only be effective for a specific IP phone. In this way, you have
high permission to control each phone by making changes on a per-phone basis.
You can create a MAC-Oriented boot file for each phone by making a copy and renaming the boot template file
(y000000000000.boot). For example, if your phone MAC address is 00156574B150, rename the template file as
00156574b150.boot (lowercase).
Tip: MAC address, a unique 12-digit serial number is assigned to each phone. You can obtain it from the bar code on the
back of the base.
Boot File Attributes
The following table lists the attributes you need to know in the boot template file.
Attributes
Description
#!version:1.0.0.1It must be placed in the first line. Do not edit and delete.
Each “include” statement can specify a location of a configuration file. The configuration file format must be *.cfg.
The locations in the angle brackets or double quotation marks support two
forms:
include:config <xxx.cfg>
include:config "xxx.cfg"
l Relative path (relative to the boot file):
For example, sip.cfg, HTTP Directory/sip.cfg
l Absolute path (or URL):
For example, http://10.2.5.258/HTTP Directory/sip.cfg
The location must point to a specific CFG file.
Enable or disable the overwrite mode.
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.
overwrite_mode
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: Overwrite mode can only be used in boot files. If a boot file is used but
“overwrite_mode” is not configured, the overwrite mode is enabled by default.
Tip: The line beginning with “#” is considered to be a comment. You can use “#” to make any comment on the boot file.
Customizing a Boot File
Procedure
1.
Open a boot template file.
2.
To add a configuration file, add include:config < > or include:config “” to the file. Each starts on a separate line.
3.
Specify a configuration file for downloading.
For example:
include:config <configure/sip.cfg >
include:config “http://10.2.5.206/configure/account.cfg”
include:config “http://10.2.5.206/configure/dialplan.cfg”
4.
Specify the overwrite mode.
For example:
overwrite_mode = 1
85
Phone Provisioning
5.
Save the boot file and place it on the provisioning server.
Related Topic
Boot File Attributes
Configuration Files
Yealink supports two configuration template files: Common CFG file and MAC-Oriented CFG file.
These configuration files contain two kinds of parameters:
l Static: The parameters start with a prefix “static.”, for example, static.auto_provision.custom.protect.
l Non-static: The parameters do not start with a prefix “static.”, for example, local_time.date_format.
You can deploy and maintain a mass of Yealink phones automatically through configuration files stored in a provisioning server.
Note: For protecting against unauthorized access, you can encrypt configuration files. For more information on encrypting
configuration files, refer to Encrypting and Decrypting Files.
Common CFG file, named <y0000000000xx>.cfg, contains parameters that affect the basic operation of the IP
phone, such as language and volume. It will be effective for all phones in the same model. The common CFG file
has a fixed name for each phone model.
The name of the common CFG file for W80DM device is y000000000103.cfg.
MAC-Oriented CFG File
MAC-Oriented CFG file, which is named after the MAC address of the IP phone. For example, if the MAC address of
an IP phone is 00156574B150, the name of MAC-Oriented CFG file is 00156574b150.cfg (lowercase). It contains
parameters unique to a particular phone, such as account registration. It will only be effective for a MAC-specific IP
phone.
MAC-local CFG File
MAC-local CFG file, which is named after the MAC address of the IP phone. For example, if the MAC address of an
IP phone is 00156574B150, the name of the MAC-local CFG file is 00156574b150-local.cfg (lowercase). It contains
changes associated with a non-static parameter that you make via the web user interface or handset user interface
(for example, changes for time and date formats).
This file generates only if you enable the provisioning priority mechanism. It is stored locally on the IP phone and
you can upload it to the provisioning server each time the file updates. This file enables the users to keep their personalized configuration settings, even though the IP phone performs auto provisioning.
Note: The non-static changes that you made before enabling the provisioning priority mechanism are not saved in the gen-
erated MAC-local file, but the previous settings still take effect on the phone. The static changes are never be saved to the
<MAC>-local.cfg file.
The provisioning priority mechanism is enabled by the parameter “static.auto_provision.custom.protect”.
Configuration File Customization
You can create some new CFG files by making a copy and renaming the configuration template file (for example,
sip.cfg, account.cfg). You can rearrange the parameters in the configuration template file and create your own con-
86
Administrator’s Guide for W80 DECT IP Multi-Cell System
figuration files with parameters you want. This flexibility is especially useful when you want to apply specific settings
to a group of phones.
Topic
Customizing a Configuration File
Customizing a Configuration File
1.
Copy and rename a configuration template file. For example, sip.cfg.
2.
Rearrange the parameters in the sip.cfg, and set the valid values for them.
For example:
account.1.anonymous_call = 1
3.
Save the configuration file and place it on the provisioning server.
Related Topic
Configuration File Attributes
Configuration File Attributes
The following table lists the attributes you need to know in the configuration template file.
AttributesDescription
#!version:1.0.0.1It must be placed in the first line. Do not edit and delete.
Configuration Parameter=Valid
Value
(for example, account.1.dnd.enable = 1)
Specify the parameters and values to apply specific settings to the phones.
l Separate each configuration parameter and value with an equal sign
l Set only one configuration parameter per line
l Put the configuration parameter and value on the same line and do not break
the line
Tip: The line beginning with “#” is considered to be a comment. You can use “#” to make any comment on the configuration
file.
Resource Files
Resource files are optional, but if the particular feature is being employed, these files are required. You need to
place resource files on the provisioning server. The phones request the resource files in addition to the configuration files during auto provisioning.
Tip: If you want to specify the desired phone to use the resource file, the access URL of the resource file should be specified
in the MAC-Oriented CFG file. During auto provisioning, the phones will request the resource files in addition to the configuration files.
Topic
Supported Resource Files
Supported Resource Files
Yealink supplies some template of resource files for you, so you can directly edit the files as required.
The following table lists the resource files Yealink supplies:
Template FileFile NameDescriptionReference in Section
AutoDST Template AutoDST.xmlAdd or modify time zone and DST settings.DST Settings
Language Packs
For example,
1.English.js
Customize the translation of the existing language on the web user interface.
Language for Web Display
Customization
87
Phone Provisioning
Template FileFile NameDescriptionReference in Section
Replace Rule Template
Dial Now Template DialNow.xmlCustomize dial now rules for the dial plan.
Super Search Template
Local Contact Filecontact.xmlAdd or modify multiple local contacts.
Remote Phone
Book Template
DialPlan.xmlCustomize replace rules for the dial plan.
super_
search.xml
Department.xml
Menu.xml
Customize the search source list.
Add or modify multiple remote contacts.
Replace Rule File Customization
Dial Now File Customization
Search Source File Customization
Local Contact File Customization
Remote Phone Book File
Customization
Files Download Process
When you provision the phones, the phones will request to download the boot files, configuration files and resource
files from the provisioning server according to the following flowchart:
The parameters in the newly downloaded configuration files will override the same parameters in files downloaded
earlier.
Provisioning Methods
Yealink provides two ways to provision your phones:
l Manual Provisioning: provisioning via the handset user interface or web user interface.
l Central Provisioning: provisioning through configuration files stored in a central provisioning server.
The method you use depends on how many phones need to be deployed and what features and settings to be configured. Manual provisioning on the web or handset user interface does not contain all of the phone settings available with the centralized method. You can use the web user interface method in conjunction with a central
88
Administrator’s Guide for W80 DECT IP Multi-Cell System
provisioning method and handset user interface method. We recommend using centralized provisioning as your
primary provisioning method when provisioning multiple phones.
Topics
Provisioning Methods Priority
Web User Interface
Phone User Interface
Central Provisioning
Provisioning Methods Priority
There is a priority for configuration among the provisioning methods - settings you make using a higher priority provisioning method override settings made using a lower priority provisioning method.
The precedence order for configuration parameter changes is as follows (highest to lowest):
Note: The provisioning priority mechanism takes effect only if “static.auto_provision.custom.protect” is set to 1. For more
information on this parameter, refer to Keeping User’s Personalized Settings Configuration.
Static parameters have no priority. They take effect no matter what method (web user interface or phone user interface or configuration files) you are using for provisioning.
Static parameters are the parameters that start with a prefix “static.”, for example, the parameters associated with
auto provisioning/network/syslog, TR069 settings and internal settings (the temporary configurations to be used for
program running).
Web User Interface
You can configure the phones via the web user interface, a web-based interface that is especially useful for remote
configuration.
Because features and configurations vary by phone models and firmware versions, options available on each page
of the web user interface can vary as well. Note that the features configured via the web user interface are limited.
Therefore, you can use the web user interface in conjunction with a central provisioning method and phone user
interface.
Note: When you manually configure a phone via the web user interface or handset user interface, the changes associated
with non-static parameters you make will be stored in the MAC-local CFG file. For more information on the MAC-local CFG
file, refer to MAC-local CFG File.
Topics
Quick Login Configuration
Web Server Type Configuration
Quick Login Configuration
You can access the web user interface quickly using the request URI. It will locate you in the Status web page after
accessing the web user interface. It is helpful to quickly log into the web user interface without entering the username and password on the login page.
89
Phone Provisioning
Note: Accessing the web user interface by request URI may be restricted by the web explorer (for example, Internet
Explorer).
For security purposes, we recommend that you use this feature in a secure network environment.
The following table lists the parameters you can use to configure quick login.
Parameter
Description
Permitted
Values
Default
Parameter
Description
Permitted
Values
Default
wui.quick_login<y0000000000xx>.cfg
It enables or disables the quick login feature.
Note: It works only if “static.wui.https_enable” is set to 1 (Enabled).
0-Disabled
1-Enabled, you can quickly log into the web user interface using a request URI (for example,
https://IP/api/auth/login?@admin:admin).
0
wui.secure_domain_list<y0000000000xx>.cfg
It configures the valid domain name to access the web user interface of the phone.
Multiple domain names are separated by semicolons.
Example:
wui.secure_domain_list = test.abc.com
You are only allowed to use test.abc.com or IP address to access the web user interface of the phone.
Note: To use a domain name to access the web user interface of the phone, make sure your DNS
server can resolve the domain name to the IP address of the phone.
String
If it is left blank, you are only allowed to use the IP address to access the web user interface of the
phone.
If it is set to “any”, you can use IP address or any domain name to access the web user interface of the
phone.
any
Web Server Type Configuration
Yealink phones support both HTTP and HTTPS protocols for accessing the web user interface. You can configure
the web server type. Web server type determines the access protocol of the web user interface. If you disable to
access the web user interface using the HTTP/HTTPS protocol, both you and the user cannot access the web user
interface.
The following table lists the parameters you can use to configure the web server type.
Parameter
Description
Permitted
Values
Default
Web UI
Parameter
Description
static.wui.http_enable
It enables or disables to access the web user interface of the phone over a non-secure tunnel (HTTP).
0-Disabled
1-Enabled
1
Network > Advanced > Web Server > HTTP
static.network.port.http
It configures the port used to access the web user interface of the phone over a non-secure tunnel
(HTTP).
[1]
[1]
<y0000000000xx>.cfg
<y0000000000xx>.cfg
90
Administrator’s Guide for W80 DECT IP Multi-Cell System
Permitted
Values
Default
Web UI
Parameter
Description
Permitted
Values
Default
Web UI
Parameter
Description
Permitted
Values
Default
Web UI
[1]
If you change this parameter, the phone will reboot to make the change take effect.
Integer from 1 to 65535
80
Network > Advanced > Web Server > HTTP Port (1~65535)
static.wui.https_enable
It enables or disables to access the web user interface of the phone over a secure tunnel (HTTPS).
0-Disabled
1-Enabled
1
Network > Advanced > Web Server > HTTPS
static.network.port.https
It configures the port used to access the web user interface of the phone over a secure tunnel
(HTTPS).
Integer from 1 to 65535
443
Network > Advanced > Web Server > HTTPS Port (1~65535)
[1]
[1]
<y0000000000xx>.cfg
<y0000000000xx>.cfg
Central Provisioning
Central provisioning enables you to provision multiple phones from a provisioning server that you set up, and maintain a set of boot files, configuration files and resource files for all phones in the central provisioning server.
The following figure shows how the phone interoperates with provisioning server when you use the centralized provisioning method:
91
Phone Provisioning
Yealink phones can obtain the provisioning server address during startup. Then the phones first download boot
files and configuration files from the provisioning server and then resolve and update the configurations written in
configuration files. This entire process is called auto provisioning. For more information on auto provisioning, refer
to Yealink SIP IP Phones Auto Provisioning Guide.
The phones can be configured to upload log files (log files provide a history of phone events), call log files and contact files to the provisioning server. You can also configure a directory for each of these three files respectively.
Topics
Auto Provisioning Settings Configuration
Auto Provisioning Settings Configuration
The following table lists the parameters you can use to configure settings for auto provisioning.
Parameter
Description
Permitted
Values
Default
Web UI
Parameter
Description
static.auto_provision.attempt_expired_time<y0000000000xx>.cfg
It configures the timeout (in seconds) to transfer a file via auto provisioning.
Note: It has a higher priority than the value defined by the parameter “static.network.attempt_expired_
time”.
Integer from 1 to 300
20
Settings > Auto Provision > Attempt Expired Time(s)
static.network.attempt_expired_time
It configures the timeout (in seconds) to transfer a file for HTTP/HTTPS connection.
Note: It has a lower priority than the value defined by the parameter “static.auto_provision.attempt_
[1]
<y0000000000xx>.cfg
92
Administrator’s Guide for W80 DECT IP Multi-Cell System
expired_time”.
Permitted
Values
Default
Integer from 1 to 20
10
Parameter
Description
Permitted
Values
Default
Parameter
Description
Permitted
Values
Default
Parameter
Description
Permitted
Values
Default
static.auto_provision.attempt_before_failed<y0000000000xx>.cfg
It configures the maximum number of attempts to transfer a file before the transfer fails during auto pro-
visioning.
Integer from 1 to 10
3
static.auto_provision.retry_delay_after_file_transfer_failed<y0000000000xx>.cfg
It configures the time (in seconds) to wait after a file transfer fails before retrying the transfer via auto
provisioning.
Integer from 0 to 300
5
static.auto_provision.reboot_force.enable
[1]
<y0000000000xx>.cfg
It enables or disables the phone to reboot after auto provisioning, even if there is no specific configuration requiring a reboot.
Note: It works only for the current auto provisioning process. If you want the phone to reboot after
every auto provisioning process, the parameter must be always contained in the configuration file and
set to 1.
If the phone reboots repeatedly after it is set to 1, you can try to set “static.auto_provision.power_on" to
0 (Off).
0-Disabled
1-Enabled
Blank
Parameter
Description
Permitted
Values
Default
Web UI
Parameter
Description
Permitted
Values
Default
Web UI
93
static.auto_provision.power_on<y0000000000xx>.cfg
It triggers the power on feature to on or off.
0-Off
1-On, the phone performs auto provisioning when powered on.
1-On, the phone performs an auto provisioning process weekly.
0
Settings > Auto Provision > Weekly
static.auto_provision.weekly_upgrade_interval<y0000000000xx>.cfg
It configures the time interval (in weeks) for the phone to perform auto provisioning.
If it is set to 0, the phone performs auto provisioning at the specific day(s) configured by the parameter
“static.auto_provision.weekly.dayofweek” every week.
If it is set to other values (for example, 3), the phone performs auto provisioning at a random day
between the specific day(s) configured by the parameter “static.auto_provision.weekly.dayofweek”
every three weeks.
Permitted
Values
Default
Web UI
Parameter
Description
Permitted
Values
Default
Note: It works only if “static.auto_provision.weekly.enable” is set to 1 (On).
Integer from 0 to 12
0
Settings > Auto Provision > Weekly Upgrade Interval(0~12week)
static.auto_provision.inactivity_time_expire<y0000000000xx>.cfg
It configures the delay time (in minutes) to perform auto provisioning when the phone is inactive at reg-
ular week.
If it is set to 0, the phone performs auto provisioning at random between a starting time configured by
the parameter “static.auto_provision.weekly.begin_time” and an ending time configured by the parameter “static.auto_provision.weekly.end_time”.
If it is set to other values (for example, 60), the phone performs auto provisioning only when it has
been inactivated for 60 minutes (1 hour) between the starting time and ending time.
Note: The phone may perform auto provisioning when you are using the phone during office hour. It
works only if “static.auto_provision.weekly.enable” is set to 1 (On). The operations on the handset will
not change the inactive status; only the functional operations related base station, such as calling, will
change the inactive status.
Integer from 0 to 120
0
94
Administrator’s Guide for W80 DECT IP Multi-Cell System
Web UI
Parameter
Description
Permitted
Values
Settings > Auto Provision > Inactivity Time Expire(0~120min)
static.auto_provision.weekly.dayofweek<y0000000000xx>.cfg
It configures the days of the week for the phone to perform auto provisioning weekly.
Example:
static.auto_provision.weekly.dayofweek = 01
If “static.auto_provision.weekly_upgrade_interval” is set to 0, it means the phone performs auto provisioning every Sunday and Monday.
If “static.auto_provision.weekly_upgrade_interval” is set to other value (for example, 3), it means the
phone performs auto provisioning by randomly selecting a day from Sunday and Monday every three
weeks.
Note: It works only if “static.auto_provision.weekly.enable” is set to 1 (On).
0,1,2,3,4,5,6 or a combination of these digits
0-Sunday
1-Monday
2-Tuesday
3-Wednesday
4-Thursday
5-Friday
Default
Web UI
Parameter
Description
Permitted
Values
Default
Web UI
Parameter
Description
Permitted
Values
6-Saturday
0123456
Settings > Auto Provision > Day of Week
static.auto_provision.weekly.begin_time
<y0000000000xx>.cfg
static.auto_provision.weekly.end_time
It configures the starting/ending time of the day for the phone to perform auto provisioning weekly.
Note: It works only if “static.auto_provision.weekly.enable” is set to 1 (On).
Time from 00:00 to 23:59
00:00
Settings > Auto Provision > Time
static.auto_provision.flexible.enable<y0000000000xx>.cfg
It triggers the flexible feature to on or off.
Note: The day within the period is based upon the phone's MAC address and does not change with a
reboot, whereas the time within the start and end is calculated again with every reboot. The timer
starts again after each auto provisioning.
0-Off
1-On, the phone performs auto provisioning at random between a starting time configured by the para-
meter "static.auto_provision.flexible.begin_time" and an ending time configured by the parameter "static.auto_provision.flexible.end_time" on a random day within the period configured by the parameter
"static.auto_provision.flexible.interval".
95
Phone Provisioning
Default
Web UI
Parameter
Description
Permitted
Values
Default
Web UI
Parameter
Description
Permitted
Values
Default
0
Settings > Auto Provision > Flexible Auto Provision
static.auto_provision.flexible.interval<y0000000000xx>.cfg
It configures the interval (in days) for the phone to perform auto provisioning.
The auto provisioning occurs on a random day within this period based on the phone's MAC address.
The phone performs auto provisioning on a random day (for example, 18) based on the phone's MAC
address.
Note: It works only if “static.auto_provision.flexible.enable” is set to 1 (On).
Integer from 1 to 1000
30
Settings > Auto Provision > Flexible Interval Days
static.auto_provision.flexible.begin_time<y0000000000xx>.cfg
It configures the starting time of the day for the phone to perform auto provisioning at random.
Note: It works only if “static.auto_provision.flexible.enable” is set to 1 (On).
Time from 00:00 to 23:59
02:00
Web UI
Parameter
Description
Permitted
Values
Default
Web UI
Parameter
Description
Permitted
Values
Settings > Auto Provision > Flexible Time
static.auto_provision.flexible.end_time<y0000000000xx>.cfg
It configures the ending time of the day for the phone to perform auto provisioning at random.
If it is left blank or set to a specific value equal to starting time configured by the parameter “static.auto_provision.weekly.begin_time”, the phone performs auto provisioning at the starting time.
If it is set to a specific value greater than starting time configured by the parameter “static.auto_provision.weekly.begin_time”, the phone performs auto provisioning at random between the starting time
and ending time.
If it is set to a specific value less than starting time configured by the parameter “static.auto_provision.weekly.begin_time”, the phone performs auto provisioning at random between the starting time
on that day and ending time in the next day.
Note: It works only if “static.auto_provision.flexible.enable” is set to 1 (On).
Time from 00:00 to 23:59
Blank
Settings > Auto Provision > Flexible Time
static.auto_provision.dns_resolv_nosys<y0000000000xx>.cfg
It enables or disables the phone to resolve the access URL of the provisioning server using download
libraries mechanism.
0-Disabled, the phone resolves the access URL of the provisioning server using the system mech-
anism.
1-Enabled
96
Administrator’s Guide for W80 DECT IP Multi-Cell System
Default
Parameter
1
static.auto_provision.dns_resolv_nretry<y0000000000xx>.cfg
It configures the retry times when the phone fails to resolve the access URL of the provisioning server.
Description
Note: For each different DNS server, it works only if “static.auto_provision.dns_resolv_nosys" is set to
1 (Enabled).
Permitted
Values
Default
Parameter
Integer from 1 to 10
2
static.auto_provision.dns_resolv_timeout<y0000000000xx>.cfg
It configures the timeout (in seconds) for the phone to retry to resolve the access URL of the pro-
visioning server.
Description
Note: For each different DNS server, it works only if “static.auto_provision.dns_resolv_nosys" is set to
1 (Enabled).
Permitted
Values
Default
[1]
If you change this parameter, the phone will reboot to make the change take effect.
Integer from 1 to 60
5
Setting Up a Provisioning Server
You can use a provisioning server to configure your phones. A provisioning server allows for flexibility in upgrading,
maintaining and configuring the phone. Boot files, configuration files, and resource files are normally located on this
server.
Topics
Supported Provisioning Protocols
Supported Provisioning Server Discovery Methods
Configuring a Provisioning Server
Supported Provisioning Protocols
Yealink phones support several transport protocols for provisioning:
l Trivial File Transfer Protocol (TFTP)
l File Transfer Protocol (FTP)
l Hyper Text Transfer Protocol – Secure (HTTPS)
l File Transfer Protocol – Secure (FTPS)
Note: There are two types of FTP methods—active and passive. The phones are not compatible with active FTP.
You can specify the transport protocol in the provisioning server address, for example, http://xxxxxxx. If not specified, the TFTP protocol is used.
Topic
Provisioning Protocols Configuration
Provisioning Protocols Configuration
The following table lists the parameter you can use to configure provisioning protocols.