Qumulo Core Upgrades via CLI

IN THIS ARTICLE

Outlines how to use upgrade-related CLI commands in Qumulo Core

REQUIREMENTS

• Cluster running Qumulo Core (Qumulo Core 4.1.0 or higher for updated commands)

NOTE: Clusters running 2.1.1 and above can upgrade via the Web UI. Reference the article Qumulo Core Upgrades via UI for additional details. 

PROCESS

Qumulo Core 4.1.0 or Higher

Starting in Qumulo Core 4.1.0, the upgrade commands have been refreshed for a smoother user experience. Refer to the Qumulo Core 4.0.6 and Below section later in this document for previous commands.

To upgrade your cluster:

• Upload the upgrade file qumulo_core_x.x.x.qimg to any directory on the cluster via a client protocol like NFS or SMB
• Connect to a node via ssh using your IP address:

ssh admin@your_IP_address

• Become root by running the following command:

sudo -s

• For an upgrade performed in a single command, simply enter:

qq upgrade_cluster --path /qumulo_core_x.x.x.qimg

NOTE: If you would like to upgrade your cluster without the new progress bar, add --no-monitor before the --path parameter. With monitoring disabled, the upgrade cannot be canceled once it has started.

• If you would prefer to upgrade in two phases, you can do so using the following two commands:

qq upgrade_cluster prepare --path /qumulo_core_x.x.x.qimg
qq upgrade_cluster commit

NOTE: Performing the upgrade in two steps allows you more refined control over the timing of the upgrade. There is no client downtime during the prepare phase—only during the commit itself. Refer to Qumulo Core Upgrade Paths for additional information.

Once the progress bar indicates that the upgrade has completed, your cluster will reboot.

To view upgrade status:

• You can check on the current upgrade status of your cluster by using the following command:

qq upgrade_status

• If no upgrade is currently in progress, a message is displayed indicating that. If an upgrade is actively underway, you'll see a progress bar similar to the one shown in the image above.
• To view the raw JSON output of the upgrade status (similar to the CLI behavior prior to Qumulo Core 4.1.0) run the following command:

qq upgrade_status --no-monitor

{
“error_info”: null,
“progress”: 29,
“settings”: {
“auto_commit”: false,
“install_path”: “/qumulo_core_x.x.x.qimg”
“target_version”: “4.1.1.”,
“upgrade_type”: “SOFTWARE_ONLY”
},
“state”: “UPGRADE_STATE_PREPARING”
}

Qumulo Core 4.0.6 or Below

• Upload the upgrade file qumulo_core_x.x.x.qimg to any directory on the cluster via a client protocol like NFS or SMB
• Connect to a node via ssh using your IP address:

ssh admin@your_IP_address

• Become root by running the following command:

sudo -s

• Confirm that the upgrade status is “IDLE” using the command below:

qq upgrade_status

• The output should reflect the following:

{
 "blocked_reason": "", 
 "details": "", 
 "error_message": "", 
 "error_state": "UPGRADE_ERROR_NO_ERROR", 
 "install_path": "", 
 "is_blocked": false, 
 "state": "UPGRADE_IDLE"
}

• Prepare the upgrade by running the following command using the path to the .qimg file you uploaded:

qq upgrade_config_set --path /qumulo_core_x.x.x.qimg --target prepare

• Issue the following command to monitor the ‘prepare’ status:

qq upgrade_status --monitor

• Proceed once you see the following output:

UPGRADE_PREPARED

• Arm the upgrade to begin the installation using the command below: 

qq upgrade_config_set --path /qumulo_core_x.x.x.qimg --target arm

NOTE: You will need to re-login after the upgrade completes and the Qumulo process is restarted.

• Check that the upgrade was successful by running the following command and verifying the new version number:

qq version

RESOLUTION

You should now be able to successfully use upgrade-related CLI commands in Qumulo Core

ADDITIONAL RESOURCES

QQ CLI: Comprehensive List of Commands

Qumulo Core Upgrades via UI

Product Releases and Announcements

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