Patrol Agent 3.6

www.bmc.com

PATROL AgentReference Manual

Supporting

PATROL Agent 3.6January 2007

Contacting BMC Software

You can access the BMC Software website at http://www.bmc.com. From this website, you can obtain information about the company, its products, corporate offices, special events, and career opportunities.

United States and Canada

Address BMC SOFTWARE INC2101 CITYWEST BLVDHOUSTON TX 77042-2827 USA

Telephone 713 918 8800 or800 841 2031

Fax 713 918 8000

Outside United States and Canada

Telephone (01) 713 918 8800 Fax (01) 713 918 8000

Copyright 2007 BMC Software, Inc., as an unpublished work. All rights reserved.

BMC Software, the BMC Software logos, and all other BMC Software product or service names are registered trademarks or trademarks of BMC Software, Inc.

IBM is a registered trademark of International Business Machines Corporation.

Oracle is a registered trademark, and the Oracle product names are registered trademarks or trademarks of Oracle Corporation.

All other trademarks belong to their respective companies.

BMC Software considers information included in this documentation to be proprietary and confidential. Your use of this information is subject to the terms and conditions of the applicable End User License Agreement for the product and the proprietary and restricted rights notices included in this documentation.

Restricted rights legend

U.S. Government Restricted Rights to Computer Software. UNPUBLISHED -- RIGHTS RESERVED UNDER THE COPYRIGHT LAWS OF THE UNITED STATES. Use, duplication, or disclosure of any data and computer software by the U.S. Government is subject to restrictions, as applicable, set forth in FAR Section 52.227-14, DFARS 252.227-7013, DFARS 252.227-7014, DFARS 252.227-7015, and DFARS 252.227-7025, as amended from time to time. Contractor/Manufacturer is BMC SOFTWARE INC, 2101 CITYWEST BLVD, HOUSTON TX 77042-2827, USA. Any contract notices should be sent to this address.

3Customer support

You can obtain technical support by using the BMC Software Customer Support website or by contacting Customer Support by telephone or e-mail. To expedite your inquiry, see Before contacting BMC.

Support website

You can obtain technical support from BMC 24 hours a day, 7 days a week at http://www.bmc.com/support_home. From this website, you can

read overviews about support services and programs that BMC offers find the most current information about BMC products search a database for issues similar to yours and possible solutions order or download product documentation report an issue or ask a question subscribe to receive proactive e-mail alerts when new product notices are released find worldwide BMC support center locations and contact information, including e-mail addresses, fax numbers, and

telephone numbers

Support by telephone or e-mail

In the United States and Canada, if you need technical support and do not have access to the web, call 800 537 1813 or send an e-mail message to [email protected]. Outside the United States and Canada, contact your local support center for assistance.

Before contacting BMC

Have the following information available so that Customer Support can begin working on your issue immediately:

product information

product name product version (release number) license number and password (trial or permanent)

operating system and environment information

machine type operating system type, version, and service pack or other maintenance level such as PUT or PTF system hardware configuration serial numbers related software (database, application, and communication) including type, version, and service pack or

maintenance level

sequence of events leading to the issue

commands and options that you used

messages received (and the time and date that you received them)

product error messages messages from the operating system, such as file system full messages from related software

4 PATROL Agent Reference Manual

ContentsChapter 1 Structure of PATROL 21

Role of the PATROL Agent. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22Purpose of PATROL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22Overview of the PATROL 3.x Architecture . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23Overview of the PATROL 7.x Architecture . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24

Components of PATROL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25PATROL Components . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25Non-PATROL Components . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29

PATROL Agent Directory and File Structure . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29PATROL_HOME Directory Structure. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 30Files Used by the PATROL Agent. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 30Profile Directory . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 32

Event Management with the PATROL Agent . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 32Services Provided by the PATROL Agent . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 33Overview of the PEM Engine . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 34Management Services from the PEM Engine . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 35

Chapter 2 Starting and Stopping the PATROL Agent 37

Methods for Starting the PATROL Agent . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 38Default Port Number . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 38Startup Process. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 38Command Line Arguments for Starting the PATROL Agent . . . . . . . . . . . . . . . . 39

Methods for Stopping the PATROL Agent . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 43Stopping the PATROL Process . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 43Improper Shutdown . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 43PATROL Configuration Utility (pconfig) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 44

Starting the PATROL Agent on UNIX . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45Starting the PATROL Agent for UNIX. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45

Stopping the PATROL Agent on UNIX . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 46Stopping the PATROL Agent for UNIX with a Script . . . . . . . . . . . . . . . . . . . . . . . 46Stopping the PATROL Agent for UNIX with a Configuration Utility Script. . . . 47

Starting the PATROL Agent on Windows . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 48PATROL Agent Configuration Utility . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 48Modes for Running the PATROL Agent for Windows . . . . . . . . . . . . . . . . . . . . . . 49Contents 5

Specifying an Account for the PATROL Agent for Windows . . . . . . . . . . . . . . . . 49Starting the PATROL Agent for Windows with the Services Applet . . . . . . . . . . 50Starting the PATROL Agent for Windows from a Command Prompt . . . . . . . . . 50Active Directory Support . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 51

Stopping the PATROL Agent on Windows . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 52

6Stopping the PATROL Agent for Windows with the Services Applet . . . . . . . . . 52Stopping the PATROL Agent for Windows from a Command Line . . . . . . . . . . . 52

Starting the PATROL Agent on OpenVMS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 53Syntax of PATROL$STARTUP.COM . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 53Starting the PATROL Agent on OpenVMS from a Command Line. . . . . . . . . . . . 53Starting the PATROL Agent on OpenVMS in a Batch Process . . . . . . . . . . . . . . . . 54

Stopping the PATROL Agent on OpenVMS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 55Syntax for PATROL$SHUTDOWN.COM . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 55Stopping the PATROL Agent on OpenVMS from the Command Prompt . . . . . . 55Stopping the PATROL Agent on OpenVMS in a Batch Process . . . . . . . . . . . . . . . 56

