Search Blog Post

Friday, May 30, 2014

RC-50013: Fatal: Instantiate driver did not complete successfully


Problem:
While cloning recently upgraded EBS environment from 11.5.10.2 to R12.1.3 using Rapid Clone with dbTechStack option, the following error occurs:
RC-50013: Fatal: Instantiate driver did not complete successfully

Contents of log file:
[AutoConfig Error Report]
The following report lists errors AutoConfig encountered during each
phase of its execution.  Errors are grouped by directory and phase.
The report format is:
      <filename>  <phase>  <return code where appropriate>
  [APPLY PHASE]
  AutoConfig could not successfully execute the following scripts:
    Directory: /clone/oracle/product/11.2.0/perl/bin/perl -I /clone/oracle/product/11.2.0/perl/lib/5.8.3 -I /clone/oracle/product/11.2.0/perl/lib/site_perl/5.8.3 -I /clone/oracle/product/11.2.0/appsutil/perl /clone/oracle/product/11.2.0/appsutil/clone
      ouicli.pl               INSTE8_APPLY       255
AutoConfig is exiting with status 1
RC-50013: Fatal: Instantiate driver did not complete successfully.
/clone/oracle/product/11.2.0/appsutil/driver/regclone.drv

Cause:
As the log file states that autoconfig failed as it could not execute the following perl script "ouicl.pl"
The possible reason could be:
1.     Either the script is not found at the location
2.     If the script is present, try to run the script manually.
3.     If it fails with the same error then the perl program "ouicli.pl" is unable to locate the JDK installation.

Solution:
·         If the script "ouicli.pl" is not found under clone directory, I would suggest to copy appsutil from source to target system and unzip appsutil under <ORACLE_HOME>
            $ unzip -o appsutil.zip
·         Check if the JDK/JRE installed under the "<RDBMS ORACLE_HOME>/appsutil/jre/bin" directory. If there is no "java" under "<RDBMS ORACLE_HOME>/appsutil/jre/bin", you will need to replace the "jre" directory and all sub-directories with a full JDK/JRE installation. Generally, you can find this under "$ORACLE_HOME/jdk"
                        $ cp -r $ORACLE_HOME/jdk/ $ORACLE_HOME/appsutil/jre/
·         Now check  that the java" executable under "<RDBMS ORACLE_HOME>/appsutil/jre/bin" is working fine.
·         If the java executable is working fine, make sure it is referenced directly in the Context File for DB tier. Check it with the below command:
                        $ cd $ORACLE_HOME/appsutil
                        $ grep s_adjvaprg <CONTEXT_NAME>.xml
                                    <ADJVAPRG oa_var="s_adjvaprg" osd="UNIX">/<ORACLE_HOME>/appsutil/jre/bin/java</ADJVAPRG>
·         Again run the cloning process,
                        perl adcfgclone.pl dbTechStack
                                    ApplyDatabase Completed Successfully.

References:
Rapidwiz 12.1.1 Fails To Execute Ouicli.Pl During Apps 10.1.3 Techstack Autoconfig (Doc ID 1328464.1)
Rapid Clone Ouicli.pl Fails: "Finished OUI CLI cloning for s_db_oh with return code: 16777215" (Doc ID 802464.1)
OUICLI.PL Fails While Running Adcfgclone On Oracle EBS R12 If Global Inventory Does Not Exist (Doc ID 458653.1)

HTH
Thanks for reading ..!!
Any suggestions or enhancements are most welcome.

RC-00110: Fatal: Error occurred while relinking of ApplyDBTechStack

Problem:
I faced the following error while cloning one of our recently upgraded EBS version from 11.5.10 to 12.1.3
RC-00110: Fatal: Error occurred while relinking of ApplyDBTechStack

The contents of log file shows:
Executing script in InstantiateFile:
/app/TEST/testdb/11.2.0/perl/bin/perl -I /app/TEST/testdb/11.2.0/perl/lib/5.8.3 -I /app/TEST/testdb/11.2.0/perl/lib/site_perl/5.8.3 -I /app/TEST/testdb/11.2.0/appsutil/perl /app/TEST/testdb/11.2.0/appsutil/clone/ouicli.pl
script returned:
****************************************************
.end std out.
Perl lib version (5.10.1) doesn't match executable version (v5.10.0) at /usr/lib64/perl5/Config.pm line 50.
Compilation failed in require at /app/TEST/testdb/11.2.0/appsutil/clone/ouicli.pl line 35.
BEGIN failed--compilation aborted at /app/TEST/testdb/11.2.0/appsutil/clone/ouicli.pl line 35.
.end err out.

Cause:
The log file clearly states that issue is due to mismatch of perl lib version with executable version on database tier

Solution:
The temporary fix would be to set the correct version of PERL5LIB environment variable on the Database tier
First check the value of PERL5LIB variable on source system(let's say PROD) and then set the same value of PERL5LIB variable on target system(let's call it TEST).
In my case, the value was set to '5.10.0'. So the variable 'PERL5LIB' on the 11gR2 database tier (target system) needs to be set as follows:
            export PERL5LIB=<ORACLE_HOME>/perl/lib/5.10.0:<ORACLE_HOME>/perl/site_perl/5.10.0:<ORACLE_HOME>/appsutil/perl

To set the value of the context variable s_perl5lib in the Database tier context file and update the PERL5LIB value in the Database tier environment file as well.
         Run AutoConfig on the Database tier using adconfig.pl script as follows:
1.     perl <ORACLE_HOME>/appsutil/bin/adconfig.pl contextfile=<CONTEXT_FILE>

The permanent fix for the above issue is to modify the correct perl version in file adxdbctx.tmp under:
            <ORACLE_HOME>/appsutil/clone/context/db
            <ORACLE_HOME>/appsutil/template

Again run the cloning process,
            perl adcfgclone.pl dbTier
                 ApplyDatabase Completed Successfully.

Check perl5lib version in context file under <ORACLE_HOME>/appsutil/<CONTEXT_NAME>.xml   -- {CONTEXT_NAME = hostname_SID}
If it shows 5.8.3 then stop the database  and application, modify the per5lib value 5.8.3 to 5.10.0 in XML file.
Start database and listener
Ran autconfig on DB Tier
Start application
Run autoconfig on Apps Tier
adpreclone.pl on db tier and apps tier.

References:
Rapid Clone Error : 11gR2 Database : Perl lib Version (v5.8.5) Doesn't Match Executable Version (v5.10.0) [ID 1276455.1]
Adpreclone Failed With Perl Lib Version (V5.8.3) Doesn'T Match Executable Version (V5.8.5) [ID 1166201.1]

Note: Please make sure to apply the latest AutoConfig and Rapid Clone patches on R12 instance.

HTH
Thanks for reading ..!!
Any suggestions or enhancements are most welcome.