Dynamic Groups

After you create a new group or select an existing group, you can add/remove devices to the group or apply dynamic device filters.

Note: Dynamic groups do not follow group access rights. Anyone with the ability to view a device group can view any dynamic groups contained in that device group as well. However, only devices the user has the ability to view appear in the group.

To configure a new dynamic group using the Dynamic Group Builder:

1. Enter or select the appropriate information:
   • Group Name. Enter a name for the Dynamic Group as it will appear in the WhatsUp Gold Device List.
   • Description. (Optional) Enter additional information for the new Dynamic Group. This description is visible to all users who can open the dynamic group.
   • Filter. Select All devices to show all devices that match the criteria of the dynamic group, select All devices in the parent group to show all devices that match the criteria of the dynamic group and are located in the group in which the dynamic group is located, or select All devices in the parent group and its children groups to show all devices that match the criteria of the dynamic group and are located in the group in which the dynamic group is located or any of that group's children groups.
2. Create and edit rules to form an SQL filter for the Dynamic Group.
   • Click Add to begin writing the rules for your SQL filter. The Dynamic Group Rule Editor appears.
   • Enter the appropriate information in the Dynamic Group Rule Editor. As you create rules, they are added to the Dynamic Group Builder dialog where you can add more rules, edit, or delete existing rules by clicking Add, Edit, or Delete.

   Note: Parentheses (single, double, triple, and quadruple) are available for use in your filter code - add them by selecting them from the lists before and after your rules.

   Tip: You can move existing rules up or down within your filter code by selecting a rule and then clicking on Up or Down.

Validating your filter code

As you configure your rules, the SQL filter is displayed at the bottom of the Builder dialog. When you are satisfied with the filter code that is displayed, click Validate to test the filter code syntax. If the test returns no errors, click OK to save the configured SQL filter and to add the new Dynamic Group to your Device List.

If the code returns errors, either make the needed changes at this time, then click OK. Additionally, you have the option to save the filter code so that you may edit it at a later time. You can then select the Dynamic Group from the Device List and right-click, then select Properties to edit the group filter code.

Converting your filter code

You can convert a Dynamic Group created with the Dynamic Group Builder to the SQL dialog by clicking Convert. It is important to note that once you convert the Dynamic Group to the SQL dialog, you are not able to edit the group in the Dynamic Group Builder again—you are only able to make changes to the group from the SQL dialog. If you aren't an advanced SQL user, we recommend that you make a copy of the Dynamic Group so that you can keep a copy available for edit in the Dynamic Group Builder.

To create a new Dynamic Group using the Advanced SQL dialog:

1. Enter the appropriate information:
   • Group name. Enter a name for the dynamic group. This name appears on the device list.
   • Description. (Optional) Enter additional information that describes the dynamic group.
   • SQL Filter. Enter the SQL query statement that retrieves the list you want from the database. For the dynamic group to appear in your device list, the first line must be 'SELECT DISTINCT nDeviceID'.
2. Click OK to save and add the Dynamic Group to your Device List.

Validating your filter code

When you are satisfied with the filter code that is displayed, click Validate to test the filter. If it runs as you expect, click OK to save the configured SQL filter and to add the new Dynamic Group to your Device List. If the code does not run as you expect, but you would still like to save the filter code so that you may edit it at a later time, click OK. You can then select the Dynamic Group from the Device List and right-click, then select Properties to edit the group filter code.

If you do not know how to formulate SQL queries, you can use the WhatsUp Gold Dynamic Group Builder, or cut and paste filter entries from existing dynamic groups, then edit them to read data from other tables.

WhatsUp Gold is preconfigured with dynamic group examples, which you can see in the Devices view, under Device Groups. In addition to the preconfigured dynamic groups, we have provided several sample filters for you to create some very interesting dynamic groups.

Note: You can learn more about the database structure by downloading the database schema file on the WhatsUp Gold support page.

See Also Devices Device Status Device Properties Panel Device Management Actions Device Groups