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 is a simple process; if the 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.

NOTE: 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.

Upgrade an Unconfigured Node

To upgrade the node, you'll need to upload the .qimg to a cloud object store and ensure the node has access using a pre-signed object URL. Keep in mind that these steps are unnecessary if the node has permission to access the object directly (permission inherited through the VPC). We recommend uploading and configuring the object to be accessible by the new instance on GCP. The http link for the object will be used below as the path for the upgrade commands.

1. Obtain a .qimg file for the version of software that your new node can be upgraded to via our Product Releases page.

2. Upload the upgrade file by running the following command with the gsutil cli utility configured and authenticated:
   

   gsutil cp <local qimg file path> <object path>

3. Generate a pre-signed URL to grant the new node permission to read the upgrade file. Note that this pre-signed URL is used in the steps below. Keep in mind that this step is unnecessary if the node has permission to access the object directly (e.g. permission inherited through the VPC).
   

   gsutil signurl <service account key file path> <object path>

4. Connect to the new node via ssh using its IP address. 

   ssh admin@node_IP_address

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

   qq upgrade_config_set --path <pre-signed URL to qimg> --target "prepare"

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

   qq upgrade_status --monitor

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

   qq upgrade_config_set --path <pre-signed URL to qimg> --target "arm"

8. 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

Your node has been upgraded! Once the software versions match between the cluster and the new node, you can successfully add it to your cluster using the Qumulo in GCP: Add a Node to an Existing Cloud Cluster article as a guide. If the new node is still running an older version, repeat this process with subsequent upgrades until the versions match.

Troubleshooting

If you are unable to successfully upgrade your unconfigured node, test that the node can access the qimg file.

1. Connect to the new node via ssh using its IP address.
   

   ssh admin@node_IP_address

2. Run the following command to verify access:
   

   curl "<object url>" --range 0-10

If the curl command above does not work and you receive an error, attempt the following:

• Use a pre-signed URL (if not already)
• Check that the object is accessible from another computer in the same VPC via the same URL

Once you no longer receive an error using the curl command above, re-attempt to upgrade the node. If the upgrade is unsuccessful again, contact Qumulo Care.

RESOLUTION 

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

ADDITIONAL RESOURCES

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

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!