1 Introduction to the Connector

The IBM Tivoli Enterprise Console (TEC) Connector (version 1.0.4.1.0) integrates Oracle Enterprise Manager with IBM TEC through web services, enabling you to exchange event information between the two systems.

Connector Features

The Oracle Management Connector for IBM TEC monitors all of the events forwarded from TEC and automatically updates alert information in the Oracle Enterprise Manager console whenever changes occur in TEC. A similar synchronization of alerts sent from Oracle Enterprise Manager occurs in TEC. This ensures that the two systems are always synchronized, providing administrators with current information about their entire data center.

The connector supports the following features:

  • Synchronization of the alert life cycle on both ends

  • Customization of alert mappings during the alert information exchange

  • Bi-directional flow of alert information

    The state change of the event/alert in the originating system is reflected in the other system but not vice versa. For example, if an alert is forwarded from Oracle Enterprise Manager to TEC, all the state changes in Enterprise Manager are reflected in TEC. However, if you change the state of the alert in TEC, the change is not reflected in Enterprise Manager because the alert originated in Enterprise Manager. This is also the case for the other direction.

The following sections explain how the connector handles TEC events and polls the TEC web service.

Oracle Enterprise Manager Alerts Transmitted to TEC Events

Conceptually, alerts in Oracle Enterprise Manager are equivalent to events in TEC. Whenever an alert is triggered in Oracle Enterprise Manager, the TEC Connector can automatically create or update an event in TEC. You can use Notification Rules to specify the set of alerts for which events must be created, and the alert severity for which this should happen.

After the connector creates an event in TEC, any subsequent change of the alert severity is propagated to IBM TEC. When the severity of the alert changes to Clear in Oracle Enterprise Manager, the corresponding event is closed in TEC.

Figure 1–1 shows an example of an Oracle Enterprise Manager alert event.

Figure 1-1 Oracle Enterprise Manager Alert Event

Shows metric alert page example

Figure 1–2 shows an example of an IBM TEC event.

Figure 1-2 IBM TEC Event

Shows sample data in General tab of TEC event page

Versions Supported

This connector supports the following versions of Oracle Enterprise Manager and IBM TEC:

  • Oracle Enterprise Manager Grid Control 10g Release 4 with one-off patch 6884527 or later

  • IBM Tivoli Enterprise Console versions 3.8 and 3.9

You can install the TEC Agent on the following platforms:

  • Microsoft Windows (2000, 2003, XP)

  • Sun Solaris (SPARC OS version 5-10)

  • IBM AIX (RS/6000 OS version 5.2+)

The base Enterprise Manager version number for the HP Tivoli Enterprise Console Connector Release 1.0.4.1.0 is Enterprise Manager 10g Release 4.

Prerequisites

Before using the IBM TEC connector, ensure that you meet the following prerequisites:

  • Oracle Patches are installed. To install patches, do the following:

    1. Download patch # 6884527 from:

      http://metalink.oracle.com/

    2. Follow the instructions included with the download in the README.txt file.

  • A utility for unzipping .zip files is available on the system hosting IBM TEC.

  • Java JRE 6.0 or higher is installed on the system where the TEC Web Service will be installed.

If you want Oracle Enterprise Manager to forward alerts to IBM TEC, you need to create an event class named OracleEnterpriseManager at the IBM TEC server. Sample BAROC and rules files are provided with the installation that you can install manually or with the installation script.