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

Interim Patch for Bug: 26997719

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

Date: Thu May 31 04:48:26 2018

---------------------------------
Platform Patch for : Generic
Product Patched : Oracle Data Integrator
Product Version : 12.2.1.3.0

This document describes how to install the interim patch for

bug # 26997719. It includes the following sections:

Section 1, "Zero Downtime Patching"

Section 2, "Prerequisites"

Section 3, "Pre-Installation Instructions"

Section 4, "Installation Instructions"

Section 5, "Post-Installation Instructions"

Section 6, "Deinstallation Instructions"

Section 7, "Post Deinstallation Instructions"

Section 8, "Bugs Fixed by This Patch"

1 Zero Downtime Patching

------------------------------
This patch has been marked as eligible for Zero Downtime Patching.
The type of Zero Downtime Patching supported by this patch is
FMW_ROLLING_ORACLE_HOME.

With Zero Downtime Patching, a Patch can be applied to a system in a manner

that does not incur any downtime. This ensures that the system can remain
available and functioning during the patching process. Certain
pre-requisites, however, must be met before the patch can be applied.

For more information, consult the My Oracle Support MOS Note: 1942159.1

2 Prerequisites
----------------
Ensure that you meet the following requirements before you install or
deinstall the patch:

1. Before applying the non-mandatory patches, ensure that you have the
exact symptoms described in the bug.

2. Oracle Fusion Middleware 12.2.1 products are installed with OPatch NextGen 13.3
to apply interim patches.
The OPatch utility should be updated over time to resolve known issues.

You can check your version using the following command:

ORACLE_HOME/OPatch/opatch version

### ycchew
C:\Oracle\Middleware\Oracle_Home
# OPatch\opatch version
OPatch Version: 13.9.2.0.0
OPatch succeeded.

Checking Patch 6880880, if a new version is available , download "OUI NextGen 13.3"
for your platform.

Review the following for more information:

Doc ID 1587524.1, "Using OUI NextGen OPatch 13 for Oracle Fusion Middleware 12c
(12.1.2+)"
https://support.oracle.com/rs?type=doc&id=1587524.1

For Oracle Fusion Middleware OPatch usage, refer to the URL below which
redirects to the latest FMW 12c document:
"Oracle Fusion Middleware Patching With OPatch"
http://www.oracle.com/pls/topic/lookup?ctx=fmw122100&id=OPATC

3. Verify the OUI Inventory.

OPatch needs access to a valid OUI inventory to apply patches.

