Performing 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 the 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.

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.

 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:

Where to go from here

Managing-the-deployable-packages