Chapter 3 Configuring the PATROL Agent 57

Controlling the Configuration of PATROL Agents. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 57Essential Controls for Configuring PATROL Agents . . . . . . . . . . . . . . . . . . . . . . . . 58Overriding the Default Values . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 60Override Parameters and the PATROL Agent Configuration . . . . . . . . . . . . . . . . 61Variables That Cannot Be Changed. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 61When Changes to the Configuration Take Effect . . . . . . . . . . . . . . . . . . . . . . . . . . . 62

Process for Configuring the PATROL Agent . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 65Methods for Specifying Files and Changing Variables . . . . . . . . . . . . . . . . . . . . . . 65Options for Changing Values for Variables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 66Determining the Method for Changing Variables . . . . . . . . . . . . . . . . . . . . . . . . . . 67Creating User-Defined Variables. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 67

Chapter 4 Establishing Accounts and Ports 69

Accounts. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 70Setting the PATROL Agent Default Account . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 70Setting the PATROL Agent Default Account Shell. . . . . . . . . . . . . . . . . . . . . . . . . . 70Setting the PATROL Agent Account for Applications. . . . . . . . . . . . . . . . . . . . . . . 71Adding Time Zones to PATROL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 71Setting the PATROL Agent Account for Instances . . . . . . . . . . . . . . . . . . . . . . . . . . 72Default Accounts for XPC Servers. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 72Using the Application-Specific Account for Commands . . . . . . . . . . . . . . . . . . . . . 73Setting the Default Account for Trusted Clients . . . . . . . . . . . . . . . . . . . . . . . . . . . . 73Setting the Default Account for PEM Commands . . . . . . . . . . . . . . . . . . . . . . . . . . 74

Ports . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 74Setting the Default Port Number on UNIX Only . . . . . . . . . . . . . . . . . . . . . . . . . . . 75Setting a Local Port for Remote Calls . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 75

Chapter 5 Managing Console Connections 77

Agent-Console Relationship . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 78Setting the Maximum Number of Remote (Agent-to-Agent) Sessions . . . . . . . . . 78Displaying and Logging PEM Connection Messages. . . . . . . . . . . . . . . . . . . . . . . . 78Changing the UNIX Display Environment . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 79Controlling System Output Window Display . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 79Setting the Agent to Run without a Console Connection . . . . . . . . . . . . . . . . . . . . 80Connecting to Systems Having Multiple Network Cards . . . . . . . . . . . . . . . . . . . . 80PATROL Agent Reference Manual

Recognize Additional IP Addresses . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 82Connections Using DHCP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 82

Controlling Access to the Agent . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 83Backing Up Your Configuration Files Before Defining an ACL. . . . . . . . . . . . . . . 84Defining Access Control Lists . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 84Denying Access to the Agent. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 87Enabling System Output Window Display . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 88HostName and UserName Attribute Conventions . . . . . . . . . . . . . . . . . . . . . . . . . 88Connection Modes and Accounts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 89Required Access. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 90Restoring Access in Case of Lockout . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 91Examples of ACL Usage . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 91Access for Agent Configuration Utility Started through Developer Console . . . 92Access for Agent Configuration Utility Started from the Command Line . . . . . . 92Controlling pconfig Access to the Agent . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 93Access for PATROL Event Manager Console . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 93Access for the Knowledge Module Scripts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 94Access for PEM Applications. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 94Error Messages. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 95Controlling Events Displayed in PEM . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 95Using the User Account for PEM Commands. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 96

Chapter 6 Support of Clusters and Failovers 97

Cluster and Failover Concepts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 98Control Script . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 98Cluster . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 98Cluster Node . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 98Cluster Application . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 98Cluster Management Software (CMS) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 99Failover . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 99Group . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 99Package . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 99Virtual IP Address. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 100

Examples of Third-Party Cluster Software . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 100PATROL Cluster Compatibility and Failover Tolerance . . . . . . . . . . . . . . . . . . . . . . . 100Failover Behavior . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 101

Description . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 101Illustration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 102

PATROL Agent Issues and Concerns . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 106One Virtual IP Address For Each Group or Package . . . . . . . . . . . . . . . . . . . . . . . 106PATROL Must Recognize the Virtual IP Address . . . . . . . . . . . . . . . . . . . . . . . . . 106Local KM Customizations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 106

Basic Set Up of the PATROL Agent in a Windows Cluster . . . . . . . . . . . . . . . . . . . . . 107Using the PATROL Cluster Configuration Wizard . . . . . . . . . . . . . . . . . . . . . . . . 107Manually Configuring the PATROL Agent for Clustering. . . . . . . . . . . . . . . . . . 108Define the PATROL Cluster-Specific Environment Variables . . . . . . . . . . . . . . . 109Create and Register a New Service for the PATROL Agent . . . . . . . . . . . . . . . . . 110Define the PATROL Agent as a Member of the Group . . . . . . . . . . . . . . . . . . . . . 111

Basic Set Up of the PATROL Agent in a UNIX Cluster . . . . . . . . . . . . . . . . . . . . . . . . 113Contents 7

8Configure PATROL Agent to Operate in a Cluster . . . . . . . . . . . . . . . . . . . . . . . . 113Define the PATROL Cluster-Specific Environment Variables . . . . . . . . . . . . . . . 115Define the PATROL Agent as a Member of the Package . . . . . . . . . . . . . . . . . . . . 115

PATROL Cluster-Specific Environment Variables for History and Configuration . 116Variables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 117Operation. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 117Example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 118

Chapter 7 Loading and Monitoring Applications 121

Loading Knowledge Modules by Console and Agent . . . . . . . . . . . . . . . . . . . . . . . . . 122When the PATROL Agent Will Not Monitor Applications. . . . . . . . . . . . . . . . . . 122Version Arbitration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 123

Application Status . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 124Statuses . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 124Assigning Status. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 125

Preloading KMs on the PATROL Agent . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 125Preloading Applications . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 127

