The Domain Name System (DNS) is essential internet functionality used for resolving domain names to IP addresses. When the target of a network or web path is identified by a domain name rather than by an IP address, the source monitoring point uses DNS to resolve the target’s IP address.

Typically, the IP addresses of DNS name servers are configured within DHCP so, if the monitoring point uses DHCP, those name servers are available to it. Additional name server addresses can also be configured directly on a per interface basis on the monitoring point.

When a network or web path is initiated from a monitoring point, a DNS request is made. The source monitoring point must determine which name servers to pass the DNS request to. If there are one or more name servers configured on the interface the path is initiated on (either directly on the interface or via DHCP on the interface), only those servers are used. If no name servers are configured on the interface or on a DHCP server servicing the interface, then all name servers known to the monitoring point are used.

From a monitoring point perspective, all name servers are considered equivalent. So, when a name resolution is required, the request is forwarded to the appropriate name servers. The first response received is used.

In cases where name servers are not equivalent (typically when providing sub-domain name resolution), this behavior may result in an incorrect name resolution. For example, a name server that cannot resolve a name may respond first with a negative result. This result is used by the monitoring point despite it receiving a positive result later on. In these instances, you want to associate a name server with a DNS Search Domain so that all requests for a given domain are forwarded to a specific name server (or set of servers).

On monitoring points where the DNS Search Domain is configured on a specific interface, when a network or web path is initiated from that interface, only the name servers configured (or supplied by DHCP) on that interface are used to resolve domain names matching the DNS Search Domain. If no DNS Search Domains are configured on the interface, then all search domains known to the monitoring point are used.

View DNS configuration

Web admin

  1. Log in to Web Admin.
  2. Navigate to Network Settings > Network Interfaces.
    • The configuration of each interface is displayed.

Admin API - view name server

  1. Access the Admin API.
  2. Navigate to DNS > GET /interface/{interface_name}/dns_nameserver/.
  3. Click Try it out.
  4. In the Parameters section, in the interface_name field, enter the name of the interface you are viewing.
  5. Click Execute.
    • The Server response section should show Code “200”.
    • The name servers are shown in the Response body.

Admin API - view DNS search domain

  1. Access the Admin API.
  2. Navigate to DNS > GET /interface/{interface_name}/dns_search/.
  3. Click Try it out.
  4. In the Parameters section, in the interface_name field, enter the name of the interface you are viewing.
  5. Click Execute.
    • The Server response section should show Code “200”.
    • The DNS search domains are shown in the Response body.

Web admin

  1. Log in to Web Admin.
  2. Click Network Configuration.
    • The DNS configuration is displayed in the DNS section.

Edit DNS configuration

Web admin

  1. Log in to Web Admin.
  2. Navigate to Network Settings > Network Interfaces.
  3. For the interface you want to edit, select > Edit.
  4. In the DNS Configuration section, make your changes to the DNS configuration.
  5. Restart networking.
    • The DNS configuration changes take effect.

Admin API - add/edit name server

  1. Access the Admin API.
  2. Navigate to DNS > POST /interface/{interface_name}/dns_nameserver/.
  3. Click Try it out.
  4. In the Parameters section:
    1. In the interface_name field, enter the name of the interface you are configuring.
    2. In the body field, replace “string” with the IP address of the name server you are adding.
      • You can enter additional name server addresses on separate lines. All but the last should have a “,” at the end.
  5. Click Execute.
    • The Server response section should show Code “200”.
    • The name servers are added/edited.
  6. Restart networking. You will briefly lose connectivity to the Admin API.
    • The DNS configuration changes take effect.

Admin API - delete name server

  1. Access the Admin API.
  2. Navigate to DNS > DELETE /interface/{interface_name}/dns_nameserver/.
  3. Click Try it out.
  4. In the Parameters section, in the interface_name field, enter the name of the interface you are deleting.
  5. Click Execute.
    • The Server response section should show Code “200”.
    • The name servers are deleted.
  6. Restart networking. You will briefly lose connectivity to the Admin API.
    • The DNS configuration changes take effect.

Admin API - add/edit DNS search domain

  1. Access the Admin API.
  2. Navigate to DNS > POST /interface/{interface_name}/dns_search/.
  3. Click Try it out.
  4. In the Parameters section:
    1. In the interface_name field, enter the name of the interface you are configuring.
    2. In the body field, replace “string” with the search domain.
      • You can enter additional search domains on separate lines. All but the last should have a “,” at the end.
  5. Click Execute.
    • The Server response section should show Code “200”.
    • The DNS search domains are added/edited.
  6. Restart networking. You will briefly lose connectivity to the Admin API.
    • The DNS configuration changes take effect.

Admin API - delete DNS search domain

  1. Access the Admin API.
  2. Navigate to DNS > DELETE /interface/{interface_name}/dns_search/.
  3. Click Try it out.
  4. In the Parameters section, in the interface_name field, enter the name of the interface you are configuring.
  5. Click Execute.
    • The Server response section should show Code “200”.
    • The DNS search domains are deleted.
  6. Restart networking. You will briefly lose connectivity to the Admin API.
    • The DNS configuration changes take effect.

Web admin

  1. Log in to Web Admin.
  2. Click Network Configuration.
  3. Click on Configure DNS.
  4. Update the configuration as appropriate.
  5. Click Save.
  6. Restart networking.
Call Support: 800-664-4401
Contact Us