Contents

Title and Copyright Information

Preface

• Audience
• Documentation Accessibility
• Related Documents
• Conventions

1 Introduction to the Connector

• 1.1 Versions Supported
• 1.2 Retry

2 Installing the 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.3.2 Exporting the Installation Files
• 2.4 Installing the Web Service for Netcool/OMNIbus Front-End
• 2.5 Web Service for Netcool/OMNIbus on Unix
  • 2.5.1 Prerequisites
  • 2.5.2 Installing the Web Service on Unix
  • 2.5.3 Running the Web Service on Unix
  • 2.5.4 Testing the Web Service on Unix
  • 2.5.5 Copying the Required .jar Files
  • 2.5.6 Uninstalling the Web Service on Unix
• 2.6 Web Service for Netcool/OMNIbus on Windows
  • 2.6.1 Prerequisites
  • 2.6.2 Installing the Web Service on Windows
    • 2.6.2.1 Running the Web Service as a Windows Service (Optional)
  • 2.6.3 Running the Web Service on Windows
  • 2.6.4 Testing the Web Service on Windows
  • 2.6.5 Copying the Required .jar Files
  • 2.6.6 Uninstalling the Web Service on Windows
• 2.7 Installing the Oracle Agent for Netcool/OMNIbus
  • 2.7.1 Uninstalling the Oracle Agent for Netcool/OMNIbus
• 2.8 Modifying Netcool/OMNIbus
  • 2.8.1 Configuring the Object Server Database
  • 2.8.2 Configuring the TEC EIF Probe
  • 2.8.3 Change Deduplication Trigger Priority
  • 2.8.4 Uninstalling Modifications to Netcool/OMNIbus
• 2.9 Uninstalling the Connector

3 Configuring the IBM Tivoli Netcool/OMNIbus 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 IBM Tivoli Netcool/OMNIbus Connector

4 Forwarding Events to IBM Netcool/OMNIbus

• 4.1 Setting Event Rules
• 4.2 Viewing Events in the IBM Netcool/OMNIbus Console

5 Working with Event Templates

• 5.1 Default Templates
  • 5.1.1 Create Event Template
  • 5.1.2 Update Event Template
  • 5.1.3 Details Mapping - Create
  • 5.1.4 Details Mapping - Update
  • 5.1.5 Journal Mapping
• 5.2 Severity Mappings
• 5.3 Customizing Event Mappings
  • 5.3.1 XML Format of Oracle Enterprise Manager Events
  • 5.3.2 Managing Templates in Oracle Enterprise Manager 12c
    • 5.3.2.1 Edit a Template with Enterprise Manager
    • 5.3.2.2 View Template Code in Enterprise Manager
    • 5.3.2.3 Delete a Template with Enterprise Manager
    • 5.3.2.4 Restore a Deleted Template with Enterprise Manager
  • 5.3.3 Manually Changing a Mapping
    • 5.3.3.1 Exporting the Template Files
    • 5.3.3.2 Modifying Templates
    • 5.3.3.3 Registering Templates
    • 5.3.3.4 Template Customization Example

6 Enabling SSL for HTTPS

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

7 Troubleshooting

• 7.1 Diagnosing the Problem
• 7.2 Troubleshooting Web Service Startup Errors
• 7.3 JVM Errors
• 7.4 Using the Correct URL for Web Service Operations
• 7.5 Determining the URL Used by the Web Service
• 7.6 Troubleshooting Web Service Operations Errors
• 7.7 Resolving Errors from Oracle Enterprise Manager
  • 7.7.1 Invalid Web Service Credentials
  • 7.7.2 SSL Not Configured in Enterprise Manager
  • 7.7.3 Web Service is Down
  • 7.7.4 Invalid IP Address
  • 7.7.5 Invalid URL Path
  • 7.7.6 Firewall Blocking Access
  • 7.7.7 Invalid Port Number
  • 7.7.8 Unknown Host
  • 7.7.9 Invalid XML Format
  • 7.7.10 Missing Log Jar
  • 7.7.11 Timeout
  • 7.7.12 Cannot Connect to the Probe

A Web Service for Netcool/OMNIbus Details

• A.1 XML Format of Netcool/OMNIbus Alerts
  • A.1.1 Mappings Between XML Format and Message Field Names
  • A.1.2 Log Entries
  • A.1.3 Extended Fields
• A.2 Changing Default Port Numbers
  • A.2.1 Changing the Web Service Port (8080)
  • A.2.2 Changing the Web Service Port (8443)
• A.3 Changing Web Service Credentials

B Enterprise Manager Event Format

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

C Web Service for Netcool/OMNIbus EventService WSDL Format

D Enterprise Manager Event Examples

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