Administrator’s Guide for SIP-T2 /T3 /T4 /T5 /CP920 IP Phones
327
Local Contacts Backup
Yealink phones support storing all local contacts to a contact file named <MAC>-contact.xml. You can back up this
file to the server, avoiding data loss. Once the contacts update, the phone will automatically upload this file to the
provisioning server or a specific server. If a contact file exists on the server, this file will be overridden. The phone
will request to download the <MAC>-contact.xml file according to its MAC address from the server during auto pro-
visioning.
The contact file 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 contact file is 00156574B150-contact.xml (uppercase).
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 phone.
The following table lists the parameters you can use to back up the local contacts.
Parameter
static.auto_provision.local_contact.backup.enable <y0000000000xx>.cfg
Description
It enables or disables the phone to upload the <MAC>-contact.xml file to the server each time the con-
tacts update and download the <MAC>-contact.xml file from the server during auto provisioning.
Note
: It does not affect the downloading of the contact avatar/icon files.
Permitted
Values
0
-Disabled, the phone will not upload the contact file “<MAC>-contact.xml” to the server, so the IP
phone downloads the contacts in the “contact.xml” from the access URL configured by the parameter
“local_contact.data.url” or “local_contact.data_photo_tar.url” during auto provisioning.
1
-Enabled, the phone uploads the contact file “<MAC>-contact.xml” to the specific path configured by
the parameter “static.auto_provision.local_contact.backup.path” each time the contacts update; and
downloads the contacts in the “<MAC>-contact.xml” according to its MAC address from the specific
path during auto provisioning.
Default
0
Parameter
static.auto_provision.local_contact.backup.path
<y0000000000xx>.cfg
Description
It configures a path or URL for the phone to upload/download the <MAC>-contact.xml file.
If it is left blank, the phone connects to the provisioning server URL, and uploads/downloads the con-
tact file “<MAC>-contact.xml”.
Example
:
static.auto_provision.local_contact.backup.path = http://192.168.1.20/contact
Once the contacts update, the phone will upload the contact file to the specified path
“http://192.168.1.20/contact”.
During auto provisioning, the phone downloads the contact file “<MAC>-contact.xml” from the spe-
cified path “http://192.168.1.20/contact”.
Note
: It works only if “static.auto_provision.local_contact.backup.enable” is set to 1 (Enabled).
Permitted
Values
String
Default
Blank
Parameter
static.auto_provision.custom.upload_method
<y0000000000xx>.cfg
Description
It configures the way the phone uploads the <MAC>-local.cfg file, <MAC>-calllog.xml file or <MAC>-
contact.xml file to the provisioning server (for HTTP/HTTPS server only).
Permitted
Values
0
-PUT
1
-POST
