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.

Device Groups

Device groups allow you to create a label for a subset of devices in the inventory. You can configure validation checks to run on select devices by referencing group names.

Create a Device Group

To create a device group, add the Device Groups card to your workbench by searching for “Device groups” in the global search field. From the card, select Create new group and follow the instructions in the UI:

  1. Enter a name for the group.

  2. Create a hostname-based rule to define which devices in the inventory should be added to the group.

  3. Confirm the expected matched devices appear in the inventory, and click Create device group.

The following example shows a group name of “exit group” matching any device in the inventory with “exit” in the hostname:

Update a Device Group

When new devices that match existing group rules are added to the inventory, NetQ flags the matching devices for review. The following example shows the switch “exit-2” detected in the inventory after the group was configured:

To add the new device to the group inventory, click Add device and then click Update device group.

Delete a Device Group

To delete a device group:

  1. Expand the Device Groups card:
  1. Click Menu on the desired group and select Delete.