GAI-Tronics VoIP Telephone Software Configuration Guide - Manual (Page 53)

GAI-TRONICS
VoIP Telephone Configuration Guide Page 53 of 88
6. Configuration File update
GAI-Tronics VoIP telephones can be updated by downloading files from a server. This
provides a powerful method of updating multiple units across a network. Security features are
built in to reduce the possibility of accidental or malicious damage. All 3 components of the
unit’s software can be upgraded:
• The configuration (equivalent to the settings on the web pages)
• The
firmware
• The kernel (effectively the operating system on which the firmware runs)
These 3 elements can be downloaded independently, with the exception that if the kernel is
updated, the firmware must be updated at the same time, since it references the kernel
version.
The update process is as follows:
1. The telephone has 4 parameters that control updates (on the UNIT page):
• SERVER: the IP address of the host running the TFTP server
• FILE: the name of the update control file on the server
• INTERVAL: a period in hours between download attempts
• CONFIGID: used to identify the current configuration
2. Note that the update is initiated by the telephone. It can also be done on demand by
clicking the “Update now” button on the UNIT page. After the update occurs the
telephone will reset itself to activate the update - this means that web pages will be
unavailable for a few seconds.
3. The update control file is a small text file containing up to 13 lines, each of which starts
with a keyword. Normal routine updates would be configuration changes only, when the
update control file would contain only 4 lines. An example file would be:
USERNAME=user
PASSWORD=password
CONFIGVERSION=18but7
CONFIGFILE=VoIP3.cfg
Where:
USERNAME & PASSWORD are used by the unit to decide if this is a valid update.
CONFIGVERSION is the string that will be checked to see if the configuration needs
upgrading. (If this matches CONFIGID in the telephone, no update will be carried out)
CONFIGFILE is the configuration file to upgrade to.
4. The configuration file itself is again a text file, composed with a fixed syntax (see section
6.1 below). An example of a simple configuration file to change 4 memories and put them
into 2 memory lists (the same example as shown in the FAQs at the start of this guide) is
shown below:
[DIALPLAN]
MEMORY=1 888
MEMORY=2 sip:[email protected]
MEMORY=3 sip:[email protected]
MEMORY=4 [email protected]
COMFORT=1 888
COMFORT=2 223344
COMFORT=3 223344
COMFORT=4 223344
LIST=1 2, 3, 4
LIST=2 1
WAKEANDDIAL=1 ON
WAKEANDDIAL=2 ON
[UNIT]
CONFIGID=18but7
Note that the configuration file is divided into sections, with each section header in square
brackets. Note that the CONFIGID in the UNIT section is used to change the CONFIGID
in the phone to the CONFIGVERSION in the update control file. This provides an
indication for the current configuration in the telephone itself, and prevents repeated
downloading of the same file triggered by the UPDATEINTERVAL.
3XE  D