22 Upgrading Enterprise Manager System with Add-Ons Installed in Graphical Mode

This chapter explains how you can upgrade Enterprise Manager 10g Grid Control Release 4 (10.2.0.4.0) or higher, or Oracle Management Service 10g Release 4 (10.2.0.4.0) or higher that has add-ons such as EBiz, PeopleSoft, JDEdwards, and so on installed. In particular, this chapter covers the following:

• Overview

• Prerequisites

• Upgrade Enterprise Manager

• Install Add-Ons

• After You Install Add-Ons

• Configure Enterprise Manager

• After You Configure Enterprise Manager

Overview

If you have installed add-ons on Enterprise Manager Grid Control or an additional OMS, and if you want to upgrade such an Enterprise Manager Grid Control or an additional OMS, then the obvious questions are: What happens to the add-ons you installed? Will they remain intact with the upgraded Enterprise Manager Grid Control or additional OMS? Should I reinstall them after upgrading Enterprise Manager Grid Control or additional OMS?

When you upgrade Enterprise Manager Grid Control or additional OMS, the add-ons that have been installed on it are NOT carried over to the upgraded version of Enterprise Manager Grid Control or additional OMS. The upgrade process is an out-of-place upgrade, that is, it creates new Oracle homes for the upgraded versions of OMS (oms11g) and Oracle Management Agent (Management Agent) (agent11g).

Due to this reason, the add-ons that were installed on the older release of Enterprise Manager Grid Control or an additional OMS are NOT automatically reinstalled on the upgraded version of Enterprise Manager Grid Control or an additional OMS.

The add-ons are independent of Enterprise Manager Grid Control and additional OMS, and if you want to continue to use them, then you must first upgrade the software binaries of the existing Enterprise Manager Grid Control or additional OMS, then install the add-ons, and then finally configure the upgraded software binaries of Enterprise Manager Grid Control or additional OMS.

Prerequisites

Before upgrading the software binaries of Enterprise Manager Grid Control or an additional OMS that has add-ons installed, ensure that you meet the prerequisites described in Prerequisites.

In addition, meet the following prerequisites:

• Download the 11g Release 1 add-on software to the host where you are upgrading the Enterprise Manager system.

• (For Microsoft Windows)Unset the PERL5LIB environment variable.

Upgrade Enterprise Manager

To upgrade the software binaries of Enterprise Manager Grid Control or an additional OMS that has add-ons installed, follow these steps:

1. Invoke the installer on the host where Enterprise Manager Grid Control or the additional OMS needs to be upgraded:

   <Software_Location>/runInstaller -noconfig

   In this command, <Software_Location> is either <DVD> or <Software_Downloaded_Location>.

   
   

   Note: For Microsoft Windows, invoke setup.exe instead of runInstaller. In Microsoft Windows, if the path to the software download location contains a subdirectory name with two or more words and a space between each of the words, then ensure that the parent directory of such a subdirectory does not contain a file whose name matches with the first word of that subdirectory. For example, if the software is downloaded to C:\Documents and Settings, then before you invoke setup.exe, ensure that there are no files titled Documents (for example, shortcut files such as C:\Documents) in the C:\ drive. After the installation ends successfully, the OMS and the Management Agent start automatically. If you do not want them to start automatically, then invoke the installer using the START_OMS=false and b_startAgent=false arguments. However, if you pass the START_OMS=false argument, the installation does not configure the EMCLI tool, and as a result, none of the EMCLI commands will work. Therefore, after the installation ends, you must manually configure the EMCLI tool in the $<ORACLE_HOME>/bin directory. To do so, refer to the Oracle Enterprise Manager Command Line Interface available at: http://www.oracle.com/technology/documentation/oem.html By default, GCDomain is the default name used for creating the WebLogic Domain. To override this, invoke the installer using the following command and specify a unique custom WebLogic Domain name: ./runInstaller WLS_DOMAIN_NAME=<Custom_Domain_Name>

   
   

2. Enterprise Manager Grid Control Installation Wizard appears. The wizard guides you through the installation process. Select the third installation type, that is, Upgrade to Enterprise Manager 11g .

   On the List of Oracle Homes screen, select the Enterprise Manager Grid Control (first OMS) or the additional OMS you want to upgrade. Specify the information required on each of the screens. Click Next on each screen until you reach the final screen. On the final screen, click Install to upgrade Enterprise Manager Grid Control.

   For information about the values you need to specify on each screen, follow the instructions outlined for upgrading Enterprise Manager Grid Control, in Oracle Enterprise Manager Grid Control Basic Installation Guide available at:

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

Install Add-Ons

After you upgrade the software binaries of Enterprise Manager Grid Control, follow these steps to install the 11g Release 1 add-ons:

1. Install the add-ons by running the following command from the Oracle home of the OMS:

   $<ORACLE_HOME>/oui/bin/runInstaller -noconfig

2. When the installer prompts you to specify the location of the products.xml file, specify the full path to the /Disk1/stage/ directory where the products.xml file is available. Ensure that the path leads up to the products.xml file. The /Disk1/stage/ directory is available in the add-on software you downloaded.

   For example, if you downloaded an add-on to /scratch/<AddOn_Name>/, then specify the path as /scratch/<AddOn_Name>/Disk1/stage/products.xml.

   
   

   Note: When you proceed with the installation, you will be prompted to select the add-on OMS component, the Oracle home of the OMS in which you want to install the add-ons. You will also be prompted to specify the Management Repository-related details.

   
   

After You Install Add-Ons

After you install the add-ons, log in as a root user in a new terminal and run the allroot.sh script from the Oracle home of the OMS:

$<ORACLE_HOME>/allroot.sh

Configure Enterprise Manager

To configure Enterprise Manager Grid Control, do the following:

1. If the environment variable PERL5LIB is set in your environment, then unset it.

2. Run the ConfigureGC.pl script from the Oracle home of the OMS (oms11g):

   $<ORACLE_HOME>/perl/bin/perl <ORACLE_HOME>/sysman/install/ConfigureGC.pl

Note: If any of the Configuration Assistants fail, then review the relevant log files, resolve the issues, and rerun the Configuration Assistants as described in What Do You Do When Configuration Assistants Fail?. To understand the optional arguments that can be passed with the ConfigureGC.pl script, see Appendix J, "Understanding Optional Arguments Run with ConfigureGC.pl Script".

After You Configure Enterprise Manager

After you configure Enterprise Manager Grid Control or an additional OMS, follow the steps outlined in After You Upgrade.