Upgrade the NetQ Platform

The first step in upgrading your NetQ 2.4.0 installation to NetQ 2.4.1 is to upgrade your NetQ Platform. This topic describes how to upgrade this for both on-premises and cloud deployments.

Prepare for Upgrade

Two important steps are required to prepare for upgrade of your NetQ Platform:

  • Download the necessary software tarballs
  • Update the Debian packages on the hardware

Optionally, you can choose to back up your NetQ Data before performing the upgrade.

To complete the preparation:

  1. Optionally back up your NetQ 2.4.0 data. Refer to Back Up Your NetQ Data.

  2. Download the relevant software.

    1. Go to the Cumulus Downloads page, and select NetQ from the Product list.

    2. Select 2.4 from the Version list, and then click 2.4.1 from the submenu.

    3. Select the relevant software from the HyperVisor/Platform list:

      Your Deployment TypeHypervisor/Platform SelectionDownloaded Filename
      NetQ On-premises Platform running KVMKVMNetQ-2.4.1.tgz
      NetQ Cloud Platform running KVMKVM (Cloud)NetQ-2.4.1-opta.tgz
      NetQ On-premises Platform running VMwareVMwareNetQ-2.4.1.tgz
      NetQ Cloud Platform running VMwareVMware (Cloud)NetQ-2.4.1-opta.tgz
      NetQ Appliance (on-premises)ApplianceNetQ-2.4.1.tgz
      NetQ Cloud ApplianceAppliance (Cloud)NetQ-2.4.1-opta.tgz
    4. Scroll down and click Download. For example: The NetQ Appliance images.

  3. Copy the file to the /mnt/installables/ directory on your hardware.

  4. Update the NetQ debian packages.

    sudo dpkg --remove --force-remove-reinstreq netq-apps netq-agent 2>/dev/null
    sudo apt-get update
    sudo apt-get install -y netq-agent netq-apps
    

You can now upgrade your hardware using the NetQ Admin UI, in the next section, or the NetQ CLI .

Upgrade Your Hardware Using the NetQ Admin UI

After completing the preparation steps, upgrading your NetQ Platform(s) or NetQ Appliance(s) is simple using the Admin UI.

To upgrade your hardware:

  1. Run the bootstrap CLI to upgrade the Admin UI itself.

    On-premises Deployments

    netq bootstrap master upgrade /mnt/installables/NetQ-2.4.1.tgz
    

    Cloud Deployments

    netq bootstrap master upgrade /mnt/installables/NetQ-2.4.1-opta.tgz
    

  2. Open the Admin UI by entering https://<hostname-or-ipaddress>:8443 in your browser address field.

  3. Click Begin Upgrade and follow the instructions in the UI, providing the NetQ installation tarball when requested.

Upgrade Your Hardware Using the NetQ CLI

After completing the preparation steps, upgrading your NetQ Platform(s) or NetQ Appliance(s) is simple using the NetQ CLI.

To upgrade your hardware:

  1. Run the appropriate netq upgrade command.

    On-premises Deployments

    netq upgrade bundle /mnt/installables/NetQ-2.4.1.tgz
    

    Cloud Deployments

    netq upgrade bundle /mnt/installables/NetQ-2.4.1-opta.tgz
    

  2. After the upgrade is completed, confirm the upgrade was successful.

    cat /etc/app-release
    

    The output should look like this:

    On-premisesCloud
    NetQ Platform
    • KVM:
      APPLIANCE_VERSION=2.4.1
      APPLIANCE_MANIFEST_HASH=E9361…12BE7
      APPLIANCE_NAME=”<NetQ Platform Name>“
    • VMware:
      APPLIANCE_VERSION=2.4.1
      APPLIANCE_MANIFEST_HASH=7916C…6D0EF
      APPLIANCE_NAME=”<NetQ Platform Name>“
    • KVM:
      APPLIANCE_VERSION=2.4.1
      APPLIANCE_MANIFEST_HASH=383E9…F4371
      APPLIANCE_NAME=”<NetQ Cloud Platform Name>“
    • VMware:
      APPLIANCE_VERSION=2.4.1
      APPLIANCE_MANIFEST_HASH=E6176…A3EA1
      APPLIANCE_NAME=”<NetQ Cloud Platform Name>“
    NetQ ApplianceAPPLIANCE_VERSION=2.4.1
    APPLIANCE_MANIFEST_HASH=ADB58…E6732
    APPLIANCE_NAME=“NetQ Appliance”
    APPLIANCE_VERSION=2.4.1
    APPLIANCE_MANIFEST_HASH=4F50D…57FE1
    APPLIANCE_NAME=“NetQ Cloud Appliance”