Home > Configuration > Domain Name Service > adddnsnameserver

adddnsnameserver

Use this method to adds a name server to the appliance. Following are the two types of name servers that can be added:
* 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), you configure a DNS virtual server on the appliance, bind the external name servers as its services, and then specify the name of the virtual server in this method.

Syntax



Parameters

ip

IP address of an external name server or, if the Local parameter is set, IP address of a local DNS server (LDNS).

dnsvservername

Name of a DNS virtual server. Overrides any IP address-based name servers configured on the Citrix ADC.

local

Mark the IP address as one that belongs to a local recursive DNS server on the Citrix ADC. 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. From 14.1 47.x build , it is recommended to use ADNS and ADNS_TCP service and associating a DNS profile with recursiveResolution parameter enabled to achieve the same functionality.

state

Administrative state of the name server.
Default value = ENABLED.

type

Protocol used by the name server. UDP_TCP is not valid if the name server is a DNS virtual server configured on the appliance.
Default value = NSA_UDP.

dnsprofilename

Name of the DNS profile to be associated with the name server

Return Value

Returns simpleResult

See Also