You are on page 1of 30

Application Tier Platform Migration with Oracle E-Business Suite

Release 12.2

Nemalipuri Shyam Sundar Rao (Senior Principal Engineer, EBS Release


Engineering)

10-Nov-2018
Copyright © 2018, Oracle and/or its affiliates. All rights reserved. |
Safe Harbor Statement
The following is intended to outline our general product direction. It is intended for
information purposes only, and may not be incorporated into any contract. It is not a
commitment to deliver any material, code, or functionality, and should not be relied upon
in making purchasing decisions. The development, release, and timing of any features or
functionality described for Oracle’s products remains at the sole discretion of Oracle.

Copyright © 2018, Oracle and/or its affiliates. All rights reserved. |


Program Agenda: Oracle E-Business Suite R12.2: Application
Tier Platform Migration

1 Overview
2 Prerequisite Tasks
3 Migration Tasks
4 Finishing Tasks
5 Key Takeaways

Copyright © 2018, Oracle and/or its affiliates. All rights reserved. | 4


Oracle E-Business Suite R12.2: Overview of
Application Tier Platform Migration

Copyright © 2018, Oracle and/or its affiliates. All rights reserved. | 5


Oracle E-Business Suite R12.2: Overview of Application Tier
Platform Migration
• Migrate an existing application tier server to any other Unix/Linux platform
certified for EBS 12.2.
• A quick way to move an existing EBS application tier to a different
Unix/Linux platform to utilize different hardware for the application tier.
• Retains the exact Oracle E-Business Suite patch level and configurations.
• Allows to retain most customizations.
• EBS Release level must be 12.2.3 or later.
• The application and database tier migrations are separate processes (Doc
ID 1377213.1)
– Database and Application tier migrations can be performed in 2 separate downtimes.
Copyright © 2018, Oracle and/or its affiliates. All rights reserved. | 6
Oracle E-Business Suite R12.2: Overview of Application Tier
Platform Migration
• Before you plan, understand that
–Migration methodology can be used if EBS Release level is 12.2.3 or
higher.
–Be at latest AD-TXK level
• for platform migration AD-TXK must be at minimum of Delta.7 level.
–Windows is only supported as a source platform.
–Migrate Platforms to single node and then scale up post migration as per
capacity planning.

Copyright © 2018, Oracle and/or its affiliates. All rights reserved. | 7


Oracle E-Business Suite R12.2: Application
Tier Platform Migration – Prerequisite Tasks

Copyright © 2018, Oracle and/or its affiliates. All rights reserved. | 8


Prerequisite Tasks
• Be at latest AD-TXK codelevel
– Source System must be on the supported AD-TXK code-level (Doc ID 1617461.1).
• Prepare Target System
– Target system must meet all the requirements listed in the Oracle E-Business Suite
Release Notes, Release 12.2 (Doc ID - 1320300.1), and in the Oracle E-Business Suite
Installation and Upgrade Notes (IUN) for the target platform.
• De-register Identity Management Components
– If Source System is integrated with Oracle Access Manager 11gR2 (11.1.2) and Oracle E-
Business Suite AccessGate, you must de-register the Identity Management components
before performing platform migration (Doc ID - 1614793.1).
• ETCC
– Run the EBS Technology Codelevel Checker (ETCC) on Database and Application Tier
(Doc ID - 1594274.1)

Copyright © 2018, Oracle and/or its affiliates. All rights reserved. | 9


Prerequisite Tasks
• If the Source System has FMW 11.1.1.6 installed, upgrade it to FMW 11.1.1.9
(Doc ID - 1590356.1).
– StartCD 12.2.0.51 installs Oracle Fusion Middleware 11gR1 (11.1.1.9)
• Autoconfig on Run File System
• AD Administration Task (adadmin): Maintain snapshot information
– Maintain Applications Files => Maintain snapshot information => Update current view
snapshot => Update Complete APPL_TOP
• Synchronize application tier file system (fs_clone)
– There must not be any active adop session.
• Run adpreclone on the application tier run file system (Doc ID 1383621.1).
• Shutdown application tier services.

