Qumulo in AWS: Upgrade an Unconfigured Node

IN THIS ARTICLE

This article explains how you can upgrade an unconfigured Qumulo node on AWS to a more recent version of Qumulo Core.

REQUIREMENTS

• An unconfigured Qumulo node on AWS with Qumulo Core 4.1.5 (or higher) 
• A .qimg file for your node. For more information, see Product Releases.
• AWS Console access
• Command line (qq CLI) tools installed using the API Tools in the Web UI

DETAILS

One of the benefits of cloud-hosted storage is the ability to add storage dynamically. If the Qumulo Core version of your new node is older than that of your cluster, you must upgrade the node before adding it to your cluster. To upgrade your note, you must start it and then use the qq CLI.

For more information about creating a new node, see Qumulo in AWS: Launch a New Node for an Existing Cloud Cluster.

To Upgrade an Unconfigured Node

To upgrade a  node, you must upload the upgrade .qimg to a node-accessible location. For AWS, we recommend uploading the .qimg file to S3 and then generating a pre-signed object URL.

1. Download a .qimg file from Product Releases.
2. Upload the file by running the following command (with the aws cli utility configured and authenticated):
   

   aws s3 cp <local qimg local file path> <object path>

3. To grant the new node permission to read the upgrade file, generate a pre-signed URL.
   NOTE: You use this pre-signed URL in the following steps. If your node has permission to access the object directly (for exactly permissions inherited through the VPC), you can skip this step.
   

   aws s3 presign <object path>

4. Connect to the new node using SSH and the node's IP address.
   

   ssh admin@node_IP_address

5. Prepare the upgrade using the following command and the path to the pre-signed URL generated for the upgrade image that you uploaded to S3.
   NOTE: For clusters running Qumulo Core 4.1.0 or lower, the commands in the following examples differ. In this case, remove the "unconfigured_" portion from each command.
   

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

6. Use the following command to monitor the prepare status and wait for it to finish.
   

   qq unconfigured_upgrade_status --monitor

7. When the UPGRADE_PREPARED message appears, run the following command to begin the upgrade.
   

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

   After a few minutes, the node restarts.
8. To check that the upgrade was successful, running the following command and verify the new version number:
   

   qq version

   Your node is upgraded. When the node and cluster software versions match, you can add the node to your cluster. For more information, see Qumulo in AWS: Add a Node to an Existing Cloud Cluster.
   NOTE: If your node still runs an older version, repeat this process with all subsequent upgrades until the versions match.
   

Troubleshooting

If you can't upgrade your unconfigured node successfully, test that the node can access the .qimg file.

1. Connect to the new node using SSH and the node's IP address.
   

   ssh admin@node_IP_address

2. To verify access, run the following command.
   

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

If the curl command doesn't work and you receive an error, try the following:

• Use a pre-signed URL
• Check that the object is accessible from another computer in the same VPC using the same URL
• Troubleshoot your S3 VPC endpoint connection

Once you no longer receive an error using the curl command, try upgrading the node again. If the upgrade continues to be unsuccessful, contact Qumulo Care.

RESOLUTION

You now know how to upgrade an unconfigured Qumulo node on AWS.

ADDITIONAL RESOURCES

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

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

QQ CLI: Cluster Configuration

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