Skip Headers

Oracle® Configuration Manager Installation and Administration Guide Release 10.3.4 Part Number E18035-01 |
Home | Book List | Contents | Index | Contact Us

Previous | Next
| View PDF

# 3 Installing Oracle Configuration Manager

This chapter provides detailed instructions about installing Oracle Configuration Manager. It also describes the procedure to prepare a database for configuration collections. It contains the following sections:

- Section 3.1, "Before You Begin"

- Section 3.2, "Installing Oracle Configuration Manager Using the Command Line Interface"

- Section 3.3, "Installing Oracle Configuration Manager Using the Oracle Universal Installer"

- Section 3.4, "Oracle Enterprise Linux Installation Using RPM Package Manager"

- Section 3.5, "Installing Oracle Configuration Manager on Enterprise Manager Grid Control"

- Section 3.6, "Installing Oracle Configuration Manager in a Shared Home"

- Section 3.7, "Setting Up Oracle Configuration Manager in a Cloned Home"

- Section 3.8, "Post-Installation PeopleSoft Configuration"

- Section 3.9, "Post-Installation Database Configuration"

- Section 3.10, "Uninstalling Oracle Configuration Manager"

## 3.1 Before You Begin

Before you start the installation, you need to decide how you will access the kit. You can install Oracle Configuration Manager using either of the following methods:

- Download the standalone install kit from the My Oracle Support site (`http://support.oracle.com`) and install Oracle Configuration Manager using the Command Line Interface. For more information, refer to Section 3.2, "Installing Oracle Configuration Manager Using the Command Line Interface".

- Oracle Configuration Manager is also bundled with new product releases and in patchsets. Use the product's installation program to collect user information, install, and configure Oracle Configuration Manager. For more information, refer to Section 3.3, "Installing Oracle Configuration Manager Using the Oracle Universal Installer" and Section 3.4, "Oracle Enterprise Linux Installation Using RPM Package Manager".

After installation, you can reconfigure the Oracle Support Hub or the proxy server and registration credentials, add additional instance homes and additional hosts, as well as switch between Connected and Disconnected modes, by using the $ORACLE_HOME/ccr/bin/configCCR script. Registration credentials are either the My Oracle Support User Name and Password credentials or the CSI and My Oracle Support User Name credentials. For more information, refer to Section 6.19, "configCCR".

Note:

If you are using a UNIX system and you do not have access to `CRON`, the following message displays:

    This account does not have permission to use cron. The Oracle
    Configuration Manager will not be automatically started on system
    reboot. Add the command:

        /net/host123/scratch/jnk/ccr/bin/emCCR start -silent

    to your system startup procedures.

    ** Installing base package **
    Deploying core - Version 10.3.4.0.0
    ...

### 3.1.1 Command Used for Installation - setupCCR

The setupCCR command is the command by which you perform the majority of the Oracle Configuration Manager installation tasks. This section explains the command in detail.

    setupCCR [ -s ] [ -d | -C <OracleSupportHubUrl> ] [ -a | -r ] [<csi-number> [[<MyOracleSupportId>] ]]

    setupCCR [-R <response_file>]

- Usage:

  - The `-s` parameter indicates the acceptance of the Oracle Configuration Manager license agreement. This parameter is optional.

  - If you use the `-d` parameter, Oracle Configuration Manager will be installed in Disconnected Mode. In this mode, configuration data is not collected automatically. This mode is used when your computer does not have Internet access. You can manually collect the data using the `emCCR collect` option. For details, refer to Section 6.3, "emCCR collect". When the -`d` parameter is specified along with the CSI and My Oracle Support User Name parameters, these parameters will be ignored. You cannot use the -C parameter when the -d parameter is used.

  - The `-C` parameter indicates the use of the Oracle Support Hub. The URL for the Oracle Support Hub is of the form: `http[s]://<OracleSupportHubHost>:<OracleSupportHubPort>`

    You can also enter NONE to indicate that no Oracle Support Hub is to be used. When you use `NONE`, you will be prompted for the proxy server if no direct connection is available.

  - The `-a` parameter configures Oracle Configuration Manager to run within the instance defined by the ORACLE_CONFIG_HOME environment variable or the current host.

    - If ORACLE_CONFIG_HOME is set to a valid directory, the Oracle Configuration Manager subdirectories are created in this directory, and the crontab entry (for UNIX platforms) or the service (for Windows platforms) for this instance is also created.

    - If ORACLE_CONFIG_HOME is not set, the Oracle Configuration Manager subdirectories are added to <ocm_install_root>/ccr/hosts/<hostname> (where hostname is the current host) and the crontab entry (for UNIX platforms) or the service (for Windows platforms) for this host is added.

    You can pass the configuration information on the command line, otherwise you will be prompted for the credentials.

  - The `-r` parameter removes Oracle Configuration Manager instance-specific data from the instance directory.

    - If ORACLE_CONFIG_HOME is set, the Oracle Configuration Manager subdirectories are removed from this directory, and the associated crontab entry (for UNIX platforms) or the service (for Windows platforms) is also removed.

    - If ORACLE_CONFIG_HOME is not set, the directory <ocm_install_root>/ccr/hosts/<hostname> (where hostname is the current host) is removed and the associated crontab entry (for UNIX platforms) or the service (for Windows platforms) is also removed.

    Note:

    Parameters `-a` and `-r` are mutually exclusive. In a multi-host, shared home environment, no prerequisite steps are required to add or remove an instance home.

    In a single host, shared file system environment, you must first set the `ORACLE_CONFIG_HOME` environment variable to the instance home being added or removed before running `configCCR -a` or `configCCR -r`.

  - `<csi-number>` is the Customer Support Identifier (CSI). Your CSI number can be found in the Profile section of My Oracle Support under the Licenses link. When you specify CSI, you are prompted for the My Oracle Support User Name. If the CSI is not specified on the command line, you will be prompted for e-mail address and password.

  - `<MyOracleSupportId>` is the My Oracle Support User Name.

  - The `-R` parameter indicates the installation is using the contents of the response file, created using the emocmrsp utility, for all required input. The `-R` parameter cannot be used with any of the following qualifiers: `-d` (disconnected mode), `-s` (signature accepted), -C (Oracle Support Hub configuration), and CSI and My Oracle Support User Name.

  - <response-file> is the response file generated by the emocmrsp utility.

