Configuring Version Rollup normalization rules
Use Version Rollup rules to define a value to assign to the
MarketVersion attribute and a qualification to select the instances that are assigned the new value. The purpose is to normalize multiple
VersionNumber strings to a particular
By default, the Version Rollup feature is enabled for datasets and all active Version Rollup rules are checked. You cannot disable the Version Rollup feature, and you cannot select particular rules to apply to individual datasets.
Also by default, the
MarketVersion value in the Version Rollup rules takes precedence over a Product Catalog entry. You can change this configuration, as explained in Priority of Version Rollup rules and Product Catalog entries.
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 if the Version Rollup rules already exist for a product or a manufacturer using the search field available on the Version Rollup tab.
- Although you can edit or delete the Version Rollup rules that are shipped with the product, BMC recommends that you do not edit or delete these rules.
- Instead of editing a rule, create a new rule and copy the desired qualification and other values to it. You can then modify this new rule.
- BMC recommends that the Version Rollup rule should be based on Normalized product names.
- When you search for existing version Rollup rules, the search results depend on the case sensitivity of the underlying database. For example, for a case sensitive database, if you enter a search string as "adobe", it treats "adobe" and "Adobe" differently. Hence, the search result does not list the rules for "Adobe". However, if the underlying database is case insensitive the search string "adobe" lists the rules for "adobe" as well as "Adobe".
Version Rollup rules apply to CIs in the BMC_Product class. You can add more classes, as explained in Adding CMDB classes to Version Rollup normalization.
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, then the Normalization Engine retains this value.
For more information about the Version Normalization feature, see Normalization and software license management.
- You can use manufacturer aliases to reduce the number of Version Rollup rules needed to match the
ManufacturerNameattribute within a CI. This is because the Normalization Engine uses manufacturer aliases to look up matching Version Rollup rules, as explained in Normalization process.
- For more information on product and manufacturer name aliasing, see Setting up aliases for normalization and Product name and manufacturer normalization aliases in the Product Catalog.
To create a Version Rollup normalization rule
- In the Normalization console, click Normalization Features.
- On the Version Rollup tab, in the Search by Manufacturer Name/Product Name field enter the Manufacturer Name or Product Name for which you want to create or edit a Version Rollup rule.
This field allows you to search for existing Version Rollup Normalization rules for that Manufacturer or Product. You can use % for wildcard search.
- Click the Create New Rule icon to create a new rule.
- In the New Rule for Version Rollup dialog box, configure the following parameters.
- Active — Select Yes to activate the rule so that the Normalization Engine applies the rule on datasets.
- Rule Name — Define a descriptive name for the rule.
- Class Name — Select the name of the class for which the qualification returns instances.
- 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.
- Qualifier — Type the qualification or click
Use BMC Remedy AR System qualifications to define the CIs or relationships to which the custom rule applies. For information about using the Qualification Builder, see Building a qualification for a reconciliation activity.
The qualification can also be written using an alias name instead of using the manufacturer or product name.
- Manufacturer Name — Specify a string to apply to the
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.
- Product Name — Specify a string to apply to the
- Market Version — Specify a value to apply to the
MarketVersionattribute of the instances that match your qualification. You can specify either an exact value, such as 2003, or an expression that generates the
MarketVersionvalue. If you are are specifying plain text with special characters, you must put the text in double quotes.
The following are examples of expressions that you can specify in the Market Version field:
MAJOR($VersionNumber$) — This expression extracts the major version from the
VersionNumberattribute of the qualified instances and applies that value to the
MarketVersionattribute. For example, if the
VersionNumberattribute value is 11.5 or 11.7, this expression populates 11 as the value of the
MAJORMINOR($VersionNumber$) — This expression extracts the major and minor version numbers from the
VersionNumberattribute. For example, if
VersionNumbercontains 5.1.2, this expression populates 5.1 as the value of the
$VersionNumber$ — This expression applies the
VersionNumberattribute value of the qualified instances to the
MarketVersionattribute. For example, if the
VersionNumberattribute value is 10.20.01, this expression populates 10.20.01 as the value of the
- Click OK.