9 Upgrading Foundation Pack

This chapter discusses how to upgrade Oracle Application Integration Architecture Foundation Pack 11g Release 11.1.1.4.0 or 11.1.1.5.0 to Foundation Pack 11g Release 1 11.1.1.6.0.

Note:

Oracle AIA Installer upgrades your existing version of Foundation Pack 11 g Release 11.1.1.4.0 or 11.1.1.5.0 to Foundation Pack 11 g 11.1.1.6.0. If you are using an AIA Foundation Pack release that is earlier than 11.1.1.4.0, first upgrade to release 11.1.1.4.0 or 11.1.1.5.0 using the respective upgrade guides and then upgrade to 11.1.1.6.0 using this guide.

This chapter includes the following sections:

Section 9.1, "Copying Foundation Pack 11g Release 1 (11.1.1.6.0) Files to AIA_HOME"
Section 9.2, "Update AIA Environment"
Section 9.3, "Running the EOL Upgrade Utility"
Section 9.4, "Running the Upgrade Script"

9.1 Copying Foundation Pack 11g Release 1 (11.1.1.6.0) Files to AIA_HOME

The section discusses the process for copying the Foundation Pack 11g Release 1 (11.1.1.6.0) files to AIA_HOME using the AIA Installer. To copy Foundation Pack 11g Release 1 (11.1.1.6.0) files:

9.1.1 Launch the Oracle AIA Foundation Pack Installer

To launch the Oracle AIA Foundation Pack Installer:

Download Foundation Pack 11g Release 1 (11.1.1.6.0).
Unzip the installer zip file.
Browse to <Installer_Unzip_Location>/aiafp/Disk1.

Follow the launch instructions for your platform. Table 9-1 lists the steps that must be used based on your platform.

Table 9-1 Commands to Launch Oracle AIA Foundation Pack Installer

Platform	To launch the Oracle AIA Foundation Pack Installer:
Linux Solaris SPARC HP-UX IBM AIX Based Systems	At the command line prompt, enter: ./runInstaller -invPtrLoc <Soa_Home>/oraInst.loc -jreloc <location of the jre specific to your operating system. This directory should have /bin/java>
Microsoft Windows	Double-click setup.exe

Platform

To launch the Oracle AIA Foundation Pack Installer:

Linux

Solaris SPARC

HP-UX

IBM AIX Based Systems

At the command line prompt, enter:

./runInstaller -invPtrLoc <Soa_Home>/oraInst.loc -jreloc 
<location of the jre specific to your operating system. 
This directory should have /bin/java>

Microsoft Windows

Double-click setup.exe

The Welcome screen is displayed.

9.1.2 Check Prerequisites

To confirm whether the prerequisites for upgrading AIA are met:

Review prerequisites in the Prerequisite Checks screen.
Click Next.

9.1.3 Specify Installation Location

To specify installation location:

Specify installation location in the AIA_Home field.
Select the AIA_INSTANCE that you want to upgrade in the AIA Instance Name for Upgrade field.
Click Next.

A warning message that says that a previous version is installed in the selected AIA_HOME is displayed. Click Yes and continue with upgrading your existing AIA_HOME to Foundation Pack 11g Release 1 (11.1.1.6.0).
Click Next.

9.1.4 Complete Copying Files

To complete copying the files:

Review the information on the Installation Summary screen.
Click Install to begin copying the files.

The system displays installation progress on the Install screen.
After copying the files, AIA Installer updates the inventory and AIAInstallProperties.xml with the latest version of Foundation Pack. The progress is displayed in Configuration Progess screen. This screen starts automatically after installer installs the Foundation Pack files.
Click Next.
Click Finish to close the AIA Foundation Pack Installer in the Installation Complete screen.

Note:

Installer takes a backup of $AIA_HOME/AIAMetaData under $AIA_HOME/AIAFPUpdates/Update_AIAFP111160/backup.

9.2 Update AIA Environment

To upgrade AIA environment:

Source aiaenv.sh from the <AIA_HOME>/aia_instances/<aia_instance>/bin.
Browse to <AIA_HOME>/AIAFPUpdates/Update_AIAFP111160/config folder.
Execute the following script

ant -f UpdateEnvironment.xml

9.3 Running the EOL Upgrade Utility

The Enterprise Object Library (EOL) Upgrade Utility upgrades the latest EOL with customizations made to the previous EOL.

