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.

Switch Inventory

With the NetQ UI and NetQ CLI, you can monitor your inventory of switches across the network or individually. A user can view operating system, motherboard, ASIC, microprocessor, disk, memory, fan, and power supply information.

For switch performance information, refer to Switch Monitoring.

Switch Inventory Commands

Several forms of this command are available based on the inventory component you’d like to view. See the command line reference for additional options, definitions, and examples.

netq show inventory (brief | asic | board | cpu | disk | memory | license | os)

To view Cumulus Linux OS versions supported on your switches, run netq show cl-manifest:

netq show cl-manifest

To view all installed software packages on your switches, run netq show cl-pkg-info:

netq show cl-pkg-info

To view recommended software package information for a switch, run netq show recommended-pkg-version:

netq <hostname> show recommended-pkg-version

Cumulus Linux, SONiC, and NetQ run services to deliver the various features of these products. You can monitor their status using the netq show services command:

netq show services

View Switch Inventory in the UI

Add the Inventory/Switches card to your workbench to monitor the hardware and software component inventory on switches running NetQ in your network. To add this card to your workbench, select Add card > Inventory > Inventory/Switches card > Open cards. Select the dropdown to view additional inventory information.


View Distribution and Component Counts

Open the large Inventory/Switches card to display more granular information about software and hardware distribution. By default, the card displays data for fresh switches. Select Rotten switches from the dropdown to display information for switches that are in a down state. Hover over the top of the card and select a category to restrict the view to ASICs, platform, or software.

Expand the Inventory/Switches card to full-screen to view, filter or export information about:

  • ASICs
  • Motherboards
  • CPUs
  • Disks
  • Memory
  • Operating system