Page tree
Skip to end of metadata
Go to start of metadata

You can perform the following tasks on BMC PATROL Agents by using Central Monitoring Administration or Operations Console:

To work with the BMC PATROL Agents:

  1. Perform the following tasks according to the console you use:
    • Infrastructure Management Central Monitoring Administration
      1. In the navigation pane of Central Monitoring Administration, click the Servers drawer.
      2. Select an appropriate Infrastructure Management Server.
      3. In the Integration Service column, expand the Integration Service.
      4. In the Agent column, select an agent.
      5. Click the wrench icon , and click Query Agent.
    • operator console
      1. Perform one of the following tasks:
        • In the Main drawer of the operator console, select Devices > Grid View. Select an agent, 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.

    Perform any of the following tasks that you want to perform on the BMC PATROL Agent:

    Field/IconDescription
    Command 

    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

    To manually enter a PSL command, type the command in the Command box and press Enter, or click Execute.
    The PSL command is run on the BMC PATROL Agent, and the result is displayed.

    For example, %DUMP ALL

    For information about the PSL commands, see the PATROL Script Language Reference Manual Volume 1—PSL Essentials.

    Note

    If you execute a GET command to obtain PATROL Agent pconfig variable values and those values are not available, the Executed successfully on the PATROL agent message is displayed, however the requested values are not displayed.

    Reinitializes (restarts) an agent 
    Reloads the config.default file and the change file for a BMC PATROL Agent
    Stops a BMC PATROL Agent
  2. If you have reinitialized, reloaded, or stopped a BMC PATROL Agent, on the confirmatory message, click OK.

Synchronizing monitor instances with a BMC PATROL Agent

You can synchronize monitor instances with a BMC PATROL Agent through Central Monitoring Administration. This process triggers the BMC PATROL Agent to resend all the instances that the agent monitors to Infrastructure Management.

Note

Monitor instances discovered and monitored by agents are automatically sent to the Infrastructure Management Server. BMC recommends that you execute the synchronization operation only when some of the monitor instances are not visible on Infrastructure Management Server, but are present on the agents. This process uses a lot of system resources on both the agents and the Infrastructure Management Server.

To synchronize with the BMC PATROL Agents, perform the following tasks:

  1. In the navigation pane of Central Monitoring Administration, click the Servers drawer.
  2. Select an appropriate Infrastructure Management Server.
  3. In the Integration Service column, expand the Integration Service.
  4. In the Agent column, select the agent that you want to sync with.
  5. Click the wrench icon , and click Sync Agent.
  6. On the confirmatory message, click Yes.
    The monitor instances on the agent are synchronized with Infrastructure Management.

Note

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

OS commands and the Query Agent functionality

You cannot run OS commands directly using the Query Agent functionality. You must run these commands using the system PSL function and view the output of this function using the print function. The following example shows how to of run the net user command using the system function:

print(system(“cmd /c net user”));

Enter this command in the Command field of the Query Agent dialog box and click Submit.

The system command runs the OS command on the PATROL Agent. Enclosing the system command within the print command causes the command output to be displayed in the Query Agent output screen; otherwise, the command executes and the Query Agent screen displays the following message:

Executed successfully on the PATROL agent

Configuration history for a BMC PATROL Agent

Using Central Monitoring Administration, you can view the applied configuration history for a BMC PATROL Agent (version 9.5 and later).

By default, the last 10 configurations applied to the BMC PATROL Agent are displayed.

  1. In the navigation pane of Central Monitoring Administration, click the Servers drawer.
  2. In the Agent column, select a BMC PATROL Agent.
  3. Click the wrench icon  and click Show History for applied configurations.

The table provides the following information:

Table fieldDescription
TimeThe date and time when the policy was applied.
Policies ConsideredPolicies that were applied on the BMC PATROL Agent.
StatusStatus of the policy - success, failure, or configuration removed.
Configuration SentDetails of the configuration sent to the BMC PATROL Agent.