B Integrating OMU with Enterprise Manager

This appendix provides detailed steps for setting up OMU for use with the Oracle Enterprise Manager OMU Connector. The steps required depend on the version of OMU involved in the integration.

Perform the following steps to set up OMU version 9 for integration with Oracle Enterprise Manager. You need to perform these steps from the administrative console and the account must have administrative permissions.

1. Create a Message Group to be used exclusively by Oracle Enterprise Manager:

   1. Click the OMU icon at the top of the screen to configure OMU.

   2. Click the All Message Groups link under the All Objects section.

   3. At the bottom of the screen, select Add Message Group… from the list and click the >> button.

   4. Enter OracleEnterpriseManager in the Name and Label fields, as well as an optional description.

   5. Click Save.

2. Create a node to be used exclusively by Oracle Enterprise Manager:

   1. Click the OMU icon at the top of the screen to configure OMU.

   2. Click the All Nodes link under the All Objects section.

   3. At the bottom of the screen, select Add Node… from the list and click the >> button.

   4. Set the Node Type field to non IP->other ->other.

   5. Click the Properties tab.

   6. Set the Host Name and Label fields to OracleEnterpriseManager.

   7. Set the Parent Group field to NodeBank.

   8. Click the Management tab.

   9. Make sure the Management type field is set to Message allowed.

   10. Click Save.

3. Add the new node to the server node group:

   1. Click the OMU icon at the top of the screen to configure OMU.

   2. Click the All Node Groups link under the All Objects section.

   3. Click on the Name of the server system.

   4. At the bottom of the screen, select Assign Nodes to this Node Group… from the list, then click the >> button.

      A Selector window appears.

   5. Enter filter information to find the new node, then click Filter.

   6. Select the new node from the list, then click OK.

4. Create a new user or select an existing user that the OMU Agent will use to connect to OMU. To use an existing user account skip to step 4-e.

   1. Click the OMU icon at the top of the screen to configure OMU.

   2. Click All Users under the All Objects section.

   3. Select the Choose an action drop down, select Add User… and click on the > button.

   4. Fill in the User Name, Password, and any optional fields. Click Save to add the new user.

   5. Click the OMU icon at the top of the screen to configure OMU.

   6. Click All Users under the All Objects section.

   7. Select Actions List next to the user to be used for the OMU Agent, and select the Edit… option.

   8. Select the Operator tab in the Edit User screen. Select all of the available Capabilities for the user. These should include Perform/Stop Actions, Modify Message Attributes, Own, and (Un-)acknowledge Messages.

   9. Click Save to save the changes to the User.

5. Give the user access to the Message Group from step 1:

   1. Click the OMU icon at the top of the screen to configure OMU.

   2. Click the All Users link under the All Objects section.

   3. Click on the Name of the user name you created/selected in step 4.

   4. Select Edit Responsibilities… from the Actions list next to the User name at the top of the window.

   5. Click Edit View at the bottom of the screen.

   6. In the Available Message Groups section, click on the message group that you added in step 1, then click the > button.

   7. In the Available Node Groups section, click the name of the server system that was selected in step 3, then click the > button.

   8. Click OK to add the new message group to the user.

      The new message group should be listed with an empty checkbox for each associated node group.

   9. Click on the new message group name to select all of the empty checkboxes.

   10. Click Save to save all of your changes.

6. Create a Policy Group to be used exclusively by Oracle Enterprise Manager:

   1. Click the OMU icon at the top of the screen to configure OMU.

   2. Click the All Policy Groups link under the All Objects section.

   3. At the bottom of the screen, select Add policy group from the list, and click the >> button.

   4. Enter OracleEnterpriseManager in the Name field, as well as an optional description.

   5. Click Save.

   All policy groups should be listed and the new one should be included in the list.

7. Add a policy to create a message for Enterprise Manager to the new policy group:

   1. Click the OMU icon at the top of the screen to configure OMU.

   2. Click the All Policy Groups link under the All Objects section.

   3. Click on the Name of the new policy group created in step 6.

      Information for the new policy group should be listed.

   4. At the bottom of the screen, select Add Policy… from the list and click the >> button.

      A window should appear where you enter the policy type.

   5. Select Open_Message_Interface from the list, then click OK.

   6. On the Properties tab, enter a Name of "Generate EM Message" and a Description of "Policy to generate a message for Oracle Enterprise Manager."

   7. Click the Message Defaults tab, and enter OracleEnterpriseManager in the Message Group field.

   8. Click the Conditions tab and select Add Condition at the bottom of the screen.

   9. Click the Condition tab and make sure the Type field is set to Message On Matched Condition.

   10. Enter "Condition to filter message from the OracleEnterpriseManager message group" in the Description field.

   11. Select all values in the Severity field.

   12. Enter OracleEnterpriseManager in the Message Group field.

   13. Click the Actions tab and click in the Automatic check box. Additional fields should be displayed under the Automatic section.

   14. Enter "/opt/oem/scripts/dummy <$MSG_ID>" in the Command field, and "<$OPC_MGMTSV>" in the Node field.

   15. Click Save to save the policy.