Executing tasks on BMC PATROL Agents from BMC ProactiveNet

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

• Run PSL commands on an agent
• Reinitialize an agent
• Kill an agent
• Reload an agent
• (Only using Central Monitoring Administration) Synchronize monitor instances with an agent
• (Only using Central Monitoring Administration) Configuration history for a BMC PATROL Agent

To work with the BMC PATROL Agents:

1. Perform the following tasks according to the console you use:
   • BMC ProactiveNet Central Monitoring Administration
     1. In the navigation pane of Central Monitoring Administration, click the Servers drawer.
     2. Select an appropriate BMC ProactiveNet 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.
   • BMC ProactiveNet Operations Console
     1. Perform one of the following tasks:
        • In the Main drawer of the BMC ProactiveNet Operations 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/Icon	Description
   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 BMC ProactiveNet.

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 BMC ProactiveNet 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 BMC ProactiveNet.

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: