Skip to main content
Pure1 Support Portal

puredns

Name

puredns — manages the DNS attributes of an array

Synopsis

puredns list [ --cli | --csv | --nvp ] [--notitle] [--page] [--raw]

puredns setattr [--domain DOMAIN] [--nameservers NAMESERVERS]

Options

-h | --help

Can be used with any command or subcommand to display a brief syntax description.

--domain

Domain suffix to be appended by the array when performing DNS lookups. To remove the domain suffix from Purity DNS queries, set to an empty string ("").

--nameservers

Comma-separated list of up to three DNS server IP addresses.

For IPv4, specify the IP address in the form ddd.ddd.ddd.ddd, where ddd is a number ranging from 0 to 255 representing a group of 8 bits. For IPv6, specify the IP address in the form xxxx:xxxx:xxxx:xxxx:xxxx:xxxx:xxxx:xxxx, where xxxx is a hexadecimal number representing a group of 16 bits. When specifying an IPv6 address, consecutive fields of zeros can be shortened by replacing the zeros with a double colon (::).

To unassign the DNS server IP addresses, set to an empty string (""). Once the DNS server IP addresses have been unassigned, the array no longer makes DNS queries.

Options that control display format:

--cli

Displays output in the form of CLI commands that can be issued to reproduce the current configuration. The --cli output is not meaningful when combined with immutable attributes.

--csv

Lists information in comma-separated value (CSV) format. The --csv output can be used for scripting purposes and imported into spreadsheet programs.

--notitle

Lists information without column titles.

--nvp

Lists information in name-value pair (NVP) format, in the form ITEMNAME=VALUE. Argument names and information items are displayed flush left. The --nvp output is designed both for convenient viewing of what might otherwise be wide listings, and for parsing individual items for scripting purposes.

--page

Turns on interactive paging.

--raw

Displays the unformatted version of column titles and data. For example, in the purearray monitor output, the unformatted version of column title us/op (read) is usec_per_read_op. The --raw output is used to sort and filter list results.

Description

The puredns command manages the DNS attributes for an array's administrative network.

The puredns setattr command sets the DNS parameters of the array. Include the --domain option to set the domain suffix to be appended to DNS queries. The list of DNS name server IP addresses specified in the --nameservers option replaces the list of name servers in effect prior to command execution.

The puredns list command displays the current DNS parameters, including domain suffix and name servers, of the array. Include the --cli option to display the CLI command line that would reproduce the array's current DNS configuration. This can, for example, be copied and pasted to create an identical DNS configuration in another array, or saved as a backup.

Examples

Example 1

puredns setattr --domain mydomain.com --nameservers 192.168.0.125,192.168.2.125
      

Specifies the IPv4 addresses of two DNS servers for Purity to use to resolve hostnames to IP addresses, and the domain suffix mydomain.com for DNS searches.

Example 2

puredns setattr --nameservers 192.168.0.125,2001:0db8:85a3::ae26:8a2e:0370:7334
      

Specifies the IP addresses of two DNS server for Purity to use to resolve hostnames to IP addresses.

Example 3

puredns setattr --domain ""
      

Removes the domain suffix from Purity DNS queries.

Example 4

puredns setattr --nameservers ""
      

Unassigns DNS server IP addresses (Purity ceases to make DNS queries).

Author

Pure Storage Inc.