Preloading KMs on the PATROL Agent

If you want your KMs to be loaded at startup and continue collecting data even when there is no console running, preload the .km files or .kml file on the appropriate PATROL Agents as described in Loading KMs from PATROL consoles. A preloaded KM is a KM that is loaded by the PATROL Agent at startup and runs as long as the PATROL Agent runs.

To preload a KM, add it to the agent preload list by using the wpconfig or xpconfig utility, as described in this section. For information about the wpconfig or xpconfig utility, see the PATROL Agent Reference Manual.

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 preloa d a KM from the PATROL Console for Microsoft Windows

1. Access the pop-up menu for a PATROL Agent 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 (for example, VSM.kml for PATROL for VMware vSphere).
    See PATROL for VMware vSphere KM files for the VMware environment for a list of the KMs that are available in this product.
7. Click OK.
8. In the Modify Variable dialog box, click OK to close the box.
9. Select Tools> Apply Configuration.
    The Apply Configuration dialog box is displayed, listing the PATROL Agent host name to which you are connected.
10. To apply your updated configuration to the PATROL Agent, click OK.
11. Save your changes to the configuration change file by clicking Save.
12. Close the wpconfig window.
13. Restart the PATROL Agent.

To preload a KM from the PATROL Console for UNIX

1. Access the pop-up menu for a PATROL Agent 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 (for example, VSM.kml for PATROL for VMware vSphere).
    See PATROL for VMware vSphere KM files for the VMware environment for a list of the KMs that are available in this product.
8. To close the Edit window and save your changes, select File> Exit.
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.
11. Restart the PATROL Agent.