User ManualTable of ContentsHP OpenView VantagePoint Operations for UNIX Developer’s Toolkit1Legal Notices2Printing History13Conventions15VPO Documentation Map17About VPO Online Help231 An Introduction to Integrating Partner Applications with VPO27Why Integrate with VPO?28HP OpenView Partnerships31A Word about Licenses31Integrating Partner Solutions with VPO32VPO Conceptual Overview34The HP OpenView Product Family and VPO34VPO Concept and Key Features34VPO Implementation36Problem Management with VPO37Collecting Management Information38Logfiles and SNMP Traps38Agent Message API38Threshold Monitors39Legacy Link Interface API39Processing and Consolidating Information40Presenting the Information to the User41IP Map Window42Managed Nodes Window43Message Groups Window44Application Desktop Window45Message Browser46Acting on the Information Provided47Customizing VPO48The VPO Java-based Operator User Interface49Integration Benefits to Partners50VPO as an INSM Framework50Specific Benefits for Integrators in the NIM, NSM, and INSM Markets51NIM Market Segment51NSM Market Segment52INSM Market Segment52Service Management Market Segment53Integration Facilities Provided by VPO54Integrating Events Using Messages54Threshold Monitoring55Working with Message Templates57Adding Instructions, Annotations, and Actions to a Message Template59Integrating Events using Trouble Ticket and Notification Services61Integrating Applications into the Application Bank62Integrating via APIs63NNM Integration Through the VPO GUI65Integrating via NNM Functionality662 Integrating Solutions with VPO67Deciding Which Integration Capabilities to Use68Defining an Integration Strategy71Adapting an Existing VPO Integration for VPO A.07.0072Leveraging From an Integration into NNM73SNMP Event Configuration74Powerful GUI Application Integration75Monitoring Facilities76Alternative Message Sources77User Role Concept77Advantages of an INSM Solution77Starting from Scratch78Obtaining Coexistence of NNM and VPO Integrations79Strategy 1: Use Transformed NNM Integration in VPO81Strategy 2: Develop a Separate VPO Integration81Summary of the Integration Process82The Role of Configuration Data in an Integration843 Using the Integration Capabilities of the VPO Motif-based GUI87In This Chapter88Event Integration Through Messages89Configuring Messages in the Message Source Templates Window89Defining Templates for Logfile Encapsulation92Using the Logfile Monitoring Options94Defining Templates for SNMP Trap Interception96Defining Templates for MPE/iX Console Message Interception97Defining Templates for Messages Sent to the VPO Message Interface opcmsg(1|3)98Defining Templates for Threshold Monitors100Overview of VPO Monitoring Capabilities100Monitoring MIB Variables101Using Threshold Monitoring to Generate Messages103Message Generation Policies and Message Filtering105Types of VPO Monitor Available108Integrating Monitors into VPO111Sending Values Over the VPO Monitoring API or Command113MIB Data Collection115Setting Advanced Options for a Message Source Template116Output to Agent and Server Message Stream Interface (MSI)117Setting Message Correlation Options for a Message Source Template118Suppression of Duplicate Messages120Setting Options for a Message Source Template122Adding Instructions to a Message Source Template123Setting Message and Suppress Conditions124Setting Conditions for Incoming Messages124Setting Custom Message Attributes for a Message Condition127Setting Conditions for Incoming SNMP Traps129Using SNMP Trap Templates Converted from NNM SNMP Trap Configuration Files130Converting NNM SNMP Trap Configuration Files to VPO Trap Templates131Hints and Tips for Event Integration from Message Sources133Adding Instructions, Annotations, Automatic- and Operator-initiated Actions136Adding Instructions for Solving Known Problems136Adding Actions and Annotations to a Message139External Notification and Trouble-ticket Service140Defining Notification Services140Defining Trouble Ticket Services143Manually Forwarding to Trouble Ticket or Notification Services143Integrating External Applications into the VPO GUI144GUI Integration Points and Methods144Advantages Gained by Integrating VPO Applications149Integrating VPO Applications150Integrating HP OpenView Windows Applications153HP OpenView Applications154HP OpenView Services154Integrating Applications into the Application Desktop155Adding VPO Applications156Adding OpenView Applications157Adding an OpenView Service158Using NNM-integrated Applications With VPO159NNM Applications in VPO159Structure of NNM Applications in VPO161Integrating Additional NNM Applications into VPO1614 Using the VPO Application Programming Interfaces163In This Chapter164Overview of the VPO APIs165The VPO Interfaces171Overview of the Server Message-Stream Interface173Access to the Server Message-stream Interface174VPO’s Serial MSI Configuration File175Modifying Message IDs176Serial MSI Configuration: Example Scenario177Overview of the Agent Message Stream Interface178Overview of the Legacy Link Interface178Structure of the Legacy Link Process180Overview of the Message Event Interface182Access to Message Events183Overview of the Application Response Interface184Access to Action Responses184Read and Write Access to the VPO Message Stream185The VPO Operator APIs188The VPO Interfaces and the VPO Operator API — A Comparison189The VPO Configuration APIs190Summary of VPO API Functions192Functions of the VPO Data API192Functions to Manipulate VPO Data Structures192Functions of the VPO Iterator194The VPO Data Structures195Functions of the VPO Service APIs197Functions to Access the VPO Interface197Functions to Access the Registration Conditions197Functions of the Server Message API198Functions to Manipulate Messages198Functions of the Agent Message API199Functions to Send/Acknowledge Messages199Functions of the Agent Monitor API200Functions to Send Monitor Values200Functions of the Connection API201Functions to Connect to the Management Server201Functions of the Application Configuration API202Functions to Configure VPO Applications202Functions of the Application Group Configuration API203Functions to Configure VPO Application Groups203Functions of the Message Group Configuration API204Functions to Configure VPO Message Groups204Functions of the Message Regroup Condition Configuration API205Function to Configure VPO Message Regroup Conditions205Functions of the Node Configuration API206Function to Configure VPO Managed Nodes206Function to Configure VPO Node Groups207Functions of the Node Hierarchy Configuration API208Functions to Configure VPO Node Hierarchies208Functions of the Template Configuration API210Function to Configure VPO Templates210Functions to Configure VPO Template Groups211Functions of the User Profile Configuration API212Functions to Configure VPO User Profiles212Functions of the User Configuration API213Functions to Configure VPO Users213Functions of the Distribution API214Functions to Distribute Configuration to Managed Nodes214Functions of the Server Synchronization API215Functions to Modify and Update Configuration Data2155 Integrating with VantagePoint Navigator217In This Chapter218The VantagePoint Navigator Architecture220The XML Data Interface222The C++ APIs224The Query Interface for Service Status and Attributes224The Registration Interface for Service Status Changes225The Registration Conditions2256 Integration Facilities of the HP OpenView NNM Core Platform227In This Chapter228Overview229The OpenView Windows API230Maps, Submaps, and Symbols232ClusterView: An Example of an Integrated Map Application234HP OpenView Data: Objects and Fields236The OpenView SNMP API240SNMP Communications API and Related Commands241Available C-API Functions241Related Commands245SNMP Configuration API246Topology Data2517 Creating and Distributing an Integration Package253In This Chapter254Structure of VPO Configuration Files256Downloading Configuration Information258Preparing to Download: Adding Executables262Warnings264Uploading Configuration Information265Example 1: Uploading in Add Mode (Default)266Example 2: Uploading in Replace Mode267Example 3: Uploading and Replacing Information at a Subentity Level267A Syntax Used in VPO Configuration Files271In This Chapter272Notation Used273General VPO Syntax Rules274Configuration Files for Templates275Template Examples282Example of a VPO Logfile Template282Example of a VPO Message Source Specification283Example of an SNMP Trap Template File284Configuration Files for Monitors286Example of a VPO Monitor Template289Syntax for Message Pattern Matching290Pattern Matching296Separator Characters297Case Insensitive Mode297Pattern Matching Examples298Configuration Files for Applications299Example of a VPO Application Configuration File301Syntax and Length of VPO Object Names302B Notification Services and Trouble Ticket Systems303In This Chapter304Parameters for Notification and Trouble Ticket Services305Example of a Trouble Ticket Parameter List307C Symbols for Application Integration309Available Symbols for Application Integration310D About VPO Man Pages311In this Appendix312Accessing and Printing Man Pages313To Access a VPO Man Page from the Command Line313To Print a Man Page from the Command Line313To Access the Man Pages in HTML Format313Man Pages in VPO314Man Pages for VPO APIs317Man Pages for HP OpenView VantagePoint Navigator318Man Pages for the VPO Developer’s Kit APIs319Size: 2.74 MBPages: 326Language: EnglishOpen manual
