[Troubleshooting] ADOP Prepare Phase: fs_clone failed while calling runPendingConfigClone subroutine

Oracle

Share Post Now :

HOW TO GET HIGH PAYING JOBS IN AWS CLOUD

Even as a beginner with NO Experience Coding Language

Explore Free course Now

Table of Contents

Loading

This post covers, Online Patching ADOP prepare phase issue reported by one of the trainees in Oracle EBS (R12) OAM/OID/OUD Integration Training where patch failed while running FS_Clone script in prepare phase.

Note: There are five phases in Online Patching (ADOP) in R12.2  PREPARE -> APPLY -> FINALIZE -> CUTOVER  -> CLEANUP .

  • To know more about Online Patching (ADOP) or for a FREE video on ADOP (new feature in EBS R12.2), check here 

Troubleshooting ADOP Prepare Phase Issue:

1. Run Prepare Phase:

Any Patching Cycle starts with Prepare Phase and to start its, run below command

adop phase=prepare

Prepare phase is failing with error message

[UNEXPECTED]fs_clone has failed.
        [UNEXPECTED]Error calling runPendingConfigClone subroutine.

2. Look at ADOP logs:

First thing in troubleshooting is to look at log file (in this case ADOP log file)

Note: Kindly refer this post to know more about log file location in R12.2 Oracle Apps R12.2 Log Files Location every Apps DBA must know

A) Error in adop logs: 

/u01/ oracle/ PRD122/ fs_ne/ EBSapps/ log/ adop/ 6/ prepare_20171109_032332/ PRD122_1705ecloud05/ log/ adop.log
Note: Here 
  • /u01/oracle/PROD is Oracle EBS install base directory
  • fs_ne Non-Editioned File System
  • 6 – adop session id
  • prepare_20171109_032332 – <phase>_<date>_<time>
  • PRD122_1705ecloud05 – CONTEXT NAME

Oracle Apps R12.2 has Dual File System (fs1 & fs2), which helps organizations to have less downtime during patching.  By introducing duplicate file system, Oracle has reduced patching downtime and improved availability of the system.

We can focus on three major parts of the E-Business Suite 12.2 file system:

  • File System 1 (fs1):  /u01/oracle/PROD/fs1
  • File System 2 (fs2):  /u01/oracle/PROD/fs2
  • Non-Editioned File System (fs_ne):  /u01/oracle/PROD/fs_ne
*******FATAL ERROR*******
PROGRAM : (/u01/oracle/PRD122/fs1/EBSapps/appl/ad/12.0.0/patch/115/bin/txkADOPPreparePhaseSynchronize.pl)
TIME    : Thu Nov  9 03:34:15 2017
FUNCTION: main::migrateCloneComponentApply [ Level 1 ] 
ERRORMSG: /u01/oracle/PRD122/fs1/EBSapps/comn/adopclone_1705ecloud05/bin/adclone.pl did not go through successfully.
 
[UNEXPECTED]Error occurred running “perl /u01/oracle/PRD122/fs1/EBSapps/appl/ad/12.0.0/patch/115/bin/txkADOPPreparePhaseSynchronize.pl -contextfile=/u01/oracle/PRD122/fs1/inst/apps/PRD12111_1705ecloud05/appl/admin/PRD12111_1705ecloud05.xml -patchcontextfile=/u01/oracle/PRD122/fs2/inst/apps/PRD12111_1705ecloud05/appl/admin/PRD12111_1705ecloud05.xml -promptmsg=hide -console=off -mode=migrate -sync_mode=copy -sessionid=6 -timestamp=20171109_032332 -outdir=/u01/oracle/PRD122/fs_ne/EBSapps/log/adop/6/20171109_032332/prepare/1705ecloud05”
        [UNEXPECTED]occurred during CONFIG_CLONE Patch File System from Run File System, running command: “perl /u01/oracle/PRD122/fs1/EBSapps/appl/ad/12.0.0/patch/115/bin/txkADOPPreparePhaseSynchronize.pl -contextfile=/u01/oracle/PRD122/fs1/inst/apps/PRD12111_1705ecloud05/appl/admin/PRD12111_1705ecloud05.xml -patchcontextfile=/u01/oracle/PRD122/fs2/inst/apps/PRD12111_1705ecloud05/appl/admin/PRD12111_1705ecloud05.xml -promptmsg=hide -console=off -mode=migrate -sync_mode=copy -sessionid=6 -timestamp=20171109_032332 -outdir=/u01/oracle/PRD122/fs_ne/EBSapps/log/adop/6/20171109_032332/prepare/1705ecloud05”.
        [PROCEDURE] [START 2017/11/09 03:34:15] Updating status of patches
        [STATEMENT] SQL statement : ”  update ad_adop_session_patches
  set status=’F’
  where applied_file_system_base = ‘/u01/oracle/PRD122/fs1’ and
  patch_file_system_base = ‘/u01/oracle/PRD122/fs2′ and bug_number=’CONFIG_CLONE’ and status <> ‘Y’
  and appltop_id=195 and node_name=’1705ecloud05′”
        [PROCEDURE] [END   2017/11/09 03:34:16] Updating status of patches
 [STATEMENT] SQL statement : ”  update ad_adop_session_patches
  set status=’F’
  where applied_file_system_base = ‘/u01/oracle/PRD122/fs1’ and
  patch_file_system_base = ‘/u01/oracle/PRD122/fs2′ and bug_number=’CONFIG_CLONE’ and status <> ‘Y’
  and appltop_id=195 and node_name=’1705ecloud05′”
        [PROCEDURE] [END   2017/11/09 03:34:16] Updating status of patches
        [UNEXPECTED]fs_clone has failed.
        [UNEXPECTED]Error calling runPendingConfigClone subroutine.

