IP Phone User Manual
Grandstream Networks, Inc. XML Provisioning Guide Page 3 of 5
www.grandstream.com Last Updated: 7/2011
OVERVIEW
The XML provisioning system allows Grandstream phones to perform configuration updates via XML
configuration files. In addition, the XML provisioning implementation may also allow generic XML
configuration file on top of the MAC based configuration file.
Note: Currently, XML provisioning is supported on the following Grandstream products:
• GXV3140 IP Multimedia Phone
• GXV3175 IP Multimedia Phone
• GXP21XX/GXP14XX Enterprise IP phones
• HT50X Analog Telephone Adapters
• GXW40XX FXS Analog IP Gateways
PROVISIONING FLOW
Figure 1: Provisioning Flow.
The provision program on the phone will apply and reload the settings after downloading the legacy
binary cfgMAC config file. This means that a provision/re-direction server can redirect the device to a XML
provision server without reboot. It can also be used to send the XML encryption password
.
XML SCHEMA AND EXAMPLE FILE
The general XML syntax consists of a list of name-value pairs. P-Value is the element and the value of
the element is represents the value for that particular configuration that the corresponding P-Value
represents. For the complete P-value list, please refer to the legacy configuration templates at
http://www.grandstream.com/index.php/support/tools
Example XML configuration file (cfgxxxxxxxxxxxx.xml):
<?xml version="1.0" encoding="UTF-8" ?>
Start
provisioning
Request
legacy
configfile
cfgMAC
Parseand
applynew
configurations
Parseand
applynew
configurations
RequestXML
config
file
cfgMAC.xml
Done