Working with PATROL Agents through the operator console

Using the operator console, you can perform the following tasks on PATROL Agents:

Running PSL commands on PATROL Agents

You can run the PSL commands on PATROL Agents and view the results through the operator console.

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. Navigate to the following location and edit the pronet.conf file:
    • (Windows) Open command prompt from the installationDirectory\tsim\pw\custom\conf folder.
    • (Linux) Navigate to the installationDirectory/tsim/pw/custom/conf folder.
  2. Add the property, askCredentialsForAQT=true to enable authentication and then save the file.
  3. Run the pw jproperties reload command.

Log on to a new session of the Infrastructure Management Server and then verify that the authentication screen is displayed on 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.

Supported with version 11.3.02 and later

The ability to enable authentication is available only with Infrastructure Management version 11.3.02 and later.

To run the PSL commands on PATROL Agents

  1. Perform one of the following tasks:

    • In the Main drawer of the operator console, select Devices > Grid View. Select the agent on which you want to run the PSL commands, and click the blue wrench icon .

    • On the Show Monitors page, in the Tools Menu column of a monitor, click the blue wrench icon .

  2. Select Query Agent.
  3. To select a commonly-used PSL command, click and select a command from the list.
    The PSL command appears in the Command box. Click Apply and then Execute.
  4. 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 the PATROL Script Language Reference Manual Volume 1—PSL Essentials.

Reinitializing a PATROL Agent

You can reinitialize or restart an agent through the operator console.

To reinitialize or restart an agent, perform the following steps:

  1. Perform one of the following tasks:
    • In the Main drawer of the operator console, select Devices > Grid View. Select the agent that you want to restart, and click the blue wrench icon .
    • On the Show Monitors page, in the Tools Menu column of a monitor, click the blue wrench icon .
  2. Select Query Agent.
  3. Click Reinitialize Agent .
  4. A confirmatory message is displayed.
  5. Click OK.
    The agent is restarted.

Reloading a PATROL Agent

You can reload the config.default file and the change file for a PATROL Agent through the operator console.

To reload the config.default file and change file for a PATROL Agent, perform the following steps:

  1. Perform one of the following tasks:
    • In the Main drawer of the operator console, select Devices > Grid View. Select the agent on which you want to reload the config.default file and the change file, and click the blue wrench icon .
    • On the Show Monitors page, in the Tools Menu column of a monitor, click the blue wrench icon .
  2. Select Query Agent.
  3. Click Reload Agent .
  4. A confirmatory message is displayed.
  5. Click OK.
    The agent is reloaded.

Killing a PATROL Agent

You can stop a PATROL Agent through the operator console.

To stop a PATROL Agent, perform the following steps:

  1. Perform one of the following tasks:
    • In the Main drawer of the operator console, select Devices > Grid View. Select the agent that you want to stop, and click the blue wrench icon .
    • On the Show Monitors page, in the Tools Menu column of a monitor, click the blue wrench icon .
  2. Select Query Agent.
  3. Click Kill Agent .
    A confirmatory message is displayed.
  4. Click OK.
    The agent process is stopped.

On non-English Linux computers, if you use the Firefox browser, when you reinitialize, reload, or kill an agent, a confirmatory message is displayed with the black background. On other browsers, the confirmatory message is properly displayed.

Obtaining the latest value of the PATROL Agent parameters

To obtain the latest value of the PATROL Agent parameters in the operator console, perform the following steps. The Refresh Parameters option triggers the collector on the PATROL Agent and starts collection data. The data is then streamed to Infrastructure Management.

  1. In the Main drawer of the operator console, select Devices > Grid View.
  2. Select the agent for which you want to obtain the latest value of the parameters.
  3. Select a monitor and from the Tools menu, select Refresh Parameters.

The command starts to execute and displays the Command Executed Successfully message after a successful execution of the command.

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

Comments