Print Email PDF

Upgrading an Unconfigured Qumulo Node in AWS


  • 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


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.

  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.


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:

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.

Was this article helpful?
0 out of 0 found this helpful



Please sign in to leave a comment.

Have more questions?
Open a Case
Share it, if you like it.