- Execute Privileges: Can be executed by <ocm_install_root> owner.

- Prerequisites: None

- Restrictions:

  - When specifying an e-mail address, avoid using UNIX characters that overlap with the TTY terminal settings in use. Otherwise an undefined resultant behavior may occur.

  - For Windows 2008, the user account control must be turned off when installing and using Oracle Configuration Manager. If user account control is on, Oracle Configuration Manager experiences permission errors during installations and other Oracle Configuration Manager operations.

- Examples: See Section 3.2.3, "Sample setupCCR Command Output"

- Errors:

  - Invalid credentials

  - Server unavailable

Note:

Oracle Configuration Manager must be installed in every product directory that contains configuration data to be collected.

## 3.2 Installing Oracle Configuration Manager Using the Command Line Interface

To install Oracle Configuration Manager using the Command Line Interface, follow these steps.

### 3.2.1 Preinstallation Steps

Before starting the installation, perform the following steps:

1. Log in as the <ocm_install_root> directory owner.

2. On UNIX based systems, issue the following command to protect the unzipped files:

       umask 077

3. Unzip the Oracle Configuration Manager distribution file into the <ocm_install_root> directory as follows:

       $unzip -d <ocm_install_root> ccr-Production-10.3.4.0.0-<OS_NAME>-<CHIP_ARCH>.zip

   The name of the platform-specific distribution file for Oracle Configuration Manager may appear as `ccr-Production-10.3.4.0.0-<OS_NAME>-<CHIP_ARCH>.zip` where `OS_NAME` refers to the name of the operating system such as Linux, AIX, Windows and <`CHIP_ARCH`> refers to the base architecture such as `i386`, `x86,` and so on.

### 3.2.2 Installing Oracle Configuration Manager in a Single Home

After the file has been unzipped, you have the following options to perform the installation:

- Section 3.2.2.1, "Scripted Installation"

- Section 3.2.2.2, "Direct Connectivity to Internet"

- Section 3.2.2.3, "No Direct Connectivity to Internet - Using Oracle Support Hub"

- Section 3.2.2.4, "No Direct Connectivity to Internet - Using a Proxy Server"

#### 3.2.2.1 Scripted Installation

Ensure a response file has been created that contains all the registration information. Install and complete the configuration of Oracle Configuration Manager by entering the following command from the `<ocm_install_root>``/ccr/bin` directory:

    setupCCR -R <response file>

See Section 5.7, "Creating a Response File" for information of how to create a Response file.

#### 3.2.2.2 Direct Connectivity to Internet

Install and complete the configuration of Oracle Configuration Manager by entering the `setupCCR` command from the `<ocm_install_root>``/ccr/bin` directory:

    setupCCR [-s] [<csi-number> [<MyOracleSupportId>] ]

Note:

When you set up Oracle Configuration Manager in Connected mode and you want to use the My Oracle Support User Name (e-mail address) for registration, specify nothing on the command line. You will be prompted for the My Oracle Support User Name and Password.

To read the license agreement, visit `http://www.oracle.com/support/policies.html`.

You will be registered in unauthenticated mode if any of the following occurs:

- You are unable to provide correct My Oracle Support credentials (User Name/Password, or CSI and My Oracle Support User Name, or Oracle Support Hub URL) within three tries

- You press the Enter key without supplying data when prompted for the password associated with the My Oracle Support User Name

When registered in unauthenticated mode, data is uploaded but not accessible, that is, data is not tied to any organization.

#### 3.2.2.3 No Direct Connectivity to Internet - Using Oracle Support Hub

If you do not have direct connectivity to the Internet, use the Oracle Support Hub.

1. If you cannot access the Oracle Support Hub specified or you entered NONE, you are prompted for the proxy server.

   - Either enter a proxy server or type NONE.

   - If you entered NONE for both Oracle Support Hub and proxy server, Oracle Configuration Manager is configured in disconnected mode.

2. If you specified a proxy server but you still cannot access Oracle, you will be prompted for Oracle Support Hub again.

   - Supply the URL for the Oracle Support Hub or type NONE.

You will be prompted for Oracle Support Hub and possibly proxy server until there is connectivity to Oracle or you type NONE for both the Oracle Support Hub and proxy server.

If you entered NONE for both Oracle Support Hub and proxy server, Oracle Configuration Manager is configured in disconnected mode.

After the file has been unzipped, install and complete the configuration of Oracle Configuration Manager by entering the following command from the `<ocm_install_root>``/ccr/bin` directory:

    bin/setupCCR [ -s ] [ -d | -C <OracleSupportHubUrl> ] [ -a | -r ] [<csi-number>
    [<MyOracleSupportId>] ]

