Preloading KMs on the PATROL Agent

Preloaded KMs collect data as long as the PATROL Agent runs, even when no PATROL console is connected. A preloaded KM is a KM that is loaded by the PATROL Agent at startup and runs as long as the PATROL Agent runs. When you view a preloaded KM's data collection history, you will not see any gaps that would otherwise occur (because of the console's absence).

A KM is usually equivalent to a .kml file. A .km file is equivalent to an application class, which is a subset of a KM or .kml file.

To preload a KM, add it to the agent's preload list by using the wpconfig or xpconfig utility, as described in this page. For information about wpconfig, see Using wpconfig (Windows) to configure the BMC PATROL Agent. For information about xpconfig, see Using xpconfig (UNIX) to configure the BMC PATROL Agent

Before you begin

• The PATROL Agent must be running.
• You must be running a PATROL developer console (PATROL Console for Windows or UNIX).
• You must have permission to modify the configuration change file (.cfg ).

To Use wpconfig to preload a KM from the PATROL Console for Microsoft Windows

1. Access the PATROL Agent's pop-up menu and select Development > Agent Configuration.
   The console starts the wpconfig utility and displays the wpconfig window.
2. In the left pane, click the AgentSetup folder.
   The variables in the AgentSetup folder are displayed in the right pane.
3. Scroll down the variable list and double-click the preloadedKMs variable.
   The Modify Variable dialog box is displayed.
4. In the Change Entries field, double-click the highlighted REPLACE line.
   The Change Entry dialog box is displayed.
5. In the Type field, leave REPLACE.
6. In the Value field, use the comma-separated format without spaces to type the names of the .kml files that you want to preload.
7. Click OK.
   The Change Entry dialog box closes.
8. In the Modify Variable dialog box, click OK to close the box.
9. From the Tools menu, select Apply Configuration.
   The Apply Configuration dialog box is displayed, listing the PATROL Agent host name to which you are connected.
10. Click OK to apply your updated configuration to the PATROL Agent.
11. Save your changes to the configuration change file by clicking the Save button.
12. Close the wpconfig window.

To Use xpconfig to preload a KM from the PATROL Console for UNIX

1. Access the PATROL Agent's pop-up menu and select Development > Agent Configuration.
   The console starts the xpconfig utility and displays the xpconfig window.
2. From the Host column in the left pane of the xpconfig window, click a PATROL Agent computer name to highlight it.
3. Click Get Configuration.
   The configuration variables for the selected computer are displayed in the Variables column in the right pane.
4. In the Filter field, type the following string:
   /AgentSetup/pre*
   The filter displays all the variables that begin with this character string.
5. Double-click the preloadedKMs variable.
   The Edit Variable dialog box is displayed.
6. Click Change.
   An Edit window is displayed.
7. Use the comma-separated format without spaces to type the names of the .kml files that you want to preload.
8. Select File > Exit to close the Edit window and save your changes.
9. In the Edit Variable dialog box, click OK to close the box.
10. Click Apply Configuration and close the xpconfig window.
    The xpconfig utility sends the updated configuration to the selected PATROL Agent.