Based on Application Name. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 127Based on Architecture . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 128

Removing KMs from the Agent Preload List . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 129Designating Applications as Static. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 132Disabling Applications . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 132

Based on Application Name. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 133Based on Architecture . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 133Based on Exclusion . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 134

Filter Processing Logic For Disabling KMs. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 134Types . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 134Precedence. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 135Example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 136

Listing Loaded Applications. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 137Running dump_km_list . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 137Example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 138

Selecting Which Instances to Monitor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 138Choosing an Inclusive or Exclusive Filter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 138Editing List to Filter by Application or Regular Expression . . . . . . . . . . . . . . . . . 139

Chapter 8 Using pconfig to Configure the PATROL Agent 141

Overview of the pconfig Command Line Configuration Utility . . . . . . . . . . . . . . . . . 142Prerequisites for Configuring at the Command Line . . . . . . . . . . . . . . . . . . . . . . . . . . 142Syntax of pconfig . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 143

Specifying a Windows Domain Account Name . . . . . . . . . . . . . . . . . . . . . . . . . . . 144Determining the Command String to Use for the Task . . . . . . . . . . . . . . . . . . . . . . . . 144Determining the Option to Use for the Task . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 147Examples of Configuring at the Command Line . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 148Using the pconfig Utility to Modify PATROL Agent Configuration Variables . . . . 149PATROL Agent Reference Manual

Chapter 9 Using xpconfig (UNIX) to Configure the PATROL Agent 151

Overview of the xpconfig Configuration Utility . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 152Prerequisites for Configuring with the xpconfig Utility . . . . . . . . . . . . . . . . . . . . . . . 152Overview of xpconfig Functions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 153The xpconfig Primary Window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 154

Accessing the xpconfig Primary Window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 155Closing the xpconfig Primary Window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 157Cancelling Changes Not Applied . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 157Stopping an Operation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 157Returning to the xpconfig Primary Window. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 157Selecting a Change File . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 158When Changes Take Effect . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 159Reinitializing the PATROL Agent. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 159Reloading the config.default File and Change File for the PATROL Agent. . . . 160Stopping the PATROL Agent . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 161

Handling Change Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 162Tasks Available for Handling Change Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 162Opening an Existing Change File . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 163Creating a New Change File . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 164Sending a Complete Set of Variables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 165Viewing a Change File . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 166Saving a Change File . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 166Applying the Changes to a PATROL Agent . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 167Purging the Existing Configuration from a PATROL Agent . . . . . . . . . . . . . . . . 169Sending a New License File to a PATROL Agent. . . . . . . . . . . . . . . . . . . . . . . . . . 170

Handling Variables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 171Handling Variables from the Primary Window . . . . . . . . . . . . . . . . . . . . . . . . . . . 171Adding a Host to the Host List . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 172Adding New Variables to the Change File . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 174Deleting a Variable from the Change File . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 175Resetting a Variable to Its Default Value . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 176Handling Variables from the Edit Variable Dialog Box . . . . . . . . . . . . . . . . . . . . 177Modifying Variables Using the Edit Variable Dialog Box. . . . . . . . . . . . . . . . . . . 177Inserting a New Change Entry in the Edit Variable Dialog Box . . . . . . . . . . . . . 179Modifying a Change Entry in the Edit Variable Dialog Box. . . . . . . . . . . . . . . . . 180Deleting a Change Entry from the Edit Variable Dialog Box . . . . . . . . . . . . . . . . 181Modifying the Default Account Variable in the Change File . . . . . . . . . . . . . . . . 181

Chapter 10 Using wpconfig (Windows) to Configure the PATROL Agent 185

Overview of the wpconfig Configuration Utility . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 186Prerequisites for Using the wpconfig Configuration Utility . . . . . . . . . . . . . . . . . . . . 186Overview of wpconfig Functions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 187Working with the wpconfig Window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 188

Accessing the wpconfig Window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 189Closing the wpconfig Window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 190Creating a New Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 190

Tasks Available for Using the wpconfig Utility . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 191Retrieving a Configuration from a PATROL Agent. . . . . . . . . . . . . . . . . . . . . . . . 191Contents 9

10Getting a Configuration from a PATROL Agent. . . . . . . . . . . . . . . . . . . . . . . . . . . 191Adding a Variable to a PATROL Agent Configuration . . . . . . . . . . . . . . . . . . . . . 192Adding a New Variable . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 192Modifying a Variable in a Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 193Modifying an Existing Variable . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 193Modifying the Default Account Variable . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 194Deleting a Variable from a Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 196Deleting an Existing Variable . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 197Viewing Changes in a Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 197Viewing Configuration Changes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 197Applying a Configuration to a PATROL Agent . . . . . . . . . . . . . . . . . . . . . . . . . . . 198Applying a Configuration to an Agent. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 198

Chapter 11 PATROL Agent Logs 201

PATROL Agent Error Log. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 201Contents. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 202Location . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 202Sample . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 203Limiting Size By Restricting the Number of Messages . . . . . . . . . . . . . . . . . . . . . 203Log File Aging . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 204

Agent Audit Log . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 205Contents. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 205Location . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 206Setting Up Audit Logging. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 207Keys and Values for the Audit Log Variable . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 207Audit Log File Format . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 210Sample Audit Log File. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 213

Chapter 12 PATROL Agent Parameter History 215

Overview of PATROL History . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 216Contents. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 216Structure . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 216Location . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 217

Setting Up the History Cache and Database . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 218Flushing the Agent Cache Based on a Time interval . . . . . . . . . . . . . . . . . . . . . . . 218Flushing the Agent Cache Based on the Number of Data Points . . . . . . . . . . . . . 219Setting the Number of Days that History is Retained in the History Database . 219

Extracting History from the Database . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 220Output . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 220File and Directory Structure Used by dump_hist . . . . . . . . . . . . . . . . . . . . . . . . . . 221Before Running the dump_hist Utility . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 223Running dump_hist . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 223Examples . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 227

