2 Installing and Configuring the Connector

The Microsoft Operations Manager Connector enables Oracle Enterprise Manager to send alerts to and retrieve alerts from Microsoft Operations Manager (MOM). The retrieved alerts are stored in the Enterprise Manager repository and displayed through the Enterprise Manager console.

This chapter provides the following information for installing and configuring the connector:

• Prerequisites

• Installing and Uninstalling the MOM Connector

• Re-registering Removed Connectors

• Configuring the MOM Connector

Prerequisites

Before using MOM Connector, ensure that the following pre-requisites are met:

• Microsoft Operations Manager 2005 is installed.

• MOM Connector framework Web services are enabled during the installation of MOM 2005.

• Internet Information Services (IIS) 6.0 or higher is deployed on the Windows server that hosts MOM.

• IP-based authentication is enabled on the Windows system that hosts MOM. See "Enabling IP-based Authentication" on page AE1 for the procedure.

  
  

  See Also: MOM 2005 Product Documentation at the following URL: http://www.microsoft.com/mom/techinfo/productdoc/default.mspx

  
  

Installing and Uninstalling the MOM Connector

The MOM Connector is installed as part of the Enterprise Manager base installation. After you install Enterprise Manager, you should see the MOM Connector listed on the Management Connectors page.

See Also: Enterprise Manager Grid Control Installation and Basic Configuration Guide available at: http://www.oracle.com/technology/documentation/oem.html

After you install Enterprise Manager, when you access the Enterprise Manager console as a Super Administrator, you can see the MOM Connector in the Management Connector Setup page as shown in Figure 2–1. See "Configuring the MOM Connector" for instructions.

To uninstall the MOM Connector, select it in the Management Connectors page, then click Delete.

Re-registering Removed Connectors

The MOM Connector is automatically registered when Enterprise Manager is installed. However, you may remove this connector at some point and then want to subsequently re-register it.

To re-register a connector that has been removed:

1. From the Oracle Management Server (OMS) host command window, run the following emctl command from the $ORACLE_HOME/bin directory:

   emctl extract_jar connector <jarfile> <connectorTypeName> <OracleHome>
   

   The command replaces spaces with underscores in <connectorTypeName> and extracts the jar file to:

   $ORACLE_HOME/sysman/connector/<connectorTypeName_without_space/
   

   For example:

   emctl extract_jar connector momconnector.jar "Microsoft Operations Manager Connector" $ORACLE_HOME
   

   This extracts the .jar file to this folder:

   $ORACLE_HOME/sysman/connector/Microsoft_Operations_Manager_Connector/
   

2. Run the following emctl command from the $ORACLE_HOME/bin directory:

   emctl register_connector connector <connectorType.xml> <server> <port> <database sid> <username> <oracleHome>
   

   For example:

   emctl register_connector connector $ORACLE_HOME/sysman/connector/Microsoft_Operations_Manager_Connector/MOMConnector.xml host.us.oracle.com 15041 EMREP SYSMAN $ORACLE_HOME
   

Note: For multiple Oracle Management Servers, you only need to register the connector once from any of the Oracle Management Servers.

Configuring the MOM Connector

1. From the Enterprise Manager console, click Setup.

2. Click the Management Connectors link in the left pane.

   The Management Connectors page appears. For the MOM Connector row, the Configured column should be blank (Figure 2–1).

   
   

   Note: A check mark in the Configured column indicates that the Connector is already configured.

   
   

   Figure 2-1 Management Connectors Page

   
   

3. Click the Configure icon for the MOM Connector.

   The General tab of the Configure Management Connector page appears.

4. Provide the required settings. See "General Settings" for details (Figure 2–2).

5. Click OK.

6. Optional: Go to the Targets tab and specify the details for creating additional target instances. See "Creating Additional Target Instances" for details.

7. Click OK.

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

   If you choose HTTPS as the protocol to establish a connection between MOM and Enterprise Manager, see Chapter 4, "Enabling SSL for HTTPS".

   Figure 2-2 Configure Management Connector Page

   
   

General Settings

This section provides the communication details required for configuring the connector.

