Top
Basic CWMP Concepts
TR-069 or CPE WAN Management Protocol (CWMP)
The Technical Report 069 (TR-069), also known as CWMP, is a Broadband Forum technical specification. This protocol can be used to monitor and update the Mediatrix unit configurations and firmware. In other words, when using TR-069, the Mediatrix unit can get in contact with an Auto Configuration Server (ACS) to initiate a configuration script transfer/execution and a firmware upgrade.
The first time the Mediatrix unit is connected to the network, it will attempt to contact the Auto Configuration Server (ACS), which is the entry point for the administrator. The Mediatrix unit will obtain the URL of the ACS using either the DHCP server with option 43 or by retrieving the information directly from the Customer's Profile. Therefore, upon start-up, the Mediatrix unit will contact the ACS, which in return will send the required configuration files and initiate, if necessary, a firmware update. This automated sequence is what is referred to as zero-touch, as the Mediatrix unit is automatically configured by the ACS according to the instructions given by the administrator without manual intervention on the unit.
- verify if new configurations are available,
- verify if a new firmware update is available and
- send notifications for monitoring purposes.
- Passive: the information is sent according to the schedule.
- Active: the information is sent immediately when a parameter status changes, regardless of the periodic schedule.
Furthermore, the administrator can initiate a connection to the Mediatrix unit to perform immediate maintenance or monitoring. This will only be possible if the NAT firewall has been configured to allow communications initiated by the ACS.
The TR-069 protocol can be activated on units that are already deployed with a licence key (For more details on licences refer to theTechnical Bulletin - How to activate a licence on a Mediatrix unit published on the Media5 Documentation Portal). However, it can be enabled/disabled for a specific configuration via the Management interface.
- SetParameterValues
- GetParameterValues
- AddObject
- DeleteObject
- Download
- Reboot
- Upload
- FactoryReset
Top
TR-104
The Technical Report 104 (TR-104) describes the data model for provisioning of a voice-over-IP (VoIP) CPE device by an Auto Configuration Server (ACS) using the mechanism defined in TR-069. Configuring the TR-104 parameters in DGW allows you to enable or disable the provisioning parameters for VoIP CPE, such as calls statistics.
- The Media5 implementation of TR-104 is limited to the SIPEndpoint profile.
- Active notifications are not supported for all objects except when explicitly mentioned. (for more details request the Supported TR-069 Methods and Parameters document from your representative).
- Only FXS lines can be managed by the TR-104 profile.
- BRI, PRI or FXO lines are not supported by the TR-104 profile.
- A single voice profile is supported, it is instantiated by default. No creation or deletion of voice profile is allowed.
- Only a subset of parameters is currently supported.
- When TR-104 is used, it is highly recommended not to use other means of configuration (since TR-104 assumes some configuration).
Top
TR-106
Technical Report 106 (TR-106) is the Data Model Template for TR-069-Enabled Devices. The configuration of the TR-106 Network Interface parameter in DGW allows you to specify the network interface to be used for the TR-106 LAN profile to report network statistics.
- If no network interface is configured for TR-106, i.e. the field is left empty under Management/Misc/CWMP, the Mediatrix unit will use the network interface configured under Management/Misc/System Management/Network Interface.
- If the network interface configured for TR-106 is set to All, the Mediatrix unit will use the
network interface configured for contacting the ACS in the TR-106 Configuration section of the
CWMP Configuration table. The
TR-106 Data Model template can only be used if Root Element is set to
Device. Refer to Configuring the Report Network Statistics
(Through the TR-106 Data Model).Note: This parameter can also be set via Cwmp.RootElement.
The TR-106 Data Model template can only be used if the Cwmp.RootElement parameter value is Device.
Top
TR-111
Technical Report 111 (TR-111) allows the remote management of home networking devices through NAT traversal mechanisms, as defined in TR-069 Annex G (formerly in TR-111).
The TR-111 parameters defined in DGW allows the activation and configuration of a STUN server, so devices behind a NAT can be reached .
Top
Basic Tasks
Configuring the Access to the Auto Configuration Server (ACS)
Top
Configuring the CWMP Establishment (TR-069)
- Go to Management/CWMP.
-
In the CWMP Configuration table, set
the following parameters:

