CMDB groups

A CMDB group is a collection of CIs that lets you apply CI actions collectively to all the CIs that are members in the group. For example, a CMDB CI Lifecycle Management API can use a CMDB group scriptable API to retrieve the group's list of CIs, and then apply a CI Lifecycle Management action collectively to all the CIs.

Populate a CMDB group

You can populate a CMDB group by manually adding individual CIs and by associating it with saved CMDB queries whose resulting CIs are added as members to the group.

Before you begin

Roles required:
  • To use a CMDB saved query - cmdb_query_builder
  • To manually add CIs - itil or asset

Also, to populate a CMDB group using a CMDB query, a saved CMDB query must exist.


  1. Navigate to Configuration > CMDB Group.
  2. In the CMDB Groups page click New.
  3. Fill in the Group Name, right-click the title bar, and select Save.
  4. To use a saved CMDB query:
    1. In the CMDB Group Contains Saved Queries section, click New.
    2. Select a query from the Query Builder Saved Query drop down list.
    3. Click Submit.
    The query that is used returns a list of CIs of the class in the start node of the query.
  5. To manually add CIs:
    1. Click Edit Manual CI.
    2. Optionally add filters.
    3. Select CIs in the Configuration Items list and click the '+' icon in the Group members section.
    4. In the Group members list, select the CIs to add to the group.
    5. Click Save or Save and Exit.
    6. In the Save Confirmation dialog box, click OK.
    7. Click Submit.

What to do next

Click Show All CI to display all CI members of the group.

Show CI Lifecycle Management details for CMDB group CIs

Display CI Lifecycle Management operational state and CI actions that apply to the CIs that are members of a CMDB group.

About this task

If the CMDB group is based on a CMDB query, then the query runs in real-time and displays the resulting CIs. If the query does not complete successfully due to timing out or for other reasons, then appropriate error messages are displayed.


  1. Navigate to Configuration > CMDB Groups.
  2. On the CMDB Groups page, click on a CMDB group.
  3. Click Show All CI.
    Field Description
    Configuration Item CI group member.
    Class Class of CI group member.
    Operational Status CI Lifecycle Management operational state of the CI such as 'Repair in Progress' or 'Operational'. Possible operational states are defined in the choice list of the Operational status field in the cmdb_ci table.
    Actions CI Lifecycle Management actions that apply to the CI such as 'Cloning' and 'Provision'. Possible actions are defined in the CMDB CI Actions [statemgmt_cmdb_actions] table.