Oracle Application Management Pack for Oracle E-Business Suite (AMP) extends Enterprise Manager (EM) 12c Cloud Control to help monitor and manage an Oracle E-Business Suite system more effectively.
This pack can be used to manage both Oracle E-Business Suite Release 12 and Release 11i systems.
This pack is available for fresh installations; that is, you do not need to have a version of the pack installed before installing this version.
For customers considering upgrades from versions of Oracle Application Management Pack for Oracle E-Business Suite already installed (possibly with Oracle Change Application Management Pack for Oracle E-Business Suite, or ACP), upgrade paths are provided from the following:
Enterprise Manager Grid Control 10.2.0.5 with AMP-ACP 3.1 installed
Enterprise Manager Grid Control 11gR1 with AMP-ACP 4.0 installed
Enterprise Manager Cloud Control 12c with AMP 12.1.0.1.0 installed
This release of Oracle Application Management Pack for Oracle E-Business Suite requires Oracle Enterprise Manager Cloud Control Release 12c 12.1.0.3 (also known as PS2).
This chapter describes the system requirements and installation of this new pack for Cloud Control.
Important: Uninstalling Oracle Application Management Pack for Oracle E-Business Suite is not supported. Please back up the Enterprise Manager repository before applying this management pack. Please contact Enterprise Manager Support if you need more clarification on the backup procedure.
Ensure that the following requirement has been met:
OS/User Group Requirement: It is recommended that the Oracle E-Business Suite OS user and the Enterprise Manager Agent OS user is the same. If they are different, then they must belong to the same OS group.
Before continuing with the installation as outlined below, please read and become familiar with the known limitations as described later in this manual. These limitations are typically minor to most Oracle E-Business Suite Release 12 and Release 11i administrators; however, they might be of concern to longtime users of Oracle Enterprise Manager who are new to using the Oracle Application Management Pack for Oracle E-Business Suite.
The following are prerequisites for installation:
Install Enterprise Manager Cloud Control.
Discover the Oracle E-Business Suite host.
Set up Software Library in Enterprise Manager. For more information on configuring Software Library, refer to: Oracle Enterprise Manager Cloud Control Administrator's Guide.
Apply any additional prerequisite patches as described in "Getting Started with Oracle Application Management Pack for Oracle E-Business Suite, Release 12.1.0.2.0", My Oracle Support Knowledge Document 1532970.1.
Important: The database plug-in must be deployed on the application nodes that have been configured to run the Applications listener so that metric collection can occur. The Applications listener target type is part of the database plug-in, so the database plug-in must be deployed on the same node(s).
Note: Unlike in a previous release, you do not need to install the Fusion Middleware plug-in on the agent. Installation will occur in the background during discovery.
For details on deploying the Oracle Application Management Pack for Oracle E-Business Suite on the Oracle Management Server (OMS) and the platform agents, see Oracle Enterprise Manager Cloud Control Administrator's Guide.
Note: Enterprise Manager 12c introduces a new tool and methodology to deliver and install plug-ins, called the Enterprise Manager Store (EM Store). 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. The Self Update feature allows customers to expand Enterprise Manager's capabilities by updating Enterprise Manager components whenever new or updated features become available. For more details on the EM Store, and the Self Update feature, see Oracle Enterprise Manager Cloud Control Administrator's Guide,
Unlike in a previous release, you do not need to install the Oracle E-Business Suite plug-in on the agent. Installation will occur in the background during discovery. However, you must manually deploy the Oracle E-Business Suite plug-in on the agent that is used to check out files for Customization Manager.
To upgrade the Oracle Application Management Pack for Oracle E-Business Suite, use the generic procedure described in Oracle Enterprise Manager Cloud Control Upgrade Guide. This procedure applies to upgrading from Release 3.1, 4.0, or 12.1.0.1.0.
The software is available from Oracle Technology Network at http://www.oracle.com/technetwork/oem/grid-control/downloads/oem-upgrade-console-502238.html under the section "Download Plug-ins".
Note: Please ensure that in the upgrade process you change the software file type to ".opar" if it is ".zip".
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 3.1 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.2.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.
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.
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.2.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.
Note the following considerations and limitations for upgrades.
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:
Oracle E-Business Suite System
Oracle Applications Infrastructure Service
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:
From the Enterprise menu, select Reports/Information Publisher Reports.
Search using the search term Target Type "Oracle Applications Infrastructure Service".
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.
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:
ebs_acp_packAccessEnabled
enableRoleBasedSecurity
enableApproval_CM
enableApproval_AZ
enableApproval_PM
targetLevelPrivilegeForApproval
The following properties must be set manually in the Preferences page after the upgrade:
stageDir (Stage Directory) - This property/preference is used by Customization Manager and specifies the OMS stage directory for package creation.
ampCloneApplTopParallelThreads (Number of threads to be used while zipping, transferring, and unzipping the files under APPL_TOP of Apps Tier. Max value 16)
ampCloneToolsParallelThreads (Number of threads to be used while zipping, transferring, and unzipping the files under Tools home of Apps Tier. Max value 8)
ampCloneWebParallelThreads (Number of threads to be used while zipping, transferring, and unzipping the files under Web home of Apps Tier. Max value 4)
ampCloneCommonTopParallelThreads (Number of threads to be used while zipping, transferring, and unzipping the files under COMMON_TOP of Apps Tier. Max value 4)
um_dashboard_no_of_rows (Number of Rows in tables of User Monitoring)
um_session_sampling_interval (Sampling Interval for User Monitoring)
omsPatchStageDir (OMS Stage Directory Location)
MOSEnabled/metalinkEnabled (Connect to My Oracle Support for Patches)
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.