class DNS-Application

ManagedElement
+-MtasFunction
+-MtasSupportFunctions
+-DNS-Application

The DNS Managed Object (MO) represents the top level of the DNS Resolver

Attributes
string
key
mandatory
noNotification
restricted
applicationName
The name of the application. The attribute name and value of is used in the applications RDN.
DnsMaxNumberCachedRecordsDT
dnsCacheSize = 20000
This attribute defines the maximum number of cached resource records.
DnsExpiredCacheBehaviorDT
dnsExpiredCacheBehavior = REMOVED
This attribute defines the life cycle management of cached resource records.
DnsLocalAddressDT[0..10] nonUnique ordered
dnsLocalAddress = 0.0.0.0
The IP address of the local host. Used as source IP address in DNS queries.

Note1: If no attributes have been specified the system will select a local address.
Note2: To make the system less vulnerable to cache poisoning it is recommended that multiple entries are specified.
DnsRetransmissionTimerDT
dnsRetransmissionTimer = 10
This attribute defines the retransmission timer for the DNS stack, to retransmit queries to the external DNS server.
DnsServerEntryDT[0..] nonUnique ordered
dnsServerEntry = 0:0.0.0.0
This attribute defines the following properties of a DNS server:

- lookup
- priority
- address
- port

address is mandatory. The address is either an IPv4 address or an IPv6 address enclosed in square brackets. It is possible to configure several attributes. There may be a mix of IPv4 and IPv6 attributes.

port is optional. No colon (':') separator shall be used if port is left out. If not configured, port is assigned a default value of 53 by the system.

Example: 10.1.1.1
[::6]:53

lookup is optional. No colon (':') separator shall be used if lookup is left out. When a DNS Server is configured with a specific lookup, the DNS Server is dedicated to handle DNS queries for that lookup. If lookup is not specified, the server is considered as a general server handling all sorts of DNS queries for which no specific DNS server is applicable. Several lookups can be specified for a given server.

Example: 10.1.1.1
[::6]:53
http:[2000::4:1]
tel:[2000::4:1]

priority is optional. No colon (':') separator shall be used if priority is left out. The priority controls which distribution mechanism to be used. Two distribution mechanisms are supported: Primary/Standby and Load Sharing. If a Primary/Standby distribution mechanism is required, the Primary Server shall be assigned the lowest priority value; the first Standby server shall be assigned the second lowest priority value; the second Standby server shall be assigned the third lowest priority value; etc. The Primary/Standby distribution mechanism is relevant to DNS servers of the same lookup (or no lookup). If a Load Sharing distribution mechanism is required, the same priority value shall be assigned to these DNS Servers. These servers form a load sharing group. The load sharing distribution mechanism is relevant to DNS servers of the same lookup (or no lookup). In case priority is not specified, Primary/Standby distribution mechanism will apply, and the system will assign a priority (next available value) for that lookup.

Example: 0:10.1.1.1
1:[::6]:53
http:0:[2000::4:1]
tel:0:[2000::4:1]

Within each lookup both distribution mechanisms can be applied as it is possible to specify several load sharing groups for a certain lookup. Then the servers with the same lowest priority constitute a Primary group, the servers with the same second lowest priority constitute a Standby group, etc.

Example: 0:10.1.1.1
0:10.1.1.2
0:10.1.1.3
1:[::6]:53
1:[::7]
http:0:[2000::4:1]
http:0:[2000::4:2]
http:1:[2000::4:3]
http:1:[2000::4:4]
http:2:[2000::4:5]
http:2:[2000::4:6]
tel:0:[2000::4:1]
tel:0:[2000::4:2]
tel:0:[2000::4:3]
tel:1:[2000::4:4]
tel:1:[2000::4:5]

Note: Attribute DnsServerEntry is used together with attribute DnsLocalAddress. This means that some entries of DnsServerEntry may be ruled out. A DnsServerEntry entry is ruled out if the IP version does not match the IP version of any DnsLocalAddress entry. For example if multiple DnsServerEntry entries have been specified with a mix of IPv4/IPv6 entries while attribute DnsLocalAddress only consists of IPv4 addresses, then none of the IPv6 entries for DnsServerEntry will be used.

  class DNS-Application