Friday, February 10, 2017

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

Problem:

While cloning recently upgraded EBS environment from [Release 11 to 12.1]
 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/12101/perl/bin/perl -I /clone/oracle/product/12101/perl/lib/5.14.1 -I /clone/oracle/product/12101/perl/lib/site_perl/5.14.1 -I /clone/oracle/product/12101/appsutil/perl /clone/oracle/product/12101/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/12101appsutil/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.


Rapid Clone Ouicli.pl Fails: "Finished OUI CLI cloning for s_db_oh with return code: 16777215" (Doc ID 802464.1)


Cause

The perl program "ouicli.pl" is unable to locate the JDK installation. This could be due to any of the following reasons:

1) There is no JDK/JRE installed under the "<RDBMS ORACLE_HOME>/appsutil/jre/bin" directory.
2) There is a problem, such as file corruption, with the JDK.
3) The value of "s_adjvaprg" in the Context File is set to an invalid location.

Solution

1. Ensure there is a working "java" executable under "<RDBMS ORACLE_HOME>/appsutil/jre/bin":

$ cd $ORACLE_HOME/appsutil/jre/bin
$ ./java -version
java version "1.6.0_07"
Java(TM) SE Runtime Environment (build 1.6.0_07-b06)
Java HotSpot(TM) Server VM (build 10.0-b23, mixed mode)

If the version information is returned, the JDK/JRE is working. This "java" executable file should be referenced directly in the Context File, as noted in step #2.

2. Check the value of "s_adjvaprg" in the Context File:

$ cd $ORACLE_HOME/appsutil/
$ grep s_adjvaprg *.xml   (assumes there is only 1 ".xml" file)
<ADJVAPRG oa_var="s_adjvaprg" osd="UNIX">/d01/R1211/db/tech_st/11.1.0/appsutil/jre/bin/java</ADJVAPRG>

Note that the value of "s_adjvaprg" points to the full path to the java executable and includes the name of the executable, "java", as well.

3. 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/

4. If any changes have been made, now re-try the "adcfgclone.pl" command.