Print Email PDF

Performing Qumulo Core Upgrades by Using the qq CLI

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.
  • During a rolling reboot, the system will reboot one or more nodes (dependent upon protection levels) in succession, requiring a restriper job to finish before continuing with the next node(s).  If the cluster is under heavy write or delete load, this may take an extended period of time.

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.
Was this article helpful?
0 out of 0 found this helpful

Comments

0 comments

Please sign in to leave a comment.

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