Fixing a Corrupted History Database . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 228Overview of fix_hist Utility . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 229Overview of the fixHistFlag Configuration Variable . . . . . . . . . . . . . . . . . . . . . . . 230File and Directory Structure Used by fix_hist . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 231Before Running the fix_hist Utility . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 233PATROL Agent Reference Manual

Running fix_hist. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 233Examples. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 236

Chapter 13 PATROL Agent Security 237

PATROL Agent Security Methods . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 237Using PATROL in an Environment with Firewalls . . . . . . . . . . . . . . . . . . . . . . . . . . . 239Using Access Control List . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 239Using Accounts. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 240Default Ownership and Permissions for Directories . . . . . . . . . . . . . . . . . . . . . . . . . . 240Default Ownership and Permissions for Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 240

Changing Ownership and Permissions on UNIX. . . . . . . . . . . . . . . . . . . . . . . . . . 241

Chapter 14 PATROL Events 243

PATROL Events . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 244PATROL Event Log . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 244

Events Stored . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 244Contents . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 244Location. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 245

Setting Up the Event Log File and Size. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 245Naming the Event Log File . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 246Setting the Event Log File Size . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 246

Managing the PATROL Event Cache . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 246Setting the Cache Size . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 247

Extracting Event Data from the PEM Log . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 247Before You Begin . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 249Running dump_events . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 249Syntax . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 250Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 250Examples. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 251Troubleshooting. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 252

PATROL Event Archive . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 252Text Filtering Events . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 253

Sub-string Matching . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 253Regular Expression Matching . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 253

Setting Event Rules . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 254Suppress an Event . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 255Replace an Event . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 256Substitute Event Text . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 257

Defining Event Descriptions. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 257Using Agent Macros . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 258List of Macros. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 258

Standard Events Published by the PATROL Agent . . . . . . . . . . . . . . . . . . . . . . . . . . . 260Application State Event . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 261Computer State Event . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 262Instance State Event . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 263Parameter Alert Event . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 264Parameter State Event . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 265Recovery Action Event . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 266Contents 11

12Chapter 15 PATROL Agent and SNMP Concepts 267

PATROL SNMP Design. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 267Support . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 268Architecture . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 268Dependencies . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 270Configuration Requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 271Localized Languages . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 272Startup Process . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 272

SNMP Roles Available to the PATROL Agent. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 273PATROL Agent as SNMP Manager . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 273Variables for Configuring the PATROL Agent . . . . . . . . . . . . . . . . . . . . . . . . . . . . 273PSL Functions for Configuring the PATROL Agent. . . . . . . . . . . . . . . . . . . . . . . . 274

Two Methods of Sending SNMP Traps. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 275Comparison of Methods . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 276Diagnostic Information for the PATROL SMUX based SNMP sub-agent. . . . . . 276Creating Custom Read and Write Community Strings . . . . . . . . . . . . . . . . . . . . . 277Modifying the snmpagt.cfg file . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 279Basic Agent Configuration File . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 280

Chapter 16 SNMP Configuration and Implementation Using PEM 287

Before You Begin Configuring PATROL with SNMP. . . . . . . . . . . . . . . . . . . . . . . . . . 288Process for Configuring the PATROL Agent with SNMP . . . . . . . . . . . . . . . . . . . 288When Configuration Changes Take Effect . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 289

Configuring the PATROL SNMP Master Agent . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 289Starting The PATROL SNMP Master Agent . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 289Specify the Working Directory. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 291Starting the PATROL SNMP Master Agent . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 292

Configuring the SNMP Subagent and the PATROL Agent . . . . . . . . . . . . . . . . . . . . . 292Start the PATROL SNMP Subagent Automatically . . . . . . . . . . . . . . . . . . . . . . . . 292Prevent PATROL SNMP Master Agent on UNIX from Starting Automatically 293Specify the Read Community Name. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 294Specify the Write Community Name . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 294Specify the Port Number for Sending and Receiving Traps . . . . . . . . . . . . . . . . . 294Specify the MIB-II Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 295Send Traps through PATROL SNMP Master Agent . . . . . . . . . . . . . . . . . . . . . . . 295Send Traps Directly to SNMP Managers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 295Ignoring Return IPAddresses. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 296

Configuring the PATROL Event Manager to Send SNMP Traps . . . . . . . . . . . . . . . . 296List of Standard Event Classes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 297

Sending SNMP Traps Based on PATROL Events . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 300Destination of SNMP PEM-based Traps. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 300SNMP Support Based on PATROL Event Manager . . . . . . . . . . . . . . . . . . . . . . . . 301Filter Traps Based on PATROL Event Severity Level . . . . . . . . . . . . . . . . . . . . . . 301Specify Application That Issued the Trap . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 302Specify the Node Name Where the Trap Originated . . . . . . . . . . . . . . . . . . . . . . . 303Filter Traps Based on PATROL Event ID . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 303Filter Traps Based on PATROL Event Class . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 304Filter Events Based on PATROL Event Description . . . . . . . . . . . . . . . . . . . . . . . . 304PATROL Agent Reference Manual

Specify a Time Period to Send Traps Based onPATROL Events . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 304

Filter Traps Based on PATROL Event Type . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 306Filter Traps Based on PATROL Event Status . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 306Set SNMP Trap Format. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 307

Disabling SNMP Trap Support for PATROL Events . . . . . . . . . . . . . . . . . . . . . . . . . . 309

Chapter 17 SNMP Configuration and Implementation Using PSL 311

Configuring the PATROL Agent as an SNMP Manager . . . . . . . . . . . . . . . . . . . . . . . 311Listening for SNMP Traps . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 312Getting and Setting MIB Variables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 312

Sending SNMP Traps Based on PSL Functions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 313Overview of PSL Functions for SNMP. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 314Set Default Community Name for PSL SNMP Functions . . . . . . . . . . . . . . . . . . . 314Managing PSL SNMP Built-In Functions Execution . . . . . . . . . . . . . . . . . . . . . . . 315PSL SNMP Built-In Functions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 316Sending SNMP Traps . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 317Debugging PSL Functions for SNMP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 317Interpreting Error Messages from PSL Functions . . . . . . . . . . . . . . . . . . . . . . . . . 318

