Creating qualification sets, include sets, and exclude sets


The Qualification Builder is a drift management tool that is used to create queries in the form of qualifications sets, include sets, and exclude sets. 
With Qualification Builder, create the following sets that contain several classes, related classes, and their attributes:


Set

Description

Qualification set

  • Specify a single CI or groups of CIs to be used in Snapshot jobs, Baselines, and Targets.
  • When a qualification set is applied to a dataset in a snapshot job, all CIs matching the query are included in the snapshot.
  • When a qualification set is applied to a dataset of CIs specified for a baseline or target, all CIs matching the query are included in the comparison job that uses the Baseline or Target.

Include set

  • Specify the attributes that should be included in the Drift Report if drift is detected. 
  • Is optional and managed as part of the Baseline job.

Exclude set

  • Specify the attributes should not be included in the Drift Report if drift is detected.
  • Is optional and managed as part of the Baseline job.

Each qualification, include, and exclude set that you create is saved in AR Systemdata forms.

Important

You must have Drift Master privileges to create, edit, and delete qualification sets, include sets, and exclude sets.

Guidelines

Understand the following guidelines when you use Qualification and Exclude sets:

When creating or using a Qualification set

  • The Delete Selected Class option is only available if there is more than one main class because a qualification must have at least one class. This option is always available for a related class, whether it is selected or not.
  • The Add Attribute and Add Related Class options are not available until the class is selected.
  • The Delete Selected Attribute option is always available, whether an attribute is selected or not.

Important

Only non-hidden attributes are shown in the Attribute list. To make a hidden attribute visible, use the Class Manager.

When creating an Exclude set

  • Use an exclude set when you want to include most attributes but not all in the comparison. You can specify which attributes to ignore by using an Exclude set.
  • Using only an exclude set o specify the attributes to be displayed in the Drift Report, is equivalent to including all attributes but excluding what is specified.
  • An exclude set takes precedence over an include set.
    For example, if you are using both an include set and an exclude set and the exact same attribute is specified in both, the result is that no attribute is selected.
  • For an exclude set, selecting attributes is optional. If no attributes are selected for an exclude, then all attributes for the class are used in the comparison.

To create a qualification set

  1. Select Authoring > Qualification Sets.

    The Qualification Sets List of Items is displayed. This is a library of previously created and saved qualifications sets that you can reuse.

    The Details pane displays information, such as the owner of the qualification set and what group can access or view the qualification.

    The Baseline, Target, and Job Membership pane shows which baseline, target, or snapshot job uses the qualification set.

  2. Click Create.

    The Qualification Builder is displayed.

  3. Enter a name and description for the qualification set.
  4. Specify the access groups that can use this qualification set.
  5. For Qualification Set, select from the following options:
    1. All Objects: All classes, CIs, and attributes in your snapshot job, baseline, or target source datasets are used.
    2. Custom Qualification Set: Specify the CIs you want to use in your source datasets based on the qualification.
      To create a custom qualification, follow these steps: 
      1. Select a class.

        When a class is selected, other options are made available from the Select Action field, for example, Add Attribute and Add Related Class.

        The options displayed depend on the selection.

      2. From the Select Action field, select Add Attribute.
      3. Select an attribute, provide an operator, and enter a value.
      4. Add additional classes and attributes and related classes to your qualification.

        Important

        The following operators are used in a qualification set:

        • AND: Used between a class and its related classes and attributes.
        • OR: Used between the main classes in the qualification such as BMC_ComputerSystem and BMC_Application.
  1. Click Save & Close.

    The new qualification set is displayed on the Qualification Sets List of Items pane. When you build a baseline, target, or snapshot job, you can apply this qualification.

Overview of Include and Exclude sets

The purpose of Include and Exclude options is different from that of a Qualification set. Qualification set applies at a CI level and is used to reduce the number of CIs in the baseline or target that are compared using a Comparison job. Include and exclude sets apply only to CI attribute level. Include and Exclude sets allow you to specify the attributes that should be included or excluded, thus filtering the number of attributes that are to be compared in a Comparison job.

Exclude Sets are much simpler than Include Sets. Any attribute selected in an Exclude Set is not displayed in the Drift Report, thus allowing you to filter the drift results to show only the important attributes. When a comparison job runs and compares the CIs in the baseline and target, excluded attributes are not compared.

To create an Include set

  1. Select Authoring > Include Sets.

    Include Sets.png

  2. When the Include Set List of Items displays, click Create.

    The Qualification Builder for an include set appears.

    Include set1.png

  3. In the Select Class Name field, select a class name.
  4. Click Show to display the attributes for this class.
  5. Select the attributes to include in the include set, overriding the default comparison operator and attribute value as needed.
  6. Click Close to save the attributes.
  7. Click Save & Close to save the include set.

    Your new include set appears in the Include Sets List of Items.


Examples

The following examples show customization in an Include set:

Default behavior

Select Class = BMC_ComputerSystem, Attribute = memory, Operator = EQ

The default operator (EQ) is selected. The comparison service compares the memory value of the target CI to the memory value of the baseline CI. If the values are not equal, the attribute has drifted and it is displayed in a Drift Report.

Overriding the default operator

Select Class= BMC_ComputerSystem, Attribute = memory, Operator = LT

The selected operator LT (less than) overrides the default operator (EQ). The comparison service compare the memory value of the target CI to the memory value of the baseline CI. If the target attribute value is not less than the baseline attribute value, the attribute is flagged as a drift.

Overriding the default operator and attribute value

Select Class= BMC_ComputerSystem, Attribute = diskcapacity, Operator = GT, Value=20

The selected operator GT (greater than) overrides the default operator (EQ). The user-supplied Value (20) overrides the baseline value, which means the comparison service uses this value instead of the baseline value. If the target attribute value is not greater than 20, the attribute is flagged as a drift.

To create an Exclude set

  1. Select Authoring > Exclude Sets.
  2. When the Exclude Set List of Items displays, click Create.

    The Qualification Builder for an exclude set is displayed.

    Exclude set.png

  3. Select a class name.
  4. Click Show, to see a list of all the attributes for the class.
  5. Select the attributes to exclude, and then click Close.

    You can add additional classes to your exclude set with attributes selected for exclusion.

  6. When finished, click Save & Close.
Example

The following example illustrates when an Exclude set is useful:

You create a comparison job to compare your business critical computers (Targets) to a standard computer (Baseline) that is configured exactly as needed for the business. The computer name in each target computer differs from the computer name in the baseline. This different is flagged as a drift. However, excluding the computer name attribute would filter this attribute and it will not be displayed in the Drift Report.

 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*