English (US)
Deutsch Español Français
OPEN A CASE
KNOWLEDGE BASE
COMMUNITY
QUMULO TRENDS

KNOWLEDGE BASE

Articles in this section

Qumulo in AWS: Upgrade an Unconfigured Node

Avatar
Shawn Magee
  • Updated
Follow

IN THIS ARTICLE

Outlines how to start an unconfigured node and upgrade it to a newer version of Qumulo Core

REQUIREMENTS

  • Cloud Cluster with Qumulo Core 2.12.4 and above 
  • AWS 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.

Start a new node

  1. Go to the AWS Marketplace listing for your cluster.
  2. Start a new instance of the Amazon Machine Image for that listing. Note that the new instance must be started in the same VPC and Security Group as the cluster.
    • If an image is available with the same version of Qumulo Core as is used on your cluster, start an instance from this AMI. Otherwise, choose an image with the closest (older) version.
  3. Go to the Qumulo listing in the AWS Marketplace and click Continue to Subscribe.

    Screen_Shot_2019-05-21_at_2.55.58_PM.png

  4. Click Continue to Configuration.

    Screen_Shot_2019-05-21_at_2.56.50_PM.png

  5. Use the Fulfillment Option drop-down field to select Amazon Machine Image.

    Screen_Shot_2019-05-21_at_2.57.44_PM.png

  6. Use the Software Version field to select the release of Qumulo Core matching your cluster. If the exact version is not listed, choose an older version.

    unnamed.png

  7. Click Continue to Launch to start the image and use the configuration wizard to configure the VPC, Subnet, Security Group, Instance type, and SSH key.
  8. Launch the instance and note its IP address and Instance ID.

Your node is now ready to be upgraded to the newer software version. If it's already running the same version as your cluster, skip the rest of this article and proceed to follow the steps provided in Qumulo in AWS: Add a Node to an Existing Cloud Cluster.

Upgrade the node

Qumulo Core software versions must be upgraded incrementally (i.e., if the new node is running version 2.12.1 and your cluster uses 2.12.3, it must be upgraded to 2.12.2 before it can be upgraded again to 2.12.3). Consequently, you may need to go through these steps more than once in order to get the node's software updated to the version of Qumulo Core on your cluster. See Qumulo Core Upgrade Paths for valid upgrade details.

  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 to a location that the new node can access.
    • We recommend uploading to S3. Configure the S3 object to be accessible by the new instance. The http link for the object will be used below as the path for the upgrade commands.
  3. Connect to the new node via ssh using its IP address.
     
    ssh admin@node_IP_address
  4. Prepare the upgrade by running the following command using the path to the upgrade image you uploaded to S3.
     
    qq upgrade_config_set --path <qimg file path> --target "prepare"
  5. Issue the following command to monitor the ‘prepare’ status and wait for it to return.
     
    qq upgrade_status --monitor
  6. Once you see UPGRADE_PREPARED, run the following command to start the upgrade.
     
    qq upgrade_config_set --path <qimg file path> --target "arm"
  7. After a few minutes, the node will restart. Check that the upgrade was successful by running the following command and verifying the new version number:
     
    qq version

Your node has been upgraded! If the software version on the node matches that of your cluster, you can add it by following the steps provided in Qumulo in AWS: Add a Node to an Existing Cloud Cluster. If the new node is still on an older version, repeat this process with subsequent upgrades until the versions match.

RESOLUTION

You should now be able to successfully add and configure a new node for an existing cloud cluster

ADDITIONAL RESOURCES

Qumulo in AWS: Build a Multi-Instance Cluster with CloudFormation

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!

Related articles

Comments

0 comments

Please sign in to leave a comment.