Upgrade NetQ Virtual Machines

This page describes how to upgrade your NetQ virtual machines. Note that the upgrade instructions vary depending on NetQ version you’re currently running.

For deployments running:

• 4.9.0, 4.8.0: upgrade directly to NetQ 4.10.0. NetQ 4.8.0 on-premises cluster deployments must incrementally upgrade to 4.9.0 before upgrading to 4.10.0.
• 4.7.0 or earlier: back up your NetQ data and perform a new installation

During the upgrade process, NetQ will be temporarily unavailable.

Before You Upgrade

1. Verify that Kubernetes is running and the admin app is up:

cumulus@masternode:~$ /home/cumulus# kubectl get pods|grep admin
    netq-app-admin-masternode                            1/1     Running            0               15m

If the output of this command displays errors or returns an empty response, you will not be able to upgrade NetQ. Try waiting and then re-run the command. If after several attempts the command continues to fail, reset the NetQ server with netq bootstrap reset keep-db and perform a fresh installation of the tarball with the appropriate netq install command for your deployment type.

2. Back up your NetQ data. This is an optional step for on-premises deployments. NVIDIA automatically creates backups for NetQ cloud deployments.

Update NetQ Debian Packages

1. Update /etc/apt/sources.list.d/cumulus-netq.list to netq-4.10:

   cat /etc/apt/sources.list.d/cumulus-netq.list
   deb [arch=amd64] https://apps3.cumulusnetworks.com/repos/deb focal netq-4.10
   

2. Update the NetQ debian packages. In cluster deployments, update the packages on the master and all worker nodes:

   cumulus@<hostname>:~$ wget -qO - https://apps3.cumulusnetworks.com/setup/cumulus-apps-deb.pubkey | sudo apt-key add
   cumulus@<hostname>:~$ sudo apt-get update
   Get:1 https://apps3.cumulusnetworks.com/repos/deb focal InRelease [13.8 kB]
   Get:2 https://apps3.cumulusnetworks.com/repos/deb focal/netq-4.10 amd64 Packages [758 B]
   Hit:3 http://archive.ubuntu.com/ubuntu focal InRelease
   Get:4 http://security.ubuntu.com/ubuntu focal-security InRelease [88.7 kB]
   Get:5 http://archive.ubuntu.com/ubuntu focal-updates InRelease [88.7 kB]
   ...
   Reading package lists... Done
   

   cumulus@<hostname>:~$ sudo apt-get install -y netq-agent netq-apps
   Reading package lists... Done
   Building dependency tree
   Reading state information... Done
   ...
   The following NEW packages will be installed:
   netq-agent netq-apps
   ...
   Fetched 39.8 MB in 3s (13.5 MB/s)
   ...
   Unpacking netq-agent (4.10.0-ub20.04u45~1713954968.127fb0c1b) ...
   ...
   Unpacking netq-apps (4.10.0-ub20.04u45~1713954968.127fb0c1b) ...
   Setting up netq-apps (4.10.0-ub20.04u45~1713954968.127fb0c1b) ...
   Setting up netq-agent (4.10.0-ub20.04u45~1713954968.127fb0c1b) ...
   Processing triggers for rsyslog (8.32.0-1ubuntu4) ...
   Processing triggers for man-db (2.8.3-2ubuntu0.1) ...
   

Download the Upgrade Software

1. Download the upgrade tarball.

   1. On the NVIDIA Application Hub, log in to your account.
      
   2. Select NVIDIA Licensing Portal.
   3. Select Software Downloads from the menu.
   4. Click Product Family and select NetQ.
   5. Select the relevant software for your hypervisor:
      If you are upgrading NetQ Platform software for a NetQ on-premises VM, select NetQ SW 4.10 Appliance to download the NetQ-4.10.0.tgz file. If you are upgrading NetQ software for a NetQ cloud VM, select NetQ SW 4.10 Appliance Cloud to download the NetQ-4.10.0-opta.tgz file.
   6. If prompted, read the license agreement and proceed with the download.

   For enterprise customers, if you do not see a link to the NVIDIA Licensing Portal on the NVIDIA Application Hub, contact NVIDIA support.

   
   

   For NVIDIA employees, download NetQ directly from the NVIDIA Licensing Portal.

2. Copy the tarball to the /mnt/installables/ directory on your NetQ VM.

Run the Upgrade

Pre-installation Checks

Verify the following items before upgrading NetQ.

1. Confirm your VM is configured with 16 vCPUs. If your VM is configured with fewer than 16 vCPUs, power off your VM, reconfigure your hypervisor to allocate 16 vCPUs, then power the VM on before proceeding. For cluster deployments, verify these requirements on each node in the cluster.

2. Check if there is sufficient disk space:

cumulus@<hostname>:~$ df -h /
Filesystem      Size  Used Avail Use% Mounted on
/dev/sda1       248G   70G  179G  28% /
cumulus@netq-appliance:~$

NVIDIA recommends proceeding with the installation only if the Use% is less than 70%. You can delete previous software tarballs in the /mnt/installables/ directory to regain some space. If you cannot decrease disk usage to under 70%, contact the NVIDIA support team.

3. Confirm that the NetQ CLI is properly configured. The netq show agents command should complete successfully and display agent status.

4. Ensure that the necessary ports are open according to your deployment model.

Upgrade Using the NetQ CLI

1. Run the appropriate commands for your deployment type:

cumulus@<hostname>:~$ netq upgrade bundle /mnt/installables/NetQ-4.10.0.tgz

cumulus@<hostname>:~$ netq upgrade bundle /mnt/installables/NetQ-4.10.0.tgz

cumulus@<hostname>:~$ netq upgrade bundle /mnt/installables/NetQ-4.10.0-opta.tgz

cumulus@<hostname>:~$ netq upgrade bundle /mnt/installables/NetQ-4.10.0-opta.tgz cluster-vip <vip-ip>

2. Confirm the upgrade was successful:

```
cumulus@<hostname>:~$ cat /etc/app-release
BOOTSTRAP_VERSION=4.10.0
APPLIANCE_MANIFEST_HASH=c664236fb1d732b3633ab83662575c35f397bc6ac3a9970632523827097c8415
APPLIANCE_VERSION=4.10.0
APPLIANCE_NAME=NetQ On-premises Appliance
```

```
cumulus@<hostname>:~$ cat /etc/app-release
BOOTSTRAP_VERSION=4.10.0
APPLIANCE_MANIFEST_HASH=370ffbe3195aa1c4cc969668441b124e7714f7eaa980962ff4cc438fcec31b87
APPLIANCE_VERSION=4.10.0
APPLIANCE_NAME=NetQ Cloud Appliance
```

Next Steps

• Upgrade NetQ Agents