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
- 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.
- 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
- Access the PATROL Agent that you want to deploy and install packages to, or uninstall monitoring solutions from.
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
- Access the PATROL Agent that you want to synchronize.
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.
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.
- Do the following:
- (Windows) Open command prompt from the installationDirectory\truesightpserver\bin folder.
- (Linux) Navigate to the installationDirectory/truesightpserver/bin folder.
- Run the
tssh properties set askCredentialsForAQT <true/false>command
- Run the
tssh properties reloadcommand.
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.
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.
Click the PATROL Agent action menu and select Query PATROL Agent. The Agent Query Tool opens in a new browser window.
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.
%DUMP ALL. The results are displayed.
For information about the PSL commands, see .
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
Click Execute. The command and its result are displayed.
To manage PATROL Agents through policies
- Access the PATROL Agent.
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.
If you want to modify the policy management on multiple PATROL Agents:
Press CTRL and select the PATROL Agents one by one.
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
- Access the PATROL Agent that you want to view configuration history for.
- Click the PATROL Agent action menu and select Show History for Applied Configurations.The table provides the following information:
|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|