DEV Community

Cover image for 🚀 Application Tier Platform Migration Oracle EBS R12.2.x
Jose Carlos Moreira (Deco)
Jose Carlos Moreira (Deco)

Posted on

🚀 Application Tier Platform Migration Oracle EBS R12.2.x

#linux #solaris #r12 #oracle

This guide details the full process for migrating the Application Tier (middle tier) of Oracle EBS R12.2.x to a new Unix/Linux platform while retaining the Database Tier unchanged.

🎯 Objective
To enable the relocation of an Oracle EBS Application Tier to a different platform (Unix/Linux), maintaining:

Current patch levels
Customizations
Database untouched
This strategy simplifies migration and ensures stability by retaining technology stack consistency.

✅ Requirements & Restrictions
Only valid for Oracle EBS 12.2.3 or higher
Migration covers Application Tier only (Database remains)
Single-node target required initially (more nodes can be added post-migration)
Only Unix/Linux platforms supported as target
Source must be at AD-TXK Delta 7 or higher
FMW version 11.1.1.9 is mandatory

  1. 🛠️ Source System Preparation

Step-by-step:
Verify Active File System

echo $FILE_EDITION   # should return "run"
Enter fullscreen mode Exit fullscreen mode
  1. Apply Required Patches 
adop phase=apply patches=21255247,22391154 apply_mode=hotpatch 
adop phase=apply patches=22259926 apply_mode=hotpatch
Enter fullscreen mode Exit fullscreen mode
  1. Run AutoConfig 
sh $AD_TOP/bin/adconfig.sh contextfile=<RUN_CONTEXT_FILE>
Enter fullscreen mode Exit fullscreen mode
  1. Run adpreclone 
cd $INST_TOP/admin/scripts perl adpreclone.pl appsTier
Enter fullscreen mode Exit fullscreen mode
  1. Update Snapshot via AD Administration 
Menu: 
Maintain Applications Files
   → Maintain Snapshot Information 
       → Update Current View Snapshot 
            → Update Complete APPL_TOP
Enter fullscreen mode Exit fullscreen mode
  1. Shut Down Application Tier Services 
adstpall.sh apps/apps
Enter fullscreen mode Exit fullscreen mode
  1. Capture Tech Stack Patch Inventory 
perl $FND_TOP/patch/115/bin/TXKScript.pl \ 
-script=$FND_TOP/patch/115/bin/txkInventory.pl \ 
-txktop=$APPLTMP -contextfile=$CONTEXT_FILE \ 
-appspass=<apps password> -outfile=$APPLTMP/Report_Inventory.html
Enter fullscreen mode Exit fullscreen mode
  1. 🔄 Migration Execution (Target System)

8.1 Generate & Upload Customization Manifest

cd $AD_TOP/bin
perl adgenpsf.pl
Upload adgenpsf.txt at: https://updates.oracle.com/PlatformMigration
Enter fullscreen mode Exit fullscreen mode

8.2 Copy Files from Source (run and patch file systems)
Copy the following:

* $EBSapps/appl

* $COMMON_TOP/clone

* $COMMON_TOP/java
Enter fullscreen mode Exit fullscreen mode

8.3 Install Prerequisites
Install on Target system:

* JDK 1.6+ (<COMMON_TOP>/util/jdk32 or jdk)

* InfoZip tools: zip ≥ 2.30, unzip ≥ 5.52
Enter fullscreen mode Exit fullscreen mode

8.4 Clone Application Context
Generate run context file:

cd $COMMON_TOP/clone/bin
perl adclonectx.pl migrate java=<JDK_TOP> pairsfile=<RUN_PAIRSFILE> contextfile=<SOURCE_CONTEXT_FILE> stage=<STAGE_DIR>
Generate patch context file:

perl adclonectx.pl java=<JDK_TOP> pairsfile=<PATCH_PAIRSFILE> contextfile=<RUN_CONTEXT_FILE> stage=<STAGE_DIR> outfile=<PATCH_CONTEXT_FILE>

