Creating a Version Rollup rule
You can create a Version Rollup rule to assign a single value to the MarketVersion attribute of a product. BMC Helix ITSM uses this value for license management. The rule also defines a qualification to select the instances that are assigned the new value. A rule normalizes multiple VersionNumber strings to a particular MarketVersion value.
Version Rollup default behavior
- The Version Rollup feature is enabled for datasets, and it checks all active Version Rollup rules.
- Version Rollup rules apply to CIs in the BMC_Product class.
- The MarketVersion value in the Version Rollup rule takes precedence over a Product Catalog entry.
The Normalization Engine includes Version Rollup rules for a number of products from manufacturers such as Microsoft Corporation, Oracle Corporation, and Adobe Systems. You must create rules for other products.
When you create new rules for the products, you can check whether the Version Rollup rules already exist for a product or a manufacturer by using the Filter By field available on the Version Rollup tab.
If the Normalization Engine does not find a specific rule for a product, and if the CI does not have a value for MarketVersion, the Normalization Engine uses a default rule to set MarketVersion to the VersionNumber value. If the CI does have a value for MarketVersion, the Normalization Engine retains this value.
Use manufacturer aliases to reduce the number of Version Rollup rules that the Normalization Engine uses to match the ManufacturerName attribute as explained in Normalization-process.
To create a Version Rollup rule
- On CMDB Portal, click Configurations.
- From the list, click Manage Normalization Rules > Features.
- Select the Version Rollup tab.
- Click
to create a new Version Rollup rule.
With the Filter by field, you search for existing Version Rollup rules for a particular manufacturer or product. You can use % (percentage sign) for a wildcard search. - In the Create Version Rollup Rule page, configure the following parameters.
Parameter | Description |
|---|---|
Rule Name | Specify a unique name for the rule. |
Active | Click the toggle button to activate the rule so that the Normalization Engine applies the rule to data sets. |
Precedence | Enter a value to determine the rule's execution order. The value can be 0 to 9999999, both 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. |
Product Name | Specify the Model the instance need to have to qualify for this rule. If you are using product aliases, make sure that the value in this field is the same as the value in the ActualName field in the Normalization Alias form. The value in the ActualName field should in turn match the Product Name field in the corresponding Product Catalog entry. |
Class Name | Select the name of the class from the list, for which the qualification returns instances. |
Manufacturer Name | Specify the ManufacturerName the instance need to have to qualify for this rule. If you are using manufacturer aliases, make sure that the value in this field is the same as the value in the ActualName field in the Normalization Alias form. The value in the ActualName field should in turn match the Manufacturer Name field in the corresponding Product Catalog entry. |
Market Version | Specify a value to apply to the MarketVersion attribute of the instances that match your qualification. You can specify either an exact value, such as 2003, or an expression that generates the MarketVersion value. If you specify plain text with special characters, you must put the entire text in double quotation marks.The following examples are of expressions that you can specify in the Market Version field:
|
Qualifier | Enter the qualification or to build it, click |
.6. Click Save.
To edit a Version Rollup rule
- On CMDB Portal, click Configurations.
- From the list, click Manage Normalization Rules > Features.
- Click the Version Rollup tab.
- Select an existing Version Rollup Rule that you want to edit, and click
. - In the Edit Version Rollup Rule page, configure the required parameters as explained for creating a Version Rollup Rule.
6. Click Save.
To delete a Version Rollup rule
- On CMDB Portal, click Configurations.
- From the list, click Manage Normalization Rules > Features.
- Click the Version Rollup tab.
- Select an existing Version Rollup Rule you want to delete, and click
- In the Delete Version Rollup Rule dialog box, click OK to confirm the deletion.
In dataset configurations, Version Rollup is enabled by default and cannot be disabled.
