IP failover with Qumulo Core

IN THIS ARTICLE

Outlines how to enable IP Failover in Qumulo Core

REQUIREMENTS

• Cluster running Qumulo Core
• Command line (CLI) tools installed via API & Tools tab

PROCESS

IP Failover is a high-availability feature that allows a node's virtual IP address(es) to be reassigned to other nodes in the cluster should a node go offline for any reason.

In addition to the fixed IP range assigned to a cluster, an administrator can set a floating range of addresses that can be reshuffled amongst online nodes as necessary. When using IP Failover, it is recommended that the cluster's client-facing DNS record be pointed at these floating IPs as opposed to the fixed range.

For example, in a BIND zone, your records may look something like this where 10.101.1.201-204 is the floating range:

Clients mount the cluster using the Qumulo hostname:

mount -t nfs -o rsize=524288,wsize=524288 qumulo:/production/ /production

In a node outage scenario, any IP in the floating range that was assigned to the offline node would move to another available node ensuring that connected clients can continue writing and reading to/from the cluster. Typically the time it takes to fail an IP over to another node will cause only a momentary blip in any running workloads.

Please note that certain connections like SMB will have to re-connect, as they require a new TCP connection. However, the failover is fast enough that most operating systems' retry mechanism can handle it.

You can use the Qumulo Core Web UI or the CLI to set up IP Failover on your Qumulo cluster.

WEB UI

1. Log in to your cluster's Web UI as 'admin'.
2. Hover over the Cluster menu and select Network Configuration.
   
   
3. On the Network Configuration page, click on Edit Static Settings.
   
   
4. In the fields for Persistent IPv4 Addresses and Floating IPv4 Addresses, enter your fixed and floating ranges.
   
   
5. Click Save.

QQ CLI

1. Using a node's IP address, ssh to the cluster as admin.

ssh admin@10.101.1.101

2. Login as root.

sudo -s

3. Run the following qq command replacing the IP range with your preferred floating range.

qq network_conf_mod --floating-ip-ranges 10.100.1.201-204

Note: We recommend assigning enough floating IP addresses so that each node will have the total number of nodes minus one for the number of floating IP addresses (up to 10 per node). The math to use is (N-1)*N where N is the total number of nodes in the cluster. Assuming many client connections, this best practice could help evenly distribute the connections from the lost node onto the remaining nodes as needed. For example, in a 4 node cluster when 1 node goes offline, its 3 virtual IPs would then float to each of the remaining 3 nodes.

RESOLUTION

You should now be able to successfully configure IP failover in Qumulo Core

ADDITIONAL RESOURCES

Video: Network Configuration

QQ CLI: Networks and IP Addresses

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