B) Error in fs_clone logs: 

Note: ADOP Prepare Phase, creates clone of Patch File System from Run File System and as per previous log, error was during this Cloning so we need to look at clone logs.

$INST_TOP/admin/log/clone/FSCloneApplyAppsTier_<timestamp>.log

/u01/ oracle/ PRD122/ fs2/ inst/ apps/ PRD12111_1705ecloud05/ admin/ log/ clone/ FSCloneApplyAppsTier_11230436.log

[Deployer:149034]An exception occurred for task [Deployer:149026]remove application accessgate on oaea_server1.: .Completed the undeployment of Application with status completed

Current Status of your Deployment:

Deployment command type: undeploy

Deployment State       : completed                                                                                        

Deployment Message     : [Deployer:149034]An exception occurred for task [Deployer:149026]remove application accessgate on oaea_server1.: .

******************************************************************************************************************************************

Deploying Application accessgate to targets oaea_server1

=============================================================

This Exception occurred at Thu Nov 23 04:54:56 EST 2017.

*****
weblogic.management.scripting.ScriptException: No file or directory found at the specified application path: /u01/oracle/PRD122/fs1/FMW_Home/Oracle_EBS-app1/applications/accessgate/fndauth.war

Error while deploying application accessgate

*****
Exiting WebLogic Scripting Tool.

<Nov 23, 2017 4:54:56 AM EST> <Warning> <JNDI> <BEA-050001> <WLContext.close() was called in a different thread than the one in which it was created.> 

.end std out.

.end err out.

Script Executed in 83454 milliseconds, returning status 1

ERROR: Failed to execute /u01/oracle/PRD122/fs1/EBSapps/appl/ad/12.0.0/patch/115/bin/adPostDomainCloneCfg.pl

Root Cause

As shown in FSCloneApplyAppsTier_<timestamp>.log above error was  while deploying application accessgate i.e. fndauth.war. (AccessGate is deployed for EBS-OAM Integration). On Patch Edition this

*****
weblogic.management.scripting.ScriptException: No file or directory found at the specified application path: /u01/oracle/PRD122/fs1/FMW_Home/Oracle_EBS-app1/applications/accessgate/fndauth.war

****

If you are in situation like this then look for keywords in My Oracle Support for known issues.

Fix

This is known bug and fix/workaround is to manually copy EBS Access Deployment file fndauth.war file from run Edition to Patch Edition (or Vice Versa, depending on where was EBSAccess Gate Deployed first)

1. Copy fndauth.war file from patch file system to run edition

cd /u01/ oracle/ PRD122/ fs2/ FMW_Home/ Oracle_EBS-app1/ applications/ accessgate
cp -R fndauth.war /u01/ oracle/ PRD122/ fs1/ FMW_Home/ Oracle_EBS-app1/ applications

2. Re-run prepare phase

Next Task For You

We cover Oracle E-Business R12.2 Architecture & concepts in our Oracle Apps DBA For Beginners Training along with the Installation, Patching, Cloning, and Troubleshooting and also, Database upgrade to 19c  and much more including the hands-on labs you must perform to upgrade your skills and get a good job with a high package.

Begin your journey towards becoming an Apps DBA by joining our FREE Masterclass on How To Learn Oracle Apps DBA (R12) & It’s New Features.

Picture of mike

mike

I started my IT career in 2000 as an Oracle DBA/Apps DBA. The first few years were tough (<$100/month), with very little growth. In 2004, I moved to the UK. After working really hard, I landed a job that paid me £2700 per month. In February 2005, I saw a job that was £450 per day, which was nearly 4 times of my then salary.