Package Mapping
Introduction
Package mapping involves creating a new virtual package alongside the existing ones while ensuring that the correct concurrency is calculated. This process is particularly useful when multiple raw package names correspond to a single package. The new package name should be visible in both the License Monitor and historical reports.
Apply the configurations shown in the Open iT Core Server.
Configuring package-mapping
- Windows
- Unix
-
Open
package-mapping
in the Configuration directory, which is by default inC:\Program Files\OpeniT\Core\Configuration
.Notice that it contains instructions on how to edit the file.
-
Specify packages to combine with the following syntax:
Mapping SyntaxMAP: <Combined_Package_Name>
<PackageName_1>
<PackageName_2>Empty lines are allowed — any line beginning with
#
as the first non-whitespace character is considered a comment. Globbing is also supported, allowing you to use several globbing patterns; however, remember that they are slower than exact matches. To make your mapping files more effective and efficient, refer to the Optimizing Rules to Speed Up Rename or Mapping page.In the mapping file, entries are case-insensitive, meaning that capitalization variations, such as 'Package' and 'package', will be recognized as identical. Also, note that leading and trailing spaces are removed from entries.
ExampleMAP: CombinedPackage
Package028
Package114This example combines the usage of Package028 and Package114 and will be gathered through CombinedPackage.
You can also include custom configurations in this mapping file, such as default mapping, setting date limits on specific mapping entries, or creating nested maps.
-
Save the changes.
-
Open
package-mapping
in the etc directory, which is by default in/var/opt/openit/etc
.Notice that it contains instructions on how to edit the file.
-
Specify packages to combine with the following syntax:
Mapping SyntaxMAP: <Combined_Package_Name>
<PackageName_1>
<PackageName_2>Empty lines are allowed — any line beginning with
#
as the first non-whitespace character is considered a comment. Globbing is also supported, allowing you to use several globbing patterns; however, remember that they are slower than exact matches. To make your mapping files more effective and efficient, refer to the Optimizing Rules to Speed Up Rename or Mapping page.In the mapping file, entries are case-insensitive, meaning that capitalization variations, such as 'Package' and 'package', will be recognized as identical. Also, note that leading and trailing spaces are removed from entries.
ExampleMAP: CombinedPackage
Package028
Package114This example combines the usage of Package028 and Package114 and will be gathered through CombinedPackage.
You can also include custom configurations in this mapping file, such as default mapping, setting date limits on specific mapping entries, or creating nested maps.
-
Save the changes.
This mapping may affect the following data types:
Licpoll2
- (45) Total License Use v2.0
- (46) Individual License Use v2.0
- (47) Host License Use v2.0
- (49) Host User License Use
- (71) Usergroup License Use v2.0
- (72) Hostgroup License Use v2.0
- (93) OLAP Raw Hourly
- (94) OLAP User Concurrency
- (95) Usergroup License Use v3.0
- (102) OLAP Total Use
- (124) License Model User Concurrency
- (125) License Model Total Use
FlexLog2
Next Steps?
Proceed with data regeneration after configuring all the necessary mapping files to apply the changes in the real-time and historical reports.
For real-time reports:
For historical reports: