12c: Operr error tool (Doc ID 1640626.1)

12c: Operr error tool (Doc ID 1640626.1)

Oracle Database 12c Release 1 Information Center (Doc ID 1595421.2)

APPLIES TO:

Oracle Database - Enterprise Edition - Version 12.1.0.1 to 12.1.0.1 [Release 12.1]
Information in this document applies to any platform.

GOAL

operr is a utility for OPatch used to get probable causes and recommended actions for all OPatch error code.

When OPatch errors out with an error code, you can invoke operr on that error code to get a probable cause and recommended actions.

SYNTAX :- operr [-f ] [-version] [-jdk ] [-jre ]

opatch error code: the error code printed to the console when you invoke OPatch.


[message file]: this argument is optional. If you don’t specify the messagefile,OPatch will use the built-in message file bundled inside the Java package $ORACLE_HOME/OPatch/jlib/opatch.jar (package oracle/opatch/diag/operr.txt).
The message file is a file that contains probable causes and recommended actions for all OPatch error code. OPatch team also puts the latest message file on My Oracle Support. You can download the latest patch 16609471 that has the latest message file, and run operr with the “-f” option to retrieve latest probable causes and recommended actions.


[-version]: “operr version” will print out the version of the operr utility {jdk] or [jre]: If there is no JRE or JDK in the Oracle Home, you can use these arguments to launch operr.

SOLUTION

USE CASE -

For Example when “Opatch apply” failed with Error code 16.

Download latest message file from My Oracle Support using patch 16609471


STEP 1 -

1. Install Instructions for Patch 16609471

Download patch 16609471 from the below link provided and Unzip the patch zip file into the PATCH_TOP

unzip -d PATCH_TOP p16609471_111150_Generic.zip

2. Latest operr.txt file is under the directory where the patch was unzipped.

ls /16609471

3. Set ORACLE_HOME environment varible and run operr with -f option.


STEP 2 -

Use Operr utility to get appropriate probable causes and recommended actions for resulted Error Code

$ORACLE_HOME/OPatch/operr 16 -f PATCH_TOP/16609471/operr.txt

Error message: The Oracle Home may be locked by other OPatch/OUI processes. May be you are installing some Oracle products or you are using OPatch to patch some Oracle products on this machine.

Recommended actions: You can check whether there is OPatch or OUI process running by running $ORACLE_HOME/oui/bin/runInstaller. If this command fails, that means there is other OPatch or OUI process running. Please kill those processes, remove the file $ORACLE_HOME/.patch_storage/patch_locked and then retry.

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