• MOM Registered Connector Name — Specify the connector name that you want to register with MOM. This is the name that the MOM administrator identifies for marking alerts to Enterprise Manager. This should be a unique name you set up within Enterprise Manager that identifies this connector.

  MOM Registered Connector Name is the connector name that appears in MOM as the name for the resolution state you specified when configuring the MOM Connector. For example, if you specify Microsoft Operations Manager Connector in this field and 218 as the Resolution State, you can see a resolution state called Microsoft Operations Manager Connector in MOM (when right-clicking on an alert and selecting the Set Resolution State menu). You can see that this resolution state corresponds to 218 in MOM from the administrator's console.

• Resolution State — Specify a value between 1 and 255. Make sure that you do not specify a value already in use, including the standard values such as 85 or 255. The default value for the MOM Connector is 218.

  To verify whether a value is currently being used, go the MOM server's Administrator Console. On the left panel, find Microsoft Operations Manager, then select Administration, Global Settings, and then select Alert Resolution State on the right panel. Right-click this and select Properties. This displays a table with the first two columns named Resolution State, which is a string, and ID, which is a number from 0 to 255.

• Protocol — Select either HTTP or HTTPS based on the protocol the MOM Web services are running on.

• Server — Enter the IP address or the DNS name of the MOM server.

• Port — Enter the port number the MOM Web server uses. The default is 1271.

  For an HTTPS connection, you must change the port to the HTTPS port enabled in MOM.

• Service Name — Enter the MOM Web service name. The default is ConnectorServiceV2.asmx. In most cases, you need not change this.

• Polling Interval — Enter the time interval between event collections. The polling interval should not be shorter than 5 minutes. If you define an interval shorter than 5 minutes, it defaults to 5 minutes.

• Enterprise Manager Username — Enter the user name to be used to insert alerts; for example, SYSMAN. The user must have full privileges on the target of type MOM Managed Host.

  Administrator privileges are recommended; for instance, you should be a super user such as SYSMAN.

• Enterprise Manager Password — Enter a password for the user name you specified.

Creating Additional Target Instances

When you deploy or install a MOM Connector, a default target instance generic_mom_managed_host is created. In addition, you can create specific target instances.

An alert is assigned to the respective targets based on the computer name in MOM. If the name specified under Computer column in the MOM Operator console matches the target name you specify in the Target Name column in the section "Targets Managed by External System (Optional)" below, the alert is assigned to this target. If the target does not exist, the alert is assigned to the default target instance.

In the Configure Management Connector page, click the Targets tab to create specific target instances. Figure 2–3 shows the Configure Management Connector Target page.

Default Connector Target

The default target instance holds external alerts that are not associated with any particular Enterprise Manager target. Oracle recommends that you do not remove this default connector target when you create additional targets.

If the default target is removed accidentally, you can recreate it by clicking the Enable button in the Targets tab of the Configure Management Connector page.

If the default target is removed for alerts that cannot be mapped to any target, error messages are logged in the file emoms.log.

Targets Managed by External System (Optional)

In this section, you can optionally create target instances and associate external alerts with these target instances.

To add a new target:

1. Specify the target name in the Target Name column.

2. In the MOM HOSTNAME column, specify the fully qualified host name (host name along with the domain name; for example, smp-mpi2.us.oracle.com) of the target.

3. Click OK.

Note: If you want to create more target instances, click Add Rows to add additional rows and then specify the target information. To remove a target, check the Select check box corresponding to the target, click Remove, then click OK.

Figure 2-3 Configure Management Connector Target Page

Response Status of Targets

The response status of generic_mom_managed_host asserts whether or not the MOM server is running. Immediately after registration, the status shows Pending.

After you configure the MOM Connector and the first event collection job runs (within a polling interval), the status shows either Up or Down. The response status of individual targets represent whether the host (represented by that target) is up or down.When the target is created, Enterprise Manager pings the host. If the server is reachable, the status is marked Up. Subsequently, if Enterprise Manager receives any alerts (indicating that the host is down), it marks the target as Down.

If the target is down, the alert retrieval is interrupted until the target is up again.

Note: In Enterprise Manager, the response status of targets managed by MOM might not be definitive and can be used only for reference purposes. For accurate information of its managed entities, use MOM.