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.

Upgrade NetQ Agents

NVIDIA strongly recommends that you upgrade your NetQ Agents when you install or upgrade to a new release. If you are using NetQ Agent 2.4.0 update 24 or earlier, you must upgrade to ensure proper operation.

The following instructions apply to both Cumulus Linux 3.x and 4.x, and for both on-premises and remote deployments.

Upgrade NetQ Agent

To upgrade the NetQ Agent:

  1. Log in to your switch or host.

  2. Update and install the new NetQ Debian package.

    sudo apt-get update
    sudo apt-get install -y netq-agent
    
    sudo yum update
    sudo yum install netq-agent
    
  3. Restart the NetQ Agent.

    netq config restart agent
    

Refer to Install NetQ Agents to complete the upgrade.

Verify NetQ Agent Version

You can verify the version of the agent software you have deployed as described in the following sections.

Run the following command to view the NetQ Agent version.

cumulus@switch:~$ dpkg-query -W -f '${Package}\t${Version}\n' netq-agent

You should see version 4.0.0 and update 34 in the results. For example:

  • Cumulus Linux 3.3.2-3.7.x
    • netq-agent_4.0.0-cl3u34~1620685168.575af58b_armel.deb
    • netq-agent_4.0.0-cl3u34~1620685168.575af58b_amd64.deb
  • Cumulus Linux 4.0.0 and later
    • netq-agent_4.0.0-cl4u34~1620685168.575af58b_armel.deb
    • netq-agent_4.0.0-cl4u34~1620685168.575af58b_amd64.deb

root@ubuntu:~# dpkg-query -W -f '${Package}\t${Version}\n' netq-agent

You should see version 4.0.0 and update 34 in the results. For example:

  • netq-agent_4.0.0-ub18.04u34~1620685168.575af58b_amd64.deb
  • netq-agent_4.0.0-ub16.04u34~1620685168.575af58b_amd64.deb
root@rhel7:~# rpm -q -netq-agent

You should see version 4.0.0 and update 34 in the results. For example:

  • netq-agent-4.0.0-rh7u34~1620685168.575af58b.x86_64.rpm

If you see an older version, upgrade the NetQ Agent, as described above.