- 64 -
The general configuration file contains settings that are required by every HD10X in the system. The
filename format is: General file: <model>.cfg
If the provisioning URL specifies a path only with no filename, then by default the HD10X will fetch both
files.
However, if the provisioning URL specifies both a path and filename, then the HD10X will only fetch
the single configuration file specified.
The general files can contain any of the available configuration settings. A setting can appear in the
general configuration file. If a setting appears in the file, the setting that is read last is the one that
applies.
You can configure a setting for most of your HD10X phones in the general file, and then overwrite that
setting for just a few HD10X phones.
6.3 Data Files
The configuration file can also include links to data files for product customization. Allowed data types
include the following:
◼ Directory (contacts, blacklist) in .xml format
◼ Certificates (server, provisioning) in .pem format
Links to data files are in the configuration file's "file" module. This is where you enter any URLs to the
data files that the HD10X phone may require.
None of the data files is export when you export a configuration file from the HD10X. However, you can
export a Directory or Blacklist .xml file using the Web Portal. After modifying the .xml file, you can use
the configuration file "file" module to have the HD10X import the new file.
6.4 Configuration File Tips and Security
All configuration settings are initially stored in a configuration template file. Copy, rename, and edit the
template file to create a general configuration file. You can store the general configuration file on your
provisioning server.
Do not modify the configuration file header line that includes the model and firmware version.
To save your time and effort, consider which settings will be common to all (or the majority of) HD10X
phones. Such settings might include call settings, language, and NAT settings. You can then edit those
settings in the configuration template and save it as the general configuration file.
6.4.1 Clearing Parameters with %NULL in Configuration File
For configuration file parameters that can have a text string value, you can clear the value of the
parameter by applying the value %NULL in the configuration file.
For example: sip_account.1.display_name = %NULL
However, the following parameter is an exception. Applying the value %NULL to this parameter will
reset it to its default value.
◼ file.hs_idle_logo - applying %NULL restores the default value ( logo)
6.5 TFTP Pull Down Method
Another way to configure your phone is to use the TFTP Pull Down Method. With this method, you can
update your phone with a configuration file from one of the following sources:
◼ DHCP option 66 server