Add a name server

You can create a name server by specifying its IP address or by configuring an existing virtual server as the name server.

  • IP address-based name server - An external name server to contact for domain name resolution. If multiple IP address-based name servers are configured on the appliance, and the local parameter is not set on any of them, incoming DNS queries are load balanced across all the name servers, in round robin fashion.
  • Virtual server-based name server - A DNS virtual server configured in the Citrix ADC. If you want more fine-grained control on how external DNS name servers are load balanced (for example, you want a load balancing method other than round robin), do the following:
  • Configure a DNS virtual server on the appliance
  • Bind the external name servers as its services
  • Specify the name of the virtual server in this command.

To verify the configuration, you can use the show dns nameServer command.

To remove a name server, at the Citrix ADC CLI, type the rm dns nameServer command followed by the IP address of the name server.

To view the details of the DNS nameserver, at the Citrix ADC CLI, type show dns nameServer command followed by the IP address of the name server.

Add a name server (when the Citrix ADC appliance acts as a forwarder) by using the CLI

At the command prompt, type;

add dns nameServer ((<IP>) | <dnsVserverName>)

or

add dns nameServer ((<IP> | <dnsVserverName>) [-type <type>]

Examples:

add dns nameServer dnsVirtualNS

add dns nameServer 192.0.2.11 -type TCP

add dns nameServer 192.0.2.12 -type UDP_TCP


add dns nameServer 192.0.2.10
show dns nameServer 192.0.2.10

1) 192.0.2.10  -  State: UP  Protocol: UDP
Done

Note:

If the name server type is not specified, a UDP name server is created by default. To create a name server of type TCP or UDP_TCP, you must specify the type.

When you specify the type as UDP_TCP, two name servers (one UDP name server and one TCP name server) are created for the given IP address.

Add a name server (when the Citrix ADC appliance acts as a resolver) by using the CLI

At the command prompt, type:

add dns nameServer ((<IP> [-local]) | <dnsVserverName>)

Example:

add dns nameServer 10.102.9.19 -local
show dns nameServer
1)  10.102.9.19 LOCAL -  State: UP  Protocol: UDP
Done

local - Mark the IP address as one that belongs to a local recursive DNS server on the Citrix ADC appliance. The appliance recursively resolves queries received on an IP address that is marked as being local. For recursive resolution to work, the global DNS parameter, recursion, must also be set. If no name server is marked as being local, the appliance functions as a stub resolver and load balances the name servers.

Add a name server by using the GUI

Navigate to Traffic Management > DNS > Name Servers and create a name server.