How To Diagnose/Debug a Portal One-Off Patch Installation?
Applies to:
Portal - Version: 10.1.2.0 to 10.1.4 - Release: 10gR2 to
Information in this document applies to any platform.
Goal
How To Diagnose/Debug a Portal One-Off Patch Installation?
This note helps to provide extra information, while attempting to apply a one-off patch to the Application Server product stack, in particular to the Oracle Portal product.
Solution
Overview
Oracle Portal patches can come in two forms:
* Portal Repository one-off patches - patches which will update the Portal Database
* Portal Midtier one-off patches - patches which will update files in the Midtier Oracle Home
The very first thing is to read very carefully the README file which comes within the zip file from the patch - to make sure all pre-requisites are satisfied and that all the steps are carefully reviewed prior to the patch apply.
The vehicle to apply both type of patches is done via the OPatch utility. OPatch utility comes now with Oracle Configuration Manager (OCM). Kindly refer to following link for more information on OCM: http://www.oracle.com/technology/documentation/ocm.html.
To know whether the patch is a Portal Repository or a Portal Midtier one-off patch, there will be a different form of installing the one-off patch - kindly review carefully the README file of the patch and the Metalink Note:375628.1 - How to apply Portal patches to a multi-midtier environment.
For Portal Repository patches the command structure is:
./opatch apply [-silent]
[-invPtrLoc
/oraInst.loc] -ocmrf -pre -s
-p
-c
For Portal Midtier patches the command structure is:
./opatch apply [-silent]
[-invPtrLoc
/oraInst.loc] -ocmrf
Note:
The -silent flag (optional) will ignore any question asked during the patch apply - it will use the defaults.
The -invPtrLoc flag (optional) should be used in case the central inventory is NOT unique and for Unix systems only. Please review carefully Note 564192.1, in case of any doubts - it is similar for iAS ORACLE_HOMEs.
The is in the form of ::.
What to Collect or Important to Review?
1. Validate the OPatch version and the Perl version being used prior to install the one-off patch.
# Set the ORACLE_HOME to the midtier ORACLE_HOME
$ perl -version > perlversion.log
$ $ORACLE_HOME/OPatch/opatch version > opatchversion.log
Note:
Check the latest version of the OPatch by checking the following Metalink Patch 6880880 - this version comes with Oracle Configuration Manager (OCM).
The OPatch is platform dependant and the version to be chosen is 10.1.0.0.0 for iAS 10.1.2.x as the database client is a 10.1.x client.
2. Validate the (shared or not) central inventory. Read carefully the Note:564192.1 - FAQs on Central Inventory and Oracle Home Inventory (Local Inventory) in Oracle RDBMS.
For Unix:
$ cat
/oraInst.loc > central_inv.log
Zip up the Local and Central inventory directories:
Local : $ORACLE_HOME/inventory -- where you are trying to apply the patch (midtier) -- local.zip
Central :
-- given by the above command -- central.zip
For Windows:
Kindly supply the value of the registry key in a file named : central_inv.log
\\HKEY_LOCAL_MACHINE\\Software\Oracle\inst_loc
Zip up the Local and Central inventory directories:
Local : %ORACLE_HOME%/inventory -- where you are trying to apply the patch (midtier) -- local.zip
Central :
-- the value taken within the Windows registry -- central.zip
3. In case the patch is a Portal Repository one-off patch it is needed to setup the right environment variable as described within the Metalink Note 316775.1 - Installing Portal patches with OPATCH on Unix environments completes successfully but the patches are not installed.
4. In case there are problems with the one-off patch apply, please set up the following environment variables as they will give extra information to Oracle Support on the one-off patch apply:
# Set the OPATCH_DEBUG and PERL_DL_DEBUG environment variables
$ export OPATCH_DEBUG=true
$ export PERL_DL_DEBUG=1
$ env > opatchenv.log
5. In case the patch is a Portal Repository one-off patch, validate what is the service_name from the database. In SQL*Plus as any DBA user onto the database:-
SQL> spool servicename.log
SQL> show parameter service_names
SQL> spool off
SQL> exit
6. In case this is the very first time you are using OPatch with OCM, then you'll need to create a response (.rsp) file in order to run the opatch command in -silent mode as following:-
$ cd $ORACLE_HOME/OPatch
$ ./ocm/bin/emocmrsp
Example for the usage of the -ocmrf flag ():
opatch ... -ocmrf /usr/oracle/midtier/OPatch/ocm.rsp ...
Note:
The response file (ocm.rsp) will be later used by the opatch utlity to apply any Portal patch (midtier or repository patch).
7. Apply the one-off patch as described within the README file of the patch:
For Portal Repository patches the command structure is:
$ cd $ORACLE_HOME/OPatch
$ ./opatch apply [-silent]
[-invPtrLoc
/oraInst.loc] -ocmrf -pre -s
-p
-c
For Portal Midtier patches the command structure is:
$ cd $ORACLE_HOME/OPatch
$ ./opatch apply [-silent]
[-invPtrLoc
/oraInst.loc] -ocmrf
Note:
1. The order of the -ocmrf flag is important! It should come after the -silent and/or -invPtrLoc flag!
2. The run of the patch will generate a file onto:
$ORACLE_HOME/.patch_storage//Apply__DD-MM-YYYY_HH-MI-SS.log
8. Validate the OPatch inventory as it will help to check not only the patches already installed, but to validate all the Oracle Application Server components.
$ cd $ORACLE_HOME/OPatch
$ ./opatch lsinventory -detail [-invPtrLoc
/oraInst.loc] > opatchdetails.log
Note:
Careful with the ORACLE_HOME which you are providing the opatchdetails.log, eg, this must be the one where you are about to install the patch or where you've installed it already. This should be seen within the opatchdetails log as seen below:
(...)
Oracle recommends you to use the latest OPatch version
and read the OPatch documentation available in the OPatch/docs
directory for usage. For information about the latest OPatch and
other support-related issues, refer to document ID 293369.1
available on My Oracle Support (https://myoraclesupport.oracle.com)
Oracle Home : /opt/product/1012/midtier
Oracle Home Inventory : /opt/product/1012/midtier/inventory
Central Inventory : /opt/product/1012/inventory
from : /etc/oraInst.loc
OUI location : /opt/product/1012/midtier/oui
OUI shared library : /opt/product/1012/midtier/oui/lib/linux/liboraInstaller.so
Java location : /opt/product/1012/midtier/jre/1.4.2/bin/java
Log file location : /opt/product/1012/midtier/.patch_storage/patch ID/*.log
(...)
9. In case the patch is a Portal Repository one-off patch, validate whether the patch got installed or not. In SQL*Plus as PORTAL onto the database:
SQL> set pagesize 9999
SQL> set linesize 128
SQL> spool repospatchcheck.log
SQL> select * from WWC_VERSION$;
SQL> select * from WWUTL_PATCH$;
SQL> select * from WWUTL_PATCHLOG$;
SQL> spool off
SQL> exit
Validate also the following file:
$ORACLE_HOME/portal/oneoffs/patch.log
10. In case the patch is a Portal Repository one-off patch and the query from point 9 doesn't return the patch being applied, then attempt to install the one-off patch by using Portal PTLPATCH utility.
$ cd $ORACLE_HOME/portal/patch/oneoffs
$ ./ptlpatch.csh -z P_PATCHBUNDLE.zip \
-s portal -p
\
-c :: \
> ptlpatch_.log
Note: After this point, make sure point 9 is redone.
Important Information to Supply to Oracle Support
It is important to supply to Oracle Support all the contained information from this Note. Depending on the type of one-off patch to be installed please kindly supply the following information:
Step #
Portal Midtier one-off patch
Portal Repository one-off patch
#1
perlversion.log & opatchversion.log
perlversion.log & opatchversion.log
#2
central_inv.log , local.zip & central.zip
central_inv.log , local.zip & central.zip
#4
opatchenv.log
opatchenv.log
#5
- - - - - - - - - -
servicename.log
#6
Apply__DD-MM-YYYY_HH-MI-SS.log
Apply__DD-MM-YYYY_HH-MI-SS.logApply__DD-MM-YYYY_HH-MI-SS.log
#7
ocm.rsp
ocm.rsp
#8
opatchdetails.log
opatchdetails.log
#9
- - - - - - - - - -
repospatchcheck.log & patch.log
#10
- - - - - - - - - -
ptlpatch_.log

Portal - Version: 10.1.2.0 to 10.1.4 - Release: 10gR2 to

* Portal Repository one-off patches - patches which will update the Portal Database
* Portal Midtier one-off patches - patches which will update files in the Midtier Oracle Home

./opatch apply [-silent]
[-invPtrLoc
/oraInst.loc] -ocmrf -pre -s
-p
-c

./opatch apply [-silent]
[-invPtrLoc
/oraInst.loc] -ocmrf

# Set the ORACLE_HOME to the midtier ORACLE_HOME
$ perl -version > perlversion.log
$ $ORACLE_HOME/OPatch/opatch version > opatchversion.log

$ cat
/oraInst.loc > central_inv.log

# Set the OPATCH_DEBUG and PERL_DL_DEBUG environment variables
$ export OPATCH_DEBUG=true
$ export PERL_DL_DEBUG=1
$ env > opatchenv.log

SQL> spool servicename.log
SQL> show parameter service_names
SQL> spool off
SQL> exit

$ cd $ORACLE_HOME/OPatch
$ ./ocm/bin/emocmrsp

opatch ... -ocmrf /usr/oracle/midtier/OPatch/ocm.rsp ...

$ cd $ORACLE_HOME/OPatch
$ ./opatch apply [-silent]
[-invPtrLoc
/oraInst.loc] -ocmrf -pre -s
-p
-c

$ cd $ORACLE_HOME/OPatch
$ ./opatch apply [-silent]
[-invPtrLoc
/oraInst.loc] -ocmrf

$ORACLE_HOME/.patch_storage//Apply__DD-MM-YYYY_HH-MI-SS.log

$ cd $ORACLE_HOME/OPatch
$ ./opatch lsinventory -detail [-invPtrLoc
/oraInst.loc] > opatchdetails.log

(...)

Oracle Home : /opt/product/1012/midtier
Oracle Home Inventory : /opt/product/1012/midtier/inventory
Central Inventory : /opt/product/1012/inventory
from : /etc/oraInst.loc
OUI location : /opt/product/1012/midtier/oui
OUI shared library : /opt/product/1012/midtier/oui/lib/linux/liboraInstaller.so
Java location : /opt/product/1012/midtier/jre/1.4.2/bin/java
Log file location : /opt/product/1012/midtier/.patch_storage/patch ID/*.log
(...)

SQL> set pagesize 9999
SQL> set linesize 128
SQL> spool repospatchcheck.log
SQL> select * from WWC_VERSION$;
SQL> select * from WWUTL_PATCH$;
SQL> select * from WWUTL_PATCHLOG$;
SQL> spool off
SQL> exit

$ORACLE_HOME/portal/oneoffs/patch.log

$ cd $ORACLE_HOME/portal/patch/oneoffs
$ ./ptlpatch.csh -z P_PATCHBUNDLE.zip \
-s portal -p
\
-c :: \
> ptlpatch_.log

Step #
Portal Midtier one-off patch
Portal Repository one-off patch
#1
perlversion.log & opatchversion.log
perlversion.log & opatchversion.log
#2
central_inv.log , local.zip & central.zip
central_inv.log , local.zip & central.zip
#4
opatchenv.log
opatchenv.log
#5
- - - - - - - - - -
servicename.log
#6
Apply__DD-MM-YYYY_HH-MI-SS.log
Apply__DD-MM-YYYY_HH-MI-SS.logApply__DD-MM-YYYY_HH-MI-SS.log
#7
ocm.rsp
ocm.rsp
#8
opatchdetails.log
opatchdetails.log
#9
- - - - - - - - - -
repospatchcheck.log & patch.log
#10
- - - - - - - - - -
ptlpatch_.log