Distinguishing Instance State Changes from Propagated States . . . . . . . . . . . . . . . . 319Gathering PATROL Data from PATROL MIB Tables . . . . . . . . . . . . . . . . . . . . . . . . . 320

Chapter 18 Managing Parameter Overrides 321

Parameter Properties that Can Be Overriden . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 322Methods of Overriding Parameters. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 322

External File Overrides . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 322Operator Overrides . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 322PSL Overrides . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 323Developer Overrides . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 323

Controlling Which Override Methods Are Used . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 323If External File Overrides Are Disabled . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 324If Operator Overrides Are Disabled . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 324If PSL Overrides Are Disabled . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 324

Combining Multiple Methods of Overriding Parameters . . . . . . . . . . . . . . . . . . . . . . 325Using Developer Overrides . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 325Using External File Overrides and Operator Overrides . . . . . . . . . . . . . . . . . . . . 325Using External File Overrides and PSL Overrides . . . . . . . . . . . . . . . . . . . . . . . . . 325Using Operator Overrides and PSL Overrides . . . . . . . . . . . . . . . . . . . . . . . . . . . . 326Using External File Overrides, Operator Overrides, and PSL Overrides . . . . . . 326

Using External Override Files to Manage Parameter Overrides . . . . . . . . . . . . . . . . 326Storing Overrides in a Single File . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 327Storing Overrides in Multiple Files. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 328External Override File Location and Privileges . . . . . . . . . . . . . . . . . . . . . . . . . . . 329External Override File Names . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 329Defining Which Override Files to Use . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 330Using Macro Variables in Override Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 330External Override File Poll Cycle . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 331External Override File Format . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 331Contents 13

14Deleting the External Override File. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 334Additional Functions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 334

Appendix A List of PATROL Agent Variables 337

Configuration Variables. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 337Agent Setup. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 337Agent Tuning . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 344COS. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 345SNMP. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 348XPC. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 351

Environment Variables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 351Components and Platforms . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 351List of Variables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 352

Appendix B Changing Variables in a File Manually 357

Overview of Changing Variables in a File Manually . . . . . . . . . . . . . . . . . . . . . . . . . . 357File Names to Use for Change Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 358Parts of a Change File. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 358

Editing the Change File Using a Text Editor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 358

Appendix C PATROL SNMP MIB 361

MIB Scalar Variables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 361objectsCwd . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 361agentExecuteCommand . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 362

Traps . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 362patrol.mib Definitions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 364

objectsTable . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 365Columns . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 365Objects . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 365

variablesTable . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 366Columns . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 367Objects . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 367

applicationsTable . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 369Columns . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 369Objects . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 369

applInstTable. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 371Columns . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 371Objects . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 372

parametersTable . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 374Columns . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 374Objects . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 375

piV1mTable . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 379Columns . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 379Objects . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 379

Appendix D Configuring a DCOM Interface to the PATROL Agent 381

Tasks to Configure a DCOM Interface to the PATROL Agent . . . . . . . . . . . . . . . . . . 382PATROL Agent Reference Manual

Setting PATROL Agent Configuration Variables . . . . . . . . . . . . . . . . . . . . . . . . . . 382Configuring DCOM on PATROL Agents . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 383Configuring Your Computer for DCOM Communication with the PATROL

Agent . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 385

Appendix E Power Management Support 387

OnNow/ACPI Support. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 387ACPI Definition and Functions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 387OnNow Definition and Functions. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 388Sleep State . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 388OnNow/ACPI Operation. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 388PATROL Agent Support for OnNow/ACPI . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 389

Appendix F Support for Regular Expressions 391

Regular Expressions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 391Components that Support Regular Expressions. . . . . . . . . . . . . . . . . . . . . . . . . . . 391Benefits . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 393Filename Metacharacters and Wildcards. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 393Using Character Classes [ ]. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 394Using Quantifiers (*, ?, +) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 395Using Anchors ($, ^, \) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 395

Appendix G Managing UNIX Environment Variables 397

Storing Environment Variables in a Script File . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 397Purpose . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 397Operation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 398Filename and Format . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 398Example. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 400Set Environment Before Running PATROL Utilities . . . . . . . . . . . . . . . . . . . . . . . 400Exception . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 400

Appendix H Managing Performance 403

PATROL Agent Mode of Operation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 404Main Run Queue . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 404PSL Run Queue . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 405Recurring or Periodic Jobs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 405Scheduling Interval . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 405

Setting PSL Instruction Limits . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 405PSL Instruction Limits Operation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 406Exceeding the Limit. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 406Internal Delay. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 406Increasing the Limit. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 406Maximum Number of Instructions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 407Time Period for Instruction Execution . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 407

Setting Refresh Rate and Discovery Cycle . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 408Relationship Between Cache and Discovery . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 408Process Cache Refresh Rate . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 408Contents 15

16Application Discovery Rate . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 409Setting Operating System Scheduling Priority. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 409

Priority Range. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 409For PATROL Agent . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 411For Processes Created by PATROL Agent . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 412For Cache Refresh Process . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 412For Internal Cache Refresh Process . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 412

Load Balancing the PATROL Agent . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 413PATROL Agent's Scheduling Policy . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 413Interval Between Internal Processes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 414Increment Checking of Internal Process Interval . . . . . . . . . . . . . . . . . . . . . . . . . . 415Maximum Delay of an Internal Process . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 415

Controlling the Number of Processes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 415Limit the Number of Files Opened Simultaneously . . . . . . . . . . . . . . . . . . . . . . . . 416Limit the Number of Processes Run Simultaneously . . . . . . . . . . . . . . . . . . . . . . . 416Limiting the Number of patrolperf Instances . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 416

Selecting PSL Debugging Level . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 417Set PSL Runtime Error Level . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 417

