Using the PATROL Configuration Manager to configure the BMC PATROL for Log Management

The PATROL Configuration Manager includes the Log KM Configuration Plug-in, which allows you to configure the Log KM to monitor specific log files without using a PATROL Console.

Plug-in actions

The Log KM Configuration Plug-in interacts with PATROL Configuration Manager based upon the task that you are performing. When adding rulesets to establish and configure monitoring, you use the Agent tree view pane. When updating or deleting rulesets, you use the RuleSets tree view pane.

 Adding/specifying object instances to monitor

Configuring PATROL to monitor aspects of an application involves creating an instance for the object being monitored, such as a log file, and establishing a ruleset. This procedure is initiated in the Agent tree view pane.

To add an object instance

1. In the Agent tree view pane, click and select an agent.
2. Right-click the agent and select Log KM Configuration > Log Files.
3. In the configuration dialog box that the configuration manager displays, click Add.

4. In the dialog box for creating instances, type the required information in the appropriate fields, as described in the following table.
   
   New Instance dialog boxes and fields

    

   Fields	Description
   New Instance Label	Enter a descriptive name (as you want it to appear in PATROL) that identifies the log that you want to monitor.
   Monitored Filename	Enter the path and filename of the log that you want to monitor.

5. Click OK.
6. Select each tab and provide the relevant information in the configuration dialog box.
   For more information about the Log KM Configuration dialog box, see Add File for Label - dialog box and Change File for Label - dialog box.
7. Click Apply to save your changes and leave the dialog box open, or OK to save the changes and close the dialog box.

 Updating monitored object instances

Changing how PATROL monitors aspects of an application involves editing a ruleset. This procedure is initiated in the RuleSet tree view pane.

1. In the RuleSet tree view pane, expand the RuleSet folder.
2. Navigate to the backup ruleset of the agent whose object instance monitoring you want to update. Expand PCM > backup > backup_container > agent > ccyymmdd-hhmmss_ruleset.

3. Right-click the ruleset and select Log KM Configuration > Log Files.

   Note

   If no object instances have been added for monitoring, the menu command is inactive. For more information about adding an object instance for monitoring, see Adding/specifying object instances to monitor.

4. In the configuration dialog box that the configuration manager displays, select an instance from the instance list and click Update.
5. Select the appropriate tab and edit the relevant information in the configuration dialog box.
   For more information about the Log KM Configuration dialog box, see Add File for Label - dialog box and Change File for Label - dialog box.
6. Click Apply to save your changes and leave the dialog box open, or OK to save the changes and close the dialog box.

Deleting monitored object instances

Stopping PATROL from monitoring aspects of an application involves deleting a ruleset. This procedure is initiated in the RuleSet tree view pane.

1. In the RuleSet tree view pane, expand the RuleSet folder.
2. Navigate to the backup ruleset of the agent whose object instance monitoring that you want to update. Expand PCM > backup > backup_container > agent > ccyymmdd-hhmmss_ruleset.

3. Right-click the ruleset and select Log KM Configuration > Log Files.

   Note

   If no object instances have been added for monitoring, the menu command is inactive. For more information about adding an object instance for monitoring, see Adding/specifying object instances to monitor.

4. In the configuration dialog box that the configuration manager displays, select an instance from the instance list.
5. Click Delete.
6. Click Apply to save the deletion and leave the dialog box open, or OK to save the deletion and close the dialog box.