This documentation supports the 9.1 to 9.1 Service Pack 3 version and its patches of BMC Atrium Core. The documentation for version 9.1.04 and its patches is available here.

To view the latest version, select the version from the Product version menu.

Configuring Suite Rollup normalization rules

This topic provides information and instructions for configuring Suite Rollup normalization rules:

Purpose and behavior of Suite Rollup normalization

Use Suite Rollup rules to create a new suite definition in the Product Catalog, to set the products that are members of a suite, and to set the ProductType attribute for instances:

  • If the Normalization Engine identifies an instance as part of a suite, it sets that CI's ProductType attribute to Component.
  • If the Normalization Engine identifies an instance as a suite, it sets that CI's ProductType attribute to Composite Product.

The instances for which the ProductType attribute is not set to Composite Product or Component are considered to be standalone products.

When you select products as part of a suite, the suite rule applies only if all the required components are found with a relationship to the same system. If they are not, the rule does not apply.

Default configurations

The Normalization Engine includes example Suite Rollup rules for Microsoft and Adobe products. You must create rules for other suites.


You cannot define composite suites that contain other suites.

By default, the Suite Rollup feature is not enabled for datasets. If you enable the Suite Rollup Normalization Feature option for an individual dataset, the Normalization Engine checks all active Suite Rollup rules. You cannot select particular rules to apply to individual datasets.


Suite Rollup rules do not run if the MarketVersion, Model (Product Name), and ManufacturerName attributes are not normalized.

You can use Suite Rollup with batch and continuous normalization jobs: It does not work with inline normalization.


If you enable the continuous normalization mode and then create a new Suite Rollup rule, that rule is applied only to new or updated product CIs related to the systems that are pushed to BMC Atrium CMDB. To apply the new Suite Rollup rule to the previously normalized data, you must rerun the continuous normalization job with the Normalize All Instances option selected.

For more information, see Suite Rollup Normalization.


  • Before enabling the Suite Rollup Normalization feature or continuous normalization mode, do the following:
    • Verify that the Product Catalog contains trusted product entries for normalizing CIs, and that product and manufacturer aliases have been defined as needed.
    • Create and enable Version Rollup rules as needed.
    • With trusted Product Catalog entries, aliases, and Version Rollup rules in place, create Suite Rollup rules to take advantage of the normalized Model, ManufacturerName, and MarketVersion attributes.
  • If you modify the Product Catalog data, add aliases, or add new custom Version Rollup rules after running a batch job, enable the Normalize All Instances option and run the batch job again.

Before You Begin

  • Know what values to use for the Suite Name, Manufacturer, Market Version, Category, Type, and Item.
  • Products must already exist in the Product Catalog. You cannot define new products in the Suite Rollup rule.
  • The Suite Rollup Normalization feature works on non-normalized data, and because it is an optional feature, it must be enabled.

To create a Suite Rollup normalization rule

  1. In the Normalization console, click Normalization Features.
  2. In the Suite Rollup tab, click Create New Rule.

  3. In the Suite Information screen, define the suite to create in the Product Catalog, and click Next.
    • Suite Name — Enter the name of the suite to create in Product Catalog.
    • Manufacturer — Select from a list of manufacturers that are defined in the Product Catalog.

      If needed, you can create a new manufacturer in the Product Catalog. For more information, see Creating custom Product Catalog entries.
    • Market Version — Select from a list of Market Versions that are defined in the Product Catalog. If needed, you can create a Market Version by typing the value.
    • Model/Version — Enter the VersionNumber attribute value for the suite.
    • Tier 1 (Category) — Enter the Category attribute value for the suite.
    • Tier 2 (Type) — Enter the Type attribute value for the suite.
    • Tier 3 (Item) — Enter the Item attribute value for the suite.

  4. In the Product List screen, select the products to include in the suite, and click Next.
    1. Search for products by the following methods. You can include the % wildcard.
      • By product name — Click Product, and enter a value for Name.
      • By product version — Click Product, and enter a value for Version.
      • By products in existing suites — Click Suite, and enter a suite name for Search.


        Searches are case sensitive.

    2. To add a product to the suite, select it from the Product Catalog list, and click the > button.
    3. To designate a required product in the suite, in the Product List, click the Reqd check box.
  5. In the Suite Summary screen, review the suite definition and set the following options, and click Next.
    • Active — Click to activate the rule so that the Normalization Engine applies the rule on datasets.
    • Precedence — Enter a value to determine the rule's execution order. The value can be 0 to 9999999, inclusive, with higher numbers determining a higher priority. If more than one rule applies to an instance, the Normalization Engine applies the rules sequentially from the highest precedence value to the lowest, until a match is found.

      The Create New Suite Wizard adds a new suite in the Product Catalog with the defined Suite Name, Manufacturer, Version and Product List information. It also creates a NE Suite Rule with the Suite Id, Active and Precedence values.
  6. In the Finish screen, review for errors.
    • If the wizard successfully creates the new suite, click Finish.
    • If the wizard encountered errors, click Back to review and make changes.
      The new suite appears in the Current Suites list of Suite Rollup tab.

To enable or disable suite rollup for a dataset

  1. In the Normalization console, click Edit Configuration.
  2. In the Normalization Features column on the Dataset Configuration tab, click the ... button.
  3. In the Configure Normalization Features dialog box, click the check box to enable or disable the Suite Normalization feature.


    Only rules that are active are executed.

  4. Click OK.
  5. In the Configuration Editor, click Save.
Was this page helpful? Yes No Submitting... Thank you