Managing Performance Retrieval Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 417Establishing a Timeout Period . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 418Determining Maximum Number of Data Points Collected Before Restarting . . 418Specifying the Debug File . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 419

Overriding Settings During a Session . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 419Resetting Values . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 419Managing the PATROL Agent from the PATROL Console . . . . . . . . . . . . . . . . . 419

Appendix I Installed Files, Directories, and System Changes 421

Main File Types. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 421Directories and Files. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 423Processes and Services . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 430Microsoft Windows Registry Modifications. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 431

Glossary 433

Index 457PATROL Agent Reference Manual

FiguresThe PATROL Agent in a 3.x PATROL System . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23The PATROL Agent in a 7.x PATROL System . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24PATROL_HOME Directories and Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 30The PEM Engine with Other PATROL Components . . . . . . . . . . . . . . . . . . . . . . . . . . . 34The PATROL Agent Configuration Dialog Box . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 49Configuring Agent Variables with the Default and Change File . . . . . . . . . . . . . . . . . 58Getting Configuration Information from a PATROL Agent . . . . . . . . . . . . . . . . . . . . 58Getting Configuration Information from Another Change File . . . . . . . . . . . . . . . . . . 59Purging the PATROL Agent Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 59Applying a Change File to an Agent . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 59Reloading an Agents Default Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 60Process Flow for Configuring the PATROL Agent . . . . . . . . . . . . . . . . . . . . . . . . . . . . 65Request, Start Up, and Run a Cluster Application . . . . . . . . . . . . . . . . . . . . . . . . . . . . 103Service Interruption and Shutdown of a Cluster Application . . . . . . . . . . . . . . . . . . 104Failover and Resumption of a Cluster Application . . . . . . . . . . . . . . . . . . . . . . . . . . . 105xpconfig Primary Window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 155The Restart Agent Dialog Box . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 160The Reload Configuration Dialog Box . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 161The Kill Agent Dialog Box . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 162The Configuration File Dialog Box . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 164The Purge Configuration Dialog Box . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 169The File Selection Dialog Box . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 171The Add Hosts Dialog Box . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 173The Add Variable Dialog Box . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 174The Edit Variable Dialog Box . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 178wpconfig Window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 189wpconfig Toolbar . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 189Toolbar in the Modify Variable Dialog Box . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 194The Change Entry Dialog Box . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 194The Modify Variable Dialog Box . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 195The Set Default Account Dialog Box . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 196The View Changes Dialog Box . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 198The Apply Configuration Dialog Box . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 199Adding /AgentSetup/auditLog in wpconfig\xpconfig . . . . . . . . . . . . . . . . . . . . . . . 207PATROL SNMP Master Agent Interacts with Other Agents . . . . . . . . . . . . . . . . . . . 269 Figures 17

Configuring the PATROL Agent with SNMP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 288PATROL Agent Configuration Change File Format . . . . . . . . . . . . . . . . . . . . . . . . . . 358PATROL Client Configuration Dialog Box - ESI Library Tab . . . . . . . . . . . . . . . . . . 385PATROL Client Configuration Dialog Box - Type Library Tab . . . . . . . . . . . . . . . . . 386

18 PATROL Agent Reference Manual

TablesPatrol Components . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25PATROL Agent File Usage . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31Methods to Request Event Management Services . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 35Command Line Arguments for Starting PATROL Agent . . . . . . . . . . . . . . . . . . . . . . . 39Variables That Cannot Be Changed . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 61Methods for Specifying Files to Use for Changing Variables . . . . . . . . . . . . . . . . . . . . 66Options for Changing the Values of Agent Variables . . . . . . . . . . . . . . . . . . . . . . . . . . 66Access Control List Connection Modes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 86Connection Modes and Accounts Used by the Agents Clients . . . . . . . . . . . . . . . . . . 90PATROL Agent Behavior in a Cluster Environment . . . . . . . . . . . . . . . . . . . . . . . . . . 102Cluster Administration Properties . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 111PATROL Cluster-Specific Environment Variables . . . . . . . . . . . . . . . . . . . . . . . . . . . . 117Operation of Configuration and History Environment Variables . . . . . . . . . . . . . . . 118PATROL Knowledge Module Version Arbitration . . . . . . . . . . . . . . . . . . . . . . . . . . . 123Knowledge Module Statuses in the PATROL Agent . . . . . . . . . . . . . . . . . . . . . . . . . . 124pconfig Command Strings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 144pconfig Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 147Menus and Menu Commands for the xpconfig Utility . . . . . . . . . . . . . . . . . . . . . . . . 153Options for Starting the xpconfig from the Command Line . . . . . . . . . . . . . . . . . . . 156Tasks to Handle Variables from the Primary Window . . . . . . . . . . . . . . . . . . . . . . . . 172Handling Variables from the Edit Variable Dialog Box . . . . . . . . . . . . . . . . . . . . . . . 177Menus and Menu Commands for the wpconfig Utility . . . . . . . . . . . . . . . . . . . . . . . 187Information Stored in PATROL Error Log . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 202Location of PATROL Agent Error Log File . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 202Type of Information Recorded in the Audit Log . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 206AgentSetup/auditLog Keys and Values . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 208Audit Log File Format . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 210Information Stored in History Database . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 216Location of History Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 217dump_hist Directories . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 221Files Read by dump_hist . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 222PATROL_HOME Environment Variable . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 223dump_hist Utility Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 225Options for -format of dump_hist . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 226Directories for fix_hist . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 231 Tables 19

Files Read by fix_hist . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 232Options Recognized by the fix_hist Utility . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 235Methods for Maintaining Security for the PATROL Agent . . . . . . . . . . . . . . . . . . . . 238Directories for Ownership and Permissions of Agent Log . . . . . . . . . . . . . . . . . . . . . 240Default Owner and Permissions of Log and Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . 241

