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]>

Give documentation feedback