TR-069 Parameters

The TR-069 parameters are described in the table below.

TR-069 Parameters

Parameter

Description

'TR-069'

configure system > cwmp > service

[TR069ServiceEnable]

Enables device management using TR-069.

■

[0] Disable (default)

■

[1] Enable

Note: For the parameter to take effect, a device reset is required.

'Data Model'

configure system > cwmp > data-model

[Tr069DataModel]

Defines the TR-069 Data Model.

■

[0] Device = (Default) TR-181

■

[1] InternetGatewayDevice = TR-098

'IPv6'

configure system > cwmp > ipv6

[Tr069IPv6Enable]

Enables the use of an IPv4 or IPv6 address for the TR-069 ACS.

■

[0] Disable = (Default) Allows the use of only an IPv4 address for the ACS:

✔

ACS URL is an FQDN: The device sends a DNS query for an IPv4 address only. If an IPv4 DNS resolution exists, the device connects to the ACS over IPv4. If no resolutions exists, the device doesn't connect and the 'ACS Connection Status' read-only field displays "Invalid configuration".

✔

ACS URL is an IP address: If it is an IPv6 address, the device doesn't connect to the ACS and the 'ACS Connection Status' read-only field displays "Invalid configuration". If it is an IPv4 address, the device connects to the ACS over IPv4.

■

[1] Enable = Allows the use of an IPv4 or IPv6 address for the ACS:

✔

ACS URL is an FQDN: The device sends DNS queries for an IPv6 and IPv4 address. If an IPv6 DNS resolution exists, the device connects to the ACS over IPv6. If an IPv4 DNS resolution exists, the device connects to the ACS over IPv4. If no DNS resolutions exists, the device doesn't connect to the ACS and the 'ACS Connection Status' read-only field displays "Invalid configuration".

✔

ACS URL is an IP address: If it is an IPv6 address, the device connects to the ACS over IPv6. If it is an IPv4 address, the device connects to the ACS over IPv4.

'VRF Name'

configure system > cwmp > vrf-name

[TR069VrfName]

Assigns a VRF to the TR-069 application.

The default is "main_vrf".

Note: This parameter is currently being phased out. Instead, configure the source interface (VRF or loopback interface) using the CLI command (cwmp-tr069)# source data.

'Port'

configure system > cwmp > port

[TR069HTTPPort]

Defines the local HTTP/S port used for TR-069.

The valid range is 0 to 65535. The default is 7547.

Note: For the parameter to take effect, a device reset is required.

'URL Provisioning Mode'

configure system > cwmp > acs-url-provisioning-mode

[Tr069AcsUrlProvisioningMode]

Defines the method for configuring the URL of the TR-069 ACS.

■

[0] Manual = (Default) URL must be configured manually on the device. The URL is configured using the TR069ConnectionRequestUrl parameter.

■

[1] Automatic = Device uses DHCP Option 43 to obtain URL address of ACS.

'URL'

configure system > cwmp > acl-url

[TR069AcsUrl]

Defines the URL address of the Auto Configuration Servers (ACS) to which the device connects. For example, http://10.4.2.1:10301/acs/.

By default, no URL is defined.

Note: The parameter is applicable only if the 'URL Provisioning Mode' parameter is set to Manual.

'Username'

configure system > cwmp > acs-user-name

[TR069AcsUsername]

Defines the login username that the device uses for authenticated access to the ACS.

The valid value is a string of up to 256 characters. By default, no username is defined.

'Password'

configure system > cwmp > acs-password

[TR069AcsPassword]

Defines the login password that the device uses for authenticated access to the ACS.

The valid value is a string of up to 256 characters. By default, no password is defined.

Note: The parameter cannot be configured with wide characters.

'URL'

configure system > cwmp > connection-request-url

