If you are using the current version of Cumulus NetQ, the content on this page 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.

Prepare Your Existing NetQ Appliances for a NetQ 4.0 Deployment

This topic describes how to prepare a NetQ 3.3.x or earlier NetQ Appliance before installing NetQ 4.0. The steps are the same for both the on-premises and cloud appliances. The only difference is the software you download for each platform. After you complete the steps included here, you are ready to perform a fresh installation of NetQ 4.0.

The figure below summarizes the preparation workflow:

To prepare your appliance:

  1. Verify that your appliance is a supported hardware model.

  2. For on-premises solutions using the NetQ On-premises Appliance, optionally back up your NetQ data.

    1. Run the backup script to create a backup file in /opt/<backup-directory>.

      Be sure to replace the backup-directory option with the name of the directory you want to use for the backup file. This location must be somewhere that is off of the appliance to avoid it being overwritten during these preparation steps.

      cumulus@<hostname>:~$ ./backuprestore.sh --backup --localdir /opt/<backup-directory>
    2. Verify the backup file creation was successful.

      cumulus@<hostname>:~$ cd /opt/<backup-directory>
      cumulus@<hostname>:~/opt/<backup-directory># ls
  3. Install Ubuntu 18.04 LTS

    Follow the instructions here to install Ubuntu.

    Note these tips when installing:

    • Ignore the instructions for MAAS.

    • You should install the Ubuntu OS on the SSD disk. Select Micron SSD with ~900 GB at step #9 in the Ubuntu instructions.

    • Set the default username to cumulus and password to CumulusLinux!.

    • When prompted, select Install SSH server.

  4. Configure networking.

    Ubuntu uses Netplan for network configuration. You can give your appliance an IP address using DHCP or a static address.

    • Create and/or edit the /etc/netplan/01-ethernet.yaml Netplan configuration file.

      # This file describes the network interfaces available on your system
      # For more information, see netplan(5).
          version: 2
          renderer: networkd
                  dhcp4: yes
    • Apply the settings.

      $ sudo netplan apply
    • Create and/or edit the  /etc/netplan/01-ethernet.yaml Netplan configuration file.

      In this example the interface, eno1, has a static IP address of with a gateway at and DNS server at and

      # This file describes the network interfaces available on your system
      # For more information, see netplan(5).
          version: 2
          renderer: networkd
                  dhcp4: no
                  addresses: []
                      addresses: [,]
    • Apply the settings.

      $ sudo netplan apply
  5. Update the Ubuntu repository.

    1. Reference and update the local apt repository.

      root@ubuntu:~# wget -O- https://apps3.cumulusnetworks.com/setup/cumulus-apps-deb.pubkey | apt-key add -
    2. Add the Ubuntu 18.04 repository.

      Create the file /etc/apt/sources.list.d/cumulus-host-ubuntu-bionic.list and add the following line:

      root@ubuntu:~# vi /etc/apt/sources.list.d/cumulus-apps-deb-bionic.list
      deb [arch=amd64] https://apps3.cumulusnetworks.com/repos/deb bionic netq-latest

      The use of netq-latest in this example means that a get to the repository always retrieves the latest version of NetQ; this applies even for major version updates. If you want to keep the repository on a specific version — such as netq-4.0 — use that instead.

  6. Install Python.

    Run the following commands:

    root@ubuntu:~# apt-get update
    root@ubuntu:~# apt-get install python python2.7 python-apt python3-lib2to3 python3-distutils
  7. Obtain the latest NetQ Agent and CLI package.

    Run the following commands:

    root@ubuntu:~# apt-get update
    root@ubuntu:~# apt-get install netq-agent netq-apps
  8. Download the bootstrap and NetQ installation tarballs.

    1. On the My Mellanox support page, log in to your account. If needed create a new account and then log in.

      Your username is based on your Email address. For example, user1@domain.com.mlnx.

    2. Open the Downloads menu.

    3. Click Software.

    4. Open the Cumulus Software option.

    5. Click All downloads next to NVIDIA NetQ.

    6. Select 4.0.0 from the NetQ Version dropdown.

    7. Select KVM from the Hypervisor dropdown.

    8. Click Show Download.

    9. Verify this is the correct image, then click Download.

    10. Copy these two files, netq-bootstrap-4.0.0.tgz and either NetQ-4.0.0.tgz (on-premises) or NetQ-4.0.0-opta.tgz (cloud), to the /mnt/installables/ directory on the appliance.

    11. Verify that the needed files are present and of the correct release. This example shows on-premises files. The only difference for cloud files is that it should list NetQ-4.0.0-opta.tgz instead of NetQ-4.0.0.tgz.

      cumulus@<hostname>:~$ dpkg -l | grep netq
      ii  netq-agent   4.0.0-ub18.04u33~1614767175.886b337_amd64   NVIDIA NetQ Telemetry Agent for Ubuntu
      ii  netq-apps    4.0.0-ub18.04u33~1614767175.886b337_amd64   NVIDIA NetQ Fabric Validation Application for Ubuntu
      cumulus@<hostname>:~$ cd /mnt/installables/
      cumulus@<hostname>:/mnt/installables$ ls
      NetQ-4.0.0.tgz  netq-bootstrap-4.0.0.tgz
    12. Run the following commands.

      sudo systemctl disable apt-{daily,daily-upgrade}.{service,timer}
      sudo systemctl stop apt-{daily,daily-upgrade}.{service,timer}
      sudo systemctl disable motd-news.{service,timer}
      sudo systemctl stop motd-news.{service,timer}
  9. Run the Bootstrap CLI.

    Run the bootstrap CLI on your appliance. Be sure to replace the eth0 interface used in this example with the interface or IP address on the appliance used to listen for NetQ Agents.

If you are creating a server cluster, you need to prepare each of those appliances as well. Repeat these steps if you are using a previously deployed appliance or refer to Install the NetQ System for a new appliance.

You are now ready to install the NetQ Software. Refer to Install NetQ Using the Admin UI (recommended) or Install NetQ Using the CLI.