Print Email PDF

Qumulo in GCP: Add a Node to an Existing Cloud Cluster


Outlines how to add a node to an existing Qumulo cluster in GCP


Google Cloud Platform (GCP) account

  • A Qumulo cluster in GCP running Qumulo Core 2.14.0 or above
  • One or more unconfigured Qumulo nodes in Google Cloud. For details on how to launch a new node, check out the Qumulo in GCP: Launch a New Node for an Existing Cloud Cluster article.
  • Google Cloud Console access
  • Command line (qq CLI) tools installed via API & Tools in the Web UI

IMPORTANT! If you have configured IP failover for your cloud cluster, you must add additional floating IP's prior to adding another node. Additionally, the new node must have the same IAM role as existing nodes. Reference the Qumulo in GCP: Configure IP Failover article for additional details. 


Running a clustered configuration of Qumulo in Google Cloud across 4 or more Qumulo nodes improves performance and increases capacity. Larger systems with higher node numbers will have increased storage efficiency dependent on the initial number of nodes used to form the cluster. The process of adding a new node to an existing cloud cluster is incredibly straightforward using the internal IPs of the Google Cloud instance. 

IMPORTANT! To successfully add new nodes to an existing Qumulo deployment, the Qumulo version must match between all nodes. If a new node uses an older version of Qumulo Core than your cluster, it must be upgraded before you can add it using the steps provided in the Qumulo in GCP: Upgrade an Unconfigured Node article.

Add a node via the Web UI

  1. In a browser window, enter https:// followed by the Internal IP address included in the Description tab of the instance listing for any node on the existing cluster.

    NOTE: Qumulo is configured with a self-signed certificate by default which may cause your browser to display a warning. This is normal behavior. A custom certificate can be installed at a later time to avoid the warning if needed. At the warning, select ADVANCED and click Proceed to continue.

  2. Login to the Qumulo Core Web UI.
  3. Hover over the Cluster menu and click Add Nodes.


  4. Enter the list of IP addresses of the unconfigured nodes into the text box and click Add Selected Nodes to Cluster.


  5. Select Yes to confirm the addition of the selected node(s).


  6. A dialog box will display as the node(s) are configured and added to the cluster.


Once the new node is configured and added, the cluster Overview page will appear with a successful confirmation banner at the top. The newly-configured node(s) will now display in the listing table for the cluster.

NOTE: Existing nodes will retain their numbering once the new node is added.

Add a node via the QQ CLI

  1. SSH onto one of the nodes using the IP address or the qq tool remotely.
  2. Run the following command using the internal IP addresses from the node(s) that will be added to the cluster. Separate multiple IP addresses with a space: 
qq node_add --node-ips INTERNAL_IP 


You should now be able to successfully add a node to an existing Qumulo cluster in GCP


Qumulo in GCP: Launch a New Node for an Existing Cloud Cluster

Qumulo in GCP: Upgrade an Unconfigured Node

Qumulo in GCP: Configure IP Failover

Qumulo in GCP: Deploy a Cloud Cluster


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

Was this article helpful?
0 out of 0 found this helpful



Please sign in to leave a comment.

Have more questions?
Open a Case
Share it, if you like it.