Note: This needs the ORACLE_HOME to be set(refer section "2. Pre-Installation

Instructions")
prior to run the below commands:

Validate the OUI inventory with the following commands:

### ycchew
452242@MYRHB-452242MAN C:\Oracle\Middleware\Oracle_Home\OPatch
# opatch lsinventory
Oracle Interim Patch Installer version 13.9.2.0.0
Copyright (c) 2019, Oracle Corporation. All rights reserved.
Oracle Home : C:\Oracle\Middleware\Oracle_Home
Central Inventory : C:\Program Files\Oracle\Inventory
from :
OPatch version : 13.9.2.0.0
OUI version : 13.9.2.0.0
Log file location : C:\Oracle\Middleware\Oracle_Home\cfgtoollogs\opatch\opatch2019-
02-08_11-30-42AM_1.log
OPatch detects the Middleware Home as "C:\Oracle\Middleware\Oracle_Home"
Lsinventory Output file location :
C:\Oracle\Middleware\Oracle_Home\cfgtoollogs\opatch\lsinv\lsinventory2019-02-08_11-
30-42AM.txt
-------------------------------------------------------------------------------
Local Machine Information::
Hostname: MYRHB-452242MAN.portaldom.ent.intranet.rhbbank.com
ARU platform id: 233
ARU platform description:: Microsoft Windows Server 2003 (64-bit AMD)
Interim patches (4) :
Patch 26355633 : applied on Mon Nov 12 11:08:40 SGT 2018
Unique Patch ID: 21447583
Patch description: "One-off"
Created on 1 Aug 2017, 21:40:20 hrs UTC
Bugs fixed:
26355633
Patch 26287183 : applied on Mon Nov 12 11:07:35 SGT 2018
Unique Patch ID: 21447582
Patch description: "One-off"
Created on 1 Aug 2017, 21:41:27 hrs UTC
Bugs fixed:
26287183
Patch 26261906 : applied on Mon Nov 12 11:06:56 SGT 2018
Unique Patch ID: 21344506
Patch description: "One-off"
Created on 12 Jun 2017, 23:36:08 hrs UTC
Bugs fixed:
25559137, 25232931, 24811916
Patch 26051289 : applied on Mon Nov 12 11:06:43 SGT 2018
Unique Patch ID: 21455037
Patch description: "One-off"
Created on 31 Jul 2017, 22:11:57 hrs UTC
Bugs fixed:
26051289

$ opatch lsinventory -jre $ORACLE_HOME/oracle_common/jdk/jre

### ycchew
452242@MYRHB-452242MAN C:\Oracle\Middleware\Oracle_Home\OPatch
# opatch lsinventory -jre C:\Oracle\Middleware\Oracle_Home\oracle_common\jdk\jre
The filename, directory name, or volume label syntax is incorrect.
The syntax of the command is incorrect.

Note:
All OPatch commands should be run with -jre option.
Make sure the JDK version you use is the certified version for your product.

If the command errors out, contact Oracle Support and work to validate
and verify the inventory setup before proceeding.

4. Confirm the executables appear in your system PATH.

The patching process will use the unzip and the OPatch executables. After
setting the ORACLE_HOME environment, confirm if the following executables
exist, before proceeding to the next step:

- opatch
- unzip

If either of these executables do not show in the PATH, correct the

problem before proceeding.

5. Create a location for storing the unzipped patch. This location

will be referred to later in the document as PATCH_TOP.

NOTE: On WINDOWS, the preferred location is the drive root directory.

For example, "C:\PATCH_TOP" and avoid choosing locations like,
"C:\Documents and Settings\username\PATCH_TOP".
This is necessary due to the 256 characters limitation on windows
platform.

3 Pre-Installation Instructions
-------------------------------
1. Set the ORACLE_HOME environment variable to the directory where you have
installed ODI.
For example, set ORACLE_HOME=C:\Oracle_ODI

4 Installation Instructions
---------------------------

1. Unzip the patch zip file into the PATCH_TOP.

$ unzip -d PATCH_TOP p26997719_122130_Generic.zip

NOTE: On WINDOWS, the unzip command has a limitation of 256 characters in the path
name.
If you encounter this, please use an alternate ZIP utility like 7-Zip to unzip the
patch.

For example: To unzip using 7-zip, run the command:

"c:\Program Files\7-Zip\7z.exe" x p26997719_122130_Generic.zip

2. Set your current directory to the directory where the patch is located.

$ cd PATCH_TOP/26997719

3. Run OPatch to apply the patch.

$ opatch apply

### ycchew
452242@MYRHB-452242MAN C:\PATCH_TOP
# opatch apply
Oracle Interim Patch Installer version 13.9.2.0.0
Copyright (c) 2019, Oracle Corporation. All rights reserved.
Oracle Home : C:\Oracle\Middleware\Oracle_Home
Central Inventory : C:\Program Files\Oracle\Inventory
from :
OPatch version : 13.9.2.0.0
OUI version : 13.9.2.0.0
Log file location : C:\Oracle\Middleware\Oracle_Home\cfgtoollogs\opatch\opatch2019-
02-08_11-52-18AM_1.log
OPatch detects the Middleware Home as "C:\Oracle\Middleware\Oracle_Home"
Verifying environment and performing prerequisite checks...
OPatch continues with these patches: 26997719
Do you want to proceed? [y|n]
y
User Responded with: Y
All checks passed.
Please shutdown Oracle instances running out of this ORACLE_HOME on the local
system.
(Oracle Home = 'C:\Oracle\Middleware\Oracle_Home')
Is the local system ready for patching? [y|n]
y
User Responded with: Y
Backing up files...
Applying interim patch '26997719' to OH 'C:\Oracle\Middleware\Oracle_Home'
ApplySession: Optional component(s) [ oracle.odi.jdev.fusiondev, 12.2.1.3.0 ] not
present in the Oracle Home or a higher version is found.

Patching component oracle.odi.sdk, 12.2.1.3.0...

Patch 26997719 successfully applied.
Log file location: C:\Oracle\Middleware\Oracle_Home\cfgtoollogs\opatch\opatch2019-
02-08_11-52-18AM_1.log
OPatch succeeded.

Note:
-----
When OPatch starts, it validates the patch and makes sure that there are no
conflicts with the software already installed in the ORACLE_HOME.

In case of opatch conflict, you will see a warning message similar to the one
mentioned below:

Interim Patch XXXX has Conflict with patch(es) [ YYYY ] in OH ...

Conflict patches: YYYY
Patch(es) YYYY conflict with the patch currently being installed (XXXX).
If you continue, patch(es) YYYY will be rolled back and the new patch (XXXX) will
be installed.

If a merge of the new patch (XXXX) and the conflicting patch(es) ( YYYY) is
required,contact Oracle Support Services and request a Merged patch.

Do you want to proceed? [y|n]

n

You must stop the patch installation and contact oracle support on how to proceed.

5 Post-Installation Instructions
---------------------------------

Make sure all ODI applications using the patched ORACLE_HOME are shut down.
Clear the ODI cache after having applied the patch:
For ODI Studio, run the odi command with -clean -initialize parameters. See
Document 1943854.1 for details.
For ODI J2EE Agent, clear the cache of the WebLogic Managed Server hosting the
application, as explained in Document 2171537.1
For ODI standalone Agent, delete the "tmp", and "work" directories, as explained
in Document 2149210.1

6 Deinstallation Instructions
------------------------------

If you experience any problems after installing this patch, remove the patch as
follows:

1. Make sure to follow the same Prerequisites or pre-install steps (if any)
when deinstalling a patch.
This includes setting up any environment variables like ORACLE_HOME and
verifying the OUI inventory before deinstalling.

2. Change to the directory where the patch was unzipped.

$ cd PATCH_TOP/26997719

3. Run OPatch to deinstall the patch.

$ opatch rollback -id 26997719

7 Post Deinstallation Instructions

-----------------------------------
6.a) Restart ODI Studio and Standalone Agent.

6.b) Restart all servers (AdminServer and all Managed server(s)).

This is necessary to redeploy the original applications and bring the

environment back to it's original state.

8 Bugs Fixed by This Patch

--------------------------
26997719: Standalone Agent startup Error-Caused by: java.lang.NullPointerException

-----------------------------------------------------------------------------
DISCLAIMER:

This interim patch has only undergone basic unit testing, and has not been
through a complete test cycle generally followed for a production patch set.
Though the fixes in this document rectifies the bug, Oracle Corporation will
not be responsible for other issues that may arise due to these fixes.
Oracle Corporation recommends to later upgrade to the next production patch
set, when available. Applying this patch could overwrite other interim
patches applied since the last patch set. Customers need to make a request
to Oracle Support for a patch that includes those fixes, as well as inform
Oracle Support about all the patches installed when a Service Request is
opened. Please download, test, and provide feedback as soon as possible
to assist in the timely resolution of this problem.

Copyright (c) 2018, Oracle and/or its affiliates. All rights reserved.
-----------------------------------------------------------------------------