CHAPTER47 Automatic Provisioning
Mediant 1000 Gateway & E-SBC | User's Manual
# configure system
(config-system)# automatic update
(automatic-update)# auto-firmware https://JoeD:1234@10.1.1.1/mysw.cmp
If you have not included the username and password in the parameters used for configuring the
URL of the server with the name of the file that you want downloaded, the device uses the
username and password that you configured for the ini file parameter [AUPDUserPassword] or CLI
command configure system > automatic-update > credentials.
Querying Provisioning Server for Updated Files
Each time the Automatic Update feature is triggered, for each file and its configured URL the device
does the following:
1. If you have configured the device to authenticate itself to the HTTP/S server for secure
access, the device sends the access authentication username and password to the HTTP/S
server (for more information, see Access Authentication with HTTP Server). If authentication
succeeds, Step 2 occurs.
2. The device establishes an HTTP/S connection with the URL host (provisioning server). If the
connection is HTTPS, the device verifies the certificate of the provisioning server, and
presents its own certificate if requested by the server.
3. The device queries the provisioning server for the requested file by sending an HTTP Get
request. This request contains the HTTP User-Agent Header, which identifies the device to the
provisioning server. By default, the header includes the device's model name, MAC address,
and currently installed software and configuration versions. Based on its own dynamic
applications for logic decision making, the provisioning server uses this information to check if
it has relevant files available for the device and determines which files must be downloaded
(working in conjunction with the HTTP If-Modified-Since header, described further on in this
section).
You can configure the information sent in the User-Agent header, using the
[AupdHttpUserAgent] parameter or CLI command, configure system > http-user-
agent. The information can include any user-defined string or the following supported string
variable tags (case-sensitive):
● <NAME>: product name, according to the installed License Key
● <MAC>: device's MAC address
● <VER>: software version currently installed on the device, e.g., "7.00.200.001"
● <CONF>: configuration version, as configured by the ini file parameter, [INIFileVersion] or
CLI command, configuration-version
The device automatically populates these tag variables with actual values in the sent header.
By default, the device sends the following in the User-Agent header:
User-Agent: Mozilla/4.0 (compatible; AudioCodes;
<NAME>;<VER>;<MAC>;<CONF>)
For example, if you configure [AupdHttpUserAgent] to "MyWorld-<NAME>;<VER>(<MAC>)",
the device sends the following User-Agent header:
User-Agent: MyWorld-Mediant;7.00.200.001(00908F1DD0D3)
- 898 -