After you run the upgrade, the EOL Upgrade Utility generates the following reports:

EOLMergeUtility_AutoLog_<TimeStamp>.log

Captures all automated (trivial) merges.
EOLMergeUtility_ManualActionLog_<TimeStamp>.log

Captures all conflicts and the manual actions the user must perform.
EOLMergeUtility_DetailedLog_<TimeStamp>.log

Captures a detailed merge report, including post-merge validations.

The reports are generated in a default location of ${AIA_INSTANCE}/logs/EOLUpgrade.

To generate these reports to a different directory, perform the following task before running the utility.

To define your own EOL Upgrade Utility report generation location:

Browse to the <AIA_HOME>/AIAFPUpdates/Update_AIAFP111160/config folder.
Open EOLUpgradeUtility.xml in edit mode.
Modify the last argument of the Java task to reflect the desired report generation location.
```
<arg value="<Desired Location of the Report>"/>
```

To run the EOL Upgrade Utility:

Foundation Pack recommends running the utility using the following two-step process.

Run the EOL Upgrade Utility in Report mode.

Reports are generated in the Report mode, and the utility does not do the actual merge. Refer to these reports to preview the changes that will happen when you run the utility in Upgrade mode.

After you run the utility in Report mode, perform all the changes suggested in the generated EOLMergeUtility_ManualActionLog_<TimeStamp>.log before running the utility in Upgrade mode.
1. Source aiaenv.sh from the <AIA_HOME>/aia_instances/<aia_instance>/bin.
  
  Note:
  You must source aiaenv.sh as the file has been updated during Section 9.2, "Update AIA Environment" and some environment variables must be set again.
2. Browse to the <AIA_HOME>/AIAFPUpdates/Update_AIAFP111160/config folder.
3. Execute the following script
```
ant -f EOLUpgradeUtility.xml report
```
Run the utility in Upgrade mode to perform the actual merge process.

If you have addressed the manual changes suggested in the EOLMergeUtility_ManualActionLog_<TimeStamp>.log report generated in step 1, the report should not contain any issues after running the utility in Upgrade mode. This indicates that the merge was completed successfully.
1. Access the <AIA_HOME>/AIAFPUpdates/Update_AIAFP111160/config folder.
2. Execute the following script:
```
ant -f EOLUpgradeUtility.xml upgrade
```

9.4 Running the Upgrade Script

If you are upgrading from Foundation Pack 11 g Release 1 (11.1.1.4.0) perform the following steps. If you are upgrading from Foundation Pack 11 g Release 1 (11.1.1.5.0) perform the steps from 4.

To run the upgrade script:

Browse to $AIA_INSTANCE/AIAMetaData/config.
Open the AIAConfigurationProperties.xml file in edit mode.

Search for the ModuleConfiguration with the name ErrorHandler and add the following property.

<Property name="EH.AIACOM_OFM_EXT.IMPL">oracle.apps.aia.industry.comms.eh.AIAOrderFalloutErrorHandlerExtension</Property>

Source aiaenv.sh from the <AIA_HOME>/aia_instances/<aia_instance>/bin.
Browse to <AIA_HOME>/AIAFPUpdates/Update_AIAFP111160/config folder.
Execute the following script:
```
ant -f UpdateAIAFP111160.xml
```
Note:
Because you are manually invoking the AIA Installation Driver (AID), you are prompted for an administrator username and password. Provide valid credentials.
Validate the upgrade.
1. Access the Oracle Enterprise Manager (http://<admin server hostname>:<admin port>/em /) and log in using the valid credentials.
2. Navigate to Farm. Expand Farm_soa_domain, SOA, soa infra in the left panel. Navigate to Deployed Composites in the main panel and verify that you can view the following composites:
  
  AIAB2BErrorHandlerInterface
  
  AIAB2BInterface
  
  ReloadProcess
  
  AIAAsyncErrorHandlingBPELProcess
  
  AIAReadJMSNotificationProcess
  
  AIAErrorTaskAdministrationProcess
3. Navigate to the AIA Home Page (http://<managed server hostname>:<managed server port number>/AIA/) and log in using valid credentials. Navigate to the Composite Application Validation System, Project Lifecycle Workbench, and the AIA setup pages. Verify that the UI tabs for each application are accessible.