Installing and Upgrading the Oracle Application Management Pack for Oracle E-Business Suite

This chapter covers the following topics:

Introduction

The Oracle Application Management Pack for Oracle E-Business Suite extends Oracle Enterprise Manager 12c Cloud Control to help monitor and manage Oracle E-Business Suite systems more effectively. This plug-in integrates Oracle Applications Manager with Cloud Control to provide a consolidated, end-to-end Oracle E-Business Suite management solution. The plug-in can be used to manage both Oracle E-Business Suite Release 11i systems and Release 12 systems.

Supported Versions

For a list of supported versions, see My Oracle Support Knowledge Document 1954099.1, Getting Started with Oracle Application Management Pack for Oracle E-Business Suite, Release 12.1.0.4.0.

Prerequisites

For a list of prerequisites, see My Oracle Support Knowledge Document 1954099.1, Getting Started with Oracle Application Management Pack for Oracle E-Business Suite, Release 12.1.0.4.0.

Additional Instructions

Ensure that the following OS/User Group requirement has been met: It is recommended that the Oracle E-Business Suite OS user and the Enterprise Manager Agent OS user are the same. If they are different, then they must belong to the same OS group.

Downloading the Plug-in

You can download plug-ins in online or offline mode. Online mode refers to an environment where you have Internet connectivity and can download the plug-in directly through Enterprise Manager from My Oracle Support. Offline mode refers to an environment where you do not have Internet connectivity or where the plug-in is not available from My Oracle Support.

See the Managing Plug-ins chapter in the Oracle Enterprise Manager Cloud Control Administrator's Guide for details on downloading the plug-in in either mode:

http://docs.oracle.com/cd/E24628_01/doc.121/e24473/plugin_mngr.htm#CHDBGHFE

The following details of the Oracle E-Business Suite plug-in can be used for searching in the Self Update feature of the Enterprise Manager console:

Plug-in Name: Oracle E-Business Suite
Description: Enterprise Manager for Oracle E-Business Suite consists of System Management and Change Management Feature Sets	
Version: 12.1.0.4.0

Deploying the Plug-in

You can deploy the plug-in to an Oracle Management Service instance using the Enterprise Manager Cloud Control console, or using the EM Command Line Interface (EM CLI). While the console enables you to deploy one plug-in at a time, the command line interface mode enables you to deploy multiple plug-ins at a time, thus saving plug-in deployment time and downtime, if applicable.

See the "Managing Plug-ins" chapter in the Oracle Enterprise Manager Cloud Control Administrator's Guide for instructions on deploying the plug-in:

http://docs.oracle.com/cd/E24628_01/doc.121/e24473/plugin_mngr.htm#CJGCDHFG

Installing a Management Agent

A Management Agent must be present on all hosts containing targets that will be monitored/managed by the plug-in.

This step is required only if a Management Agent is not already present on a host containing targets to be managed.

See the "Installing Oracle Management Agents" chapter in the Oracle Enterprise Manager Cloud Control Basic Installation Guide for instructions on deploying a Management Agent to a host machine:

http://docs.oracle.com/cd/E24628_01/install.121/e22624/install_agent.htm

Discovering Targets

After the plug-in is deployed, targets that will be managed/monitored by the plug-in must be "discovered" by Enterprise Manager.

For information on discovery, see the chapter Discovering Oracle E-Business Suite with Cloud Control.

Metrics Collected by the Plug-in

See the Oracle Application Management Pack for Oracle E-Business Suite Metric Reference Manual.

Upgrading the Plug-in

The Self Update feature allows you to expand Enterprise Manager's capabilities by updating Enterprise Manager components whenever new or updated features become available. Updated plug-ins are made available through the Enterprise Manager Store, an external site that is periodically checked by Enterprise Manager Cloud Control to obtain information about updates ready for download. See the "Updating Cloud Control" chapter in the Oracle Enterprise Manager Cloud Control Administrator's Guide for steps to update the plug-in:

http://docs.oracle.com/cd/E24628_01/doc.121/e24473/self_update.htm#EMADM13221

Note that if you had installed the plug-in on an agent without a discovered Oracle E-Business Suite target, the plug-in will not be upgraded on that agent. For example, say in Release 4.0 you had installed the plug-in on an agent exclusively for performing check-in and check-out from source control for Customization Manager. There is no Oracle E-Business Suite target that is being monitored by this agent. During an upgrade to Release 12.1.0.4.0, this agent will not be upgraded to this latest release. You will have to upgrade this agent manually from the Oracle Management Service user interface.

Note: For a list of supported upgrade paths, refer to My Oracle Support Knowledge Document 1954099.1, Getting Started with Oracle Application Management Pack for Oracle E-Business Suite, Release 12.1.0.4.0.

Considerations for Cloning and Upgrades

Only Smart Clone procedures are supported in this release. As a prerequisite to running a Smart Clone procedure, the target Oracle E-Business Suite database must be cloned and discovered in the Enterprise Manager.

Clone transaction data created in previous releases will not be usable in this release. After you upgrade from an earlier release, the old cloning transactions will not be available.

Considerations for Patch Manager and Upgrades

Before upgrading from a prior release, you should ensure that all patching runs have completed or are in a state in which they are no longer being used. After the upgrade to Release 12.1.0.4.0, these old patch runs will no longer be visible in Patch Manager. For example, say you have a patch run in a "Pending Approval" or "Approved" state in Release 4.0. After you upgrade, you will not be able to use this patch run.

Considerations for Upgrading from Release 3.1 or 4.0

Note the following considerations and limitations for upgrades.

Deleting an Instance

If you are deleting an Oracle E-Business Suite instance after an upgrade, Oracle recommends you delete the retired targets associated with the instance. Delete these retired targets manually from the All Targets page before running discovery again later. The target types are:

Note: You must delete these manually in the current release. In a future release this deletion will be handled automatically.

Oracle also recommends that you delete the report associated with Oracle Applications Infrastructure Service. To do this, perform the following steps:

  1. From the Enterprise menu, select Reports/Information Publisher Reports.

  2. Search using the search term Target Type "Oracle Applications Infrastructure Service".

  3. From under Oracle Applications Dashboards/Oracle Applications Service Dashboards, select <Oracle E-Business Suite instance name>-Oracle Applications Infrastructure Service Dashboard and click the Delete button.

Properties in amp.properties file replaced by Preferences

The amp.properties file is obsolete with this release of the Oracle Application Management Pack for Oracle E-Business Suite.

The following properties are obsolete:

The following properties must be set manually in the Preferences page after the upgrade:

Security using Enterprise Manager Privileges and Roles

Oracle Application Management Pack for Oracle E-Business Suite now uses the native Enterprise Manager privileges and roles. As noted above, the amp.properties file is obsolete, so its security-related properties are no longer used. See Privileges and Roles for Managing Oracle E-Business Suite for more information on managing security.

Undeploying the Plug-in

See the "Managing Plug-ins" chapter in the Oracle Enterprise Manager Cloud Control Administrator's Guide for steps to undeploy the plug-in:

http://docs.oracle.com/cd/E24628_01/doc.121/e24473/plugin_mngr.htm#CJGEFADI