#### 3.2.2.4 No Direct Connectivity to Internet - Using a Proxy Server

After the file has been unzipped, install and complete the configuration of Oracle Configuration Manager by entering the following command from the `<ocm_install_root>``/ccr/bin` directory:

    setupCCR [-s] [[<CSI>] [<MyOracleSupportUserName>] ]

Note:

When you set up Oracle Configuration Manager in Connected mode and you want to register using the Customer Support Identifier (CSI), you must specify at least the CSI on the command line. If the CSI is not specified on the command line, you will be prompted for credentials. If you do not specify correct credentials in three tries, unauthenticated mode will be used.

To install and complete the configuration of Oracle Configuration Manager using a proxy server, do the following:

1. If you do not have direct access to the Internet and you do not have access to an Oracle Support Hub, type NONE at the prompt for the Oracle Support Hub.

2. Specify the host, port, and authentication information, if required, for the proxy server. The format is as follows:

       [<proxy-user>@]<proxy-host>:<proxy-port>

3. If you specify a proxy server but you still cannot access Oracle, you will be prompted for a proxy server until you type a correct proxy server or you type NONE.

Note the following:

- If the `proxy-user` is specified, you will be prompted to enter the password.

- If the `proxy-user` is not specified (`<proxy-host>:<proxy-port>`), a proxy server will be used for the connection, but will not be authenticated.

- If a default `proxy-port` is to be used, any of the following is a valid proxy string:

      <proxy-host>
      <proxy-user>@<proxy-host>

See "Using Both Oracle Support Hub and Proxy Server (In Connected Mode)" for an example using proxy information.

#### 3.2.2.5 After Configuration Is Completed

After you have completed the configuration, Oracle Configuration Manager will begin to collect and upload configuration data. If there is a database in the `<ocm_install_root>` directory, you must run the database collection scripts after the configuration of the Oracle Configuration Manager. If a database is being used by either an Oracle E-Business installation or an Oracle Enterprise Manager Grid Control installation, you must execute the database collection scripts to enable the collection of the database configuration data. Refer to Section 3.9.2, "Instrumenting the Database for Configuration Collection" for details.

### 3.2.3 Sample setupCCR Command Output

This section provides samples of setupCCR command output in both connected mode and disconnected mode.

#### 3.2.3.1 Using My Oracle Support User Name and Password (No Parameters Used)