20Information Stored in Event Log . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 245Location of Event Log Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 245dump_events Utility Directory Structure . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 249PATROL_HOME Environment Variable . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 249Options for the dump_events Command Line Utility . . . . . . . . . . . . . . . . . . . . . . . . . 250List of Agent Macros . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 258Macros that Cannot be Expanded by the Agent . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 259Standard Events that Reveal a State Change . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 260PATROL SNMP Component Definitions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 270Configuration for PATROL Support of SNMP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 271Configuring the PATROL Agent to Run with SNMP . . . . . . . . . . . . . . . . . . . . . . . . . 274Functions for Sending Traps . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 275Functions for Starting and Stopping the SNMP Agent . . . . . . . . . . . . . . . . . . . . . . . . 275Functions for Changing the Registered SNMP Manager List . . . . . . . . . . . . . . . . . . . 275Comparing Methods for Sending Traps . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 276Standard Event Classes for Sending SNMP Traps . . . . . . . . . . . . . . . . . . . . . . . . . . . . 297Functions for SNMP Manager/Trap Handler . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 312Functions for Getting and Setting MIB Variables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 312PSL Functions for SNMP Support . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 316Functions for Sending Traps . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 317Functions for Debugging PSL Functions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 318Global Error Messages for SNMP PSL Functions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 318status and ruleState Variables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 319Attribute and Value Pairs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 332/AgentSetup/ Variables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 338/AgentSetup/AgentTuning Variables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 344/AgentSetup/cos Variables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 346/SNMP Variables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 348/AgentSetup/XPC Variables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 351Environment Variables Used by PATROL Console and PATROL Agent . . . . . . . . 352PATROL Agent COM Variables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 383Wildcards Supported by PATROL Regular Expressions . . . . . . . . . . . . . . . . . . . . . . 393File Types By File Extension . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 421Secure Plug-In Directories and Files on the PATROL Agent Computer . . . . . . . . . . 423Secure Plug-In Processes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 430Windows Registry Modifications . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 431PATROL Agent Reference Manual

1 SC h a p t e r 1tructure of PATROL

This chapter lists the components of PATROL and provides an overview of the PATROL architecture. It also gives background information about the PATROL Event Manager Engine (the component of the PATROL Agent that manages events), lists the services available from the PATROL Agent, and tells you how to request services from the PATROL Agent. This chapter contains the following sections:

Role of the PATROL Agent. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22Purpose of PATROL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22Overview of the PATROL 3.x Architecture . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23

Components of PATROL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25PATROL Components . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25Non-PATROL Components . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29

PATROL Agent Directory and File Structure . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29PATROL_HOME Directory Structure . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 30Files Used by the PATROL Agent. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 30Profile Directory . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 32

Event Management with the PATROL Agent . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 32Services Provided by the PATROL Agent . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 33Overview of the PEM Engine . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 34Management Services from the PEM Engine . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 35Chapter 1 Structure of PATROL 21

Role of the PATROL Agent

22

R

Pole of the PATROL AgentThis section describes how the PATROL Agent works with a number of different PATROL and non-PATROL system components.

urpose of PATROL

PATROL is a systems, applications, and event management tool. It provides an environment where you can monitor the status of every vital resource in the distributed environment you are managing.PATROL Agent Reference Manual


O

Figverview of the PATROL 3.x Architecture

Figure 1 shows the relationship between the PATROL Agent and other PATROL and non-PATROL components in a PATROL 3.x environment. The agents interactions with these components is described in the following sections.

ure 1 The PATROL Agent in a 3.x PATROL System

Application

OperatingSystem

Remote System with PATROL monitoring the operating system and an application. The PATROL Agent communicates with the PATROL Console on the local system.

Local system with a PATROL Agent and PATROL Knowledge Modules monitoring its operating system and applications and connecting to the PATROL Console and, optionally, to an SNMP Console.The PATROL Agent and PATROL Knowledge Modules on the remote system are monitoring the operating system and an application and are connected to the PATROL Console on the local system.

Application

OperatingSystem

PATROL

PATROL

Local Computer

User Interface

User Interface

Remote Computer

Operating System

Knowledge Module

Operating System

Knowledge Module

Application Knowledge

Module

Application Knowledge

Module

SNMPManager

Perform Agent Executable

PATROL Agent Executable

PATROLConsole

PATROL SNMP Master Agent

PATROLAgent

Perform Agent Executable

PATROL Agent Executable

PATROLAgentChapter 1 Structure of PATROL 23


24

O

Fig

Co

Co

Mverview of the PATROL 7.x Architecture

Figure 2 shows the relationship between the PATROL Agent and other PATROL PATROL components in a PATROL 7.x environment. The difference is that the agent talks to 7.x consoles through the PATROL Console Server and an RTserver or RTserver cloud.

ure 2 The PATROL Agent in a 7.x PATROL System

RTserver Cloud

mmon Services

PATROL Agent (version 3.5)Install PATROL solutions (KMs) for resources on each system.

Web browser

PATROL Central Microsoft Windows Edition PATROL Central

Operator Microsoft Windows Edition

Other console modules

PATROL Console for UNIX or PATROL Console for Microsoft Windows

Install classic console versions of PATROL Solutions (KMs) for systems being managed.

PATROL Central Web Edition PATROL Central

Operator Web Edition Other console modules

nsole Systems

anaged Systems

PATROL Console Server

PATROL products and solutions may require additional files installed throughout the infrastructure.PATROL Agent Reference Manual

Components of PATROL

C

PA

Ta

C

POMW

POE

PSeomponents of PATROLThis section lists and describes the components provided as part of PATROL and provides an overview of the products from other vendors that you can integrate with PATROL.

TROL Components

ble 1 Patrol Components (Part 1 of 5)

omponent Purpose Dependencies

ATROL Central perator - icrosoft indows Edition

Like other PATROL Consoles, PATROL Central Operator - Microsoft Windows Edition provides a window into your PATROL environment. PATROL Central Operator - Microsoft Windows Edition works with only the PATROL 7.x architecture; it does not work with the PATROL 3 architecture.


PATROL Agent

ATROL Central perator - Web dition

