Managing the Infrastructure › Delete Retired Components

Delete Retired Components

Data Aggregator includes a script to delete retired components. Retired components are components that no longer exist on physical devices. The presence of excessive numbers of retired components can impact user interface performance. To delete retired components, understand how to use this script.

Note: To automate the removal of retired components, see the Data Aggregator Administration Using REST Web Services Guide.

Follow these steps:

1. Open a command prompt and access the /opt/IMDataAggregator/scripts directory.
2. To call the script to delete retired components, type the following command:

   ./remove_retired_items.sh
   

   The script parameters are listed and are described.

Example: Return a Total Number of Retired Components

1. Type the following command:

   ./remove_retired_items.sh -h host_name
   

   -h host_name

   Specifies the Data Aggregator host name to connect to.

   The total number of retired components is displayed.

2. (Optional) Enter the number 1 to return a list of the names of the retired components.
3. (Optional) Enter the number 1 to delete all of the retired components.

Example: Filter the List of Retired Components By a Specific Criterion

1. To call the script to delete retired components, type the following command:

   ./remove_retired_items.sh
   

   The script parameters are listed and are described.

2. Delete retired components by a specific criterion:
   • If multiple Data Collector instances are installed, you can have duplicate IP addresses. To filter retired components by IP address, do the following steps:
     1. Type the following command:

           ./remove_retired_items.sh -h host_name -a device_IP_address
        

     2. Note: You cannot enter a range of IP addresses.
     3. (Optional) Enter the number 1 to return a list of the names of the retired components.
     4. (Optional) Enter the number 1 to delete all of the retired components.
   • To delete by the age of the retired components (in number of days old), type the following command:

     ./remove_retired_items.sh -h host_name -t filter_by_days_old_from_current_time
     

     For example, the following command deletes retired components that are less than ten days old from the current time:

     ./remove_retired_items.sh -h host_name -t 10
     

Example: Delete a Large Number of Retired Components

You can easily delete all of the retired components where the total exceeds 100,000:

• To review all of the retired components where the total exceeds 100,000, type the following command:

  ./remove_retired_items.sh -h host_name -o ouputfile 
  

  -o outputfile

  Is the output of all of the retired components. The output is a .csv file.

  For example, the following command outputs a list of all of the retired components. The .csv file format includes the device item ID, the device display name, the retired component ID, and the retired component display name:

  ./remove_retired_items.sh -h my_host_name -o myretired.csv
  

• To delete all of the retired components where the total exceeds 100,000, and to log the information to a .csv file, type the following command:

  ./remove_retired_items.sh -h host_name -o ouputfile -c Yes
  

  -o outputfile

  Is the output of all of the retired components. The output is a .csv file.

  –c Yes

  Confirms the deletion of all retired components.

  For example, the following command deletes all of the retired components:

  ./remove_retired_items.sh -h my_host_name -o myretired.csv -c Yes
  

Consider further details about deleting retired components:

• If you filter retired components by IP domain name or IP domain ID, also specify a specific IP address to return correct results.
• If your filter criteria return too many retired components, the REST interface does not return a response. Use other filtering options to narrow the results. More filter criteria are available at http://hostname:port/rest/retired/xsd/filterselect.xsd.