Custom DNS Configuration

IN THIS ARTICLE

Outlines how to configure custom DNS servers and search domains in Qumulo Core

REQUIREMENTS

• Cluster running Qumulo Core 2.13.0 or later
• Cloud cluster running Qumulo Core 4.2.3 or later (for Web UI configuration)

NOTE: DNS entries will be automatically created from the node used to add the cluster to Active Directory and can be removed without issue during configuration.

Details

In Qumulo Core 2.13.0 and above, you can configure custom DNS server and search domains even when your cluster is not using a static IP configuration. Once these settings are configured, the set value will replace the one originally configured by DHCP on your cluster.

NOTE FOR GCP CLUSTERS: If you wish to use a custom DNS configuration with a cluster deployed in GCP, we recommend using the Google Internal DNS server (169.254.169.254) to forward requests to your own custom DNS for all GCE instances. If your custom DNS is required to be the DNS server for your GCE instances, ensure forwarding is configured to Google’s internal DNS for compatibility with many cloud features. For more information, check out the Best Practices for DNS Forwarding Zones and Internal DNS details in the GCP documentation.

Follow the steps below to configure, verify, or clear custom DNS servers and search domains.

Manage DNS Configuration via the Web UI

NOTE: Custom DNS configuration via the Web UI is only available for cloud clusters (such as those in AWS, GCP, or Azure).

As of Qumulo Core 4.2.3, cloud deployments can manage DNS settings using the Web UI. Follow the steps below:

1. Log into the Web UI for your cluster.
2. Hover over the Cluster menu and select Network Configuration.
3. Click to access the DNS configuration.
4. Enter the IP addresses for the DNS servers you wish to use. If you are adding multiple servers, separate the IPs with commas.
5. Enter any custom search domains you wish to configure in the Search Domains field.
6. Click Save.

Manage DNS Configuration via the QQ CLI

To setup a custom DNS configuration on your network using the QQ CLI, specify the interface, network IDs, and desired DNS information using the following command:

qq network_mod_network --interface-id ID --network-id ID --dns-servers IP1 IP2 --dns-search-domains "DOMAIN1" "DOMAIN2"

NOTE: As shown above, multiple entries can be separated by spaces.

Use the following command to verify your custom DNS configuration:

qq network_get_network --network-id ID

See the following example output:

test:~$ qq network_get_network --network-id 1
{
 "assigned_by": "DHCP",
 "dns_search_domains": [
 "corp.qumulo.com",
 "corp2.qumulo.com"
 ],
 "dns_servers": [
 "10.0.0.1",
 "10.0.0.2"
 ],
 "floating_ip_ranges": [],
 "id": 1,
 "ip_ranges": [],
 "mtu": 1500,
 "name": "Default",
 "netmask": "",
 "vlan_id": 0
}

Use the following command to clear your custom DNS configuration:

qq network_mod_network --interface-id ID --network-id ID --clear-dns-servers --clear-dns-search-domains 

Once you clear the custom configuration using the command above, the settings will revert to those assigned by DHCP on your cluster.

RESOLUTION

You should now be able to successfully configure custom DNS server and search domains with Qumulo Core

ADDITIONAL RESOURCES

QQ CLI: Networks and IP Addresses 

Like what you see? Share this article with your network!