Copyright © 2018, Oracle and/or its affiliates. All rights reserved. | 10


Oracle E-Business Suite R12.2: Application
Tier Platform Migration Tasks

Copyright © 2018, Oracle and/or its affiliates. All rights reserved. | 11


Migration Tasks: Generate & Upload Manifest
• Generate a manifest of platform dependent files specific to the customer
instance
–perl adgenpsf.pl (on Run File System)
–Manifest file: <APPL_TOP>/admin/<TWO_TASK>/out/adgenpsf.txt

• Generate files compatible to the target platform


– Launch https://updates.oracle.com/PlatformMigration
–select the value 'R12' from the 'Release' dropdown menu
–Upload manifest
–Email notification once patch with compatible files are available.

Copyright © 2018, Oracle and/or its affiliates. All rights reserved. | 12


Migration Tasks: Copy from Source to Target
• Copy the following directories from Run File System of Source to Run and
Patch File Systems of Target system:
– EBSapps/appl
– COMMON_TOP/clone
– COMMON_TOP/java
• Install the JDK and InfoZip utilities on the Target System run file system.
– JDK 1.6 or higher, in the JDK_HOME (refer IUN for the new platform).
– InfoZip UNZIP version 5.52 or higher.
– InfoZip ZIP version Zip 2.30 or higher.
• Create the <COMMON_TOP>/util directory on the patch file system.
• Copy Run File System’s context file from source to the Target System.

Copyright © 2018, Oracle and/or its affiliates. All rights reserved. | 13


Migration Tasks: Clone and Generate Context File (Run File
System)
• Copy the run file system pairsfile (<s_contextname>_run.txt) from
<INST_TOP>/appl/admin of the Source run file system to the Target run file
system.
– Modify the pairs file to match the target host details and target run file system.
– Add the context variable s_apps_jdbc_connect_descriptor, s_jdktop and
s_fmw_jdktop to the pairs file
• Generate Target System Run edition context file
– cd <COMMON_TOP>/clone/bin
– perl adclonectx.pl migrate java=<RUN JDK_TOP> pairsfile=<pairsfile>
contextfile=<Complete Path to Source System Context File Copied to Target System>
stage=<Clone Stage Location>

Copyright © 2018, Oracle and/or its affiliates. All rights reserved. | 14


Migration Tasks: Clone and Generate Context File (Patch File
System)
• Copy the patch file system pairsfile (<s_contextname>_patch.txt) from
<INST_TOP>/appl/admin of the Source patch file system to the Target patch
file system.
– Modify the pairs file to match the target host details and target patch file system.
– Add the context variable s_apps_jdbc_connect_descriptor, s_jdktop and s_fmw_jdktop
to the pairs file
• Generate Target System Patch edition context file
– cd <COMMON_TOP>/clone/bin
– perl adclonectx.pl java=<RUN JDK_TOP> contextfile=<Target System Run Context File>
pairsfile=<PATCH PAIRS FILE> stage=<CLONE STAGE LOCATION> outfile=<Complete Path
to Target System Patch Context File>

Copyright © 2018, Oracle and/or its affiliates. All rights reserved. | 15


Migration Tasks: Install Application Tier Technology Stack
• Use StartCD 12.2.0.51 (Patch 22066363 + Bundle 25525148) and latest media
pack for EBS on Oracle Software Delivery Cloud (Doc ID - 1320300.1)
• Rapid Install (with StartCD 51) installs FMW 11.1.1.9
• Run Rapid Install with the -techstack option
– This step will install the technology stack on both file systems.
– cd /StageR122/startCD/Disk1/rapidwiz
– Run#1: Install FMW Home
• ./rapidwiz –techstack
• Choose the option to install the Fusion Middleware 11g (10.3.6 WLS + 11.1.1.9 OHS)
– Run#2: Install 10.1.2 Oracle Home
• ./rapidwiz –techstack
• Choose the option to install the 10.1.2.3 Oracle Home

Copyright © 2018, Oracle and/or its affiliates. All rights reserved. | 16


