Patch 32226239: GI RELEASE UPDATE 19.10.0.0.0

The Grid Infrastructure patches are cumulative and include the Database CPU program security content.

Table 1-1 lists the various configurations and the applicable patch that should be used to patch that configuration.

^Footnote 1 Opatchauto does not support patching in Data Guard environments. See Installing patch in Standby-First Mode for more information.

Table 1-2 lists the various patches by patch number getting installed as part of this Bundle patch.

^Footnote 2

ACFS, DBWLM and TOMCAT subpatches are not applicable to the HP-UX Itanium and Linux on IBM System z platforms.

This section includes the following sections:

• Patch Installation Prerequisites

• One-off Patch Conflict Detection and Resolution

• opatchauto

• Patch Installation

• Installing patch in Standby-First Mode

• Patch Post-Installation Instructions

• Patch Post-Installation Instructions for Databases Created or Upgraded after Installation of Patch in the Oracle Home

• Patch Deinstallation

• Patch Post-Deinstallation Instructions

You must satisfy the conditions in the following sections before applying the patch:

• OPatch Utility Information

• Validation of Oracle Inventory

• Download and Unzip the Patch

• Run OPatch Conflict Check

• Run OPatch SystemSpace Check

You must use the OPatch utility version 12.2.0.1.23 or later to apply this patch for all platforms. 

Oracle recommends that you use the latest released OPatch version for 19c, which is available 

for download from My Oracle Support patch 6880880 by selecting ARU link for the 12.2.0.1.0 

Opatch release. It is recommended that you download the Opatch utility and the patch in a shared

 location to be able to access them from any node in the cluster for the patch application on each node.

When patching the GI Home, a shared location on ACFS only needs to be unmounted on the node 

where the GI Home is being patched.

The new opatch utility should be updated in all the Oracle RAC database homes and the GI home

 that are being patched.

To update Opatch, use the following instructions:

1. Download the OPatch utility to a temporary directory.

2. For each Oracle RAC database home and the GI home that are being patched, run the following

    commands as the home owner to extract the OPatch utility.

   $ unzip <OPATCH-ZIP> -d <ORACLE_HOME>
   $ <ORACLE_HOME>/OPatch/opatch version
   

The version output of the previous command should be 12.2.0.1.23 or later.

For information about OPatch documentation, including any known issues, see My Oracle Support

 Document 293369.1 OPatch documentation list.

Before beginning patch application, check the consistency of inventory information for GI home and

 each database home to be patched. Run the following command as respective Oracle home owner

 to check the consistency.

$ <ORACLE_HOME>/OPatch/opatch lsinventory -detail -oh <ORACLE_HOME>

If this command succeeds, it lists the Oracle components that are installed in the home. Save the

 output so you have the status prior to the patch apply.

If this command fails, contact Oracle Support Services for assistance.

To apply the patch, it must be accessible from all nodes in the Oracle cluster. Download the patch 

and unzip it to a shared location, this is called the <UNZIPPED_PATCH_LOCATION>. This directory

 must be empty and not be /tmp. Additionally, the directory should have read permission for the

 ORA_INSTALL group.

$ cd <UNZIPPED_PATCH_LOCATION>

Check that the directory is empty.

$ ls

Unzip the patch as grid home owner except for installations that do not have any grid homes. For 

installations where this patch will be applied to the Database home only, the patch needs to be 

unzipped as the database home owner.

$ unzip p32226239_190000_Linux-x86-64.zip

Determine whether any currently installed one-off patches conflict with this patch 32226239 as follows:

• For Grid Infrastructure Home, as home user:

  % $ORACLE_HOME/OPatch/opatch prereq CheckConflictAgainstOHWithDetail -phBaseDir <UNZIPPED_PATCH_LOCATION>/32226239/32218454
  % $ORACLE_HOME/OPatch/opatch prereq CheckConflictAgainstOHWithDetail -phBaseDir <UNZIPPED_PATCH_LOCATION>/32226239/32222571
  % $ORACLE_HOME/OPatch/opatch prereq CheckConflictAgainstOHWithDetail -phBaseDir <UNZIPPED_PATCH_LOCATION>/32226239/32218663
  % $ORACLE_HOME/OPatch/opatch prereq CheckConflictAgainstOHWithDetail -phBaseDir <UNZIPPED_PATCH_LOCATION>/32226239/29340594
  % $ORACLE_HOME/OPatch/opatch prereq CheckConflictAgainstOHWithDetail -phBaseDir <UNZIPPED_PATCH_LOCATION>/32226239/32240590
  

