Removing KMs from the agent preload list

If a .km file was preloaded, unloading it does not stop the PATROL Agent from collecting data for that .km file. However, if the .km file was not preloaded, then unloading it does stop the file from running and collecting data on the PATROL Agent.

If you no longer want the PATROL Agent to run a KM that was preloaded, you can remove its corresponding .kml file or .km files from the PATROL Agent preload list as described in the following tasks.

When you remove a KM from the PATROL Agent preload list, the agent does not run the KM unless you load it with a running console. KMs that are not preloaded do not run when no console is running.

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 remove a KM from the preload list in 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, 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 List-of-KM-files.
7. Click OK to close the Change Entry dialog box.
8. Click OK to close the Modify Variable dialog 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 Save.
12. Close the wpconfig window.
13. Restart the PATROL Agent.

To remove a KM from the Preload List in 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 that character string.
5. Double-click the preloadedKMs variable.
    The Edit Variable dialog box is displayed.
6. Click Change.
    An Edit window is displayed.
7. 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 List-of-KM-files.
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.
11. Restart the PATROL Agent.