This knowledge base has moved to the documentation site. Please visit the knowledge base here for the most up to date content. This site is no longer maintained.

What the NetQ Validation System Checks


Cumulus NetQ provides the information you need to monitor the health of your network fabric, devices, and interfaces. You are able to easily validate the operation and view the configuration across the entire network from switches to hosts to containers.


  • Cumulus NetQ 2.0 - 2.3


With the NetQ CLI, netq check commands provide on-demand validation of the various network protocols and services running in your network fabric, looking for inconsistencies in configuration across your fabric, connectivity faults, missing configuration, and so forth, and then display the results for your assessment. You can run them from any node in the network.

The NetQ GUI provides the same capabilities through the Validation Request card.

Both the CLI and GUI enable you to validate relevant operational characteristics for network protocols and services on devices being monitored by NetQ. The validations performed for each protocol and service include:

  • agents: check for rotten nodes
  • bgp: session sanity (established, router ID, AFI/SAFI consistency)
  • clag: peering status, backup IP, system MAC, VXLAN anycast IP, bridge membership checks; list of dual-homed bonds; list of single-homed bonds, protodown bonds, dual-homed bonds in conflict states
  • evpn: BGP AFI/SAFI consistency; VNI type consistency; VTEP IP reachability; kernel/FRR consistency; source replication list consistency for a layer 2 VNI; VLAN-to-layer-2-VNI mapping consistency; MAC destination consistency; VRF-to-layer-3-VNI mapping consistency
  • interfaces: port speed, admin/operational state, link flap, plugin module status and link peer identity validation
  • license: presence and validity of switch license
  • lnv: vxrd peer database, vxsnd peer database, VNI operational state and head end replication list consistency
  • mtu: MTU consistency on all links
  • ntp: NTP sync state
  • ospf: session sanity (router ID, hello time, dead time, area ID, network type consistency)
  • sensors: fan, temperature, PSU sensor status
  • vlan: VLAN list and PVID consistency on links; MLAG peerlink and dual-homed bonds VLAN membership check
  • vxlan: VLAN-to-VNI mappings; source replication list consistency

To run a validation using the CLI, append one of the bold keywords from the list above to the netq check command. For example, netq check agents or netq check evpn:

  cumulus@switch:~$ netq check agents
  Checked nodes: 25, Rotten nodes: 1
  Hostname          Status           Last Changed
  ----------------- ---------------- -------------------------
  leaf01            Rotten           8d:13h:34m:51s

In the NetQ GUI, open the Validation Request card, select the validation to run, then click Run Now:


The corresponding On-demand Validation Result card opens automatically and is populated on completion of the check. For selected protocols and services, you can click Open <Protocol or Service Name> Service Card to view more detail about the protocol or service health.



This support portal has moved

Cumulus Networks is now part of the NVIDIA Networking Business Unit! The NVIDIA Cumulus Global Support Services (GSS) team has merged its operations with the NVIDIA Mellanox support services team.

You can access NVIDIA Cumulus support content from the Mellanox support portal.

You open and update new cases on the Mellanox support portal. Any previous cases that have been closed have been migrated to the Mellanox support portal.

Cases that are still open on the Cumulus portal will continue to be managed on the Cumulus portal. Once these cases close, they will be moved to the Mellanox support portal.

Powered by Zendesk