Contents

Title and Copyright Information

Preface

• Audience
• Documentation Accessibility
• Related Documents
• Conventions

1 Introduction to Connector

• 1.1 Event Templates
• 1.2 Retry
• 1.3 Versions Supported

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.4 Installing the IBM TEC Web Service
  • 2.4.1 Installing and Running the IBM TEC Web Service on Unix
    • 2.4.1.1 Prerequisites
    • 2.4.1.2 Installing the Web Service on Unix
    • 2.4.1.3 Running the Web Service on Unix
    • 2.4.1.4 Testing the Web Service on Unix
    • 2.4.1.5 Uninstalling the Web Service on Unix
  • 2.4.2 Installing and Running the IBM TEC Web Service on Windows
    • 2.4.2.1 Prerequisites
    • 2.4.2.2 Installing the Web Service on Windows
    • 2.4.2.3 Running the Web Service as a Windows Service (Optional)
    • 2.4.2.4 Running the Web Service on Windows
    • 2.4.2.5 Testing the Web Service on Windows
    • 2.4.2.6 Uninstalling the Web Service on Windows
  • 2.4.3 Exporting the Web Service Installation File
    • 2.4.3.1 Setting Up EM CLI On Your System
• 2.5 Installing and Running the IBM TEC Agent
  • 2.5.1 Installing the Agent
  • 2.5.2 Running and Stopping the Agent
  • 2.5.3 Exporting the Agent Installation File
  • 2.5.4 Uninstalling the TEC Agent
• 2.6 Updates to TEC Rules
  • 2.6.1 Handling Data Flowing from Enterprise Manager to TEC
  • 2.6.2 Removing TEC Rules/BAROC Files
• 2.7 Uninstalling the Connector

3 Configuring the Connector

• 3.1 Creating a Connector Instance
• 3.2 Configuring the Connector
• 3.3 Enabling/Disabling the Connector
• 3.4 Providing General Settings
  • 3.4.1 Connection Settings
  • 3.4.2 Retry
• 3.5 Deleting the Connector
• 3.6 Testing the IBM TEC Connector

4 Forwarding Events to IBM TEC

• 4.1 Setting Event Rules
• 4.2 Viewing Events in the IBM TEC Console

5 Working With Event Templates

• 5.1 Familiarization with Event Templates
  • 5.1.1 Default Templates
    • 5.1.1.1 Create Event Template
    • 5.1.1.2 Update Event Template
    • 5.1.1.3 Formatted Enterprise Manager Event Contents
  • 5.1.2 Severity Mapping
  • 5.1.3 Class Name Mapping
• 5.2 Customizing Event Templates
  • 5.2.1 XML Format of Oracle Enterprise Manager Events
  • 5.2.2 Managing Templates in Oracle Enterprise Manager 12c
    • 5.2.2.1 Edit a Template with Enterprise Manager
    • 5.2.2.2 View Template Code in Enterprise Manager
    • 5.2.2.3 Delete a Template with Enterprise Manager
    • 5.2.2.4 Restore a Deleted Template with Enterprise Manager
  • 5.2.3 Changing a Mapping
    • 5.2.3.1 Exporting the Template Files
    • 5.2.3.2 Modifying Templates
    • 5.2.3.3 Registering Templates
    • 5.2.3.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 TEC Web Service Operations
• 7.5 Troubleshooting Web Service Operations Errors
• 7.6 Troubleshooting Errors from Oracle Enterprise Manager

A Customizing IBM TEC

• A.1 XML Format of IBM TEC Events
  • A.1.1 Mappings Between XML Format and Event Field Names
  • A.1.2 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)

B Enterprise Manager Event Samples

• B.1 Create Sample
• B.2 Update Sample
• B.3 Clear Sample

C Enterprise Manager Event Format

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

D TEC Web Service WSDL Format

• D.1 EventService WSDL

Index