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

Introduction to Installation

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

This release of Oracle Application Management Pack for Oracle E-Business Suite requires Oracle Enterprise Manager Cloud Control Release 12c.
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.


Note: This document typically uses UNIX syntax. If using MS Windows, substitute the appropriate Windows syntax.


System Requirements
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.


Installing the Oracle Application Management Pack for Oracle E-Business Suite
The following are prerequisites for installation:

1. Install Enterprise Manager Cloud Control.
   
2. Discover the Oracle E-Business Suite host and install a Management Agent on that Oracle E-Business Suite host.
   
3. Deploy the Fusion Middleware plug-in on all application nodes that run the web tier. This step is necessary for Oracle E-Business Suite discovery to work correctly.
   
   1. From the Enterprise Manager Cloud Control Setup menu, select Extensibility, then Plug-ins.
      
   2. Select Oracle Fusion Middleware in the Plug-ins table. Select Deploy On and then select Management Agent.
   See Oracle Enterprise Manager Cloud Control Getting Started with Oracle Fusion Middleware Management for more information.
   
4. Set up Software Library in Enterprise Manager. For more information on configuring Software Library, refer to: Oracle Enterprise Manager Cloud Control Administrator's Guide.
   
5. If the RDBMS version of the OMS database is 11.2.0.2.0 or greater, then apply RDBMS Server patch 12965899 on the OMS database before installing the Oracle E-Business Suite plug-in.
   
6. Apply any additional prerequisite patches as described in "Getting Started with Oracle Application Management Pack for Oracle E-Business Suite, Release 12.1.0.1.0", My Oracle Support Knowledge Document 1434392.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).


Installing and Deploying the Oracle Application Management Pack for Oracle E-Business Suite
For details on deploying platform agents, see the chapter on installing Oracle Management Agent in Oracle Enterprise Manager Cloud Control Basic Installation Guide.
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,


Upgrading the Oracle Application Management Pack for Oracle E-Business Suite
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.
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".


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:

• 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:

1. From the Enterprise menu select Report/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.

Special Considerations for Upgrades
Note the following considerations and limitations for upgrades.

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:

• 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)
  
• containerTableMaxRows
  
• 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)

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.


Cloning Considerations
Only Smart Clone procedures are supported in this release.
Clone transaction data created in previous releases will not be operable in this release.