Preloading KMs on the PATROL Agent

If you want your KMs to continue collecting data even when no console is running, you must preload your KMs on the PATROL Agent. 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's preload list. You can update the preload list by using one of these methods:

• Use the PATROL Configuration Manager to apply one of the predefined rulesets to the PATROL Agent (see PATROL for Microsoft Windows Servers rulesets)
• Using the wpconfig or xpconfig utility

Preloading using the wpconfig utility

You can use the wpconfig utility to preload KMs on the PATROL Agent. For information about the wpconfig ir xpconfig utility, see the PATROL Agent Reference Manual.

Before you begin

• The PATROL Agent must be running.
• The wpconfig utility must be installed on a computer that can access computers that are running the PATROL Agent over the network.
• 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. From a Windows command window, type wpconfig.
   The wpconfig window is displayed.
2. From the menu bar, select Tools > Get Configuration.
   The Get Configuration dialog box is displayed.
3. In the Host Name field, enter the name of a computer that is hosting the PATROL Agent and click OK.
   The wpconfig utility gets the PATROL Agent's configuration.
4. In the left pane, click the AgentSetup folder.
   The variables in the AgentSetup folder are displayed in the right pane.
5. Scroll down the variable list and double-click the preloadedKMs variable.
   The Modify Variable dialog box is displayed.
6. In the Change Entries field, double-click the highlighted REPLACE line.
   The Change Entry dialog box is displayed.
7. In the Type field, leave REPLACE.
8. 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 a list of the KMs that are available in this product, see PATROL for Microsoft Windows Servers .kml files.
   For example, a valid and typical preloaded KMs list is as follows:
   NT_BASE.kml,COM.kml,NT_PERFMON_WIZARD.kml
9. Click OK.
   The Change Entry dialog box closes.
10. In the Modify Variable dialog box, click OK to close the box.
11. 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.
12. Click OK to apply your updated configuration to the PATROL Agent.
13. Save your changes to the configuration change file by clicking the Save button.
14. Close the wpconfig window.

Using wpconfig to remove KMs from the Agent preload list

If you want to remove a KM or application class so that it no longer runs on the PATROL Agent, remove the corresponding .kml or .km file from the agent preload list, as described in this task.

Before you begin

• The PATROL Agent must be running.
• The wpconfig utility must be installed on a computer that can access computers that are running the PATROL Agent over the network.
• You must have permission to modify the configuration change file (.cfg ).

To use wpconfig to remove a KM from the preload list in the PATROL Console for Microsoft Windows

1. From a Windows command window, type wpconfig.
   The wpconfig window is displayed.
2. From the menu bar, select Tools > Get Configuration.
   The Get Configuration dialog box is displayed.
3. In the Host Name field, enter the name of a computer hosting the PATROL Agent and click OK.
   The wpconfig utility gets the PATROL Agent's configuration.
4. In the left pane, click the AgentSetup folder.
   The variables in the AgentSetup folder are displayed in the right pane.
5. Scroll down the variable list and double-click the preloadedKMs variable.
   The Modify Variable dialog box is displayed.
6. In the Change Entries field, double-click the highlighted REPLACE line.
   The Change Entry dialog box is displayed.
7. In the Type field, leave REPLACE.
8. In the Value field, delete the .kml file names that you want to remove from the preload list.
   For a list of the KMs that are available in this product, see PATROL for Microsoft Windows Servers .kml files.
9. Click OK to close the Change Entry dialog box.
10. Click OK to close the Modify Variable dialog box.
11. From the Tools menu, select Apply Configuration.
    The Apply Configuration dialog box is displayed.
12. Click OK to apply your updated configuration to the PATROL Agent.
13. Save your changes to the configuration change file by clicking the Save button.
14. Close the wpconfig window.