Performing actions on a PATROL Agent



Use the Managed Devices page on the TrueSight console to access a PATROL Agent and perform actions on it.

You can perform the following actions on a PATROL Agent:

To access a PATROL Agent

  1. In the navigation pane of the TrueSight console, click Configuration and select Managed Devices. In the Managed Devices table, the PATROL Agents are displayed under the associated Integration Services that are displayed under the corresponding Infrastructure Management Servers.
  2. For the PATROL Agent that you want to access, click + against the associated Infrastructure Management server and the Integration Service to expand them. The PATROL Agent is displayed.


To deploy and install packages or uninstall monitoring solutions from a PATROL Agent

  1. Access the PATROL Agent that you want to deploy and install packages to, or uninstall monitoring solutions from.
  2. Click the PATROL Agent action menu and select Deploy and Install Packages or Uninstall Monitoring Solutions, depending on the action that you need to perform. For more information, see Deploying packages to PATROL Agents using the TrueSight console and Uninstalling monitoring solutions from PATROL Agents.

To synchronize monitor instances with a PATROL Agent

  1. Access the PATROL Agent that you want to synchronize.
  2. Click the PATROL Agent action menu and select Synchronize Monitor Instance Information.

    This action triggers t
    he PATROL Agent to resend all the instances that the Agent monitors to Infrastructure Management.

    Note

    Perform this action only when you are sure that the monitor instance information from the PATROL Agent is out of sync with that on the Infrastructure Management server.

    The synchronization process uses system resources heavily on both the Agents and the Infrastructure Management server.

To run a query on the PATROL Agent

You can run the PSL commands on PATROL Agents by using the Agent Query Tool and view the results in the tool.

User roles with the permission, Allow trusted connections to PATROL Agents do not require authentication for running a query via the Agent Query Tool. 


If you want all users (irrespective of their permissions) to authenticate themselves before they run any queries, you need to enable authentication.

  Steps to enable or disable authentication
  1. Do the following:
    • (Windows) Open command prompt from the installationDirectory\truesightpserver\bin folder.
    • (Linux) Navigate to the installationDirectory/truesightpserver/bin folder.
  2. Run the tssh properties set askCredentialsForAQT <true/false> command 
  3. Run the tssh properties reload command.

Log on to a new session of the Presentation Server to verify that the authentication screen is displayed for the Agent Query Tool.

The user credentials required for authentication are the same as that used for installing PATROL Agent (used for the PATROL default account).  After the user is authenticated, the credentials remain valid until:

  • The user is logged into the application 
  • The user disconnects from the current Agent Query Tool session by clicking the Disconnect button.

Note

The ability to enable authentication is available only from version 11.3.02 of the product.

 Access the PATROL Agent that you want to view configuration history for.

  1. Click the PATROL Agent action menu and select Query PATROL Agent. The Agent Query Tool opens in a new browser window.

  2. In the Command box, specify the query: 

    • To manually enter a PSL command, type the command in the Command box and press Enter, or click Execute.
      For example, %DUMP ALL. The results are displayed. 

       For information about the PSL commands, see PATROL Script Language overview and functions .

    • To select a query from a commonly-used PSL command list, click .... In the Select Command dialog box, select a command and click Apply.
      The following queries are available:

      Query Description
      Active KMs Shows all the knowledge modules (KMs) that are currently loaded on the selected PATROL Agent
      Agent Information Shows the PATROL Agent information: host, IP address, port, version, and OS version.
      All pconfig variables Shows the PATROL configuration data currently loaded on the selected PATROL Agent
      Disabled KMs Shows all the knowledge modules that are disabled on the selected PATROL Agent
      Force Discovery Triggers discovery of all instances configured on the selected PATROL Agent
      History Retention Shows the number of days that data collection history is saved on the collection PATROL Agent
      Last 20 Parameter Alarm/Warning Events Shows the last 20 parameters that were triggered with alarm or warning events on the selected PATROl Agent
      Mapped Device Report Shows all the devices mapped to this PATROL Agent
      You can use this to understand the device structure and to identity problems with FQDN mapping.
      PATROL SID Report Shows all of the PATROL Agent's created instances and their SIDs You can use this to easily find the SID you need to create a filter for a specific instance.
      Preloaded KMs - All -Policy+Local Shows all the preloaded KMs (local and policy) configured on the selected PATROL Agent
      Preloaded KMs - Locally configured Shows all the locally-configured preloaded KMs on the selected PATROL Agent
      Preloaded KMs - Policy configured Shows all the policy-configured preloaded KMs on the selected PATROL Agent
      RTServer Information Shows server information about the RT server
      Refresh Parameters

      Rrefreshes all the collection parameters for the KMs configured on the selected PATROL Agent to get the latest data.

      Running KMs details Shows all the knowledge modules (KMs) that are currently loaded on the selected PATROL Agent
  3. Click Execute. The command and its result are displayed.

To manage PATROL Agents through policies

  1. Access the PATROL Agent.
  2. Click the PATROL Agent action menu and select Use Policy Management. Policy updates are now applied to the selected PATROL Agent.

    If the PATROL Agent action menu shows the Remove Policy Management option, it indicates that the Agent is already managed by policies. To remove the PATROL Agent from being managed by the TrueSight console, select Remove Policy Management.

  3. If you want to modify the policy management on multiple PATROL Agents:

    1. Press CTRL and select the PATROL Agents one by one.

    2. From the Common action menu, select Use Policy Management or Remove Policy Management, depending on the action to be performed.

To view configuration history for a PATROL Agent

  1. Access the PATROL Agent that you want to view configuration history for.
  2. Click the PATROL Agent action menu and select Show History for Applied Configurations.The table provides the following information:
Column Description
Time Date and time when the policy was applied on the PATROL Agent
Policies Considered Policies that were applied on the PATROL Agent
Status Status of the applied policies
Configuration Sent Details of the configuration that are applied on the PATROL Agent

Where to go from here

Managing the deployable packages

Was this page helpful? Yes No Submitting... Thank you

Comments