• For Database home, as home user:

  % $ORACLE_HOME/OPatch/opatch prereq CheckConflictAgainstOHWithDetail -phBaseDir <UNZIPPED_PATCH_LOCATION>/32226239/32218454
  % $ORACLE_HOME/OPatch/opatch prereq CheckConflictAgainstOHWithDetail -phBaseDir <UNZIPPED_PATCH_LOCATION>/32226239/32222571
  

The report will indicate the interim patches that conflict with the patch 32226239 and the interim 

patches for which patch 32226239 is a superset.

Check if enough free space is available on the ORACLE_HOME filesystem for the patches to be 

applied as given below:

• For Grid Infrastructure Home, as home user:

  1. Create file /tmp/patch_list_gihome.txt with the following content:

     % cat /tmp/patch_list_gihome.txt
     
     <UNZIPPED_PATCH_LOCATION>/32226239/32218454
     <UNZIPPED_PATCH_LOCATION>/32226239/32222571
     <UNZIPPED_PATCH_LOCATION>/32226239/32218663
     <UNZIPPED_PATCH_LOCATION>/32226239/29340594
     <UNZIPPED_PATCH_LOCATION>/32226239/32240590
     

  2. Run the opatch command to check if enough free space is available in the Grid Infrastructure Home:

     % $ORACLE_HOME/OPatch/opatch prereq CheckSystemSpace -phBaseFile /tmp/patch_list_gihome.txt
     

• For Database home, as home user:

  1. Create file /tmp/patch_list_dbhome.txt with the following content:

     % cat /tmp/patch_list_dbhome.txt
     <UNZIPPED_PATCH_LOCATION>/32226239/32218454
     <UNZIPPED_PATCH_LOCATION>/32226239/32222571
     

  2. Run opatch command to check if enough free space is available in the Database Home:

     % $ORACLE_HOME/OPatch/opatch prereq CheckSystemSpace -phBaseFile /tmp/patch_list_dbhome.txt
     

The command output reports pass and fail messages as per the system space availability:

• If OPatch reports Prereq "checkSystemSpace" failed., then cleanup the 

  system space as the required amount of space is not available.

• If OPatch reports Prereq "checkSystemSpace" passed., then no action is needed. 

  Proceed with patch installation.

The fastest and easiest way to determine whether you have one-off patches in the Oracle home that conflict with the patch, and to get the necessary conflict resolution

 patches, is to use the Patch Recommendations and Patch Plans features on the Patches & Updates tab in 

My Oracle Support. These features work in conjunction with the My Oracle Support Configuration Manager. Recorded 

training sessions on these features can be found in Document 603505.1.

However, if you are not using My Oracle Support Patch Plans, the My Oracle Support Conflict Checker tool 

enables you to upload an OPatch inventory and check the patches that you want to apply to your environment 

for conflicts.

If no conflicts are found, you can download the patches. If conflicts are found, the tool finds an existing resolution 

to download. If no resolution is found, it will automatically request a resolution, which you can monitor in

 the Plans and Patch Requests region of the Patches & Updates tab.

For more information, see Knowledge Document 1091294.1, How to use the My Oracle Support Conflict 

Checker Tool.

Or, manually determine whether any currently installed one-off patches conflict with the PSU patch as follows:

• In the unzipped directory as described in Download and Unzip the Patch.

• The following commands check for conflicts in both the 12.1 GI home and the 12.1 DB homes.

  • In case you are applying the patch, run this command:

    #GRID_HOME/OPatch/opatchauto apply <UNZIPPED_PATCH_LOCATION>/32226239 -analyze
    

  • In case you are rolling back the patch, run this command:

    #GRID_HOME/OPatch/opatchauto rollback <UNZIPPED_PATCH_LOCATION>/32226239 -analyze
    

