File Location for Automatic Update

The files for updating the device can be stored on any standard Web (HTTP/S), TFTP, or FTP server. The files can be loaded periodically to the device using HTTP/S, TFTP, or FTP. This mechanism can be used even when the device is installed behind NAT and firewalls. The Automatic Update feature is done per file and configured by specifying the file name and URL address of the provisioning server where the file is located. If the device needs to authenticate itself with the server, you can use the same parameters to configure the authentication username and password (for more information, see Access Authentication with HTTP Server). For a description of the parameters for configuring the URLs of the servers of the files, see Automatic Update Parameters.

Below are examples for configuring the file names and their URLs for Automatic Update:

■

ini File:

IniFileURL = 'http://www.corp.com/configuration.ini'
CptFileURL = 'http://www.corp.com/call_progress.dat'
AutoCmpFileUrl = 'http://www.corp.com/SIP_F7.20A.008.cmp
FeatureKeyURL = 'https://www.company.com/License_Key.txt'

■

CLI:

# configure system
(config-system)# automatic-update
(auto-update)# cli-script https://company.com/cli/<MAC>
(auto-update)# startup-script https://company.com/startup/<MAC>
(auto-update)# ini-file http://www.company.com/configuration.ini
(auto-update)# call-progress-tones http://www.company.com/call_progress.dat
(auto-update)# feature-key http://www.company.com/License_Key.txt
(auto-update)# auto-firmware http://www.company.com/SIP_F7.20A.008.cmp

The URL of the HTTP server where the files are located can include an IPv6 address or a host name (FQDN) which is resolved into an IPv6 address by a DNS server. The IPv6 URL must be enclosed in square brackets:

■

URL with host name (FQDN) for DNS resolution into an IPv6 address:

http://[FQDN]:<port>/<filename>

■

URL with IPv6 address:

http://[IPv6 address]:<port>/<filename>

An example of an IPv6 URL for Automatic Update is shown below:

(auto-update)# firmware http://[2000::1]:80/F7.20A.222.0070.cmp

●

For configuration files, the file name in the URL can automatically contain the device's MAC address for enabling the device to download a file unique to the device. For more information, see MAC Address Placeholder in Configuration File Name.

●

When using the [IniFileURL] parameter, parameters not included in the file are restored to default settings. If you want to keep the settings of these parameters, use the [IncrementalIniFileURL] parameter instead.

●

You can provision the device with a Configuration Package file that contains all the device's certificates (automatic update > configuration-pkg). If this file contains the certificates, it's password-protected (encrypted) and therefore, you need to specify the password (automatic update > default-configuration-package-password). For more information on this file, see Saving and Loading a Configuration Package File.