Working with Dashboards and Reports › Viewing Data in CA Performance Center › Inventory of Managed Items › Set Alias Names For Monitored Devices

Set Alias Names For Monitored Devices

CA Performance Center includes a script to set alias names for monitored devices. You can use this script to set the alias names for more than one monitored device at a time. The alias name appears in the inventory list of devices and in the inventory list of interfaces.

This script has two functions. First, the script returns a list of device item IDs and device names in .csv format. You modify the .csv file to include the alias names that you want to set on each monitored device. The second function of the script is to take the updated .csv file and set the alias names for the monitored devices.

Follow these steps:

1. Open a command prompt and access the Performance_Center_installation_directory/PerformanceCenter/Tools/bin directory.
2. To call the script to set alias names for monitored devices, type the following command:

   ./update_alias_name.sh
   

   The script parameters are listed and are described.

Example: Set Alias Names for Multiple Monitored Devices

1. To return a complete list of devices that a Data Aggregator host is monitoring, type the following command:

   ./update_alias_name.sh -h host_name [-o output_filename]
   

   -h host_name

   Specifies the Data Aggregator host name to connect to.

   -o output_filename

   (Optional) Creates a .csv file with the total number of monitored devices by itemID and Device Name with a different filename for the .csv file than the default filename. f you do not enter a value for this parameter, the default name, DeviceList.csv, is used for the .csv file.

   The .csv file has the following format: ItemID, Device Name.

   For example:

   560, MyRouter1

   561, MyRouter2

2. Modify the .csv file that was created in the previous step, noting the alias name that you want to set for each monitored device. This file must have the following format: ItemID, Alias Device Name.

   For example:

   560 , MyRouter1AliasDisplayName

   561, MyRouter2AliasDisplayName

3. Type the following command:

   ./update_alias_name.sh -h host_name -i input_file 
   

   -h host_name

   Specifies the Data Aggregator host name to connect to.

   -i input_file

   Specifies the filename of the .csv file that you created previously with the alias names.

   The alias names are set for monitored devices.

4. (Optional) To set alias names for a number of monitored devices that are greater than 30, type the following command to adjust the batch size and pause between batches. These adjustments help to control the workload:

   ./update_alias_name.sh -h host_name -i input_file -b batch_size -t time_in_seconds
   

   –b batch_size

   Indicates the number of items to process in each batch.

   –t time_in_seconds

   Indicates the time, in seconds, to pause between batches.

   For example:

   ./update_alias_name.sh -h host_name -i input_file -b 20 -t 2