Oracle® Enterprise Manager

Documentation Description and Access

You can access the documentation for the Connector Framework from the Oracle Technology Network (OTN). You can find data sheets, the certification matrix, and other documentation in the OTN under Enterprise Manager and in Metalink.

Key Features

The Connector Framework provides clients with the following capabilities:

• Query Enterprise Manager data through a unified web services interface.

• Request Enterprise Manager to create a Real Application Clusters (RAC) database through a web services interface.

• Request Enterprise Manager to add nodes to existing RAC databases through a web services interface.

• Request Enterprise Manager to delete nodes from existing RAC databases through a web services interface.

Prerequisites

The Connector Framework has the following system requirements:

• Oracle Enterprise Manager Management Server version 10.2.0.2

• Oracle Enterprise Manager Management Agent version 10.2.0.2

• Oracle Database version 10.2.0.2

For the Connector Framework to function properly, you need to set up emcli. For a procedure on how to do this, see the Oracle Enterprise Manager Connector Framework Integration Guide (B31191-01).

For security purposes, the OMS should be set up using HTTPS.

Installing the Connector Framework

The Connector Framework is installed to the OMS home. The $ORACLE_HOME in the procedure below refers to the OMS home. To download and install the Connector Framework, do the following:

1. Download the Connector Framework installable files from OTN by clicking Downloads, then Enterprise Manager.

2. Stop OMS by running:

   $ORACLE_HOME/opmn/bin/opmnctl stopall

3. Start the Oracle Universal Installer (OUI) by running the following command:

   For Linux or Unix:

   $ORACLE_HOME/oui/bin/runInstaller

   For Windows:

   $ORACLE_HOME\oui\bin\setup

4. When prompted by OUI, locate products.xml in the installation source directory:

   connectors/framework/10.2.0.2/1.0/source/Disk1/stage

5. Follow the instructions in the OUI screens.

6. Access the Enterprise Manager web console from one of the following URLs:

   http://server:port/em/connector/ManagementService

   https://server:port/em/connector/ManagementService

Uninstalling the Connector Framework

The Connector Framework is installed to the OMS home. The $ORACLE_HOME in the procedure below refers to the OMS home. To uninstall the Connector Framework, do the following:

1. Stop OMS by running:

   $ORACLE_HOME/opmn/bin/opmnctl stopall

2. Start the Oracle Universal Installer (OUI) by running the following command:

   For Linux or Unix:

   $ORACLE_HOME/oui/bin/runInstaller

   For Windows:

   $ORACLE_HOME\oui\bin\setup

3. Click Deinstall Products..., open the list under OMS home, then open the list under the connector to be uninstalled.

4. Select the connector to be uninstalled and Connector Framework 1.0.0.0.0 under it, then click the Remove… button.

5. Click Yes for confirmation, then exit OUI.

6. Manually delete the following section from $ORACLE_HOME/j2ee/OC4J_EM/applications/em/em/WEB-INF/web.xml:

   Example 1 Code for Management Service Interface for Connector Framework

   <description>Management Service Interface for Connector Framework</description>
             <servlet>
               <servlet-name>ManagementService</servlet-name>
               <servlet-class>oracle.j2ee.ws.StatelessJavaRpcWebService</servlet-class>
               <init-param>
                 <param-name>class-name</param-name>
                 <param-value>oracle.sysman.connector.base.mgmtsvc. 
          ManagementServiceImpl</param-value>
               </init-param>
               <init-param>
                 <param-name>interface-name</param-name>
                 <param-value>oracle.sysman.connector.base.mgmtsvc.
          IManagementService</param-value>
               </init-param>
             </servlet>
             <servlet-mapping>
               <servlet-name>ManagementService</servlet-name>
               <url-pattern>/connector/ManagementService</url-pattern>
             </servlet-mapping>
             <session-config>
               <session-timeout>35</session-timeout>
             </session-config>
             <mime-mapping>
               <extension>html</extension>
               <mime-type>text/html</mime-type>
             </mime-mapping>
             <mime-mapping>
               <extension>txt</extension>
               <mime-type>text/plain</mime-type>
             </mime-mapping>
   

7. Start OMS by running:

   $ORACLE_HOME/opmn/bin/opmnctl startall

Configuring and Using the Connector Framework

To understand how to configure and use Connector Framework release 10.2.0.2, refer to the Oracle Enterprise Manager Connector Framework Integration Guide (B31191-01). The Enterprise Manager documentation library for this release is located at the following URL:

http://download-west.oracle.com/docs/cd/B16240_01/doc/nav/portal_booklist.htm

Known Issues

The following universal limitations and known issues apply to this release of the Connector Framework.

<AggregateTarget>
  <Name>RAC1</Name>
  <Type>rac_database</Type>
  <Target>
    <Name>RAC1_RAC11</Name>
    <Type>oracle_database</Type>
     …
  </Target>
  <Property>
    <Name>gdbName</Name>
    <Value>RAC1</Value>
  </Property>
  <Property>
    <Name>sid</Name>
    <Value>RAC1</Value>
  </Property>
   …
</AggregateTarget>

<AggregateTarget>
   <Name>RAC1</Name>
   <Type>rac_database</Type>
   <Target>
       …
    </Target>
    <Property>
      <Name>oms_delete_all_targets</Name>
         <Value>true</Value>
    </Property>
</AggregateTarget>

AggregateTarget>
  <Name>RAC1</Name>
  <Type>rac_database</Type>
  <Target>
    …
  </Target>
  <Property>
    <Name>oms_delete_all_targets</Name>
      <Value>true</Value>
  </Property>
</AggregateTarget>

<AggregateTarget>
  <Name>RAC1</Name>
  <Type>rac_database</Type>
  <Target>
    <Name>RAC1_RAC11</Name>
    <Type>oracle_database</Type>
     …
  </Target>
  <Property>
    <Name>gdbName</Name>
    <Value>RAC1</Value>
  </Property>
  <Property>
    <Name>sid</Name>
    <Value>RAC1</Value>
  </Property>
   …
</AggregateTarget>

Documentation Accessibility

Our goal is to make Oracle products, services, and supporting documentation accessible, with good usability, to the disabled community. To that end, our documentation includes features that make information available to users of assistive technology. This documentation is available in HTML format, and contains markup to facilitate access by the disabled community. Accessibility standards will continue to evolve over time, and Oracle is actively engaged with other market-leading technology vendors to address technical obstacles so that our documentation can be accessible to all of our customers. For more information, visit the Oracle Accessibility Program Web site at: http://www.oracle.com/accessibility/

Accessibility of Code Examples in Documentation

Screen readers may not always correctly read the code examples in this document. The conventions for writing code require that closing braces should appear on an otherwise empty line; however, some screen readers may not always read a line of text that consists solely of a bracket or brace.

Accessibility of Links to External Web Sites in Documentation

This documentation may contain links to Web sites of other companies or organizations that Oracle does not own or control. Oracle neither evaluates nor makes any representations regarding the accessibility of these Web sites.

TTY Access to Oracle Support Services

Oracle provides dedicated Text Telephone (TTY) access to Oracle Support Services within the United States of America 24 hours a day, seven days a week. For TTY support, call 800.446.2398.