Note that Oracle proactively generates interim patches for common conflicts.

See My Oracle Support Document 1061295.1 Patch Set Updates - One-off Patch Conflict Resolution to determine, for each conflicting patch, whether a conflict resolution patch 

is already available, and if you need to request a new conflict resolution patch or if the conflict may be ignored.

The Opatch utility has automated the patch application for the Oracle Grid Infrastructure (GI) home and 

the Oracle RAC database homes. It operates by querying existing configurations and automating the steps

 required for patching each Oracle RAC database home of same version and the GI home.

The utility must be executed by an operating system (OS) user with root privileges, and it must be

 executed on each node in the cluster if the GI home or Oracle RAC database home is in non-shared storage. The utility should not be run in parallel on the cluster nodes.

Depending on command line options specified, one invocation of opatchauto can patch the GI home, 

Oracle RAC database homes, or both GI and Oracle RAC database homes of the same Oracle release

 version as the patch. You can also roll back the patch with the same selectivity.

Add the directory containing the opatchauto to the $PATH environment variable. For example:

# export PATH=$PATH:<GI_HOME>/OPatch

To patch the GI home and all Oracle RAC database homes of the same version:

# opatchauto apply <UNZIPPED_PATCH_LOCATION>/32226239

To patch only the GI home:

# opatchauto apply <UNZIPPED_PATCH_LOCATION>/32226239 -oh <GI_HOME>

To patch one or more Oracle RAC database homes:

# opatchauto apply <UNZIPPED_PATCH_LOCATION>/32226239 -oh <oracle_home1_path>,<oracle_home2_path>

To roll back the patch from the GI home and each Oracle RAC database home:

# opatchauto rollback <UNZIPPED_PATCH_LOCATION>/32226239 

To roll back the patch from the GI home:

# opatchauto rollback <UNZIPPED_PATCH_LOCATION>/32226239 -oh <path to GI home>  

To roll back the patch from the Oracle RAC database home:

# opatchauto rollback <UNZIPPED_PATCH_LOCATION>/32226239 -oh <oracle_home1_path>,<oracle_home2_path> 

For more information about opatchauto, see Oracle® OPatch User's Guide.

For detailed patch installation instructions, see Patch Installation.

The patch instructions will differ based on the configuration of the Grid infrastructure and the Oracle

 RAC database homes. Patching instructions for Oracle RAC Database Homes and GI together are listed below.

The most common configurations are listed as follows:

• Case 1: Oracle RAC, where the GI Home and the Database Homes are not shared and ACFS

   file system is not configured

• Case 2: Oracle RAC, where the GI Home is not shared, Database Home is shared, ACFS 

  may be used

• Case 3: Non-Oracle RAC Database homes

For other configurations listed below, see My Oracle Support Document 1591616.1:

• GI Home is not shared, the Database Home is not shared, ACFS may be used.

• Patching Oracle RAC Database Homes.

• Patching GI Home alone.

• Patching Oracle Restart Home.

• Patching a software only GI Home installation or before the GI Home is configured.

• Case 1: Oracle RAC, where the GI Home and the Database Homes are not shared and 

  ACFS file system is not configured.

  As root user, execute the following command on each node of the cluster:

  # <GI_HOME>/OPatch/opatchauto apply <UNZIPPED_PATCH_LOCATION>/32226239
  

