User manual GRANDSTREAM GXV2100 XML PROVISIONING GUIDE 12-2010

[. . . ] Grandstream Networks, Inc. XML Provisioning Guide GXV3140/GXV3175 IP Multimedia Phone GXV21XX/GXP14XX Enterprise IP Phone www. grandstream. com TABLE OF CONTENTS XML PROVISIONING GUIDE OVERVIEW . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3 PROVISIONING FLOW . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . [. . . ] www. grandstream. com XML Provisioning Guide Page 2 of 5 Last Updated: 12/2010 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 (firmware 1. 0. 3. 24 and above) IP Multimedia Phone · GXV3175 IP Multimedia Phone · GXP21XX/GXP14XX Enterprise IP phones · HT50X Analog Telephone Adapters · GXW40XX FXS IP Analog Gateways PROVISIONING FLOW Start provisioning Request legacy config file cfgMAC Parse and apply new configurations Request XML config file cfgMAC. xml Done Parse and apply new configurations 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/support/configurationtool. html Example XML configuration file (cfgxxxxxxxxxxxx. xml): <?xml version="1. 0" encoding="UTF-8" ?> <gs_provision version="1"> <mac>000b82123456</mac> Grandstream Networks, Inc. www. grandstream. com XML Provisioning Guide Page 3 of 5 Last Updated: 12/2010 <config version="1"> <P271>0</P271> <P270>Account name</P270> </config> </gs_provision> The mac element is not mandatory. It is designed this way because not all provision systems support MAC address. If it is present, the provision program will validate the mac element with the actual MAC address on the device. XML FILE ENCRYPTION The XML configuration file may be encrypted using AES-256-CBC algorithm. [. . . ] This is the industry standard approach and has the strongest safety. Grandstream Networks, Inc. www. grandstream. com XML Provisioning Guide Page 5 of 5 Last Updated: 12/2010 [. . . ]