Migration Tasks: Install and Configure Application Tier
Technology Stack
• Copy the <FMW_HOME>/Oracle_EBS-app1/applications directory from the
run file system of the Source System to the run file system of the Target
system.
• Autoconfig in setup phase on Run File System
– sh <AD_TOP>/bin/adconfig.sh contextfile=<CONTEXT_FILE> run=INSTE8_SETUP
• Complete Domain, OHS creations and FMW layout on the Run File System
– perl txkPlatformMigrationTasks.pl <RUN_CONTEXT_FILE>
• Run the Middle Tier EBS Technology Codelevel Checker (MT-ETCC).

Copyright © 2018, Oracle and/or its affiliates. All rights reserved. | 17


Migration Tasks: Apply customer-specific platform
migration patch
• Download and Unzip the platform migration patch (for the uploaded
manifest) into the $PATCH_TOP directory.
• Change the directory location to download area
– cd $PATCH_TOP/<patch_number>/ad/patch/115/etc
• Unzip the adpatchR12_AD_C.zip file and copy the corresponding adpatch
executable to the $AD_TOP/bin directory (refer README of
adpatchR12_AD_C.zip).
• Apply the patch
– adop phase=apply apply_mode=bootstrap preinstall=yes
patchtop=$PATCH_TOP/<patch_number>
– Executables will be relinked as part of above process.

Copyright © 2018, Oracle and/or its affiliates. All rights reserved. | 18


Migration Tasks: Cleanup nodes
• Cleanup nodes as applicable on Target System (if target machine name is
different)
– sh $INST_TOP/admin/install/afcpclean.sh <apps user> <apps password>
• Recreate the Node Configuration
– Source the database tier environment, and then run AutoConfig on the database
tier.
• sh <RDBMS_ORACLE_HOME>/appsutil/scripts/<CONTEXT_NAME>/adautocfg.sh
– Re-run AutoConfig on the run file system of the Target System application tier
• sh $AD_TOP/bin/adconfig.sh contextfile=<RUN_CONTEXT_FILE>

Copyright © 2018, Oracle and/or its affiliates. All rights reserved. | 19


Migration Tasks: Complete Target System Configuration
• Regenerate File system objects
– sh $AD_TOP/bin/adgensgn.sh <apps username>/<apps password>
• Apply relevant patches for third party products in bootstrap mode (Doc ID
2048954.1)
– ilog, RogueWave, Applications Shared Technology (SHT)
– adop phase=apply apply_mode=bootstrap preinstall=yes
• AD Administration (adadmin) Task
– Relink all applications programs
– Generate message files
– Generate form files
– Generate report files
– Generate product JAR files
– Reload JAR files to database

Copyright © 2018, Oracle and/or its affiliates. All rights reserved. | 20


Migration Tasks: Complete Target System Configuration
• Update ADOP repository tables with new appltop_id
– select APPL_TOP_ID from ad_appl_tops where name=<Source|Target APPL_TOP
name>;
– AD_ZD_FIXER.FIX_ADOP_REPO_TABLES(<SOURCE_APPLTOP_ID>,
<SOURCE_NODENAME>, <TARGET_APPLTOP_ID>, <TARGET_NODENAME>);
• Run Autoconfig on the Target system application tier
– On Run file system:
• sh $AD_TOP/bin/adconfig.sh contextfile=<RUN_CONTEXT_FILE>
– On Patch file system:
• sh $AD_TOP/bin/adconfig.sh contextfile=<PATCH_CONTEXT_FILE> -syncctx

Copyright © 2018, Oracle and/or its affiliates. All rights reserved. | 21


Oracle E-Business Suite R12.2 - Application
Tier Platform Migration: Post Migration
Tasks

Copyright © 2018, Oracle and/or its affiliates. All rights reserved. | 22


Finishing Tasks
• Update any third party extensions by applying the appropriate patches in
downtime mode to the Target System run file system.
• Review and update Target System application tier settings and
customizations.
• Update Printer settings.
• Update Oracle Workflow configuration settings.
• Verify the APPLCSF variable setting.
• Update the SESSION_COOKIE_DOMAIN value in ICX_PARAMETERS.
– If the Target System is in a different domain name from the Source System, and
SESSION_COOKIE_DOMAIN was not null in the Source System, update the value to
reflect the new domain name.