Update values:

s_jdktop, s_fmw_jdktop, s_apps_jdbc_connect_descriptor
Enter fullscreen mode Exit fullscreen mode

8.5 Install Tech Stack Using Rapid Install
Run buildStage:

cd /u01/StageR122/startCD/Disk1/rapidwiz/bin
./buildStage.sh
Run Rapid Install (twice):

cd /u01/StageR122/startCD/Disk1/rapidwiz
./rapidwiz -techstack   # FMW install
./rapidwiz -techstack   # 10.1.2 ORACLE_HOME install
Enter fullscreen mode Exit fullscreen mode

8.6 Configure Target System
Run AutoConfig Setup Phase:


sh $AD_TOP/bin/adconfig.sh contextfile=<RUN_CONTEXT_FILE> run=INSTE8_SETUP
Run Platform Migration Tasks:
Enter fullscreen mode Exit fullscreen mode 

cd $AD_TOP/patch/115/bin
perl txkPlatformMigrationTasks.pl <RUN_CONTEXT_FILE>
Enter fullscreen mode Exit fullscreen mode

8.7 Apply Custom Migration Patch

Unzip patch and override adpatch:
unzip adpatchR12_AD_C.zip cp adpatch $AD_TOP/bin/

. Apply patch:

adop phase=apply apply_mode=bootstrap preinstall=yes patchtop=$PATCH_TOP/<patch_number>
Enter fullscreen mode Exit fullscreen mode

8.8 Cleanup and AutoConfig Execution
Run cleanup:
Enter fullscreen mode Exit fullscreen mode

cd $INST_TOP/admin/install
sh ./afcpclean.sh apps apps
Run AutoConfig on DB tier:

sh $RDBMS_ORACLE_HOME/appsutil/scripts//adautocfg.sh
Re-run AutoConfig on Apps:

sh $AD_TOP/bin/adconfig.sh contextfile=
Enter fullscreen mode Exit fullscreen mode

8.9 Regenerate and Relink
Generate Signature and Compile:


cd $AD_TOP/bin
sh ./adgensgn.sh apps/apps
adadmin  # Compile forms, reports, messages, JARs, relink
Enter fullscreen mode Exit fullscreen mode

8.10 Bug Fix (if needed — Bug 21212865)

begin
  AD_ZD_FIXER.FIX_ADOP_REPO_TABLES(<SRC_APPLTOP_ID>, <SRC_NODENAME>, <TGT_APPLTOP_ID>, <TGT_NODENAME>);
end;
Enter fullscreen mode Exit fullscreen mode

8.11 Sync Patch FS with Run FS

adop phase=fs_clone
Enter fullscreen mode Exit fullscreen mode

8.12 Start All Services

cd $INST_TOP/admin/scripts
./adstrtal.sh apps/apps
Enter fullscreen mode Exit fullscreen mode
  1. 🧾 Post-Migration Tasks Apply third-party library patches: 
iLog: Patch 10135606
RogueWave: Patch 10135608
SHT: Patch 10135610
Recompile custom code and extensions
Update:
Printer settings
Workflow URLs (WF_*, FND_*)
APPLCSF variable
SESSION_COOKIE_DOMAIN in ICX_PARAMETERS
Enter fullscreen mode Exit fullscreen mode

📚 Additional Documentation
[Doc ID 1383621.1] — Cloning R12.2 with Rapid Clone
[Doc ID 1320300.1] — EBS 12.2 Release Notes
[Doc ID 1594274.1] — EBS Technology Codelevel Checker (ETCC)

📚 Thank you for reading!
I’m passionate about sharing real-world experiences in Oracle General, Oracle Cloud, Database Optimization, IT Innovation, and Enterprise Solutions.

🚀 Follow me here to stay updated with new articles, best practices, and actionable insights. Let’s grow together in the world of technology!

Top comments (0)