Type
  • Best practice
Description
  • This article explains how to set the configuration variable removedObjectList to remove one or more instances from a TrueSight console or from a PATROL Console configured in CA mode.
Additional Keywords
  • TrueSight

Related Topics

Knowledge Base

Removing One or More Instances from TrueSight

KB1190 - Dec 22, 2016

Introduction

You can remove instances whenever their supervision becomes irrelevant by setting the removedObjectList configuration variable in the relevant monitoring policy. In this article, we will explain how to remove the following HP 3PAR Power Supply instance:
inline
Monitoring an HP3PAR Storage System

Procedure

Step 1 – Obtaining the Related PATROL Object Path 

Before configuring the removedObjectList configuration variable, you must query the PATROL Agent to obtain the related PATROL object path of the instance to be removed. The procedure is as follows:

  1. Launch the TrueSight Console.
  2. In the TrueSight Console navigation pane, click Configuration > Managed Devices
    Viewing the Managed Devices in the TrueSight Console

    Viewing the Managed Devices in the TrueSight Console

  3. Click the PATROL Agent action menu inline and select Query PATROL Agent
    Querying the PATROL Agent from the TrueSight Console

    Querying the PATROL Agent from the TrueSight Console

  4. In the Command box, enter the following command:
          CLASS_NAME = "SEN_CLASS_NAME";
            nodes = get_vars("/".CLASS_NAME, "subnodes");
            foreach node (nodes)
            {
            objectPath = "/".CLASS_NAME."/".node;
            instanceName = get(objectPath."/name");
            output  = [output, "Instance Name:  ".instanceName. " - ObjectPath:  ".objectPath."\n"];
            }
            print(output);
            
    where SEN_CLASS_NAME must be replaced with the application class name (SEN_HP3P_POWERSUPPLY in our example).
  5. Click Execute. The related PATROL object paths are displayed:

In our example, the related PATROL object path of the cage0-ps-0 instance is /SEN_HP3P_POWERSUPPLY/HP3PAR-SAN _cage0-ps-0.

Step 2 - Configuring the Monitoring Policy

To remove the HP 3PAR Power Supply instance cage0-ps-0:

  1. Edit the Monitoring Policy that applies to the PATROL Agent for which you need to configure the removedObjectList variable:
    1. In the Navigation pane, click Configuration > Infrastructure Policies.
    2. Click the action menu inline of your policy and click Edit.
      Editing the HP3PAR Infrastructure Policy

      Editing the HP3PAR Infrastructure Policy

    3. Under the Monitoring tab, click the action menu inline of your monitoring policy and click Edit.
      Editing the HP3PAR Monitoring Policy

      Editing the HP3PAR Monitoring Policy

    4. In the Additional Variables section of the Add Monitoring Configuration panel, click Add.
      Adding Configuration Variables to the HP3PAR Monitoring Policy

      Adding Configuration Variables to the HP3PAR Monitoring Policy

  2. Fill the Configuration Variables panel:
    1. In the Name field, enter removedObjectList
    2. In the Value field, enter the related PATROL object path of the instance(s) to be removed delimited by a ‘|’ pipe. In our example: /SEN_HP3P_POWERSUPPLY/HP3PAR-SAN _cage0-ps-0.
      Adding the removedObjectList Configuration Variable to the HP3PAR Monitoring Policy

      Adding the removedObjectList Configuration Variable to the HP3PAR Monitoring Policy

    3. Click OK twice and click Save.
    4. Apply the policy. The instance cage0-ps-0 is now removed:
      HP3PAR power supply instance successfully removed

      HP3PAR power supply instance successfully removed