Dynamic DNS Configuration

Options in this group are responsible for the Dynamic DNS service.

Enable Dynamic DNS Updates

Key name in the configuration file: ddnsEnabled

Value type: Boolean

Possible values: true or false

Default value: false

Allows connecting Device Servers to register in the DNS. For a Device Server to register itself in dDNS, dDNS registration must also be enabled in its settings.

Zone Name

Key name in the configuration file: ddnsZone

Value type: String

Possible values: Any valid DNS domain name

Default value: "" (empty)

This option defines DNS zone (domain) name to which Iotellect Server will add hosts corresponding to Device Servers. This can be a domain name in your company's local DNS (within your LAN or Intranet) or a global Internet domain name like "company.com" (if you own one).

IP Address of DNS Server

Key name in the configuration file: ddnsServerIp

Value type: String

Possible values: Any IP address

Default value: "" (empty)

Defines the IP address of the DNS server used for Dynamic DNS updates.

Port Number on DNS Server to Communicate with

Key name in the configuration file: ddnsServerPort

Value type: Integer

Possible values: 1-65535

Default value: 53

Defines the destination port number on the DNS server used for Dynamic DNS updates.

Enable Transaction Signature (TSIG) Keys

Key name in the configuration file: ddnsUseTsigKeys

Value type: Boolean

Possible values: true or false

Default value: false

This option enables using Transaction Signature (TSIG) keys for making communication with DNS server secure. TSIG keys are a form of DNS security. You can learn more about them at http://en.wikipedia.org/wiki/TSIG

TSIG Key Name

Key name in the configuration file: ddnsTsigKeyName

Value type: String

Possible values: Any string value conforming to the Dynamic DNS specification

Default value: "" (empty)

Defines the name of the key to be used for Transaction Signatures (TSIG).

TSIG Key Value

Key name in the configuration file: ddnsTsigKeyValue

Value type: String

Possible values: Any string value conforming to the Dynamic DNS specification

Default value: "" (empty)

Defines the value of key to be used in Transaction Signatures (TSIG).

Enable TCP Mode

Key name in the configuration file: ddnsTcpMode

Value type: Boolean

Possible values: true or false

Default value: true

If this option is set to true, TCP protocol is used for DNS updates, otherwise all transactions are performed using UDP.

Timeout for DNS Operations, Seconds

Key name in the configuration file: ddnsTimeout

Value type: Integer

Possible values: Any positive integer number

Default value: 10

Defines timeout for DNS update operations. If no answer is received from the DNS server within this time, the DNS update operation is considered unsuccessful.

TTL for New DNS Records, Seconds

Key name in the configuration file: ddnsTtl

Value type: Integer

Possible values: Any positive integer number

Default value: 600

Defines Time To Live (TTL) interval that is set for all newly created DNS records. When a caching (recursive) nameserver queries the authoritative nameserver for a resource record, it will cache that record for the time (in seconds) specified by the TTL. A low value of this setting leads to high number of dDNS updates. A high value results in a slower update of information (and thus less update requests). This value is counted in seconds (600 equals 10 minutes).

Host Pattern for Registering External IPs

Key name in the configuration file: ddnsHostPatternForExternalIPs

Value type: String

Possible values: String containing special tokens

Default value: $n.$o.ext

Defines the host name pattern which will be used for external Device Servers. The string is parsed and the following substitutions are made:

  • $n is changed to the device name of a particular Device Server (as defined in its internal settings)
  • $o is changed to the owner name of a particular Device Server (also, as defined in the device's settings)

The result is used as a prefix to the zone name to form a fully qualified domain name. So for example, with the default value for this setting, if we have a Device Server called LightSaber and the owner name is Luke, and the domain is DeathStar.com, we would access the Device Server using the DNS address lightsaber.luke.deathstar.com.

Host Pattern for Registering Internal IPs

Key name in the configuration file: ddnsHostPatternForInternalIPs

Value type: String

Possible values: String containing special tokens

Default value: $n.$o.int

Defines host name pattern which will be used for registering Device Servers whose IP addresses are internal (within your LAN). The string is parsed and the following substitutions are made:

  • $n is changed to the device name of a particular Device Server
  • $o is changed to the owner name of a particular Device Server

The result is used as a prefix to the zone name to form a fully qualified domain name (for details, see example above).

Was this page helpful?