Contents

Title and Copyright Information

Preface

• Audience
• Documentation Accessibility
• Related Documents
• Conventions

1 Introduction to the Connector

• 1.1 OMU Messages and Acknowledgements
• 1.2 Retry Option
• 1.3 Versions Supported

2 Installing the HP OMU Event Connector

• 2.1 Installation Platforms
• 2.2 Prerequisites
• 2.3 Installing the Connector in Enterprise Manager
  • 2.3.1 Installing the Connector if Enterprise Manager is in "Offline" Mode
• 2.4 Installing and Running the Oracle Agent for HP Operations Manager
  • 2.4.1 Installing the Agent
  • 2.4.2 Uninstalling the Agent
  • 2.4.3 Running and Stopping the Agent
  • 2.4.4 Exporting the Agent Installation File
  • 2.4.5 Troubleshooting the Agent
    • 2.4.5.1 Linux
    • 2.4.5.2 HP-UX
    • 2.4.5.3 Solaris
    • 2.4.5.4 Examples for Solaris
• 2.5 Installing the Oracle Web Service for HP Operations Manager
  • 2.5.1 Installing and Running the HP Operations Manager Web Service on Unix
    • 2.5.1.1 Prerequisites
    • 2.5.1.2 Installing the Web Service on Unix
    • 2.5.1.3 Running the Web Service on Unix
    • 2.5.1.4 Testing the Web Service on Unix
    • 2.5.1.5 Uninstalling the Web Service on UNIX
  • 2.5.2 Installing and Running the HP Operations Manager Web Service on Windows
    • 2.5.2.1 Prerequisites
    • 2.5.2.2 Installing the Web Service on Windows
    • 2.5.2.3 Running the Web Service on Windows
    • 2.5.2.4 Testing the Web Service on Windows
    • 2.5.2.5 Uninstalling the Web Service on Windows
  • 2.5.3 Exporting the Web Service Installation File

3 Configuring the HP OMU Connector

• 3.1 Creating a Connector Instance
• 3.2 Configuring the Connector
• 3.3 Enabling and Disabling the Connector
• 3.4 Providing General Settings
  • 3.4.1 Connection Settings
  • 3.4.2 Retry
• 3.5 Testing the HP OMU Connector

4 Forwarding Events to HP OMU

• 4.1 Setting Events Rules
• 4.2 Viewing Events in the HP Operations Console

5 Working With Event Templates

• 5.1 Default Templates
  • 5.1.1 Create Event Template
  • 5.1.2 Update Event Template
• 5.2 Formatted Enterprise Manager Event Contents
• 5.3 Severity Mappings
• 5.4 Customizing Event Mappings
  • 5.4.1 XML Format of Oracle Enterprise Manager Events
  • 5.4.2 Changing a Mapping
    • 5.4.2.1 Exporting the Template Files
    • 5.4.2.2 Modifying Templates
    • 5.4.2.3 Registering Templates
    • 5.4.2.4 Template Customization Example

6 Enabling SSL for HTTPS

• 6.1 Configuring Enterprise Manager to Use SSL
• 6.2 Installing a Self-Signed Certificate
• 6.3 Installing a Certificate from a Certificate Authority
• 6.4 Importing the Web Service Certificate into Enterprise Manager

7 Troubleshooting the Connector

• 7.1 Diagnosing the Problem
• 7.2 Troubleshooting Web Service Startup Errors
• 7.3 JVM Errors
• 7.4 Using the Correct URL for OMU Web Service Operations
• 7.5 Troubleshooting Web Service Operations Errors
• 7.6 Resolving Errors from Oracle Enterprise Manager

A Customizing Microsoft HP Operations Manager

• A.1 XML Format of HP OMU Messages
  • A.1.1 Mappings Between XML Format and Message Field Names
  • A.1.2 Extended Fields
• A.2 Changing Default Port Numbers
  • A.2.1 Changing the Agent Listener Port (9007)
  • A.2.2 Changing the Agent Shutdown Port (9008)
  • A.2.3 Changing the Web Service Port (8080)
  • A.2.4 Changing the Web Service Port (8443)
• A.3 Changing Web Service Credentials

B Integrating OMU with Enterprise Manager

C Enterprise Manager Event Format

• C.1 EMEvent.xsd
• C.2 connectorCommon.xsd
• C.3 externalEvent.xsd

D OMU Web Service WSDL Format

E Enterprise Manager Event Examples

• E.1 Create Example
• E.2 Update Example
• E.3 Clear Example