Configure Cluster DNS
DNS is critical to the default operation of Redis Enterprise Software deployments. This can be altered, but instead using the Discovery Service, which utilizes pure IP-based connectivity as it is compliant with the Redis Sentinel API.
As part of the high availability capabilities in Redis Enterprise Software, each node includes a small DNS server for managing various internal cluster functionalities, such as automatic failover or automatic migration. Therefore, nodes that provision Redis Enterprise Software should run only the DNS server included with the software. They should not run any other DNS servers; otherwise, unexpected behavior can occur.
Cluster name (FQDN) and connection management
Whether you’re administering Redis Enterprise Software or accessing databases, there are two ways to connect:
URL-based connections - URL-based connections use DNS to resolve the fully qualified cluster domain name. This means that DNS records might need to be updated when topology changes, such as adding (or removing) nodes from the cluster.
Because apps and other clients connections rely on the URL, they do not need to be modified when topology changes.
IP-based connections - IP-based connections do not require DNS setup, as they rely on the underlying TCP/IP addresses. As long as topology changes do not change the address of the cluster nodes, no configuration changes are needed, DNS or otherwise.
However, changes to IP addresses (or changes to IP address access) impact all apps and clients connecting to the node.
URL-based connections and how to set up cluster name (FQDN)
The Fully Qualified Domain Name (FQDN) is the unique cluster identifier that enables clients to connect to the different components of Redis Enterprise Software. The FQDN is a crucial component of the high-availability mechanism because it’s used internally to enable and implement automatic and transparent failover of nodes, databases shards, and endpoints.
Name the cluster domain name
You can name the cluster domain name using either DNS or IP addresses.
Use DNS if you:
- have your own domain
- want to integrate the cluster into that domain
- can access and update the DNS records for that domain
Make sure that the cluster and at least one node (preferably all nodes) in the cluster are correctly configured in the DNS with the appropriate NS entries.
- Your domain is: mydomain.com - You would like to name the Redis Enterprise Software cluster: redislabscluster - You have three nodes in the cluster: - node1 with IP 18.104.22.168 - node2 with IP 22.214.171.124 - node3 with IP 126.96.36.199
In the FQDN field, enter the value
redislabscluster.mydomain.comand add the following records in the DNS for mydomain.com:
redislabscluster.mydomain.com NS node1.redislabscluster.mydomain.com node2.redislabscluster.mydomain.com node3.redislabscluster.mydomain.com node1.redislabscluster.mydomain.com A 188.8.131.52 node2.redislabscluster.mydomain.com A 184.108.40.206 node3.redislabscluster.mydomain.com A 220.127.116.11
Zero-configuration using mDNS (Development option only)
mDNS (Multicast DNS) is a standard protocol that provides DNS-like name resolution and service discovery capabilities to machines on local networks with minimal to no configuration. Because not all clients support mDNS, ensure first that the clients that are connecting to the cluster actually have mDNS support, and that the network infrastructure permits mDNS/multi-casting between them and the cluster nodes.
Configuring the cluster to support mDNS requires you to assign the cluster a
For example, if you want to name the Redis Enterprise Software cluster
redislabscluster.local in the FQDN field.
When using the DNS or mDNS option, failover can be done transparently and the DNS is updated automatically to point to the IP of the new master.
When you use the IP-based connection option, the FQDN does not need to have any special format because clients use IP addresses instead of hostnames to access the databases so you are free to choose whatever name you want. Using the IP-based connection option does not require any DNS configuration either.
To administer the cluster you do need to know the IP address of at least one of the nodes in the cluster. Once you have the IP address, you can simply connect to port number 8443 (for example: https://10.0.0.12:8443). However, as the topology of the cluster changes and node with the given IP address is removed, you need to remember the IP address of another node participating in this cluster to connect to the admin console and manage the cluster.
Applications connecting to Redis Software databases have the same constraints. When using the IP-based connection method, you can use the Discovery Service to discover the database endpoint for a given database name as long as you have an IP address for at least one of the nodes in the cluster. The API used for discovery service is compliant with the Redis Sentinel API.
To test your connection, try pinging the service. For help, see [Connect yo your database]connYou can find a simple example of URL and IP-based connection in the “Testing Connectivity to your Database” section of Creating a new database.