Anchor | ||||
---|---|---|---|---|
|
Anchor | ||||
---|---|---|---|---|
|
How to Use TR069
on Htek IP Phones
Version 2.0.4.4.24
Feb. 2018
TR069 feature
This technote mainly provides a general introduction of TR069 (Technical Report 069) and the way of enabling the TR069 on the Htek IP phones. The information in this document is restricted to the following Htek IP phone models with firmware version 1.0.3.85 or later:
TR069 introduction
Anchor | ||||
---|---|---|---|---|
|
Why to use TR069?
TR069 is an application layer protocol, which has broad applicability and no access restriction. TR-69 standard allows the subscriber to manage all devices on a common platform regardless of its device type and manufacturer. Its specifications ensure that the device can be easily and securely configured, activated and managed from a console in the service provider's network. This allows the service provider to provide an efficient and cost effective deployment of services.
Configure the TR069 feature on the IP phone
TR069 feature is disabled on the IP phone by default. You can enable or disable the TR069 feature using the configuration files or web interface.
To configure TR069 using the Anchor OLE_LINK107 OLE_LINK107
configuration files: Anchor OLE_LINK108 OLE_LINK108
- Set the following parameters:
Web Setting Path
Permitted Values
Descriptions
Parameter
Default Value
Anchor OLE_LINK89 OLE_LINK89
Setting->TR069->Anchor OLE_LINK90 OLE_LINK90 Anchor OLE_LINK87 OLE_LINK87
TR069 EnableAnchor OLE_LINK88 OLE_LINK88 Number: 0, 1
TR069 Enable (In Use). 0 - No, 1 - Yes
P8100
0
Anchor OLE_LINK93 OLE_LINK93
Setting->TR069-> ACS URLAnchor OLE_LINK94 OLE_LINK94 String
Specifies the URL of ACS used to establish the TR069 session with the ACS.
P8101
Blank
Anchor OLE_LINK95 OLE_LINK95
Setting->TR069-> ACS UsernameAnchor OLE_LINK96 OLE_LINK96 Anchor OLE_LINK91 OLE_LINK91
StringAnchor OLE_LINK92 OLE_LINK92 Specifies the username used for HTTP authentication against the ACS.
Anchor OLE_LINK97 OLE_LINK97
P8102Anchor OLE_LINK98 OLE_LINK98 Blank
Anchor OLE_LINK99 OLE_LINK99
Setting->TR069-> ACS PasswordAnchor OLE_LINK100 OLE_LINK100 String
Specifies the password used for HTTP authentication against the ACS.
P8103
Blank
Anchor OLE_LINK101 OLE_LINK101
Setting->TR069->Enable Periodic InformAnchor OLE_LINK102 OLE_LINK102 Number: 0, 1
Enables or disables the phone to report its configuration information to the ACS.0 –No,1 - Yes
P8104
0
Anchor OLE_LINK103 OLE_LINK103
Setting->TR069-> Periodic Inform Interval(seconds)Anchor OLE_LINK104 OLE_LINK104 Integer
Sets the interval (in seconds) to report its configuration information to the ACS.
P8105
60
Anchor OLE_LINK105 OLE_LINK105
Setting->TR069-> Connection Request UsernameAnchor OLE_LINK106 OLE_LINK106 String
Sets the username used to authenticate the incoming connection requests.
P8106
Blank
Setting->TR069-> Connection Request Password
String
Sets the password used to authenticate the incoming connection requests.
P8107
Blank
- Store the configuration files to the root directory of the configuration server.
To configure TR069 via web interface:
- Login the IP Phone's web
- Click Setting -> TR069
- Configure the parameters in the corresponding fields.
- Click Saveset button to accept the change.
After configurations, the phone establishes the TR069 session with the ACS.
Support TR069 RPC Methods:
The RPC (Remote Procedure Call) method defines a generic mechanism that is used for bi-directional communication between a CPE and an ACS. An ACS can get or set parameters to configure and monitor the CPE by using the RPC methods. The following table provides a description of RPC methods supported by the Htek IP phones:
RPC Method | Description |
GetRPCMethods | This method is used to discover the set of methods supported by the CPE. |
SetParameterValues | This method is used to modify the value of one or more CPE parameters. |
GetParameterValues | This method is used to obtain the value of one or more CPE parameters. |
GetParameterNames | This method is used to discover the parameters accessible on a particular CPE. |
GetParameterAttributes | This method is used to read the attributes associated with one or more CPE parameters. |
SetParameterAttributes | This method is used to modify attributes associated with one or more CPE parameters. |
Reboot | This method causes the CPE to reboot. |
Download | This method is used to cause the CPE to download a specified file from the designated location. |
Upload | This method is used to cause the CPE to upload a specified file to the designated location |
ScheduleInform | This method is used to request the CPE to schedule a one-time Inform method call (separate from its periodic Inform method calls) sometime in the future. |
FactoryReset | This method resets the CPE to its factory default state. |
TransferComplete | This method informs the ACS of the completion(either successful or unsuccessful) of a file transferinitiated by an earlier Download or Upload methodcall. |
AddObject | This method is used to add a new instance of anobject defined on the CPE. |
DeleteObject | This method is used to remove a particular instance of an object. |
The ACS supports a variety of functionalities to manage a collection of phones using the above RPC methods, the following primary capabilities are included.
Auto-configuration and dynamic service provisioning
The ACS can provision a phone or collection of phones based on a variety of criteria. Different phone models can be configured using the uniform parameters. Phone can be provisioned at the initial connection and re-provision at any subsequent time. The ACS can also check the provision status (success or failure).
Firmware image management
Phone firmware can be upgraded or downgraded by downloading the firmware file from the ACS. TR069 also provides mechanisms for version identification and file download initiation (ACS initiated downloads and optional phone initiated downloads). The ACS can be notified of the success or failure of a file downloading.
Status and performance monitoring
The ACS can use the GetParameterValues and GetParameterAttributes methods to monitor the phone's status and performance statistics. TR069 also defines a set of mechanisms that allow the phone to actively notify the ACS of changes to its state.
Diagnostics
For troubleshooting purposes, the phone can send diagnostic information such as network status to the ACS, or the ACS can execute the defined diagnostic tests to get the information from the phone.