IN THIS ARTICLE
This article explains how you can upgrade an unconfigured Qumulo node on GCP to a more recent version of Qumulo Core.
REQUIREMENTS
- An unconfigured Qumulo node on GCP with Qumulo Core 4.1.5 (or higher)
- A
.qimg
file for your node. For more information, see Product Releases. - GCP 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 GCP: 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 Google Cloud, we recommend uploading the .qimg
file to Google Cloud Object Storage 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
gsutil
cli utility configured and authenticated):
gsutil cp <local qimg 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.
gsutil signurl <service account key file path> <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 Google Cloud Object Storage.
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"
- 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 --path <pre-signed URL to qimg> --target "arm"
After a few minutes, the node restarts. - 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 GCP: 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
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 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 a Cloud Cluster
Like what you see? Share this article with your network!
Comments
0 comments