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 node, 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.
- Download a
.qimg
file from Product Releases. - 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>
- 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>
- Connect to the new node using SSH and the node's IP address.
ssh admin@<node_IP_address>
- 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 theunconfigured_
portion from each command.
qq unconfigured_upgrade_config_set \
--path <pre-signed URL to qimg> \
--target 'prepare' - Use the following command to monitor the
prepare
status and wait for it to finish.
qq unconfigured_upgrade_status --monitor
- When the
UPGRADE_PREPARED
message appears, run the following command to begin the upgrade.
qq unconfigured_upgrade_config_set \
After a few minutes, the node restarts.
--path <pre-signed URL to qimg> \
--target 'arm' - 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.
- Connect to the new node using SSH and the node's IP address.
ssh admin@<node_IP_address>
- 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.
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
Like what you see? Share this article with your network!
Comments
0 comments