Preloading Cisco Nexus on 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.

If you want your KMs to continue collecting data even when there is no console running, preload your KMs. To preload a KM, use one of the following techniques to add it to the agent's preload list:

• The menu command Agent Quick Config > Make Current KM's Preloaded from the agent host computer icon
• PATROL Configuration Manager
• The wpconfig or xpconfig utility, as described in this task.

For information about the wpconfig or xpconfig utility, see the PATROL Agent Reference Manual.

Before you begin

• The PATROL Agent is installed and running.
• You have a PATROL developer connection to the agent (PATROL Console for Windows or Unix).
• You 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 menu and choose Development > Agent Configuration.
    The console starts the wpconfig utility and the Wpconfig window opens.
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 opens.
4. In the Change Entries field, double-click the highlighted REPLACE line.
    The Change Entry dialog box opens.
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.
    In this case PCZ.kml is the only required kml file.
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, choose Apply Configuration.
    The Apply Configuration dialog box opens, 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 choose Development > Agent Configuration.
    The console starts the xpconfig utility and the Xpconfig window opens.
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 opens.
6. Click Change.
7. In the Edit window, use the comma-separated format without spaces to type the names of the .kml files that you want to preload.
8. Choose 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.