3 Configuring the HP OMU Connector

This chapter provides procedures to configure the two sub-pages of the main Configure Management Connector page, then explains how to perform other tasks to complete the configuration process.

This chapter discusses the following topics:

• Creating a Connector Instance

• Configuring the Connector

• Enabling and Disabling the Connector

• Providing General Settings

• Testing the HP OMU Connector

3.1 Creating a Connector Instance

After the OMU Connector is installed in Enterprise Manager, you need to create one or more instances of this connector type. A connector instance refers to the configured instance of the connector with specific details, such as connector name, web-service end-points, username/password, and so forth of the OMU system. Multiple connector instances for the same connector type are supported, which provides the flexibility to configure multiple OMU systems with Enterprise Manager.

For example, you could have a production database and test database that Enterprise Manager monitors, and you could create two different connector instances that point to two different OMU systems, and then associate each instance with separate event rules. Using this setup, you can forward Enterprise Manager events generated from these two databases to two different OMU systems.

To create a connector instance:

1. From the Setup menu of the Enterprise Manager console, select Extensibility, then Management Connectors.

2. Select a connector type of OMU from the Create Connector drop-down list, then click Go.

3. Enter the connector name and description on the next page and click OK.

   The connector instance appears as unconfigured in the Connector Setup page. Figure 3-1 shows an unconfigured OMU connector instance.

   Figure 3-1 Unconfigured HP OMU Connector

   
   

3.2 Configuring the Connector

To configure the connector:

1. From the Setup menu of the Enterprise Manager console as Super Administrator, select Extensibility, then Management Connectors.

   The Management Connectors page appears, which lists all created connector instances.

   Note:

   The connector is already configured if a green checkmark appears in the Status column.

2. Click on the name of the OMU Connector.

   The General tab of the Configure Management Connector page appears, as shown in Figure 3-2.

3. Provide the required settings. See Section 3.4, "Providing General Settings" for details.

4. Click OK.

   The Management Connectors page reappears. The row for the OMU Connector should have a check mark in the Configured column.

   Note:

   If you chose HTTPS as the protocol to establish a connection between OMU and Enterprise Manager, make sure you have performed the steps specified in Section 6.1, "Configuring Enterprise Manager to Use SSL".

Figure 3-2 Configure Management Connector Page

3.3 Enabling and Disabling the Connector

You can enable or disable a connector instance without needing to reconfigure or remove the connector from the system.

You can enable or disable a connector from the Management Connector page by selecting the connector and clicking either the Enable or Disable button. After a connector is disabled, a red cross icon appears under the Status column. By default, the connector instance is enabled as soon as it is configured.

Note:

Only enabled connectors are available to forward events.

3.4 Providing General Settings

The following sections explain how to provide various configuration details.

3.4.1 Connection Settings

The OMU Connector communicates with Operations Manager through the OMU web service installed in Section 2.5, "Installing the Oracle Web Service for HP Operations Manager". All of the following fields are mandatory.

• Web Service End Points — URL to use when creating and updating events (messages) in OMU. The OMU web service uses the same URL for the createEvent and updateEvent operations. The default format for both operations is as follows:

  http://[Hostname]:8080/services/hpovou/EventService
  

  Modify the URL for both operations based on whether the OMU web service was set up using HTTP or HTTPS.

  For HTTP —

  • Replace [Hostname] in the URL with the host name or IP address of the system where the OMU web service was installed.

  For HTTPS —

  • Change the protocol from http to https.

  • Replace [Hostname] in the URL with the hostname or IP address of the system where the OMU web service was installed.

  • Change the port number from 8080 to 8443.

  Examples:

  If the OMU web service was installed on a system with a host name of omuws, the following URLs would be configured for the different protocols.

  • For HTTP —

    http://omuws:8080/services/hpovou/EventService
    

  • For HTTPS —

    https://omuws:8443/services/hpovou/EventService
    

• OMU Web Service Username - User name that was configured for accessing the OMU web service in step 9 of the appropriate web service installation section (Section 2.5.1.2 for Unix and Section 2.5.2.2 for Windows).

• OMU Web Service Password - Password that was configured for accessing the OMU web service in step 10 of the appropriate web service installation section (Section 2.5.1.2 for Unix and Section 2.5.2.2 for Windows).

3.4.2 Retry

You can enable and disable the Retry option and configure its interval value. By default, the Retry is disabled. This setting applies to all events the OMU Connector processes. See Section 1.2, "Retry Option" for details.

The retry period interval accepts the number of hours as any integer value; for example, 1 or 2.

3.5 Testing the HP OMU Connector

To verify that the connector is configured correctly:

1. Log in to the Oracle Enterprise Manager console with an account that has Super Administrator permissions.

2. From the Setup menu of the Enterprise Manager console, select Extensibility, then Management Connectors.

   The Management Connectors page appears.

3. Click on the name of the OMU Connector.

   The General tab of the Configure Management Connector page appears.

4. Select and copy the URL specified for the createEvent or updateEvent operation.

5. Open an internet browser on the system where the Oracle Enterprise Manager server is installed.

6. In the address window, enter the URL that was copied in step 4 above. Add ?wsdl to the end of the URL. The URL should appear similar to the following example:

   http://[Hostname]:8080/services/hpovou/EventService?wsdl
   

   [Hostname] is the actual host name or IP address where the OMU web service is installed.

   If the WSDL is loaded, this confirms that the connector is configured correctly for sending event information to OMU.