Removing KMs for Exchange Servers from your console and agent

If you want to remove a KM from being displayed in your PATROL Console, you can unload its corresponding application classes (.km files) as described in Unloading KMs from a PATROL Console.

When you unload a .km file, its corresponding application class no longer appears in your console. Unloading a .km file does not delete the file from the lib\knowledge or psl directories on the PATROL Console or PATROL Agent computer. If you want to delete a KM completely from your system, you must uninstall the KM.

If a .km file was preloaded (whether as part of a .kml file or not), 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 Removing KMs from the agent preload list.

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.

 Unloading KMs from a PATROL Console

If you no longer want to view a KM that currently appears in your console, you can unload the corresponding application classes (.km files) that make up the KM.

To unload KMs from PATROL Central - Microsoft Windows Edition

PATROL Central - Microsoft Windows Edition has a wizard with which you can unload specified .km files from specified computers.

  1. On the Common Tasks tab of the taskpad, click the Unload Knowledge Modules icon.

    PATROL Central - Microsoft Windows Edition displays the wizard.
  2. Click Next to start the wizard.

    The wizard lists each computer on which a PATROL Agent has been installed.
  3. Select the check boxes for the computers from which you want to unload .km files, and click Next.

    The wizard displays a list of application class names (that correspond to .km file names) for each computer selected. Each application class name is listed once for each computer.
  4. Select the check boxes for the .km and computer pair that you want to unload, and click Next. To unload an entire KM, select all the .km files that make up the KM. See Preload package descriptions and included components for a list of the .km files in each KM.
  5. Click Finish.

    The console removes the selected .km files from the current management profile.

To unload KMs from PATROL Central - Web Edition

PATROL Central - Web Edition has a feature with which you can unload specified .km files from specified computers.

  1. From the Managed Systems page, click the Load/Unload KMs button.
     The Load KMs page opens, listing each computer on which a PATROL Agent has been installed.
  2. Select the computers from which you want to unload .km files, and click Next.
     The Load KMs page displays a list of .km files. Currently loaded .km files are highlighted (selected) in the list.
  3. Cancel the selection of the .km files that you want to unload by clicking them in the list. To unload an entire KM, cancel the selection of all the .km files that make up the KM. See Preload package descriptions and included components for a list of the .km files in each KM.
  4. Click Finish.
     The console removes the .km files that you specified from the current management profile.

To unload KMs from the PATROL Console for Microsoft Windows

Unloading a KM is also referred to as deleting a KM in the PATROL Console for Microsoft Windows. However, the files are actually unloaded from the console's memory rather than deleted from your hard drive.

  1. From the KM tab of the tree view, right-click the application class name that you want to delete and select Delete from the pop-up menu.

    The console displays a dialog box that asks if you want to delete the selected application.
  2. Click Yes to delete the application class.

    The application class is removed from your console, and its corresponding .km file is removed from your console session file when you save your changes.
  3. Repeat Step 1 and Step 2 until you have deleted all of the application classes (.km files) associated with the KM that you want to delete.
  4. From the console menu bar, select File > Save KM to save your changes.

To unload KMs from the PATROL Console for UNIX

Unloading a KM is also referred to as deleting a KM in the PATROL Console for UNIX. However, the files are actually unloaded from the console's memory rather than deleted from your hard drive.

  1. From the PATROL Main window, select Attributes > Application Classes.

    The console displays the List of Application Classes window.
  2. Click the name of the application class that you want to delete.

    The console highlights the application class name.
  3. From the List of Application Classes menu bar, select Edit > Delete.

    The application class is removed from your console, and its corresponding .km file is removed from your console session file when you save your changes.
  4. Repeat Step 2 and Step 3 until you have deleted all of the application classes associated with the KM that you want to delete.
  5. From the List of Application Classes menu bar, select File > Save KM to save your changes.

 Removing 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.
  • 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 remove a KM from the preload list in 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, delete the .kml file names that you want to remove from the preload list. See Preload package descriptions and included components for a list of the KMs that are available in this product.
  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 the Save button.
  12. Close the wpconfig window.

To use xpconfig to remove a KM from the preload list in 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 the Get Configuration button.

    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 the Change button.

    An Edit window is displayed.
  7. Delete the .kml file names that you want to remove from the preload list. See PATROL for Exchange Servers KML files for a list of the KMs that are available in this product.
  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.

 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*