dns command

This command configures and displays the CMM DNS settings.

If command syntax is not correctly entered, or if a command fails to run, an error message is returned. See Common errors for a list of error messages that apply to all commands or dns command errors for a list of error messages that are specific to the dns command.

Table 1. dns command.

The command table is a multi-row, four-column table where each row describes a CMM CLI command option: column one lists command function, column two provides a detailed command description, column three shows command-option syntax, and column four lists valid command targets.
Function What it does Command Target (see paths in Command targets)
Display DNS configuration of CMM Displays the current DNS configuration of the CMM. Possible return values are:
  • enabled
  • disabled
  • -i1 IPv4_first_ip_address
  • -i2 IPv4_second_ip_address
  • -i3 IPv4_third_ip_address
  • -i61 IPv6_first_ip_address
  • -i62 IPv6_second_ip_address
  • -i63 IPv6_third_ip_address
  • -ddns dynamic_DNS_state (enabled/disabled)
  • -p DNS_server_priority (ipv4/ipv6)
 dns
Primary CMM:
  • mm[p]
  • mm[P]
  • mm[x]
  • where x is the primary CMM bay number.
DNS - enable Enables the CMM DNS configuration.
Note:
  • At least one IP address must be non-zero to enable DNS.
  • Any additional DNS servers are added to the top of the search list. Hostname lookup is done on these servers before a DNS server that is assigned automatically by a DHCP server.
 dns -on
This command can only be run by users who have one or more of the following command authorities:
  • Supervisor
  • Chassis configuration
See Commands and user authority for additional information.
Primary CMM:
  • mm[p]
  • mm[P]
  • mm[x]
  • where x is the primary CMM bay number.
DNS - disable Disables the CMM DNS configuration.
Note:
  • DNS lookup is always enabled.
  • When DHCP is in use, other DNS addresses might be assigned automatically by the DHCP server.
dns -off
This command can only be run by users who have one or more of the following command authorities:
  • Supervisor
  • Chassis configuration
See Commands and user authority for additional information.
Primary CMM:
  • mm[p]
  • mm[P]
  • mm[x]
  • where x is the primary CMM bay number.
Dynamic DNS - enable / disable Enables or disables dynamic DNS for the CMM. dns -ddns state

where state is enabled or disabled .

This command can only be run by users who have one or more of the following command authorities:
  • Supervisor
  • Chassis configuration
See Commands and user authority for additional information.
Primary CMM:
  • mm[p]
  • mm[P]
  • mm[x]
  • where x is the primary CMM bay number.
DNS first IPv4 IP address - set Sets the first IPv4 IP address.
Note:
  • At least one IP address must be non-zero to enable DNS.
  • Any additional DNS servers are added to the top of the search list. Hostname lookup is done on these servers before a DNS server that is assigned automatically by a DHCP server.
 dns -i1 ip_address

where ip_address is the first IP address in dotted decimal IP address format.

This command can only be run by users who have one or more of the following command authorities:
  • Supervisor
  • Chassis configuration
See Commands and user authority for additional information.
Primary CMM:
  • mm[p]
  • mm[P]
  • mm[x]
  • where x is the primary CMM bay number.
DNS second IPv4 IP address - set Sets the second IPv4 IP address.
Note:
  • At least one IP address must be non-zero to enable DNS.
  • Any additional DNS servers are added to the top of the search list. Hostname lookup is done on these servers before a DNS server that is assigned automatically by a DHCP server.
 dns -i2 ip_address

where ip_address is the second IP address in dotted decimal IP address format.

This command can only be run by users who have one or more of the following command authorities:
  • Supervisor
  • Chassis configuration
See Commands and user authority for additional information.
Primary CMM:
  • mm[p]
  • mm[P]
  • mm[x]
  • where x is the primary CMM bay number.
DNS third IPv4 IP address - set Sets the third IPv4 IP address.
Note:
  • At least one IP address must be non-zero to enable DNS.
  • Any additional DNS servers are added to the top of the search list. Hostname lookup is done on these servers before a DNS server that is assigned automatically by a DHCP server.
 dns -i3 ip_address

