Jump to content
  • EN

RUT140 TR-069

From Teltonika Networks Wiki
Main Page > RUT Routers > RUT140 > RUT140 Manual > RUT140 WebUI > RUT140 Services section > RUT140 TR-069

The information in this page is updated in accordance with firmware version RUT14X_R_00.07.23.2.

Summary

TR-069 (Technical Report 069) is an application layer protocol designed for management of equipment connected to a remote network.

This chapter of the user manual provides an overview of the UPnP page in RUT140 devices.

TR-069 is additional software that can be installed from the System → Package Manager page.

TR-069 Client Configuration

Field Value Description
Enable off | on; default: off Turns TR-069 client on or off.
Periodic enable off | on; default: on Enables TR-069 client periodic data transmission to TR-069 server.
Accept server request off | on; default: off When enabled the device accepts connection requests from servers.
Sending interval integer [60..9999999]; default: 100 Periodic data transmission frequency (in seconds).
Username string; default: easycwmp Username used for authentication to a TR-069 server.
Password string; default: easycwmp Password used for authentication to a TR-069 server.
URL host | ip; default: http://192.168.1.110:8080/openacs/acs IP address or hostname of a TR-069 server.
Use secure connection off | on; default: off Enable TLS for a secure connection. Requires certificate files. TLS works only if the URL starts with https://.
Use certificate files from device off | on; default: off Choose this option if you want to select certificate files from device.
Store keys in TPM off | on; default: on When enabled, keys will be stored in TPM2 secure storage if space is available. Note: this option is only available on devices with TPM support.
Certificate authority file CA file Upload the Certificate Authority (CA) file. Required for verifying the server's certificate.
Client certificate .crt file Upload the client certificate file. This is used for client authentication by the server.
Client private keyfile .key file Upload the client private key file. This is used along with the client certificate for authentication.

Management via TR-069

TR-069 can be used to set or get values from RUT devices. Below is a list of commands used for device management via TR-069.

  • R - read only;
  • RW - read/write;
  • string(64) - 64 bit string;
  • string(256) - 256 bit string;
  • unsignedInt - integer storing only positive values.

Device Information:

  1. DeviceInfo.HardwareVersion - device hardware version (e.g., 0201) R
  2. DeviceInfo.Manufacturer - device manufacturer (e.g., Teltonika) R
  3. DeviceInfo.ManufacturerOUI - organizationally unique identifier of the device manufacture (e.g., 001E42) R
  4. DeviceInfo.ProductClass - device model (e.g., RUT140) R
  5. DeviceInfo.ProvisioningCode - provisioning code R
  6. DeviceInfo.SerialNumber - device serial number (e.g., 1000111111) R
  7. DeviceInfo.SoftwareVersion - device software version (e.g., RUT14X_R_00.0X.XX) R
  8. DeviceInfo.SpecVersion - device special version (e.g., 1.0) R

Device IP Interface information:

  1. IP.Interface.{i}.Enable - Enables or disables the interface R
  2. IP.Interface.{i}.Name - The textual name of the interface as assigned by the CPE R
  3. IP.Interface.{i}.Type - IP interface type R
  4. IP.Interface.{i}.IPv4AddressNumberOfEntries - R
  5. IP.Interface.{i}.IPv4Address.{i}.IPAddress - IPv4 address (e.g., 192.168.1.1) RW
  6. IP.Interface.{i}.IPv4Address.{i}.AddressingType - Addressing method used to assign the IP address R
  7. IP.Interface.{i}.IPv4Address.{i}.Enable - Enables or disables this IPv4 address R
  8. IP.Interface.{i}.IPv4Address.{i}.SubnetMask - Subnet mask R
  9. IP.Interface.{i}.Stats.BytesSent - The total number of bytes transmitted out of the interface, including framing characters R
  10. IP.Interface.{i}.Stats.BytesReceived - The total number of bytes received on the interface, including framing characters R
  11. IP.Interface.{i}.Stats.PacketsSent - The total number of packets transmitted out of the interface R
  12. IP.Interface.{i}.Stats.PacketsReceived - The total number of packets received on the interface R
  13. IP.Interface.{i}.Stats.ErrorsSent - The total number of outbound packets that could not be transmitted because of errors R
  14. IP.Interface.{i}.Stats.ErrorsReceived - The total number of inbound packets that contained errors preventing them from being delivered to a higher-layer protocol R
  15. IP.Interface.{i}.Stats.DiscardPacketsSent - The total number of outbound packets which were chosen to be discarded even though no errors had been detected to prevent their being transmitted. One possible reason for discarding such a packet could be to free up buffer space R
  16. IP.Interface.{i}.Stats.DiscardPacketsReceived - The total number of inbound packets which were chosen to be discarded even though no errors had been detected to prevent their being delivered. One possible reason for discarding such a packet could be to free up buffer space R

Device IP Diagnostics information:

  1. IP.Diagnostics.IPPing.DiagnosticsState - Controls and indicates the state of the ping test RW
  2. IP.Diagnostics.IPPing.Host - Specifies the target hostname or IP address to ping RW
  3. IP.Diagnostics.IPPing.NumberOfRepetitions - Defines how many ICMP echo requests will be sent during the test RW
  4. IP.Diagnostics.IPPing.Timeout - Maximum time in milliseconds to wait for each ping response before considering it failed RW
  5. IP.Diagnostics.IPPing.DataBlockSize - Size in bytes of the payload in each ping packet RW
  6. IP.Diagnostics.IPPing.SuccessCount - Number of ping requests that received a successful reply R
  7. IP.Diagnostics.IPPing.FailureCount - Number of ping requests that failed or timed out; typically calculated as total minus successful responses RW
  8. IP.Diagnostics.IPPing.AverageResponseTime - Average round-trip time of all successful ping responses, in milliseconds R
  9. IP.Diagnostics.IPPing.MinimumResponseTime - Shortest round-trip time recorded during the test, in milliseconds R
  10. IP.Diagnostics.IPPing.MaximumResponseTime - Longest round-trip time recorded during the test, in milliseconds R