[TR069ConnectionRequestUrl

Defines the URL for the ACS connection request. For example, http://10.31.4.115:82/tr069/.

'Username'

configure system > cwmp > connection-request-user-name

[TR069ConnectionRequestUsername]

Defines the connection request username used by the ACS to connect to the device.

The valid value is a string of up to 256 characters. By default, no username is defined.

'Password'

configure system > cwmp > connection-request-password

[TR069ConnectionRequestPassword]

Defines the connection request password used by the ACS to connect to the device.

The valid value is a string of up to 256 characters. By default, no password is defined.

Note: The parameter cannot be configured with wide characters.

'Default Inform Interval'

configure system > cwmp > default-inform-interval

[TR069PeriodicInformInterval]

Defines the inform interval (in seconds) at which the device periodically communicates with the ACS. Each time the device communicates with the ACS, the ACS sends a response indicating whether or not the ACS has an action to execute on the device.

The valid value is 0 to 4294967295. The default is 60.

configure system > cwmp > tr069-cwmp-wait-interval

[TR069RetryinimumWaitInterval]

Defines the minimum interval (in seconds) that the device waits before attempting again to communicate with the ACS after the previous communication attempt failed.

The valid value is 1 to 65535. The default is 5.

configure system > cwmp > debug-mode

[TR069DebugMode]

Defines the debug mode level, which is the type of messages sent to the Syslog server.

The valid value is between 0 and 3, where 0 (default) means no debug messages are sent and 3 is all message types are sent.

configure system > cwmp > conf-change-notification

[Tr069ConfChangeNotification]

Enables the device to notify the TR-069 ACS of device configuration changes. The device sends this as a TR-069 Value Change Event when the management user logs out of the management interface (Web or CLI). The parameter is applicable to Data Model InternetGatewayDevice (TR-098).

■

[0] = (Default) Disable

■

[1] = Enable

'TLS Context'

configure system > cwmp > tls-context

[Tr069TLSContext]

Assigns a TLS Context for TR-069 management.

By default, TLS Context ID 0 is used.

'Verify Certificate'

configure system > cwmp > verify-certificate

[Tr069VerifyCertificate]

Enables verification of the certificate during the TR-069 connection.

■

[0] Disable

■

[1] Enable (default)

Verify Common Name

configure system > cwmp > verify-common-name

[Tr069VerifyCommonName]

Enables verification of the Common Name (CN) field (DNS hostname matches the certificate subject common name) during the TR-069 connection.

■

[0] Disable

■

[1] Enable (default)

configure system > cwmp > ntp-dependency

[TR069NTPDependency]

Enables the device to connect to the ACS only when ithe device is synchronized with the NTP server. This parameter is applicable only when you configure the device to connect securely (TLS) to the ACS (see the [Tr069TLSContext] parameter) and to verify the certificate (see the [Tr069VerifyCertificate] parameter).

■

[0] = (Default) Disable

■

[1] = Enable

configure system > cwmp > tcp-fragment

[Tr069TCPFragment]

Enables the device to send or receive fragmented TCP packets for TR-069 (i.e., sets the Fragment flag in the IP header to on).

■

[0] = (Default) Disable

■

[1] = Enable

[TR069CustomerProductClass]

Defines the device's TR-069 Product Class. The default is "MSBR".

Idle Period

You can configure an "idle" period during which the CPE (device) accepts TR-069 ACS requests (ScheduleDownload method) to download and apply files to the device. This is useful in that it allows file download to be done during periods of relatively low traffic, avoiding disruption to calls. The device rejects the ScheduleDownload request if it is received out of the idle period. The device starts downloading the files at a randomly chosen time within the configured Idle period.

Note: ACS sends to the CPE the ScheduleDownload request with a window which includes WindowMode = 3, and WindowStart and WindowEnd which defines a period during which download is allowed. It is important that this window overlaps your configured Idle period. For example, if Idle period is Saturday night and ScheduleDownload request is sent on Sunday, the window should be a week (WindowEnd to WindowStart = 1 week = 7*24*3600). If the Idle period doesn't overlap the received TimeWindow, the CPE rejects the ScheduleDownload request with the fault code 9003 (Invalid arguments).

'Day of Week'

configure system > cwmp > idle-period > day-of-week

[TR069IdleTimeDayWeek]

Defines the day of the week on which the CPE allows file download from ACS.

■

[0] Everyday

■

[1] Sunday

■

[2] Monday

■

[3] Tuesday

■

[4] Wednesday

■

[5] Thursday

■

[6] Friday

■

[7] Saturday

The default is Everyday.

'Start Time'

configure system > cwmp > idle-period > start

[TR069IdleTimeStart]

Defines the start time (in HH:MM format) of the idle period range during which the CPE allows file download from ACS.

The default is 0 (no idle time).

'End Time'

configure system > cwmp > idle-period > end

[TR069IdleTimeEnd]

Defines the end time (in HH:MM format) of the idle period range during which the CPE allows file download from ACS. The files download operation (he download operation (file transfer from server and apply the download - run and burn file) must complete by this time.

The default is 23:59.