where ip_address is the third IP address in dotted decimal IP address format.

This command can only be run by users who have one or more of the following command authorities:
  • Supervisor
  • Chassis configuration
See Commands and user authority for additional information.
Primary CMM:
  • mm[p]
  • mm[P]
  • mm[x]
  • where x is the primary CMM bay number.
DNS first IPv6 IP address - set Sets the first IPv6 IP address.
Note:
  • At least one IP address must be non-zero to enable DNS.
  • Any additional DNS servers are added to the top of the search list. Hostname lookup is done on these servers before a DNS server that is assigned automatically by a DHCP server.
 dns -i61 ip_address

where ip_address is the first IP address in IPv6 format.

This command can only be run by users who have one or more of the following command authorities:
  • Supervisor
  • Chassis configuration
See Commands and user authority for additional information.
Primary CMM:
  • mm[p]
  • mm[P]
  • mm[x]
  • where x is the primary CMM bay number.
DNS second IPv6 IP address - set Sets the second IPv6 IP address.
Note:
  • At least one IP address must be non-zero to enable DNS.
  • Any additional DNS servers are added to the top of the search list. Hostname lookup is done on these servers before a DNS server that is assigned automatically by a DHCP server.
 dns -i62 ip_address

where ip_address is the second IP address in IPv6 format.

This command can only be run by users who have one or more of the following command authorities:
  • Supervisor
  • Chassis configuration
See Commands and user authority for additional information.
Primary CMM:
  • mm[p]
  • mm[P]
  • mm[x]
  • where x is the primary CMM bay number.
DNS third IPv6 IP address - set Sets the third IPv6 IP address.
Note:
  • At least one IP address must be non-zero to enable DNS.
  • Any additional DNS servers are added to the top of the search list. Hostname lookup is done on these servers before a DNS server that is assigned automatically by a DHCP server.
 dns -i63 ip_address

where ip_address is the third IP address in IPv6 format.

This command can only be run by users who have one or more of the following command authorities:
  • Supervisor
  • Chassis configuration
See Commands and user authority for additional information.
Primary CMM:
  • mm[p]
  • mm[P]
  • mm[x]
  • where x is the primary CMM bay number.
DNS server priority - set Sets the DNS server priority for the CMM to IPv4 or IPv6.. dns -p priority

where priority is ipv4 or ipv6 .

This command can only be run by users who have one or more of the following command authorities:
  • Supervisor
  • Chassis configuration
See Commands and user authority for additional information.
Primary CMM:
  • mm[p]
  • mm[P]
  • mm[x]
  • where x is the primary CMM bay number.
Example: To set the first IP address of the CMM DNS server to 192.168.70.29 and enable DNS on the primary CMM that does not have IPv6 support, while the primary CMM in bay 1 is set as the persistent command environment, at the system:mm[1]> prompt, type 
dns -i1 192.168.70.29 -on
To display the DNS status of the primary CMM, while primary CMM in bay 1 is set as the persistent command environment, at the system:mm[1]> prompt, type 
dns

The following example shows the information that is returned from these two commands:

system:mm[1]> dns -i1 192.168.70.29 -on
system:mm[1]> dns
Enabled
-i1 192.168.70.29
-i2 0.0.0.0
-i3 0.0.0.0
system:mm[1]>
To display the DNS status of a primary CMM that supports IPv6, while CMM 1 is set as the persistent command environment, at the system:mm[1]> prompt, type 
dns

The following example shows the information that is returned from this command:

system:mm[1]> dns
Enabled
Enabled
-i1 192.168.70.230
-i2 0.0.0.0
-i3 0.0.0.0
-i61 2002:1013::211:25ff:fec3:227d
-i62 ::
-i63 ::
-ddns disabled
-p ipv4
system:mm[1]>
Parent topic: Command reference