Skip to main content
SANtricity commands

Set controller DNS settings

Contributors netapp-driley

The set controller DNSServers command updates the Domain Name System (DNS) settings for a controller. DNS is used to resolve fully qualified domain names for the controllers and a Network Time Protocol (NTP) server.

Supported Arrays

This command applies to any individual storage array, including the E2700, E5600, E2800, E5700, EF600 and EF300 arrays, as long as all SMcli packages are installed.


To execute this command on an E2800, E5700, EF600, or EF300 storage array, you must have the Storage Admin role.


Before you begin make sure that:

  • A DNS server is configured.

  • You know the addresses of a primary DNS server and a backup DNS server, in case the primary DNS server fails. These addresses can be IPv4 addresses or IPv6 addresses.


You need to send this command to both controllers. This command is controller-specific.


If you already configured the array's management ports with DHCP (Dynamic Host Configuration Protocol), and you have one or more DNS or NTP servers associated with the DHCP setup, then you do not need to manually configure DNS/NTP. In this case, the array should have already obtained the DNS/NTP server addresses automatically.


set controller[a] DNSServers=(auto|(Address1 [Address2]))


Parameter Description


This parameter configures the DNS servers for the controller. Specify auto to use the DNS servers provided by DHCP. Otherwise, use a whitespace separated list of one or two DNS servers.


The management Ethernet ports on the array can support IPv4 or IPv6 protocols simultaneously. The addresses may be an IPv4 address or an IPv6 address. If specifying more than one address, the address types do not need to match.

If more than one address is specified, they will be used in the order they are specified (first is primary, second is backup).




set controller[a] DNSServers=auto;
set controller[a] DNSServers=(;
set controller[b] DNSServers=(;
set controller[b] DNSServers=(2001:0db8:85a3:0000:0000:8a2e:0370:7334

Minimum firmware level