THOMSON TR-069 - Configuration Update Mechanism

E-DOC-CTC-20071119-0003 v1.0
42
3| Firmware Upgrade
and Configuration Upda
te
3.2.1 Configuration Update Mechanism
Why configuration update?
A configuration update focuses on management of the home network. It is used to configure the CPE services
and (typically router) features that apply to the home network functionality.
File types
For a configuration update, one of the following file types can be used:
 Configuration file (user.ini)
 Script file (*.STS)
File name length
The length of a file name of a file that must be downloaded via a Download RPC is limited to 12 characters:
 8 characters for the part before the “.”
 The dot “.”
 3 characters for the file name extension
Description
First, the CPE receives a Download RPC from the ACS. If the FileType argument is set to “3 Vendor
Configuration File”, a configuration update is started.
A configuration update includes following steps:
1 The CPE downloads the file at the File URL and locally saves it on Flash in the /dl directory.
2 The downloaded file is loaded, without saving the new configuration.
This corresponds to CLI command
:config load filename=<downloaded file>.
3 The CPE establishes a new transaction session with the ACS sending an Inform with at least the Transfer
Complete event.
 If the CPE can connect to the ACS and the ACS responds with an InformResponse:
1 The CPE saves the new configuration to user.ini.
This corresponds to CLI command
:saveall.
2 The downloaded file on Flash in the /dl directory is deleted.
 If the CPE cannot connect to the ACS or authentication of the CPE fails or the ACS does not respond
with an InformResponse, a roll-back mechanism is started:
1 The user.ini file is loaded to undo the configuration changes performed by the downloaded file.
This corresponds to CLI command
:config load filename=user.ini.
2 The downloaded file on Flash in the /dl directory is deleted.
3 The CPE establishes a new transaction session with the ACS. In this case, the TransferComplete
method reports a fault. The TransferComplete method is used by the ACS to learn whether or not
the configuration file was applied.
For more information on configuration files and script files, see “3.2.2 STS Files” on page 44.