Device NAT Port Mapping information:

  1. NAT.PortMapping.{i}.Enable - Enables or disables the port mapping instance. On creation, an entry is disabled by default RW
  2. NAT.PortMapping.{i}.Status - R
  3. NAT.PortMapping.{i}.Origin - Indicates the Origin of the PortMapping instance R
  4. NAT.PortMapping.{i}.LeaseDuration - Determines the time to live, in seconds, of a port mapping lease, where "time to live" means the number of seconds before the port mapping expires RW
  5. NAT.PortMapping.{i}.RemainingLeaseTime - For a dynamic (non-static) port mapping, when this parameter is read, the value represents the time (in seconds) remaining on the port mapping lease. That is, for a dynamic port mapping, the value counts down toward 0. When a dynamic port mapping lease expires, the device MUST automatically terminate that port mapping, and MUST automatically delete the corresponding PortMapping table entry R
  6. NAT.PortMapping.{i}.RemoteHost - This parameter is the IP address of the source of inbound packets. An empty string indicates a "wildcard", i.e. any IP address (this will be an empty string in most cases). CPE are REQUIRED only to support an empty string RW
  7. NAT.PortMapping.{i}.ExternalPort - The external port (or the first port of a range of external ports) that the NAT gateway would listen on for traffic to a corresponding InternalPort. Inbound packets to this external port on the WAN interface SHOULD be forwarded to the IP.Interface associated with the InternalClient on the InternalPort RW
  8. NAT.PortMapping.{i}.ExternalPortEndRange - Indicates the last port of the external port range that starts with ExternalPort RW
  9. NAT.PortMapping.{i}.InternalPort - The port on InternalClient that the gateway SHOULD forward traffic to RW
  10. NAT.PortMapping.{i}.Protocol - The protocol of the port mapping RW
  11. NAT.PortMapping.{i}.InternalClient - The IP address or DNS host name of an internal client (on the LAN) RW
  12. NAT.PortMapping.{i}.Description - User-readable description of this port mapping RW

Device Management Server information:

  1. ManagementServer.ConnectionRequestPassword - connection request password (e.g., randompassword) RW
  2. ManagementServer.ConnectionRequestURL - connection request URL R
  3. ManagementServer.ConnectionRequestUsername - connection request username (e.g., 001E42-RUTX14-0000000000) RW
  4. ManagementServer.ParameterKey - server parameter key R
  5. ManagementServer.Password - server password RW
  6. ManagementServer.PeriodicInformEnable - enabled/disabled TR-069 client periodic data transmission to TR-069 server (e.g., true) RW
  7. ManagementServer.PeriodicInformInterval - periodic data transmission interval (e.g., 300) RW
  8. ManagementServer.PeriodicInformTime - periodic information time (e.g., 1/1/1970, 8:09:27 PM) RW
  9. ManagementServer.URL - server URL RW
  10. ManagementServer.Username - server username RW

Device ID information:

  1. DeviceID.ID - device ID (e.g., 001E42-RUTX14-0000000000) R
  2. DeviceID.Manufacturer - device manufacturer (e.g., Teltonika) R
  3. DeviceID.OUI - organizationally unique identifier of the device manufacture (e.g., 001E42) R
  4. DeviceID.ProductClass - product class (e.g., RUTXXX) R
  5. DeviceID.SerialNumber - device serial number R

Events information:

  1. Events.0_BOOTSTRAP - bootstrap time R
  2. Events.1_BOOT - boot time R
  3. Events.Inform - information time R
  4. Events.Registered - events reg time R

Device DHCPv4 information:

  1. DHCPv4.Server.Pool.{i}.Enable - Enables or disables the Pool entry RW
  2. DHCPv4.Server.Pool.{i}.Status - The status of this entry R
  3. DHCPv4.Server.Pool.{i}.Interface - The IP Interface associated with the Pool entry RW
  4. DHCPv4.Server.Pool.{i}.MinAddress - Specifies first IPv4 address in the pool to be assigned by the DHCP server on the LAN interface RW
  5. DHCPv4.Server.Pool.{i}.MaxAddress - Specifies last IPv4 address in the pool to be assigned by the DHCP server on the LAN interface RW
  6. DHCPv4.Server.Pool.{i}.SubnetMask - Specifies the client's network subnet mask RW
  7. DHCPv4.Server.Pool.{i}.DNSServers - Comma-separated list (up to 4 items) (length ) of IPv4Addresses. List items represent DNS servers offered to DHCP clients. Support for more than three DNS Servers is OPTIONAL RW
  8. DHCPv4.Server.Pool.{i}.IPRouters - Comma-separated list (up to 4 items) (length ) of IPv4Addresses. List items represent addresses of routers on this subnet. Also known as default gateway. Support for more than one Router address is OPTIONAL RW
  9. DHCPv4.Server.Pool.{i}.LeaseTime - Specifies the lease time in seconds of client assigned addresses. A value of -1 indicates an infinite lease RW
Retrieved from "https://wiki.teltonika-networks.com/index.php?title=RUT140_TR-069&oldid=123878"