Grandstream SIPDeviceProvisioning User Manual
Grandstream Networks, Inc.
SIP Device Provisioning Guide
www.grandstream.com
TABLE OF CONTENTS
SIP DEVICE PROVISIONING GUIDE
OVERVIEW ......................................................................................................................................................... 3
PROVISIONING FLOW ......................................................................................................................................... 3
CONFIGURATION PARAMETERS ......................................................................................................................... 4
GENERATE CONFIGURATION FILES...................................................................................................................... 4
TFTP OR HTTP/HTTPS FOR CONFIGURATION FILE ................................................................................................ 4
CONFIGURATION FILE ENCRYPTION .................................................................................................................... 4
FIRMWARE AND CONFIGURATION FILE PREFIX AND POSTFIX ............................................................................. 4
FIRMWARE SERVER AND CONFIGURATION FILE SERVER ..................................................................................... 5
MANAGING FIRMWARE AND CONFIGURATION FILE DOWNLOAD ....................................................................... 5
PRE-CONFIGURATION AND CONFIGURATION REDIRECTION ................................................................................ 6
AUTOMATIC PROVISIONING WITHIN LAN ........................................................................................................... 6
XML PROVISIONING SCHEMA AND EXAMPLE FILE............................................................................................... 7
XML FILE ENCRYPTION ....................................................................................................................................... 8
SECURE PROVISIONING ...................................................................................................................................... 9
TABLE OF FIGURES
SIP DEVICE PROVISIONING GUIDE
FIGURE 1: PROVISIONING FLOW. ................................................................................................................................ 3
FIGURE 2: USING WEB UI TO DEFINE THE XML CONFIGURATION FILE PASSWORD ................................................................... 8
Grandstream Networks, Inc. SIP Device Provisioning Guide Page 2 of 9
www.grandstream.com Last Updated: 9/2012
OVERVIEW
Start
provisioning
Request
legacy
config file
cfgMAC
Parse and
apply new
configurations
Parse and
apply new
configurations
Request XML
config file
cfgMAC.xml
Done
cfgMAC.xml
download
successful?
Request XML
config file
cfg.xml
Parse and
apply new
configurations
No
Yes
Grandstream SIP Devices can be configured via Web Interface as well as via Configuration File
through TFTP or HTTP/HTTPS download. All Grandstream SIP devices support a proprietary
binary format configuration file. Product families such as GXP21xx/14xx/11xx, GXV31xx,
HT50x, HT70x, GXW40xx and DP71x accept configuration files in XML format in addition to
the legacy proprietary binary format. The XML provisioning implementation also allow generic
XML configuration file on top of the MAC based configuration file.
When Grandstream device boots up or reboots, it issues a request for a configuration file named
“cfgMAC”, where “MAC” is the MAC address of the device, for example “cfg000b820102ab”. The
configuration file name should be in lower case. The file “cfgMAC” is a proprietary binary format
configuration file that must be generated by Grandstream configuration tools. For devices that
support XML provisioning, they will also issue a request for a XML configuration file
“cfgMAC.xml”.
PROVISIONING FLOW
Figure 1: Provisioning Flow.
Grandstream Networks, Inc. SIP Device Provisioning Guide Page 3 of 9
www.grandstream.com Last Updated: 9/2012
Loading...