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:

• Configuring the General Page

• Configuring the Targets Page

• Testing the HP OMU Connector

• Sending Oracle Enterprise Manager Alerts to HP OMU

Configuring the General Page

To configure the General page:

1. From the Management Connectors page, select the HP OMU Connector and click the Configure icon. By default, the General sub-page of the Configure Management Connector page appears, as shown in Figure 3–1.

   Figure 3-1 HP OMU Connector General Settings

   
   

2. Change HTTP to HTTPS at the beginning of the web service URLs if you have configured the HP Operations Manager web services with HTTPS. Otherwise, go to the next step.

3. Change the port to the port on which the web services are running. For example, the default port for HTTP is 8080 and the default port for HTTPS is 8443.

   If you are using HTTPS as the protocol, you must also include the HP Operations Manager web service certificate in the Enterprise Manager as described in Adding Signed Certificates to Enterprise Manager.

   Operation Descriptions

   • getNewAlerts — Creates alerts in Oracle Enterprise Manager based on events (messages) that originate in HP Operations Manager. Oracle Enterprise Manager uses this operation when polling for events in HP Operations Manager.

   • getUpdatedAlerts — Updates alerts in Oracle Enterprise Manager based on events (messages) that originate from HP Operations Manager. Oracle Enterprise Manager uses this operation when polling for events from HP Operations Manager.

   • acknowledgeAlerts — Acknowledges the alerts after Oracle Enterprise Manager has processed them. Oracle Enterprise Manager uses this operation when polling for events in HP Operations Manager.

   • createEvent — Generates events (messages) in HP Operations Manager based on alerts that originate in Oracle Enterprise Manager. Oracle Enterprise Manager invokes this operation when it forwards a new alert to OMU.

   • updateEvent — Updates events (messages) in HP Operations Manager based on alerts that originate in Oracle Enterprise Manager. Oracle Enterprise Manager invokes this operation when it forwards an updated alert to OMU.

   URL Types

   The connector uses two different URLs. One URL is used for operations that poll data out of HP Operations Manager (getNewAlerts, getUpdatedAlerts and acknowledgeAlerts), and defaults to the following value:

   http://[Hostname]:8080/services/AcquisitionService
   

   You need to replace [Hostname] in the URL when configuring it for HTTP.

   The other URL is used for operations that push data into HP Operations Manager (createEvent and updateEvent), and defaults to the following value:

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

   You need to replace [Hostname] in the URL when configuring it for HTTP.

4. Enter the user name and password you specified when you installed the OMU web service, which is discussed in steps 10 and 11 of Section 2.3.1.1, "Installing the Web Service on Unix", and steps 11 and 12 of Section 2.3.2.2, "Installing the Web Service on Windows".

5. Enter the user name and password of the Oracle Enterprise Manager account.

6. Optionally enter a polling interval to specify how often Oracle Enterprise Manager should poll the HP Operations Manager web service for new or updated messages to process. The poll interval defaults to 5 minutes if not specified.

7. Click OK to save your configuration changes.

Configuring the Targets Page

Whenever an HP Operations Manager message is translated into an Oracle Enterprise Manager alert, the HP OMU message node determines the target-type instance associated with the alert in Oracle Enterprise Manager. If a target instance that matches the message node is not found, the default target instance of generic_omu_managed_node is used for the alert.

To add proxy targets in Oracle Enterprise Manager:

1. From the Configure Management Connector page, click the Targets link to display the Targets page, as shown in Figure 3–2.

   Figure 3-2 HP OMU Connector Target Settings

   
   

2. Provide a target name. The Target Name field is set to the node name specified in the OMU message and must match the message node name exactly.

3. Provide the fully qualified OMU node name in the OMU NODE NAME field. This field must be set to the same value as the Target Name field.

4. Repeat this process for as many target instances as desired.

5. Click OK to save your configuration changes.

Testing the HP OMU Connector

Perform the following steps to test the connector:

1. Log in to the Oracle Enterprise Manager console by entering a user name with a 'Super Administrator' role, entering the appropriate password, then clicking Login.

2. Click the Setup link at the top right part of the window. The Overview of Setup page appears.

3. Click the Management Connectors link on the left side of the window. The Management Connectors page appears, which shows the installed connectors.

4. Click on the Configure icon associated with the HP OMU Connector.

5. Click the General link.

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

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

8. In the address window, enter the URL that was copied in step 6 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.

9. At the Oracle Enterprise Manager console, select and copy the URL specified for the getNewAlerts, getUpdatedAlerts, or the acknowledgeAlerts operation. They should all be set to the same URL.

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

11. In the address window, enter the URL that you copied in step 9 above. Add ?wsdl to the end of the URL. The URL should similar to the following example:

    http://[Hostname]:8080/services/AcquisitionService?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 polling event information from OMU.

Sending Oracle Enterprise Manager Alerts to HP OMU

Alerts generated or updated in Oracle Enterprise Manager are not transferred to OMU unless you create notification rules to invoke the HP OMU notification method. A notification rule identifies the conditions that must be met before the notification method is invoked.

The following sections provide procedures that explain how to create and update notification rules.

Creating Notification Rules

The following procedure explains how to create a new notification rule to invoke the OMU notification method.

1. Click the Preferences link in the upper right corner of the Oracle Enterprise Manager console. The General page appears.

2. Click the Notification Rules link on the left side of the window. The Notification Rules page appears and displays a list of all defined notification rules.

3. Click Create to create a new notification rule.

4. From the General sub-page, enter a name for the notification rule and an optional description.

   Select the target type and whether you want it to apply to all targets of that type or a specific instance. If you indicate that you want a specific instance, you need to click Add and select the desired target instance.

5. Click the Availability link, then select the availability states for which you would like to receive notifications. Each state you select invokes the notification method whenever it is reached.

6. Click the Metrics link. If you want to trigger the notification method based on metric violations, click Add and select the metrics and states for which you want to invoke the notification method, then click Continue.

7. Click the Methods link. In the Advanced Notification Methods section, click the check box next to the HP OMU Connector to assign the OMU notification method to the notification rule.

8. Click OK to complete the setup.

Updating Notification Rules

The following procedure explains how to update an existing notification rule to invoke the OMU notification method.

1. Click the Preferences link in the upper right corner of the Oracle Enterprise Manager console. The General page appears.

2. Click the Notification Rules link on the left side of the window. The Notification Rules page appears and displays a list of all defined notification rules.

3. Click on the radio button next to the notification rule you want to update, and click Edit to update the notification rule.

4. Click the Methods link. In the Advanced Notification Methods section, click on the check box next to the HP OMU Connector to assign the OMU notification method to the notification rule.

5. Click OK to complete the update.

Viewing Oracle Enterprise Manager Alerts

Whenever a message is created in HP Operations Manager from an alert that originates in Oracle Enterprise Manager, a link is provided in the message text. To view the Oracle Enterprise Manager alert that triggered the message, click on the link and you will be asked to log into Oracle Enterprise Manager. After logging in, the Oracle Enterprise Manager alert information is displayed.