Installation Procedures

Download the Oracle Application Management Pack for Oracle E-Business Suite Patch 8333939 from My Oracle Support to the Enterprise Manager Oracle Management Server.

The Oracle Application Management Pack for Oracle E-Business Suite is installed using Oracle Universal Installer. To install this pack, you must have an existing Grid Control installation. The pack must be installed into each existing Grid Control Management Service and Management Agent that will be used for Oracle E-Business Suite.

Note: When installing patch 8333939, the oraInst.loc must point to an oraInventory with correct permissions for the user that is running the installer.

Note: Rollback of patches is not supported.

Important: Uninstalling Oracle Application Management Pack for Oracle E-Business Suite and Oracle Application Change Management Pack for Oracle E-Business Suite (ACP) Release 3.1 is not supported. Please back up the Enterprise Manager repository before applying AMP/ACP Release 3.1. Please contact Enterprise Manager Grid Support if you need more clarification on the backup procedure.

Running Oracle Universal Installer

Please follow these steps to run Oracle Universal Installer.

Set up the Provisioning Frameworks Software library as mentioned in the Getting Started Guide for Oracle Application Management Pack for Oracle E-Business Suite, My Oracle Support Knowledge Document 982302.1.
Stop all the Management Services before installing the pack to a Management Service. Management Services will be restarted automatically after the pack has been installed.
1. Stop the OMS.
```
$PROMPT> $ORACLE_HOME/bin/emctl stop oms 
```
```
$PROMPT> $ORACLE_HOME/bin/emctl stop iasconsole 
```
```
$PROMPT> $ORACLE_HOME/opmn/bin/opmnctl stopall 
```
```
$PROMPT> AGENT_HOME/bin/emctl stop agent 
```
```
Select count(*) FROM dba_jobs_running run_job; gv$session sess WHERE sess.sid = run_job.sid AND sess.schemaname = 'SYSMAN' 
```
Note: If your EM Repository (EM Database) is on the same machine, it must be left running. Only OMS and Agent services need to be taken down.
```
 export ORACLE_HOME=/d1/oracle/em10g/oms10g
```
```
 /Disk1/runInstaller
```
Install Grid Control Extensions for Enterprise Manager Repository and Management Service

To install Grid Control Extensions for Enterprise Manager Repository and Management Service

Please follow these steps to install Grid Control Extensions for Enterprise Manager Repository and Management Service.
1. Specify the product to install. Choose Grid Control Plug-in for Oracle E-Business Suite Management Pack 3.1.0.0.0 and click Next to continue.
2. Specify Oracle Home (of Management Service) details. The Application Management Pack must be installed into each existing Grid Control Management Service and Repository. To perform this installation, begin by choosing the name and location of the Oracle Home of the Management Service into which you want to install the plug-in. Once you have properly chosen the name and location of the Management Service’s Oracle Home, click Next to continue.
3. Specify Repository Database Connection details. You will be prompted to enter the password for the SYS user account in the Enterprise Manager Repository database. After you enter the password, click Next to continue. Note: When installing the management pack in a Grid Control environment in which the Management Repository was not a new database created by the Grid Control installer, you may see the connect string blanked out in the Universal Installer. This is a known display-only limitation and does not prevent successful installation of the management pack.
4. View the Install Summary. The next page will present a summary of what will be installed. Click Install to continue with the installation.
5. View the progress of the installation. You can then view the progress of the installation in the Install window. Once all of the installation steps have completed, the Configuration Assistants window will display automatically.
6. View the Configuration Assistants (Upgrade and Restart Service). The configuration assistants will complete the upgrade of the Grid Control Repository and restart the Management Service. You can view the progress of the configuration assistants in this window.
7. End of Installation. Once the installation is complete, click Exit to end your session.
Post-install Steps for the OMS tier

Note: The following steps need to be repeated as appropriate in the case of multi-OMS tier configurations.
1. Copy Apache POI 3.2 Libraries to the OMS tier. The Application Change Management Pack for Oracle E-Business Suite's Setup Manager product has a dependency on Apache POI 3.2 libraries. Download the Apache POI libraries from http://archive.apache.org/dist/poi/release/bin/poi-bin-3.2-FINAL-20081019.zip and unzip the content to copy the poi-3.2-FINAL-20081019.jar to /j2ee/OC4J_EM/applications/em/em/WEB-INF/lib location.
2. Stop all the Management Services.
  1. Stop the OMS.
```
$PROMPT> $ORACLE_HOME/bin/emctl stop oms 
```
```
$PROMPT> $ORACLE_HOME/bin/emctl stop iasconsole
```
```
$PROMPT> $ORACLE_HOME/opmn/bin/opmnctl stopall 
```
```
$PROMPT> $ ORACLE _HOME/bin/emctl start oms
```
  Installing the Management Agent Plug-in
  
  Download patch 8333939 to your Oracle Enterprise Manager (EM) Agent host.
  
  Please follow these instructions to install the Management Agent Plug-in.
  
  Running Oracle Universal Installer
  
  Please follow these steps to run Oracle Universal Installer.
```
export ORACLE_HOME=/d1/oracle/em10g/agent10g
```
```
/Disk1/runInstaller
```
  Installing the Management Agent Plug-in
  
  Please follow these steps to install Management Agent Plug-in.
  1. Specify the product to install. Begin the installation of the Management Agent Plug-in by running the Oracle Universal Installer (as described in Running Oracle Universal Installer) on the respective host. Choose the Management Agent Plug-In for Oracle E-Business Suite Management Pack 3.1.0.0.0 option to install the Management Agent plug-in. Click Next to continue.
  2. Specify the Agent’s Oracle Home details. Next choose the correct name and location of the Oracle Home of the EM Agent into where you want to install the plug-in. Click Next to continue with the installation.
  3. View the Install Summary. The next page will present a summary of what will be installed. Click Install to continue with the installation.
  4. View the progress of the installation. You can then view the progress of the installation in the Install window. Once all of the installation steps have completed, the Configuration Assistants window will display automatically.
  5. View the Configuration Assistant (Stop and Start Agent). The configuration assistants will stop and restart the agent for you. You can monitor their progress in this window.
  6. End of Installation. Once the installation is complete, click Exit to end your installation.
  Silent Installation of the Management Agent Plug-in
  1. Unzip the p8333939_31_LINUX.zip file
  2. Modify the template by substituting with correct values in the oracle.apps.agent_extn.Custom.rsp template located under Disk1/stage/Response
  3. Run the installer using the command
```
/Disk1/runInstaller -silent -responseFile Disk1/stage/Response/oracle.apps.agent_extn.Custom.rsp 
```

Installation Procedures

Running Oracle Universal Installer

Install Grid Control Extensions for Enterprise Manager Repository and Management Service

Installing the Management Agent Plug-in