This documentation is for an older version of the software. If you are using the current version of Cumulus Linux, this content may not be up to date. The current version of the documentation is available here. If you are redirected to the main page of the user guide, then this page may have been renamed; please search for it there.

Upgrade NetQ Software on Your Cloud Server

This document describes the steps required to upgrade the NetQ Software (versions 2.0.0 through 2.2.0) installed and running on your NetQ cloud server to NetQ version 2.2.2.

Cumulus Networks recommends upgrading NetQ only during a network maintenance window.

Events generated during the upgrade process will not be available in the database. Once the upgrade process is complete, the NetQ Agents resynchronize with the current state of the Host or Cumulus Linux switch with the NetQ Server.


Before you begin the upgrade process, please note the following:

  • The minimum supported Cumulus Linux version for NetQ 2.2.x is 3.3.2.
  • You must upgrade your NetQ Agents as well as the NetQ Platform.
  • You can upgrade to NetQ 2.2.x without upgrading Cumulus Linux.
  • The NetQ installer pod netq-installer should be up in either the Containercreating or Running state. The netq-installer pod state could also be ContainerCreating, in which case the host is initializing with the SSH keys.

Hardware Requirements

Cumulus NetQ software is supported on a variety of hardware.

Confirm that your hardware meets these minimum requirements to upgrade the VM.

The NetQ software requires a server with the following:

Hardware ComponentMinimum Requirement
ProcessorFour (4) virtual CPUs
Memory8 GB RAM
Local disk storage32 GB (SSD not required)
Network interface speed1 Gb NIC

You must also open port 31980 on your hardware to use the NetQ software.

NetQ Platform HyperVisor Requirements

The NetQ Platform can be installed as a Virtual Machine (VM) using one of the following hypervisors:

  • VMware ESXi™ 6.5 for servers running Cumulus Linux, CentOS, Ubuntu and RedHat operating systems.
  • KVM/QCOW (QEMU Copy on Write) image for servers running CentOS, Ubuntu and RedHat operating systems.

NetQ Agent Operating System Requirements

NetQ 2.2 Agents are supported on the following switch and host operating systems:

  • Cumulus Linux 3.3.2 and later
  • Ubuntu 16.04 or Ubuntu 18.04 (NetQ 2.2.2 and later)
  • Red Hat® Enterprise Linux (RHEL) 7.1
  • CentOS 7

Perform an In-place Upgrade of Cumulus NetQ

An in-place upgrade is recommended for upgrades from Cumulus NetQ 2.2.1. If you are upgrading from NetQ 2.2.0 or earlier, a disk image upgrade is recommended.

In-place Upgrade Workflow

Upgrading NetQ involves backing up your data, downloading and installing the new version of NetQ software, restoring your NetQ data, and upgrading and configuring the NetQ Agents.

Download the NetQ Software

To upgrade the NetQ software on your own hardware using a VM image:

  1. IMPORTANT: Confirm that your server hardware meets the requirements set out above.

  2. On the Cumulus Downloads page, select NetQ from the Product list box.

  3. Click 2.2 from the Version list box, and then select 2.2.2 from the submenu.

  4. Optionally, select the hypervisor you wish to use (VMware (Cloud) or KVM (Cloud)) from the Hypervisor/Platform list box.

    For customers with VMware/ESXi OVA deployments, Cumulus Networks recommends deploying a fresh installation of NetQ 2.2.2, rather than performing the upgrade from 2.1.x or 2.2.0, to take advantage of the performance improvements available with the new vmxnet3 and Paravirtualization SCSI drivers.

  5. Scroll down to review the images that match your selection criteria.

  6. Click Upgrade for the relevant version, being careful to select the correct deployment version.

Install and Configure the CLI

You must upgrade the CLI to make use of the modified upgrade command.

  1. Verify your /etc/apt/sources.list file has the repository reference for Cumulus NetQ.
cumulus@switch:~$ sudo nano /etc/apt/sources.list
deb CumulusLinux-3 netq-2.2
  1. Update the local apt repository, then install the NetQ apps package on the switch.
cumulus@switch:~$ sudo apt-get update
cumulus@switch:~$ sudo apt-get install netq-apps
  1. Configure the CLI server, using the IP address of your NetQ server.
cumulus@switch:~$ netq config add cli server
cumulus@switch:~$ netq config restart cli

Run the Upgrade Command

  1. Use the netq upgrade opta command to install the VM you downloaded above.
cumulus@switch:~$ netq upgrade opta tarball NetQ-2.2.2-opta.tgz
  1. Verify the release has been updated successfully.
cumulus@switch:~$ cat /etc/app-release

If you have changed the IP Address or hostname of the NetQ server, you need to re-register this address or hostname with the Kubernetes containers before you can continue.

  1. Reset all Kubernetes administrative settings. Run the command twice to make sure all directories and files have been reset.

    cumulus@switch:~$ sudo kubeadm reset -f  
    cumulus@switch:~$ sudo kubeadm reset -f
  2. Remove the Kubernetes configuration.

    cumulus@switch:~$ sudo rm /home/cumulus/.kube/config
  3. Reset the NetQ Platform install daemon.

    cumulus@switch:~$ sudo systemctl reset-failed
  4. Reset the Kubernetes service.

    cumulus@switch:~$ sudo systemctl restart cts-kubectl-config

    Note: Allow 15 minutes for the prompt to return.

Verify the Operation of NetQ on Your Server

  1. Run the netq show opta-health command to verify all applications are operating properly. Please allow 10-15 minutes for all applications to come up and report their status.
cumulus@<netq-platform-hostname>:~$ netq show opta-health
OPTA is healthy

If the results do not indicate the server is healthy after 30 minutes, open a support ticket and attach the output of the opta-support command.

  1. Verify that NTP is configured and running. NTP operation is critical to proper operation of NetQ. Refer to Setting Date and Time in the Cumulus Linux User Guide for details and instructions.

  2. Continue the NetQ upgrade by upgrading the NetQ Agent on each switch or host you want to monitor. Refer to Install the NetQ Agent and CLI on Switches for instructions.

Perform a Disk Image Upgrade of Cumulus NetQ

A disk image upgrade is recommended for upgrades from Cumulus NetQ 2.2.0 or earlier. An in-place upgrade is recommended for upgrades from NetQ 2.2.1.

Disk Image Upgrade Workflow

Upgrading NetQ involves backing up your data, downloading and installing the new version of NetQ software, restoring your NetQ data, and upgrading and configuring the NetQ Agents.

Please follow the instructions in the following topics in this order:

  1. Backup Your NetQ Data

  2. Download and Install the New Software

  3. Restore Your NetQ Data

  4. Install and Configure NetQ Agent and CLI on Switches and Hosts