<ocm_install_root>/ccr/bin/setupCCR

    Provide your email address to be informed of security issues, install and
    initiate Oracle Configuration Manager. Easier for you if you use your My Oracle Support
    Email address/User Name.
    Visit http://www.oracle.com/support/policies.html for details.
    Email address/User Name: jsmith@example.com
    Provide your My Oracle Support password to receive security updates via your My Oracle Support account.
    Password (optional):

    ** Installing base package **
    Deploying core - Version 10.3.4.0.0

    ** Registering installation with Oracle Configuration Manager server(s) **
    Deploying engines - Version 10.2.7.1.0
    Deploying metricdata - Version 10.2.4.0.3
    Deploying scripts - Version 10.3.4.0.0

    ** Getting package updates from ContentServer **

    ** Starting the Oracle Configuration Manager Scheduler **
    Oracle Configuration Manager - Release: 10.3.4.0.0 - Production
    Copyright (c) 2005, 2010, Oracle.  All rights reserved.
    ------------------------------------------------------------------
    Starting Oracle Configuration Manager...
    Waiting for status from Oracle Configuration Manager....
    Start Date               06-Jan-2010 12:49:53
    Last Collection Time     -
    Next Collection Time     07-Jan-2010 12:49:00
    Collection Frequency     Daily at 12:49
    Collection Status        scheduled collection running
    Log Directory            /scratch/jsmith/test/ccr/hosts/myhost/log
    Registered At            06-Jan-2010 12:49:05
    Automatic Update         On
    Collector Mode           Connected

    Oracle Configuration Manager successfully started.

    Oracle Configuration Manager has been configured in connected mode. If the
    target ORACLE_HOME is running a database, please refer to the
    "Post-installation Database Configuration" section of the OCM Installation
    and Administration Guide
    (http://www.oracle.com/technology/documentation/ocm.html) to complete the
    installation.

    View configuration data reports and access valuable configuration best
    practices by going to My Oracle Support.

#### 3.2.3.2 Using CSI

<ocm_install_root>/ccr/bin/setupCCR 12345678

    Configuration requires the following pieces(s) of information.
        Oracle My Oracle Support User Name: joe.smith@example.com

    ** Installing base package **
    Deploying core - Version 10.3.4.0.0

    ** Registering installation with Oracle Configuration Manager server(s) **
    Deploying engines - Version 10.2.7.1.0
    Deploying metricdata - Version 10.2.4.0.3
    Deploying scripts - Version 10.3.4.0.0

    ** Getting package updates from ContentServer **

    ** Starting the Oracle Configuration Manager Scheduler **
    Oracle Configuration Manager - Release: 10.3.4.0.0 - Production
    Copyright (c) 2005, 2010, Oracle.  All rights reserved.
    ------------------------------------------------------------------
    Starting Oracle Configuration Manager...
    Waiting for status from Oracle Configuration Manager....
    Start Date                06-Jan-2010 12:49:53
    Last Collection Time     -
    Next Collection Time     07-Jan-2010 12:49:00
    Collection Frequency     Daily at 12:49
    Collection Status        scheduled collection running
    Log Directory            /scratch/jsmith/test/ccr/hosts/myhost/log
    Registered At            06-Jan-2010 12:49:05
    Automatic Update         On
    Collector Mode           Connected

    Oracle Configuration Manager successfully started.

    Oracle Configuration Manager has been configured in connected mode. If the
    target ORACLE_HOME is running a database, please refer to the
    "Post-installation Database Configuration" section of the OCM Installation
    and Administration Guide
    (http://www.oracle.com/technology/documentation/ocm.html) to complete the
    installation.

    View configuration data reports and access valuable configuration best
    practices by going to My Oracle Support.

#### 3.2.3.3 Using Oracle Support Hub

    Provide your email address to be informed of security issues, install and
    initiate Oracle Configuration Manager. Easier for you if you use your My
    Oracle Support Email address/User Name.
    Visit http://www.oracle.com/support/policies.html for details.
    Email address/User Name: joe.smith@company.com
    Provide your My Oracle Support password to receive security updates via your My Oracle Support account.
    Password (optional):

    Unable to establish a network connection to Oracle. Specify the URL for an
    Oracle Support Hub in this format:
        http[s]://<OracleSupportHubHost>:<OracleSupportHubPort>
    If you do not wish to configure OCM through an Oracle Support Hub, enter NONE
    Oracle Support Hub URL: http://host123.company.com:7654

    ** Installing base package **
    Deploying core - Version 10.3.4.0.0

    ** Registering installation with Oracle Configuration Manager server(s) **
    Deploying engines - Version 10.2.7.1.0
    Deploying metricdata - Version 10.2.4.0.3
    Deploying scripts - Version 10.3.4.0.0

    ** Getting package updates from ContentServer **

    ** Starting the Oracle Configuration Manager Scheduler **
    Oracle Configuration Manager - Release: 10.3.4.0.0 - Production
    Copyright (c) 2005, 2010, Oracle and/or its affiliates.  All rights reserved.
    ------------------------------------------------------------------
    Starting Oracle Configuration Manager...
    Waiting for status from Oracle Configuration Manager....
    Start Date                     03-Jan-2010 15:13:47
    Last Collection Time           -
    Next Collection Time           04-Jan-2010 15:13:00
    Collection Frequency           Daily at 15:13
    Collection Status              scheduled collection running
    Log Directory                  /scratch/jsmith/test/ccr/hosts/host123/log
    Registered At                  03-Jan-2010 15:13:27
    Automatic Update               On
    Collector Mode           Connected (via Oracle Support Hub)
    Oracle Support Hub URL   http://host123.company.com:7654

    Oracle Configuration Manager successfully started.

    Oracle Configuration Manager has been configured in connected mode. If the
    target ORACLE_HOME is running a database, please refer to the
    "Post-installation Database Configuration" section of the OCM Installation
    and Administration Guide
    (http://www.oracle.com/technology/documentation/ocm.html) to complete the
    installation.

#### 3.2.3.4 Using Both Oracle Support Hub and Proxy Server (In Connected Mode)

    Provide your email address to be informed of security issues, install and
    initiate Oracle Configuration Manager. Easier for you if you use your My
    Oracle Support Email address/User Name.
    Visit http://www.oracle.com/support/policies.html for details.
    Email address/User Name: joe.smith@company.com
    Provide your My Oracle Support password to receive security updates via your My Oracle Support account.
    Password (optional):

    Unable to establish a network connection to Oracle. Specify the URL for an
    Oracle Support Hub in this format:
        http[s]://<OracleSupportHubHost>:<OracleSupportHubPort>
    If you do not wish to configure OCM through an Oracle Support Hub, enter NONE
    Oracle Support Hub URL: http://host123.company.com:7654

    Unable to establish a network connection to the Oracle Support Hub. If your
    systems require a local proxy server, enter the proxy server details in this
    format:
        [<proxy-user>@]<proxy-host>[:<proxy-port>]
    To go back to the previous menu, enter NONE
    Proxy specification: ccr@jsmith-sun:8083
    Proxy Password:
    Proxy information verified, validating specified email value(s).

    ** Installing base package **
    Deploying core - Version 10.3.4.0.0

    ** Registering installation with Oracle Configuration Manager server(s) **
    Deploying engines - Version 10.2.7.1.0
    Deploying metricdata - Version 10.2.4.0.3
    Deploying scripts - Version 10.3.4.0.0

    ** Getting package updates from ContentServer **

    ** Starting the Oracle Configuration Manager Scheduler **
    Oracle Configuration Manager - Release: 10.3.4.0.0 - Production
    Copyright (c) 2005, 2010, Oracle and/or its affiliates.  All rights reserved.
    ------------------------------------------------------------------
    Starting Oracle Configuration Manager...
    Waiting for status from Oracle Configuration Manager....
    Start Date                    03-Jan-2010 15:04:46
    Last Collection Time          -
    Next Collection Time          04-Jan-2010 15:04:00
    Collection Frequency          Daily at 15:04
    Collection Status             scheduled collection running
    Log Directory            /scratch/jsmith/test/ccr/hosts/host123/log
    Registered At            03-Jan-2010 15:04:27
    Automatic Update         On
    Collector Mode           Connected (via Oracle Support Hub)
    Oracle Support Hub URL   http://host123.company.com:7654
    HTTP Proxy               ccr@jsmith-sun:8083

    Oracle Configuration Manager successfully started.

    Oracle Configuration Manager has been configured in connected mode. If the
    target ORACLE_HOME is running a database, please refer to the
    "Post-installation Database Configuration" section of the OCM Installation
    and Administration Guide
    (http://www.oracle.com/technology/documentation/ocm.html) to complete the
    installation.

#### 3.2.3.5 Disconnected Mode

Sample setupCCR Command Output (In Disconnected Mode)

<ocm_install_root>/ccr/bin/setupCCR -s -d

    ** Installing base package **
    Deploying core - Version 10.3.4.0.0
    Deploying engines - Version 10.2.7.1.0
    Deploying metricdata - Version 10.2.4.0.3
    Deploying scripts - Version 10.3.4.0.0

To verify Oracle Configuration Manager is in disconnected mode, execute `emCCR status`.

    Oracle Configuration Manager - Release: 10.3.4.0.0 - Production
    Copyright (c) 2005, 2010, Oracle and/or its affiliates.  All rights reserved.
    ------------------------------------------------------------------
    Log Directory            /scratch/jsmith/test/ccr/hosts/host123/log
    Collector Mode           Disconnected
    To switch to connected mode, please run /scratch/jsmith/test/ccr/bin/configCCR

## 3.3 Installing Oracle Configuration Manager Using the Oracle Universal Installer

Oracle Configuration Manager may be bundled with another product release or patchset, and can be installed using the Oracle Universal Installer. When you are installing the product release or patchset with which Oracle Configuration Manager has been included, Figure 3-1 is displayed.

Figure 3-1 Oracle Configuration Manager Registration Screen

### 3.3.1 Providing Credentials

When you provide both the e-mail address and password, Oracle Configuration Manager checks for connectivity to verify the credentials specified. If there is no direct connectivity to Oracle, the Connection Failed dialog box appears with the Proxy connection method selected (Figure 3-2). If you want to configure Oracle Configuration Manager to connect to Oracle using an Oracle Support Hub, you must select the Oracle Support Hub radio button (Figure 3-3). Either of these methods enable you to define a connection to Oracle.

If no connection is possible, check the I want to remain uninformed of critical security issues in my configuration check box on the Connection Failed dialog box. This causes Oracle Configuration Manager to be installed in disconnected mode.

Once connectivity is established, the credentials are verified. You are given three opportunities to enter correct credentials. After the third failure, you will no longer be prompted and Oracle Configuration Manager will be configured in unauthenticated mode.

You must supply at least the e-mail address. Oracle Configuration Manager is configured in unauthenticated mode.

#### 3.3.1.1 Connection Settings Using Proxy Server

The Connection Failed dialog box, with Proxy connection method selected (Figure 3-2), appears when Oracle Universal Installer determines there is no connectivity to Oracle.

Figure 3-2 Connection Failed - Proxy Method

Description of "Figure 3-2 Connection Failed - Proxy Method"

To configure Oracle Configuration Manager to use a proxy server, enter the following details.

On the Connection Failed dialog box:

- Enter the host name of the proxy server. For example, you can specify the proxy server setting as follows:

  Proxy Server: `www-proxy.example.com`

- Enter the port number of the proxy server. For example, you can specify the proxy port as follows:

  Port: 98

- If the proxy server requires authentication, you must specify the credentials in the Proxy Username and Password fields.

- Click Continue to verify that you can connect to Oracle.

  - If the connection is not successful, you remain on the Connection Failed dialog box. Either enter correct proxy server information or, if no connection is possible, check the I want to remain uninformed of critical security issues in my configuration checkbox. Oracle Configuration Manager will be installed in disconnected mode.

  - If the connection is successful, Oracle Configuration Manager validates the My Oracle Support User Name (e-mail address) and My Oracle Support Password. See Section 3.3.1, "Providing Credentials" for additional information.

Note:

NT LAN Manager (NTLM) proxy server settings are not supported.

#### 3.3.1.2 Connection Settings Using Oracle Support Hub

When Oracle Universal Installer determines there is no connectivity to Oracle, you can choose the Oracle Support Hub connection method (Figure 3-3).

Figure 3-3 Connection Failed - Oracle Support Hub Method

Enter the Oracle Support Hub configuration details as follows.

On the Connection Failed dialog box:

- Choose the appropriate Oracle Support Hub from the Existing Oracle Support Hub URL drop-down list or enter the URL for the Oracle Support Hub, for example, http://host123.company.com:8888.

- Decide whether you need to connect to the Oracle Support Hub by way of a proxy server. If so:

  - Check the 'Connect Using Proxy Server' box.

  - Enter the host name of the proxy server. For example, you can specify the proxy server setting as follows:

    Proxy Server: `www-proxy.example.com`

  - Enter the port number of the proxy server. For example, you can specify the proxy port as follows:

    Port: 98

  - If the proxy server requires authentication, you must specify the credentials in the Proxy Username and Proxy Password fields.

  - Click Continue to validate that you can connect to Oracle.

    - If the connection is not successful, you remain on the Connection Failed dialog box. Either enter the Oracle Support Home URL or, add or correct the proxy server information. If no connection is possible, check the I want to remain uninformed of critical security issues in my configuration checkbooks. Oracle Configuration Manager will be installed in disconnected mode.

    - If the connection is successful, Oracle Configuration Manager validates the My Oracle Support User Name (e-mail address) and My Oracle Support Password. See Section 3.3.1, "Providing Credentials" for additional information.

### 3.3.2 Entering E-Mail Address But No Password

If you specify only an e-mail address and the check box for receiving security updates (I wish to receive security updates via My Oracle Support) is unchecked, Oracle Configuration Manager is installed and configured in unauthenticated mode.

### 3.3.3 Not Entering E-Mail Address

If you do not enter the e-mail address, a confirmation dialog box appears asking if you really do not want to receive security updates. If you click Yes, the installation continues and Oracle Configuration Manager is installed but not configured.

### 3.3.4 Completing the Installation

At the end of the installation, the Oracle Configuration Manager Configuration Assistant is executed. The Configuration Assistant displays the success or failure of the installation. If the installation has failed, check the install log files located in the Oracle Home directory. You can reattempt the configuration after the installation by invoking the command `<ocm_install_root>/ccr/bin/setupCCR`.

If a previous version of Oracle Configuration Manager has been installed in the Oracle Home directory, Oracle Configuration Manager will be automatically updated to the latest shipping version of the software.

## 3.4 Oracle Enterprise Linux Installation Using RPM Package Manager

To install Oracle Configuration Manager on Oracle Enterprise Linux (OEL) machines, the Oracle Configuration Manager kit is packaged as an RPM Package Manager (RPM). Oracle Configuration Manager for OEL is available on Unbreakable Linux Network (ULN) (see `http://linux.oracle.com`). Following are the channel details:

    OEL 4 (32 Bit) Oracle Software for Enterprise Linux 4 (i386) - el4_i386_oracle
    OEL 4 (64 Bit) Oracle Software for Enterprise Linux 4 (x86_64) - el4_x86_64_oracle
    OEL 5 (32 Bit) Oracle Software for Enterprise Linux 5 (i386)- el5_i386_oracle
    OEL 5 (64 Bit) Oracle Software for Enterprise Linux 5 (x86_64) - el5_x86_64_oracle

Note:

To avoid CCR configuration failure on 64-bit Linux systems, install the 32-bit gcc RPM and reconfigure the Oracle Configuration Manager using the command line interface: `$ORACLE_HOME/ccr/bin/setupCCR`

### 3.4.1 Installing and Upgrading Oracle Configuration Manager on Oracle Enterprise Linux

To install and upgrade Oracle Configuration Manager, you must have a subscription to the appropriate channel listed in Section 3.4, "Oracle Enterprise Linux Installation Using RPM Package Manager".

- To install Oracle Configuration Manager, run the following command:

      up2date ocm

  This command only installs Oracle Configuration Manager.

  Invoke the `/usr/lib/oracle/ccr/ccr/bin/setupCCR` command manually to configure Oracle Configuration Manager.

- If Oracle Configuration Manager already exists on the system and you run the `up2date ocm` command, Oracle Configuration Manager will be upgraded to the newest version.

  If the `up2date` command fails during upgrade, for example, CCR registration site is temporarily down, you must perform the following steps:

  1. Run:

         up2date --get ocm

     This command downloads the rpm file to the `/var/spool/up2date/` location.

  2. Run:

         rpm -U  --replacepkgs <rpm file>

     This command forces an upgrade to the latest version of Oracle Configuration Manager

### 3.4.2 Uninstalling Oracle Configuration Manager on Oracle Enterprise Linux

To uninstall Oracle Configuration Manager, run the following command:

    rpm -e ocm

## 3.5 Installing Oracle Configuration Manager on Enterprise Manager Grid Control

The Oracle Configuration Manager leverages your existing investment in deployed Oracle Grid Control Management Agents by uploading configuration information present in the Oracle Enterprise Manager Grid Control Management Repository. The uploaded configuration information provides value-added services available through My Oracle Support.

To upload Oracle Grid Control discovered configuration information, the Oracle Configuration Manager collector must have connectivity to Oracle on the host where the Oracle Enterprise Manager Management Service resides.

For information of how to install Oracle Configuration Manager on Enterprise Manager Grid Control, refer to the Oracle Enterprise Manager Grid Control Basic Installation Guide located at:

`http://www.oracle.com/technology/documentation/oem.html`

## 3.6 Installing Oracle Configuration Manager in a Shared Home

Oracle Configuration Manager should only be installed as a shared home if the application in the Oracle Home where it is being installed has been installed as a shared home. Shared homes are only used when configuration files must be placed in a separate location from the common executables.

Perform the following steps:

1. Install Oracle Configuration Manager in the base directory following the instructions described in Section 3.2, "Installing Oracle Configuration Manager Using the Command Line Interface".

2. Install Oracle Configuration Manager in the shared home:

   1. For each additional instance in the same host, set the ORACLE_CONFIG_HOME variable for each instance you want to configure.

   2. Run `<ocm_install_root>/ccr/bin/configCCR -a`. You will be prompted for credentials. See Section 6.19, "configCCR" for configuration information.

## 3.7 Setting Up Oracle Configuration Manager in a Cloned Home

If Oracle Configuration Manager was configured, then perform the following steps in the cloned Oracle home:

1. Delete all the subdirectories in the $ORACLE_HOME/ccr/hosts directory to remove previously configured hosts using the following command:

       rm -rf $ORACLE_HOME/ccr/hosts/*

2. Move (do not copy) $ORACLE_HOME/ccr/inventory/core.jar to $ORACLE_HOME/ccr/inventory/pending/core.jar

3. Run the following command from $ORACLE_HOME/ccr/bin:

   $ ./configCCR -a

## 3.8 Post-Installation PeopleSoft Configuration

This step is only needed if you are installing a version of Oracle Configuration Manager into a PeopleSoft home (PS_HOME) with PeopleTools release 8.51 and higher or if Oracle Configuration Manager is updated in the PeopleSoft home.

### 3.8.1 Instrumenting PeopleSoft for Configuration Collection

The PeopleSoft query definitions for configuration collections are packaged as part of Oracle Configuration Manager and will be published by way of the Integration Broker interface to your PeopleSoft environment during this step.

The PeopleSoft Integration Broker configuration required for publishing the configuration collections are defined in PeopleBooks (PeopleTools 8.51 PeopleBook: PeopleSoft Change Assistant: "Configuring and Running Environment Management Components," Integrating with Oracle Configuration Manager located at `http://ple70008uias.dsi-inet.peoplesoft.com:6460/ODLA/pt851pbr0_run1_yk/eng/psbooks/tswu/htm/tswu01.htm`.)

To configure the PeopleSoft for configuration collection, perform the following steps:

1. Run publisher:

   Go to the PS_HOME/ccr/sysman/admin/util directory.

   On UNIX run psft_qrypub.sh; on Windows run psft_qrypub.bat

2. Provide the parameters when prompted.

   Provide SOAP url. (Format:

       https://<hostname>:<port>/PSIGW/PeopleSoftServiceListeningConnector): Provide HTTPS Listener endpoint

       For example:
       https://rtdc78454vmc/PSIGW/PeopleSoftServiceListeningConnector

3. Provide security credentials when prompted

   Provide User ID: QEDMO

   Provide Password:

Note:

This step needs to be performed only once for your PeopleSoft environment. If you have Oracle Configuration Manager installed and configured on each PeopleSoft server (Application Server, Web Server, Process Schedluer, or Web server ), publishing needs to be done only once for a PeopleSoft environment from any of the configured collectors in your PeopleSoft servers (PS_HOME/ccr).

## 3.9 Post-Installation Database Configuration

If you have installed Oracle Configuration Manager in a home that contains a database, you must run a script to instrument the database for configuration collection. Whether you are in Connected or Disconnected mode, you must run this script. It will create the database account, ORACLE_OCM. This account stores the PL/SQL procedures that collect the configuration information, and the account owns the database management system (DBMS) job that performs the collection. After the account has been set up, it is locked because login privileges are no longer required.

Note:

- Because the collected configuration data is not stored in the database, additional disk space is not required for the database.

- Because database configuration collections are performed using the database jobs, the `job_queue_process` initialization parameter must have a value greater than 0 for pre-10g databases only.

### 3.9.1 Preparing Pre-9.2 Databases

Before running the `installCCRSQL.sh` (UNIX) or `installCCRSQL.exe` (Windows) script to prepare the database for configuration collection, you must perform the following steps for pre 9.2 databases:

1. Edit the `init``<sid`>.`ora` file where `sid` is the database system identifier, and set the `UTL_FILE_DIR` parameter to include `OCM_CONFIG_HOME/state` as one of its directories.

   If a server parameter file (`spfile`) is used, alter the `UTL_FILE_DIR` parameter using the following SQL*Plus command:

       SQL>alter system set utl_file_dir=<value> scope=spfile

   where `value` is OCM_CONFIG_HOME/state.

2. Restart the database.

### 3.9.2 Instrumenting the Database for Configuration Collection

This step is only needed if you are installing a version of Oracle Configuration Manager into a database release home that is prior to release 10.2.0.4 or if Oracle Configuration Manager is updated in the database home. As of Oracle Database release 10.2.0.4, the database is automatically instrumented.

To configure the database for configuration collection, perform the following steps:

- Run the following script which will prompt for the SYSDBA-USER password:

      <ocm_install_root>/ccr/admin/scripts/installCCRSQL.sh collectconfig -s <SID> -r <SYSDBA-USER>

  The `installCCRSQL.sh` (UNIX) or `installCCRSQL.exe` (Windows) script creates an Oracle Configuration Manager user and loads the PL/SQL procedure into the database defined by the `ORACLE_SID`. You can also specify the database `<SID>` by using the `-s` option in the command line as in the following example where the `<SID>` is `orcl`:

      <ocm_install_root>/ccr/admin/scripts/installCCRSQL.sh collectconfig -s orcl

  By default, the connection to the database is through OS authentication, "/as sysdba." To specify a different `SYSDBA` user and password, you can use this option:

  `-r <SYSDBA-USER>`: The login name of the `SYSDBA` user

  You will be prompted for the corresponding password.

- For Oracle Real Application Cluster (RAC) databases, you must run the database script against only one instance, but Oracle Configuration Manager must be installed in all instance homes. Oracle Configuration Manager does not support active/passive clusters.

Note:

- If the Oracle Configuration Manager account already exists, when you run the `installCCRSQL.sh` script, it will be dropped and re-created.

- If you upgrade from a 9.x database version to a 10.x version after the Oracle Configuration Manager installation, you must run the `installCCRSQL.sh` script again to instrument the upgraded version.

- In a RAC configuration with a non-shared file system environment, it is possible to alter Oracle Configuration Manager configuration and installation such that the dbms_job output is not sent to a host-specific directory:

  Set the ORACLE_CONFIG_HOME environment variable to $ORACLE_HOME prior to running the installCCRSQL.sh script. This causes the dbms_job output to go to the $ORACLE_HOME/ccr/state directory. The discovery scripts for databases account for this already, so the database and RAC database targets will be discovered and have their configuration information collected.

#### 3.9.2.1 Additional Step for E-Business Suite

If the database is used as a repository for an Oracle E-Business Suite, you must also run the following script from the `<ocm_install_root>` directory in which the E-Business database has been hosted:

    <ocm_install_root>/ccr/admin/scripts/installCCRSQL.sh ebs_collectconfig -u <Oracle_Applications_User>

The `-u` parameter is mandatory. If you do not specify this parameter, you will be prompted for the Oracle Applications User. If the `-u` parameter is specified, you will be prompted for the Oracle Applications Password.

If you want to automate the install, you can create a script that will run the `installCCRSQL.sh` script with an additional `-w` option to specify the Oracle Applications Password. For example:

`<ocm_install_root>/ccr/admin/scripts/installCCRSQL.sh ebs_collectconfig -u` `<Oracle_Applications_User> -w <Oracle_Applications_Password>`

WARNING:

Creating a script containing a password could pose a risk to database security.

You can add the `-s` <`SID`> command to specify the `SID` of the Oracle Applications Database instance.

If you are not using OS authentication to connect to the database, you must use the `-r` parameter to specify the following:

`-r <SYSDBA-USER>`: The login name of the `SYSDBA` user; you will be prompted for the corresponding password.

#### 3.9.2.2 Additional Step for Oracle Enterprise Manager Grid Control

As of Grid Control release 10.2.0.5, this step is automatically executed.

If the database is used as a repository for Oracle Enterprise Manager Grid Control, you must also run the following script:

`<ocm_install_root>/ccr/admin/scripts/installCCRSQL.sh collectemrep`

When you run this command, you will be prompted for the `SYSMAN` password. If you want to automate the install, you can create a script that will run the `installCCRSQL.sh` script specifying the `SYSMAN` password. For example:

`<ocm_install_root>/ccr/admin/scripts/installCCRSQL.sh collectemrep -e <SYSMAN.PASSWORD>`

WARNING:

Creating a script containing a password could pose a risk to database security.

You can add the `-s` <`SID`> command to specify the `SID` of the Oracle Enterprise Manager Grid Control Database instance. You must run this script from the `<ocm_install_root>` in which the Oracle Enterprise Manager Grid Control database has been hosted.

If you are not using OS authentication to connect to the database, you must use the `-r` parameter to specify the following:

`-r <SYSDBA-USER>`: The login name of the `SYSDBA` user; you will be prompted for the corresponding password.

## 3.10 Uninstalling Oracle Configuration Manager

To uninstall Oracle Configuration Manager, follow the steps in the following sections:

- Section 3.10.1, "Removing Oracle Configuration Manager Instrumentation from a Database"

- Section 3.10.2, "Uninstalling Oracle Configuration Manager in a Single Instance Home (Upgraded Pre-10.2.7 Installations)"

- Section 3.10.3, "Uninstalling Oracle Configuration Manager in Shared Homes (10.2.7 and Higher Installations)"

### 3.10.1 Removing Oracle Configuration Manager Instrumentation from a Database

Follow these steps to remove a database:

1. If the `<ocm_install_root>` directory contains a database, remove the Oracle Configuration Manager user and the associated objects from the database as follows:

       SQL> @ccr/admin/scripts/dropocm.sql;

   Note:

   You must have SYSDBA privileges to perform this operation.

2. If the database is a repository for the Oracle E-Business Suite, log in to the database as an `SYSDBA` user and remove the additional objects from the database as follows:

       SQL> @ccr/admin/scripts/ebs_dropccr.sql <Oracle_Applications_User>

3. If the database is a repository for Oracle Grid Control, log in to the database as the `SYSMAN` user and remove the additional objects from the database as follows:

       SQL> @ccr/admin/scripts/dropemrep_collect.sql;

### 3.10.2 Uninstalling Oracle Configuration Manager in a Single Instance Home (Upgraded Pre-10.2.7 Installations)

To remove Oracle Configuration Manager from an upgraded pre 10.2.7 installation, follow these steps:

1. To stop the Scheduler and remove the service or the `crontab` entry, enter the following command:

       <ocm_install_root>/ccr/bin/deployPackages -d <ocm_install_root>/ccr/inventory/core.jar

   Note:

   On Windows operating systems, the message `Batch file not found` is displayed upon command completion. This message indicates that all primary components of Oracle Configuration Manager have been removed.

2. Delete the `ccr` directory by entering the following command:

       $rm -rf <ocm_install_root>/ccr (On UNIX)

       >rmdir /s/q %<ocm_install_root>%\ccr (On Windows)

   Oracle Configuration Manager is successfully uninstalled.

### 3.10.3 Uninstalling Oracle Configuration Manager in Shared Homes (10.2.7 and Higher Installations)

If Oracle Configuration Manager has been installed and configured to support a shared home system environment, you must deconfigure all instances prior to removing the base ccr directory.

To remove shared homes:

1. For each instance, run `configCCR -r` to remove the Oracle Configuration Manager configuration for that instance.

   - If the instances are on separate hosts, no setup is required prior to running this command.

   - If the instances are on the same host, you must set the `ORACLE_CONFIG_HOME` environmental variable to point to the instance prior to running this command.

   - Delete the ORACLE_CONFIG_HOME.

2. All shared homes must first be deinstalled; then the base can be deinstalled and the directory removed. Delete the `ccr` directory by entering the following command:

       $rm -rf <ocm_install_root>/ccr (On UNIX)

       >rmdir /s/q <ocm_install_root>\ccr (On Windows)

Note:

If the "base" contains a host directory, then all `ORACLE_CONFIG_HOMEs` must be deinstalled.