Performing Qumulo Core Upgrades by Using the qq CLI

IN THIS ARTICLE

This article outlines how you can upgrade Qumulo Core by using the qq CLI.

PROCESS

Qumulo Core 4.1.0 (and Higher)

To Upgrade Your Cluster

1. Upload the upgrade file qumulo_core_x.x.x.qimg to any directory on the cluster by using a client protocol such as NFS or SMB
2. Connect to a node by using SSH and its IP address.
3. To become root, use the sudo -s command.
4. Do one of the following:
   • In Qumulo Core 5.1.0.1 (and higher):
     • To perform an upgrade immediately with a rolling reboot, use the following command.

       qq upgrade_cluster --rolling \
         --path /qumulo_upgrade_x.x.x.qimg

     • To perform an upgrade in two phrases with a rolling reboot, use the following commands.

       qq upgrade_cluster prepare --rolling \
         --path /qumulo_upgrade_x.x.x.qimg
       qq upgrade_cluster commit

   • In Qumulo Core 5.0.6 (and lower):
     • To perform the upgrade immediately, use the following command.

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

     • To perform the upgrade in two phrases, use the following commands.

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

Notes:

• There is no client downtime during the prepare phase, only during the commit itself.
• To upgrade your cluster without the new progress bar, add the --no-monitor flag. If you disable monitoring, you can't cancel the upgrade after it begins.

When the progress bar indicates that the upgrade has completed, your cluster reboots.

To View the Cluster Upgrade Status

To view the upgrade status for your cluster, use the qq upgrade_status command.

• If no upgrade is currently in progress, the system reports this.
• If an upgrade is in progress, a progress bar appears.

To view the raw JSON output of the upgrade status, run the qq upgrade_status --no-monitor command. The following is example output.

{
  "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 (and Lower)

1. Upload the upgrade file qumulo_core_x.x.x.qimg to any directory on the cluster by using a client protocol such as NFS or SMB
2. Connect to a node by using SSH and its IP address.
3. To become root, use the sudo -s command.
4. To confirm that the upgrade status is IDLE, use the qq upgrade_status command. The following is example output.

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

5. To prepare the upgrade, use the following command:

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

6. To monitor the prepare status, use the following command:

   qq upgrade_status --monitor

   When the UPGRADE_PREPARED status appears, you can begin the installation.
7. To arm the upgrade, use the following command:

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

   Note: When the upgrade completes and the Qumulo process restarts, you must log in again.
8. To check that the upgrade was successful, use the qq version command.

ADDITIONAL RESOURCES

QQ CLI: Comprehensive List of Commands

Qumulo Core Upgrades via UI

Product Releases and Announcements