23 Upgrading Enterprise Manager System with Add-Ons Installed in Silent Mode

This chapter explains how you can use silent mode to 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:

Copy the following response file to an accessible location on your local host:

<Software_Location>/response/upgrade.rsp

In this command, <Software_Location> is either <DVD> or <Software_Downloaded_Location>.
Edit the response file:
- If you are upgrading Enterprise Manager Grid Control, then specify values for the mandatory parameters listed in Table 21-2.
- If you are upgrading an additional OMS, then specify values for the mandatory parameters listed in Table 21-3.

Invoke the installer:

./runInstaller -noconfig -silent -responseFile <absolute_path_to_location>/upgrade.rsp

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:

./runInstaller WLS_DOMAIN_NAME=<Custom_Domain_Name>

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:

Create a response file titled addon_oms.rsp with the following details:

RESPONSEFILE_VERSION=2.2.1.0.0
FROM_LOCATION=<absolute_path_to_products.xml>
DEINSTALL_LIST={"<add-on oms component name>","<add-on oms component version>"}
TOPLEVEL_COMPONENT={"<add-on oms component name>","<add-on oms component version>"}
ORACLE_HOME=<OMS OracleHome>
ORACLE_HOME_NAME=<name of the Oracle Home>
b_upgrade=false
EM_REPOS_DBA_PWD="<Repository SYS password>"
DATABASE_HOSTNAME=<Repository Host name>
LISTENER_PORT=<Repository Port>
SERVICENAME_OR_SID=<Repository SID>
b_silentInstall=true
ACCEPT_LICENSE_AGREEMENT=true

Run the following command from the Oracle home of the OMS and pass the response file to install the add-ons:

$<ORACLE_HOME>/oui/bin/runInstaller -noconfig -silent -responseFile <absolute_path_to_location>

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:

If the environment variable PERL5LIB is set in your environment, then unset it.
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.