Qumulo in GCP: Upgrade an Unconfigured Node

IN THIS ARTICLE 

Outlines how to upgrade an unconfigured node for a Qumulo cluster in GCP

REQUIREMENTS

• GCP Cluster running Qumulo Core 2.14.0 or above
• A .qimg file for the version of software that your new node can be upgraded to via our Product Releases page
• GCP Console Access
• Command line (QQ CLI) tools installed via API & Tools in the Web UI

DETAILS

One of the perks of hosting your storage in the cloud is the ability to dynamically add more as your storage needs increase. Starting up a new node (a.k.a, launching a deployment) is a simple process and adding the instance to an existing cloud cluster is even easier.

Keep in mind that if this new node uses an older version of Qumulo Core than your cluster, it must be upgraded before you can add it. The process of upgrading a new node is simply a matter of starting the node up and then upgrading it via the QQ CLI. Once the node's software version matches the one your deployment uses, you can add it to your cluster.

Launch a New Instance

1. Navigate to the GCP Marketplace listing for your cluster.
2. Launch a new instance for that listing in the same VPC and Security Group as the existing cluster.
   
   
   
   
3. Ensure Automatically cluster your instances is unchecked.
4. Click Deploy.

IMPORTANT! If an image is available with the same version of Qumulo Core used on your cluster, start an instance from this image. Otherwise, choose an image with the closest (older) version.

Upgrade the Nodes via the QQ CLI

1. Upload the .qimg upgrade file to a location that the new node can access.
2. Connect to the new node via ssh using its IP address. 
   

   ssh admin@node_IP_address

3. Prepare the upgrade by running the following command using the path to the upgrade image you previously uploaded.
   

   qq upgrade_config_set --path <qimg file path> --target "prepare"

4. Use the following command to monitor the ‘prepare’ status until it returns UPGRADE_PREPARED.
   

   qq upgrade_status --monitor

5. Once you see UPGRADE_PREPARED, run the following command to start the upgrade.
   

   qq upgrade_config_set --path <qimg file path> --target "arm"

6. The node will restart after a few minutes after completing the upgrade. Check that the upgrade was successful by running the following command and verifying the new version number.
   

   qq version

If the software version on the node matches that of your cluster, you can then proceed to follow the steps provided in Qumulo in GCP: Add a Node to an Existing Cloud Cluster. If the new node is still on an older version, repeat this process with subsequent upgrades until the versions match.

RESOLUTION 

You should now be able to successfully upgrade an unconfigured node for Qumulo cluster in GCP

ADDITIONAL RESOURCES

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

Qumulo in GCP: Deploy an Instance

Qumulo in GCP: Build a Multi-Instance Cluster

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