User guide

SwUpdate module Software update
1-67
iMG/RG Software Reference Manual (System Configuration)
By default SwUpdate module is set to work in TFTP mode trying to get all the TFTP server parameters from
the DHCP parameters list option passed by the external DHCP server
When working in TFTP mode, the gateway requires that the IP interface connected to the swupdate network is
set dynamically. Swupdate will use the feature of the dhcpclient to request the DHCP option 66 (“tftp-file-
name”) and the DHCP option 60 (dhcp-class-identifier).
The swupdate module will then use the tftp-file-name option and the DHCP filename field value passed in the
DHCP ACK message to set the TFTP server address and the server path respectively.
During the interface IP address discover or renewal, the DHCP client notifies to the server the Residential gate-
way model type and MAC address in the dhcp-class-identifier and dhcp-client-identifier options respectively.
Notification of dhcp-class-identifier and dhcp-client-identifier options allow DHCP server to discover dynami-
cally the type of unit and perform selective choice of TFTP server parameters (for example select a different
server path to download different code versions or different unit configuration files).
Note: The swupdate module needs the dhcp-class-identifier option to be present in the DHCP ACK message
with the same value sent in the DHCP Discover and Request messages. If this value is different or the
option is not present, the swupdate doesn’t start.
1.4.3.6 Server access
FTP server account
SwUpdate is able to access FTP server using the server access login.
The FTP server login account and login password are configurable into the SwUpdate module.
FTP/TFTP working directory
SwUpdate is able to navigate into the FTP/TFTP server directory.
The working directory can be specified defining in the SwUpdate module a parameter named path. It identifies
the relative path respect the login home directory where the SwUpdate module expects to found the files.
For example if the home directory is:
/home/manager
and the gateway path address is set to:
at-iMG616BD-software-xxx
the working directory will be:
/home/manager/at-iMG616BD-software-xxx
The working directory can be specified also using the gateway MAC address in the format:
aa_bb_cc_dd_ee_ff.
In this case the working directory will be the login home directory plus the MAC address.