PATROL Central Operator - Web Edition is a web-based application that provides a window into your PATROL environment. PATROL Central Operator - Web Edition works with only the PATROL 7.x architecture; it does not work with the PATROL 3 architecture.


PATROL Agent

ATROL Console rver

The PATROL Console Server is used by PATROL 7.x consoles to communicate with PATROL Agents on managed systems. A primary feature of PATROL monitoring is that you can create views and organize objects according to a specific business need. The PATROL Console Server provides persistency support for those views. In addition, persistent views are maintained in a common format so you can use the same view with multiple 7.x consoles.

PATROL Agent

PATROL Knowledge ModulesChapter 1 Structure of PATROL 25


26

PO

PDC

Ta

CATROL perator Console

The graphical work space from which you issue commands and manage the distributed environment monitored by PATROL. The PATROL Console displays all of the monitored computers and applications.

With the PATROL Operator Console, you can perform the following tasks:

define which applications you want PATROL to monitor

monitor and manage computers and applications through the PATROL Agent and PATROL Knowledge Modules

monitor the PATROL Agents use of resources

run predefined or user-defined commands and tasks against monitored machines

run state change action commands on the PATROL Console machine when a state change occurs on a monitored computer

log on to any managed computer (only for UNIX and OpenVMS)

start and stop PATROL Agents remotely

view parameter data

retrieve historical data stored by the PATROL Agent

PATROL Agent

PATROL Knowledge Module

ATROL eveloper onsole

With the PATROL Developer Console, you can do everything you can do with the PATROL Operator Console, plus the following:

build new KMs and customize existing KMs customize menu commands and application parameters modify agent knowledge in memory transfer knowledge to an agent edit or replace KM files send an additional KM file to an agent machine start the PATROL Agent configuration utility commit changes to agents

PATROL Agent



omponent Purpose DependenciesPATROL Agent Reference Manual


PMC

PInP

P

Ta

CATROL Event anager (PEM onsole)

With the PEM Console, you can do the following: view events manage events/use events to control your environment trigger events generate event statistics acknowledge events delete events close events

PATROL Agent


ATROL tegration

roducts

Provides an interface between PATROL Agent and third party enterprise management systems such as HP OpenView Network Node Manager.

PATROL Agent


ATROL Agent The core piece of the PATROL architecture that monitors and manages host computers. The PATROL Agent consists of Perform Agent executables (BDS_SDService.exe, which is registered as a service on Windows platforms, and bgscollect.exe) and the PATROL Agent executable (patrolagent.exe), which is registered as a service. On the OpenVMS platform, the Agent does not use the Perform Agent executables.

The PATROL Agent performs the following tasks:

runs commands to collect system or application information; the information is collected according to applications and parameters defined in Knowledge Modules

stores information locally for retrieval by the PATROL Console

loads specified Knowledge Modules (KMs) at start-up, runs menu commands, and updates InfoBoxes on the PATROL Console

acts as a service provider for event management



omponent Purpose DependenciesChapter 1 Structure of PATROL 27


28

PKM

A

PL

P

Ta

CATROL nowledge odule

A set of files from which a PATROL Agent receives information about all of the resources, such as databases and file systems, running on a monitored computer.

PATROL KMs provide information to the PATROL Agent about:

identity of objects parameters actions to take when an object changes a state how to monitor the application

PATROL Agent

gent Query You can view information about monitored objects through Agent Query. Using this function, you can work with objects outside the PATROL Console window. Instead of viewing objects as icons, you view their names in a tabular format. Results of queries are displayed in the Query Results window. You can save queries, then load and reissue them when needed.

PATROL Agent


PATROL Console

ATROL Script anguage (PSL)

Included as part of the PATROL Developer Console is the PATROL Script Language (PSL) that you can use to write parameters, commands, tasks, recovery actions, and discovery procedures for the PATROL Agents. PSL is a fourth-generation language that is both compiled and interpreted, which is similar to programming languages such as C++, C, and Perl. PSL is the native language of PATROL KMs.

PATROL Agent

SL Compiler You can use the PSL Compiler to check the syntax of PSL and to build a PSL library.

PATROL Agent

PATROL Developer Console


omponent Purpose DependenciesPATROL Agent Reference Manual

PATROL Agent Directory and File Structure

N

P

P

PCIn

Ta

Con-PATROL Components

The PATROL Agent can run with console products (managers) and agents from other vendors. These managers and agents can communicate with the PATROL Agent through SNMP or through the PATROL API. For more information, see Chapter 15, PATROL Agent and SNMP Concepts, and Event Management with the PATROL Agent.

ATROL Agent Directory and File StructureThe PATROL Agent creates several important directories and files on the PATROL hosts disk drive. These files are automatically generated at run time and range from temporary files used for error logging to permanent files that store historical information.

SL Debugger You can use the PSL Debugger to debug PSL scripts. PATROL Agent

PATROL Developer Console

ATROL ommand Line terface

The PATROL Command Line Interface (CLI) is a program for retrieving object and event information from a PATROL Agent. CLI is designed to connect to a PATROL Agent in instances when a GUI interface is unavailable or when the user is logged onto a host using a terminal emulator (without a TCP/IP stack).

CLI has both interactive and non-interactive modes. You can start CLI from a command line and manually submit commands to the CLI. You can also call the CLI within a script and have it execute commands that you provide on the command line or in additional CLI script files.

PATROL Agent


PATROL Console

NOTE The PATROL Agent uses minimal space in the registry.


omponent Purpose DependenciesChapter 1 Structure of PATROL 29

PATROL Agent Directory and File Structure

30

PA

FiTROL_HOME Directory Structure

The PATROL_HOME directory is the directory in which the PATROL installation process installs PATROL and in which the PATROL executables and utilities run, write, and read information. The directory contains binaries, knowledge, sounds, images, application defaults, help files, and utilities. The directory is represented as $PATROL_HOME in UNIX and %PATROL_HOME% in Windows. Figure

Patrol Agent 3.6

Documents

Transcript of Patrol Agent 3.6