GAI-TRONICS
VoIP Telephone Configuration Guide
Page 70 of 78
8.1
Structure of files used in the update process
8.1.1 Update control file
The update control file is a plain text file containing a maximum of 7 lines (not including
comments).
Comments are lines starting with #.
A typical file could be:
# Upgrade Titan telephones to v 2.1.00
server=192.168.9.253
bootfile=1193boot1_0.ece
bootrevision=1.00.00
codefile=1193code2_1.ece
coderevision=2.01.00
cfgfile=900-20-6612.cfg
cfgrevision=1.00.00
Where:
Server
is the IP address or FQDN of the TFTP server hosting the files to be downloaded.
Note that this allows redirection - it need not necessarily be the same server as that
containing the update control file itself.
Bootfile, codefile,
and
cfgfile
are the filenames to download from the TFTP server
Bootrevision, coderevision
and
cfgrevision
are the version numbers of the respective files,
which the telephone will check to determine whether an update is required (thereby avoiding
repeated downloads). A file will only be downloaded if the version number in the control file
does not match the corresponding version number currently in the telephone (shown on the
System Identification page).
Cfgrevision
should have a maximum length of 15 characters -
only the first 15 characters will be matched against the
parameter held in the phone.
It is not necessary to list all 3 files - in other words if only the configuration is to be updated
then the bootfile and code file need not be listed in the control file, but if a file is to be updated
then its revision number must be included.
NOTE -
the control file must always have a
blank line
at the end, to ensure that the fie is read
correctly
8.1.2 Configuration file
The configuration file is a plain text file containing a list of parameters and optional comments.
The configuration file is constructed as follows:
•
A configuration file may contain any number of parameters and comments.
•
Each parameter or comment must be on its own line.
•
Comments are lines starting with #.
•
Each parameter has 3 elements, combined together on a single line with no spaces
or other delimiters between them:
o
The parameter name
o
The web page permission string
o
The value to assign.
•
Parameters may be listed in any order.
•
The telephone processes the file from top to bottom, meaning that, if a parameter is
repeated in the file, the telephone will use the last setting it finds.
•
IMPORTANT -
the file must always have a
blank line
at the end, to ensure that it is
read correctly
Parameters are listed in the configuration parameter descriptions in section 4.4 of this
manual. Note that these are case-sensitive and must be typed exactly as they appear in
section 4.4.