Contents

Title and Copyright Information

Preface

• Audience
• Documentation Accessibility
• Related Documentation
• Conventions

1 Building a Ticketing Connector

• 1.1 Introduction to Ticketing Connectors
• 1.2 How a Ticketing Connector Functions
  • 1.2.1 Configuring the Connector
  • 1.2.2 Creating a Ticket
  • 1.2.3 Updating a Ticket
  • 1.2.4 Clearing a Ticket
  • 1.2.5 Synchronizing Ticket Status (Optional)
• 1.3 Prerequisites
• 1.4 Extracting Schema Files
• 1.5 Building a Ticketing Connector
  • 1.5.1 Determining Connector Functionality
  • 1.5.2 Developing Required Template Files
    • 1.5.2.1 getTicket Request Template
    • 1.5.2.2 getTicket Response Template
    • 1.5.2.3 Default Template(s)
    • 1.5.2.4 createTicket Response Template
    • 1.5.2.5 publishTicket Request Template
  • 1.5.3 Defining the Connector Descriptor File
    • 1.5.3.1 Connector Deploy Field Information
    • 1.5.3.2 Connector Information Section
    • 1.5.3.3 Sample Connector Information Section
    • 1.5.3.4 Authentication Section
    • 1.5.3.5 Sample Authentication Section
    • 1.5.3.6 Connectivity Test Variable Section
    • 1.5.3.7 Sample Connectivity Test Variable Section
    • 1.5.3.8 External URL Section
    • 1.5.3.9 Sample External URL Section
    • 1.5.3.10 Service Section
    • 1.5.3.11 Sample Service Section
    • 1.5.3.12 Template Registration Section
    • 1.5.3.13 Sample Template Registration Section
    • 1.5.3.14 Complete Connector Deployment File
• 1.6 Packaging and Deploying the Ticketing Connector

2 Building an Event Connector

• 2.1 Introduction to the Event Connector
• 2.2 How an Event Connector Functions
• 2.3 Prerequisites
• 2.4 Extracting Schema Files
• 2.5 Building an Event Connector
  • 2.5.1 Determining Connector Functionality
  • 2.5.2 Developing Required Template Files
    • 2.5.2.1 setup/initialize/uninitialize/cleanup Request Template
    • 2.5.2.2 setup/initialize/uninitialize Response Template
    • 2.5.2.3 createEvent/updateEvent Request Template
    • 2.5.2.4 createEvent/updateEvent Response Template
  • 2.5.3 Defining the Connector Descriptor File
    • 2.5.3.1 Connector Deploy Field Information
    • 2.5.3.2 Connector Information Section
    • 2.5.3.3 Sample Connector Information Section
    • 2.5.3.4 Authentication Section
    • 2.5.3.5 Sample Authentication Section
    • 2.5.3.6 Service Section
    • 2.5.3.7 Sample Service Section
    • 2.5.3.8 Template Registration Section
    • 2.5.3.9 Sample Template Registration Section
    • 2.5.3.10 Complete Connector Deployment File
• 2.6 Packaging and Deploying the Event Connector

3 Building a Data Exchange Connector

• 3.1 Introduction to the Data Exchange Connector
  • 3.1.1 Enterprise Manager and External Management System
  • 3.1.2 Data Forwarding Frequency Options and Modes
• 3.2 Data Exchange Concepts
  • 3.2.1 Data Exchange Hub
  • 3.2.2 Inbound Data Exchange Session
  • 3.2.3 Outbound Data Exchange Session
    • 3.2.3.1 Normalized Message Format
    • 3.2.3.2 Denormalized Message Format
  • 3.2.4 Message Schemas
  • 3.2.5 Data Source
  • 3.2.6 Average Data
• 3.3 Setting up a Data Exchange Connector
  • 3.3.1 Creating a Data Exchange Hub
  • 3.3.2 Using a Third-Party JMS Server as a Data Exchange Hub
  • 3.3.3 Creating an Outbound Data Exchange Session
  • 3.3.4 Outbound JMS Destinations
  • 3.3.5 Outbound Message Schema
    • 3.3.5.1 Normalized Message Format
    • 3.3.5.2 Denormalized Message Format
  • 3.3.6 Tuning Outbound Session Message Parameters
  • 3.3.7 Creating an Inbound Data Exchange Session
  • 3.3.8 Inbound JMS Destinations
  • 3.3.9 Inbound Message Schemas
    • 3.3.9.1 Inbound Indicators Schema
    • 3.3.9.2 Message Semantics
    • 3.3.9.3 Inbound Alert Schema
• 3.4 Integrating Enterprise Manager with Oracle BAM
  • 3.4.1 Supported Versions
  • 3.4.2 Setting up the Data Flow from Enterprise Manager to Oracle BAM
    • 3.4.2.1 Importing Oracle BAM Artifacts for an Outbound Session
    • 3.4.2.2 Updating JNDI (for Oracle BAM 10g and 11g only)
    • 3.4.2.3 Updating the EMS Definitions in Oracle BAM 12c
  • 3.4.3 Setting up the Data Flow from Oracle BAM to Enterprise Manager
  • 3.4.4 End-to-End Flow
• 3.5 Using an OC4J as a Data Exchange Hub
• 3.6 Tips and Troubleshooting Information
  • 3.6.1 Data Exchange Hub Connection Errors
  • 3.6.2 Notification Methods and Rules
    • 3.6.2.1 Notification Method
    • 3.6.2.2 Notification Rules
  • 3.6.3 Data Flow Tips
  • 3.6.4 Log Files
  • 3.6.5 End-to-End Flow Sample Demonstrations
• 3.7 Suggested Reading

4 Reference Tables

• 4.1 Request Attributes
• 4.2 Response File Properties for the Windows Platform
  • 4.2.1 sl_OHPartitionsAndSpace_valueFromDlg Property
  • 4.2.2 ret_PrivIntrList Property
• 4.3 Queryable Properties
• 4.4 Complex Response Properties
• 4.5 Status Codes

A Ticketing Connector Samples

B Error Messages and Debugging

• B.1 Error Messages
• B.2 Debugging
  • B.2.1 Specifying the Debug Option
  • B.2.2 Viewing Debug Messages

C Event Connector Samples

D Default Template Example

• D.1 Create Mappings
• D.2 Update Mappings
• D.3 Completed Templates
  • D.3.1 Completed First Template Example
  • D.3.2 Completed Second Template Example

E Create Event Template Example

• E.1 Study Data in External Application
• E.2 Study Data in Enterprise Manager
• E.3 Determine the Mapping for the Template
• E.4 Create the Template
• E.5 Create Mappings
  • E.5.1 Mapping the Summary Field
  • E.5.2 Mapping the Description Field
  • E.5.3 Mapping the Severity Field
  • E.5.4 Mapping the Priority Field
• E.6 Completed Template Examples

F Sample Incident Data

• F.1 Sample Create Transaction
• F.2 Sample Update Transaction
• F.3 Sample Close Transaction

G Sample Event Data

• G.1 Sample Create Transaction
• G.2 Sample Update Transaction
• G.3 Sample Close Transaction

Glossary

Index