Top
Configuring VoIP Provisioning (TR-104 Data Model)
- Go to Management/CWMP.
- In the CWMP Configuration table, under the TR-104 Configuration section, from the drop down list, select Enable.
- Click Apply.
Top
Configuring the Access to the STUN Server TR-111
- Go to Management/CWMP.
- In the CWMP Configuration table, under the TR-111 Configuration section, complete the fields as required.
- Click Apply.
Top
Configuring the Report Network Statistics (Through the TR-106 Data Model)
The TR-106 Data Model template can only be used if the Cwmp.RootElement parameter value is Device.
- Go to Management/CWMP.
-
In the CWMP Configuration table,
under the TR-106 Configurationsection,
in the Network Interface field indicate the network interface referred by the TR-106 LAN
profile.
- If left empty, use the network interface configured in the Hoc.ManagementInterface parameter.
- If the Hoc.ManagementInterface parameter is set to All, use the network interface used for contacting the ACS.
- Click Apply.
Top
Advanced CPE WAN Management Protocol (CWMP) Parameters
- using a MIB browser
- using the CLI
- creating a configuration script containing the configuration parameters
For ACS
- To set the parameter type validation when the ACS assigns a value to a parameter Cwmp.interopParameterTypeValidation
- To set the access mode to the local log table from the ACS: Cwmp.NlmLocalLogLogEnable
- To define the username to authenticate an ACS making a connection request to the CPE: Cwmp.ConnectionRequestUsername
- To define the password to authenticate an ACS making a connection request to the CPE: Cwmp.ConnectionRequestPassword
For TR-069 (CWMP) establishment
- To set the HTTPS transport cipher suite configuration for TR-069 (CWMP): Cwmp.TransportHttpsCipherSuite .
- To set the HTTPS Transport Tls Version configuration for TR-069 (CWMP): Cwmp.TransportHTTPSTlsVersion.
- To set the level of security to use when validating the server's certificate when connecting to the ACS using HTTPS: Cwmp.TransportCertificateValidation
For TR-111
- To set the period range, in seconds, at which STUN Binding Requests must be sent by the unit for the purpose of maintaining the STUN connection: Cwmp.tr111StunKeepAlivePeriod. The current implementation does not allow a range. The minimum and maximum values must be the same.
- To set the value of the STUN username attribute to be used in Binding Requests: Cwmp.tr111StunUsername
- To set the level of security to use when validating the server's certificate when connecting to the ACS using HTTPS: Cwmp.TransportCertificateValidation
For the MAC address
- To set the MAC address format: Cwmp.InteropMacAddressFormat.
Top
Supported TR-069 Methods and Parameters
Data Model and Reference Guide
- TR-069 Mediatrix DataModel: Documents the TR-069, TR-104, and TR-106 standard data models, along with the Mediatrix proprietary data model.
- Reference Guide: Documents the complete set of parameters and commands from the different DGW services.
Top
CwmpEx Special Parameters
- CwmpEx.Command
- CwmpEx.LastResult
They are documented in the TR-069 Mediatrix DataModel document.
Top
DGW Documentation
Mediatrix devices are supplied with an exhaustive set of documentation.
Mediatrix user documentation is available on the Media5 Documentation Portal.
- Release notes: Generated at each GA release, this document includes the known and solved issues of the software. It also outlines the changes and the new features the release includes.
- Configuration notes: These documents are created to facilitate the configuration of a specific use case. They address a configuration aspect we consider that most users will need to perform. However, in some cases, a configuration note is created after receiving a question from a customer. They provide standard step-by-step procedures detailing the values of the parameters to use. They provide a means of validation and present some conceptual information. The configuration notes are specifically created to guide the user through an aspect of the configuration.
- Technical bulletins: These documents are created to facilitate the configuration of a specific technical action, such as performing a firmware upgrade.
- Hardware installation guide: They provide the detailed procedure on how to safely and adequately install the unit. It provides information on card installation, cable connections, and how to access for the first time the Management interface.
- User guide: The user guide explains how to customise to your needs the configuration of the unit. Although this document is task oriented, it provides conceptual information to help the user understand the purpose and impact of each task. The User Guide will provide information such as where and how TR-069 can be configured in the Management Interface, how to set firewalls, or how to use the CLI to configure parameters that are not available in the Management Interface.
- Reference guide: This exhaustive document has been created for advanced users. It includes a description of all the parameters used by all the services of the Mediatrix units. You will find, for example, scripts to configure a specific parameter, notification messages sent by a service, or an action description used to create Rulesets. This document includes reference information such as a dictionary, and it does not include any step-by-step procedures.
Top
Online Help
If you are not familiar with the meaning of the fields and buttons, click Show Help, located at the upper right corner of the Web page. When activated, the fields and buttons that offer online help will change to green and if you hover over them, the description will bedisplayed.
Top
Copyright Notice
Copyright © 2023 Media5 Corporation.
This document contains information that is proprietary to Media5 Corporation.
Media5 Corporation reserves all rights to this document as well as to the Intellectual Property of the document and the technology and know-how that it includes and represents.
This publication cannot be reproduced, neither in whole nor in part, in any form whatsoever, without written prior approval by Media5 Corporation.
Media5 Corporation reserves the right to revise this publication and make changes at any time and without the obligation to notify any person and/or entity of such revisions and/or changes.