Contents

List of Examples

List of Figures

List of Tables

Title and Copyright Information

Preface

• Audience
• Documentation Accessibility
• Related Documents
• Conventions

1 Introduction to Connector

• Event Templates
• Retry
• Versions Supported

2 Installing the Connector

• Installation Platforms
• Prerequisites
• Installing the Connector in Enterprise Manager
• Installing the IBM TEC Web Service
  • Installing and Running the IBM TEC Web Service on Unix
    • Prerequisites
    • Installing the Web Service on Unix
    • Running the Web Service on Unix
    • Testing the Web Service on Unix
  • Installing and Running the IBM TEC Web Service on Windows
    • Prerequisites
    • Installing the Web Service on Windows
    • Running the Web Service on Windows
    • Testing the Web Service on Windows
  • Exporting the Web Service Installation File
    • Setting Up EM CLI On Your System
• Installing and Running the IBM TEC Agent
  • Installing the Agent
  • Running and Stopping the Agent
  • Exporting the Agent Installation File
• Updates to TEC Rules
  • Handling Data Flowing from Enterprise Manager to TEC

3 Configuring the Connector

• Creating a Connector Instance
• Configuring the Connector
• Enabling/Disabling the Connector
• Providing General Settings
  • Connection Settings
  • Retry
• Deleting the Connector
• Testing the IBM TEC Connector

4 Forwarding Events to IBM TEC

• Setting Event Rules
• Viewing Events Via TEC Console

5 Working With Event Templates

• Familiarization with Event Templates
  • Default Templates
    • Create Event Template
    • Update Event Template
    • Formatted Enterprise Manager Event Contents
  • Severity Mapping
  • Class Name Mapping
• Customizing Event Templates
  • XML Format of Oracle Enterprise Manager Events
  • Managing Templates in Oracle Enterprise Manager 12c
    • Edit a Template with Enterprise Manager
    • View Template Code in Enterprise Manager
    • Delete a Template with Enterprise Manager
    • Restore a Deleted Template with Enterprise Manager
  • Changing a Mapping
    • Exporting the Template Files
    • Modifying Templates
    • Registering Templates
    • Template Customization Example

6 Enabling SSL for HTTPS

• Configuring Enterprise Manager to use SSL
• Installing a Self-Signed Certificate
• Installing a Certificate from a Certificate Authority
• Importing the Web Service Certificate into Enterprise Manager

7 Troubleshooting the Connector

• Diagnosing the Problem
• Troubleshooting Web Service Startup Errors
• JVM Errors
• Using the Correct URL for TEC Web Service Operations
• Troubleshooting Web Service Operations Errors
• Troubleshooting Errors from Oracle Enterprise Manager

A Customizing IBM TEC

• XML Format of IBM TEC Events
  • Mappings Between XML Format and Event Field Names
  • Extended Fields
• Changing Default Port Numbers
  • Changing the Web Service Port (8080)
  • Changing the Web Service Port (8443)

B Enterprise Manager Event Samples

• Create Sample
• Update Sample
• Clear Sample

C Enterprise Manager Event Format

• EMEvent.xsd
• connectorCommon.xsd
• externalEvent.xsd

D TEC Web Service WSDL Format

• EventService WSDL

Index