Version: 10.2

Configuring Handle Rename

Introduction

Configure handle-rename.map to rename handles from cold_master.conf. The new handle name will be visible in the historical reports.

warning

Apply the configurations shown in the Open iT Core Server.

Open handle-rename.map in the Configuration directory, which is by default in C:\Program Files\OpeniT\Core\Configuration.

Notice that it contains instructions on how to edit the file.
Specify handle name with the following syntax:
Mapping Syntax
```
MAP: <New_HandleName>   
<Old_HandleName>
```
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 'Application' and 'application', will be recognized as identical. Also, note that leading and trailing spaces are removed from entries.
Example
```
MAP: Windows GDSPlot   
Wgdsplot
```
This example renames Wgdsplot to Windows GDSPlot.

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 handle-rename.map 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 handle name with the following syntax:
Mapping Syntax
```
MAP: <New_HandleName>   
<Old_HandleName>
```
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 'Application' and 'application', will be recognized as identical. Also, note that leading and trailing spaces are removed from entries.
Example
```
MAP: Open iT Client   
oitclient
```
This example renames oitclient to Open iT Client.

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:

Freeze

Proceed with data regeneration after configuring all the necessary mapping files to apply the changes in the historical reports.