Copyright © 2018, Oracle and/or its affiliates. All rights reserved. | 23


Finally -

• Run fs_clone to synchronize the Target System run and patch file systems
– adop phase=fs_clone
– As application tier technology one-offs and patches are applied on the Run File
System, it is mandatory to run fs_clone to synchronize patch file system with the run
file system on the target system.
• Start all services on the Target System run file system.
• Scale up as per your capacity planning (Doc ID 1383621.1)

Copyright © 2018, Oracle and/or its affiliates. All rights reserved. | 24


Recap
• Business/Operations driven (as part of capacity planning, infrastructure tuning,
server support policy, etc.).
• A quick way to move an existing EBS application tier to a different Unix/Linux
platform to utilize different hardware for the application tier by retaining EBS
patch level, configurations and allowing you to retain many customizations.
• File system must be synchronized on source system; no active adop sessions.
• AD administration task to maintain snapshot is mandatory.
• Rapid install in techstack to be used for installing FMW 11.1.1.9 and 10.1.2.3
ORACLE_HOME.
• adop to be invoked after copying adpatch from platform migration patch.
• Platform migration patch to be applied in bootstrap mode.
• Patch File System to be synchronized with Run File System in the target system.
Copyright © 2018, Oracle and/or its affiliates. All rights reserved. | 25
Key Takeaways
• Perform as much of the migration as possible outside of the production
system downtime.
• Consider a shared application tier configuration if you plan to use multiple
application tiers.
• Platform Migration patch is customer environment specific.
– Do not use platform migration patch of one system for migrating platform for another
system as patch levels in the system may be different.
• Synchronize File systems as before (on source) and after application tier
platform migration (on target).
• Use latest StartCD.
– Refer to Oracle E-Business Suite installation guide to understand release versions of
components of application tier technology stack.
• Being on latest AD-TXK code-levels are recommended.
Copyright © 2018, Oracle and/or its affiliates. All rights reserved. | 26
Documentation
• Application Tier Migration with Oracle E-Business Suite Release 12.2 (Doc ID 2048954.1)
• Oracle E-Business Suite Upgrades and Platform Migration(Doc ID 1377213.1)
• Cloning Oracle E-Business Suite Release 12.2 with Rapid Clone (Doc ID 1383621.1)
• Applying the Latest AD and TXK Release Update Packs to Oracle E-Business Suite Release 12.2 (Doc ID
1617461.1)
• Oracle E-Business Suite Release Notes, Release 12.2 (Doc ID 1320300.1)
• Oracle E-Business Suite Release 12.2: Consolidated List of Patches and Technology Bug Fixes (Doc ID
1594274.1)
• Upgrading Oracle Fusion Middleware WebTier of Oracle E-Business Suite Release 12.2 to the latest 11gR1
(11.1.1.x) PatchSet‘ (Doc ID 1590356.1)
• Oracle E-Business Suite Release 12.2 Technology Stack Documentation Roadmap (Doc ID 1934915.1)
• Oracle E-Business Suite – Installation Guide: Using Rapid Install Release 12.2 (Part No - E22950)
• Oracle E-Business Suite – Setup Guide: Release 12.2 (Part No - E22953)
• Oracle E-Business Suite – Maintenance Guide: Release 12.2 (Part No - E22954)
Copyright © 2018, Oracle and/or its affiliates. All rights reserved. | 27
1

Copyright © 2018, Oracle and/or its affiliates. All rights reserved. |


Safe Harbor Statement
The following is intended to outline our general product direction. It is intended for
information purposes only, and may not be incorporated into any contract. It is not a
commitment to deliver any material, code, or functionality, and should not be relied upon
in making purchasing decisions. The development, release, and timing of any features or
functionality described for Oracle’s products remains at the sole discretion of Oracle.

Copyright © 2018, Oracle and/or its affiliates. All rights reserved. |

You might also like