• Case 2: Oracle RAC, where the GI Home is not shared, Database Home is shared, 

  ACFS may be used.

  Patching instructions:

  1. From the Oracle database home, make sure to stop the Oracle RAC databases running on all nodes. 

     As the database home owner execute:

     $ <ORACLE_HOME>/bin/srvctl stop database –d <db-unique-name>
     

  2. On the 1st node, unmount the ACFS file systems. See My Oracle Support Document 1494652.1

     
      for unmounting ACFS file systems.

  3. On the 1st node, apply the patch to the GI Home using the opatchauto command. As root

      user, execute the following command:

     # <GI_HOME>/OPatch/opatchauto apply <UNZIPPED_PATCH_LOCATION>/32226239 -oh <GI_HOME>
     

  4. If the message, "A system reboot is recommended before using ACFS" is shown, then a reboot 

     must be issued before continuing. Failure to do so will result in running with an unpatched ACFS

     \ADVM\OKS driver.

  5. On the 1st node, remount ACFS file systems. See My Oracle Support Document 1494652.1 for

      mounting ACFS file systems.

  6. On the 1st node, apply the patch to the Database home using the opatchauto command. 

     Since the Database home is shared, this operation will patch the Database home across the cluster.

      Note that a USM only patch cannot be applied to a database home. As root user, execute the 

     following command:

     # <GI_HOME>/OPatch/opatchauto apply <UNZIPPED_PATCH_LOCATION>/32226239 -oh <ORACLE_HOME>
     

  7. On the 1st node only, restart the Oracle instance, which you have previously stopped in 

     Step 1. As the database home owner execute:

     $ <ORACLE_HOME>/bin/srvctl start instance –d <db-unique-name> -n <nodename>
     

  8. On the 2nd (next) node, unmount the ACFS file systems. See My Oracle Support Document 

     1494652.1 for unmounting ACFS file systems.

  9. On the 2nd node, apply the patch to GI Home using the opatchauto command. As root user, 

     execute the following command:

     # <GI_HOME>/OPatch/opatchauto apply <UNZIPPED_PATCH_LOCATION>/32226239 -oh <GI_HOME>
     

  10. If the message, "A system reboot is recommended before using ACFS" is shown, then a reboot 

      must be issued before continuing. Failure to do so will result in running with an unpatched ACFS

      \ADVM\OKS driver.

  11. On the 2nd node, running the opatchauto command in Step 9 will restart the stack.

  12. On the 2nd node, remount ACFS file systems. See My Oracle Support Document 1494652.1 for

       mounting ACFS file systems.

  13. On the 2nd node only, restart the Oracle instance, which you have previously stopped in 

      Step 1. As the database home owner execute:

      $ <ORACLE_HOME>/bin/srvctl start instance –d <db-unique-name> -n <nodename>
      

  14. Repeat Steps 8 through 13 for all remaining nodes of the cluster.

• Case 3: Non-Oracle RAC Database homes.

  Follow these steps:

  1. If you are using a Data Guard Physical Standby database, you must install this patch on both the 

     primary database and the physical standby database, as described by My Oracle Support Document

      278641.1.

  2. If this is not an Oracle RAC environment, shut down all instances and listeners associated with the

      Oracle home that you are updating. For more information, see Oracle Database Administrator's Guide.

  3. Set your current directory to the directory where the patch is located and then run the OPatch utility 

     by entering the following commands:

     cd <UNZIPPED_PATCH_LOCATION>/32226239/32218454
     opatch apply
     

  4. If there are errors, refer to Known Issues.

You must execute the steps in Loading Modified SQL Files into the Database for any new or upgraded database.

Datapatch is run to complete the post-deinstall SQL deployment for the Database subpatch. For further details about Datapatch, including Known 

Issues and workarounds to common problems, see: Database 12c Post Patch SQL Automation (Doc ID 1585822.1).

The patch rollback instructions will differ based on the configuration of the Grid infrastructure and the Oracle

 RAC database homes. Roll Back instructions for Oracle RAC Database Homes and GI are listed below.

The most common configurations are listed as follows:

• Case 1: Oracle RAC, where the GI Home and Database Homes are not shared and ACFS file system 

  is not configured

• Case 2: Oracle RAC, where the GI Home is not shared, Database Home is shared and ACFS 

  may be used

• Case 3: Non-Oracle RAC Database homes

For other configurations listed below, see My Oracle Support Document 1591616.1:

• GI Home is not shared, the Database Home is not shared, ACFS may be used.

• Rolling back from Oracle RAC Database Homes.

• Rolling back from GI Home alone.

• Rolling back the patch from Oracle Restart Home.

• Rolling back the patch from a software only GI Home installation or before the GI Home is configured.