1 Introduction to Oracle Configuration Manager

Oracle Configuration Manager is used to personalize the support experience by collecting configuration information and uploading it to the Management Repository. The collector of this information can be configured to gather information for all products on the server, or to gather information in separate collection sites.

When customer configuration data is uploaded on a regular basis, customer support representatives can analyze this data and provide better service to the customers. For example, when a customer logs a service request, he can associate the configuration data directly with that service request. The customer support representative can then view the list of systems associated with the customer and solve problems accordingly.

Some of the benefits of using Oracle Configuration Manager are as follows:

  • Reduces time for resolution of support issues

  • Provides pro-active problem avoidance

  • Improves access to best practices and the Oracle knowledge base

  • Improves understanding of customer's business needs and provides consistent responses and services

1.1 What's New in Oracle Configuration Manager

The new features in the release include:

  • Oracle Configuration Manager Supports Oracle Enterprise Manager Cloud Control 12c Release 2 (

    Oracle Configuration Manager now supports Oracle Enterprise Manager Cloud Control 12c release 2 (

  • Support for NTLM

    Oracle Configuration Manager now supports the NTLM (NT LAN Manager) authorization scheme for proxy servers.

  • Data Masking Supported for Oracle Configuration Manager Harvester

    Oracle Configuration Manager now supports data masking for Harvester. [Enhancement Request 14258759]

  • Central Collector That You Can Configure to Collect Your Oracle Homes Not Previously Configured or Left Disconnected

    You can configure a central collector that collects data for Oracle Homes that were not previously configured or left in disconnected mode. The central collector uploads these Oracle Homes under its own My Oracle Support credentials. See About the Central Collector.

1.2 System Architecture

The Oracle Configuration Manager architecture is displayed in Figure 1-1.

Figure 1-1 Oracle Configuration Manager Architecture

Description of Figure 1-1 follows
Description of "Figure 1-1 Oracle Configuration Manager Architecture"

Figure 1-1 displays the following:

  • Oracle Configuration Manager: This is the Oracle Configuration Manager infrastructure.

  • Site 1: Systems that are directly connected to the Internet.

  • Site 2: Systems that are connected to the Internet through a proxy server.

  • Site 3: Systems that do not have direct access to the Internet but do have access to an Intranet proxy server which in turn has Internet connection through the Support Hub.

  • Site 4: Systems that do not have direct access to the Internet but do have access to the Support Hub which in turn is connected to the Internet through a proxy server.

1.3 About the Central Collector

You can configure a central collector to collect all the Oracle Homes that you own on the host that have a disconnected or unconfigured collector, and upload them under its My Oracle Support (MOS) credentials. To reap the benefits of a collector, such as a personalized support experience, quicker resolution of support issues, and proactive problem avoidance, the configuration data for each Oracle installation must be collected and uploaded. This is normally the task of the collector installed in the Oracle home. However, sometimes the collector in Oracle homes might not have been configured or is left disconnected.

Here are the characteristics of a central collector:

  • A central collector collects:

    • Oracle home in which it resides

    • Oracle homes that you own on the host where the collector is not configured or left disconnected. Central collector considers collectors running in unauthenticated mode as not completely configured and will collect these homes as well.

    If a collector in an Oracle home has been configured using a pre-10.3.8 collector and with ORACLE_CONFIG_HOME defined (shared homes), then the central collector will not collect that home.

  • You can designate a collector to be a central collector by providing the -c option to the setupCCR or configCCR commands.

  • If the central collector is running as "root" then it collects all the Oracle homes on the host, unless the home already has a collector or is being collected by a "user" central collector. The Oracle Solaris operating system release 11.1 and any Oracle Solaris 10 release after 8/11 configure a central collector as root by default.

  • The Oracle Universal Installer central inventory is the source from which the central collector obtains the set of candidate Oracle homes to be collected. This central inventory is found in one of two ways:

    • From the oraInst.loc file in the Oracle home in which the collector is being configured,

    • Or, if not found, from the OUI default central inventory location. See the Oracle Universal Installer and OPatch User's Guide for more detail.

    Note that Oracle homes not found in one of the ways above will not be collected by the central collector. For example, if you have installed an Oracle product using your own OUI inventory then that Oracle home will not be found.

  • Only Oracle Fusion Middleware based products that use Oracle WebLogic and Oracle Database are collected by the central collector.

  • All configuration data collected by the central collector from Oracle homes is uploaded using the My Oracle Support credentials of the central collector.

  • The central collector feature is not supported on HP, Linux PPC, Linux Itanium, and Windows platforms. Also, the Java used must be run in 32-bit mode, except on Linux,where Java can be run in 32-bit or 64-bit mode.

1.4 About Connected and Disconnected Modes

Oracle Configuration Manager can be installed in the following modes:

  • Connected (Authenticated) Mode

    This mode is recommended if your server has direct connection to the Internet, connection through a proxy server, or connection using Oracle Support Hub. In this mode, configuration data is automatically collected and uploaded to the Oracle server. In addition, updates to Oracle Configuration Manager occur automatically.

  • Connected (Unauthenticated) Mode

    This mode, though not recommended, is used when only the e-mail address is specified but no password. Though this mode allows you to register and upload data, you are not able to view or use the data collected in the My Oracle Support interface.

  • Disconnected Mode

    This mode is required when your server does not have a connection to the Internet and you cannot configure an Oracle Support Hub. In this mode, you can collect configuration data manually by using the emCCR collect command. When you run this command, the collected configuration data is stored in the <OCM_CONFIG_HOME>/state/upload/ocmconfig.jar file. If problems occur, you can then upload this file to Oracle by way of a Service Request and My Oracle Support from another system that has Internet access.

    Refer to Section 6.3, "emCCR collect" for details. In this mode, the only commands supported are: emCCR collect, emCCR status, emCCR enable_target, emCCR disable_target, emCCR update_components, configCCR, and emCCR help.


    For Fusion MiddleWare 12.1.2, a mini version of the OCM collector kit is included. This version of the kit includes a minimal set of components that are needed for initial configuration. During configuration if the OCM is connected, the remaining components are download and installed.

    If the OCM is not connected, the remaining components must be installed manually. You can download the full OCM collector kit from My Oracle Support (download the latest version of the patch for bug 5567658):


    Once you have downloaded the patch, update OCM with the following command:

    cd $FMW_HOME/oracle_common/ccr/bin/emCCR update_components  -distribution=/scratch/distribution/ccr-Production-

    For more details, refer to Section 6.16, "emCCR update_components."

You can switch between Connected and Disconnected modes by using the configCCR command. Refer to Section 6.19, "configCCR" for details.

1.5 Support for Shared Homes

A shared home is an installation of an Oracle product that can be used and accessed by multiple hosts, or across multiple configurations on a single host. There are shared homes that require special Oracle Configuration Manager setup, and those that do not.

1.5.1 Shared Homes That Do Not Require Special Oracle Configuration Manager Setup

Examples of shared homes that do not require special Oracle Configuration Manager setup are:

  • When multiple database instances are created on the same host, from a single software installation.

  • When a single installation is shared across multiple hosts and each host has one or more database instances. In this case, though Oracle Configuration Manager requires no special setup, the collector must be setup separately on each host.

1.5.2 Shared Homes That Do Require Special Oracle Configuration Manager Setup

Some software products allow for the installation of the executables to be placed in a shared directory structure. Each use of the product requires a separate directory to segregate the product's runtime specific information.

An example of this is the Oracle Fusion Middleware installation with its separate directories. Typically the product-specific information collected by Oracle Configuration Manger is found in files in each of these separate directories.

To support this type of shared home, Oracle Configuration Manager treats each separate runtime state directory as an ORACLE_CONFIG_HOME.

If you have a software installation of this type, read Appendix A, "Shared Homes" before deciding whether you absolutely need shared homes.

Typically, most Oracle homes are not shared Oracle homes, therefore special Oracle Configuration Manager setup is not required.


If you are upgrading from an existing version of Oracle Configuration Manager that is prior to release 10.2.7, you cannot take advantage of the Shared Homes functionality. This functionality is only available with a new installation of Oracle Configuration Manager release 10.2.7 or later.

To use this feature, you must deinstall the current installation of Oracle Configuration Manager and then reinstall Oracle Configuration Manager release 10.2.7 or later.

1.6 Oracle Support Hub

The Oracle Support Hub conveys the configuration payload from individual Oracle Configuration Manager instances to the repository maintained at Oracle. The Oracle Support Hub is situated inside the customer network, so that it becomes the only point of access needed between inside the network and the outside Internet.

For the complete description of the Oracle Support Hub, refer to the Oracle Configuration Manager Companion Distribution Guide.

1.7 Oracle Harvester

Oracle Harvester (Harvester) collects target configuration data from the Management Repository and uploads it to Oracle.

When Oracle Configuration Manager is configured in Enterprise Manager release or higher, it enables the Harvester functionality. The Harvester job runs every 24 hours and collects configuration data from the Management Repository which Oracle Configuration Manager uploads to Oracle as part of its next collection. Some target types for which data is collected include: Oracle Database, Host, Oracle Home, Oracle Virtual Machine, Oracle Real Application Cluster, Oracle Application Server, and Web Logic Server.

If Oracle Configuration Manager is also installed in the actual target home, the data collected by Oracle Configuration Manager in this home overrides data collected by the Harvester from the Management Repository.