Contents

Title and Copyright Information

Preface

• Audience
• Documentation Accessibility
• Related Documents
• Conventions

1 Introduction to OPatch and Patching

• 1.1 Overview of the Patch Process
  • 1.1.1 Obtaining the Patches You Need
  • 1.1.2 Applying the Patch to the Desired Targets
    • 1.1.2.1 Manual Patching
    • 1.1.2.2 Configuration Patching
• 1.2 Patching with Enterprise Manager
• 1.3 Who Should Use OPatch?
• 1.4 What's Covered in this Guide
• 1.5 OPatch Integration with Other Oracle Software
• 1.6 How to Access the OPatch Utilities

2 Binary Patching Using OPatch

• 2.1 Obtain the Latest OPatch Utility
• 2.2 Using OPatch
  • 2.2.1 Patching Workflow
    • 2.2.1.1 Setting the ORACLE_HOME Environment Variable
    • 2.2.1.2 Determining What is Installed On Your System
    • 2.2.1.3 Ensuring Patch Application Prerequisites are Met
    • 2.2.1.4 Applying a Patch
    • 2.2.1.5 Running Post-apply Checks
• 2.3 Applying a Patch Set Update (PSU)
  • 2.3.1 Applying a Single Patch
  • 2.3.2 Apply Multiple Patches Using a Text File
• 2.4 Patch Conflict Detection and Resolution

3 Concepts of Patch Orchestration Using OPatchAuto

• 3.1 Patch Orchestration Concepts
• 3.2 OPatchAuto Pre-requisite
• 3.3 Phases and Sessions
• 3.4 OPatch Automation (OPatchAuto)
  • 3.4.1 Supported Patch Format
  • 3.4.2 Supported Target Configurations
    • 3.4.2.1 Shared Versus Non-Shared (GI or RAC) Homes
    • 3.4.2.2 Patch Application Modes
  • 3.4.3 Configuration Support

4 Multiple Patch Application

• 4.1 Command Line Support
• 4.2 Supported Content of the Patch Base Directory
• 4.3 -phBaseDir Restrictions

5 Patching of Grid Infrastructure and RAC DB Environment Using OPatchAuto

• 5.1 Configuration Support
• 5.2 Preparing to Use OPatchAuto
  • 5.2.1 OPatchAuto Environment Variable
  • 5.2.2 Running OPatchAuto on a Single Node
    • 5.2.2.1 Node Availability during Patching (Rolling vs. Non-rolling)
    • 5.2.2.2 OPatchAuto Apply\Rollback steps
  • 5.2.3 Patching Session Output
  • 5.2.4 Sample Console Output
  • 5.2.5 OPatchAuto Apply
  • 5.2.6 OPatchAuto: System Reboot Request
• 5.3 Using OPatchAuto to Patch a GI/RAC Environment
• 5.4 Patching a Sharded Database
  • 5.4.1 Selectively Patching Subset Entities
    • 5.4.1.1 Data Guard
    • 5.4.1.2 Shard Group
    • 5.4.1.3 Shard Space
  • 5.4.2 Sharded Database Command Option
  • 5.4.3 About the Wallet File
    • 5.4.3.1 Creating Wallet Using OPatchAuto Wallet Tool
  • 5.4.4 Log Files

6 OPatchAuto -binary

• 6.1 Supported Patch Types
• 6.2 Analyze Mode of Operation
• 6.3 Target Types in a SystemPatch
• 6.4 Syntax and Commands

7 Out-of-Place Patching

• 7.1 GI RAC
  • 7.1.1 Out of Place Patching Method
  • 7.1.2 Switchback to original home
• 7.2 SIHA SIDB

8 Inplace Patching

• 8.1 OPatchAuto Apply\Rollback steps

9 Troubleshooting OPatch

• 9.1 Debugging: Enable Logging and Tracing
• 9.2 References
• 9.3 Products and Patch Types Not Supported by OPatch

10 Troubleshooting OPatchAuto

• 10.1 OPatchAuto Troubleshooting Architecture
• 10.2 OPatchAuto (Use Cases)
  • 10.2.1 OPatch Fails
  • 10.2.2 Rootcrs.pl
    • 10.2.2.1 Rootcrs.pl Prepatch
    • 10.2.2.2 Rootcrs Problem Use Cases
  • 10.2.3 Patchgen
  • 10.2.4 Datapatch
• 10.3 Troubleshooting OPatchAuto
  • 10.3.1 Logging and Debugging
  • 10.3.2 Verification
  • 10.3.3 OHASD FAILURE DURING ROOTCRS POSTPATCH
• 10.4 Known Issues while Patching
  • 10.4.1 Known Issues: rootcrs.pl
    • 10.4.1.1 Opatchauto Rollback Fails
    • 10.4.1.2 OPatchAuto Fails During Leaf Node Patching
  • 10.4.2 Known Issues: Datapatch
    • 10.4.2.1 Datapatch is Executed on the First Node Instead of the Last Node During Rollback
  • 10.4.3 Known Issues: OPatch
    • 10.4.3.1 opatch napply failure
    • 10.4.3.2 OPatch fails to rollback July'17 DB PSU
  • 10.4.4 Known Issues: OPatchAuto
    • 10.4.4.1 Known Issues in OPatchAuto 12.1.0.1.7
      • 10.4.4.1.1 Opatchauto fails when the name of the Real Applicaiton Cluster is all upper-case.
    • 10.4.4.2 Known Issues in OPatchAuto 12.1.0.1.5
      • 10.4.4.2.1 Software-only Homes
      • 10.4.4.2.2 OPatchAuto fails to determine a shared home
      • 10.4.4.2.3 RAC One related Issues:
      • 10.4.4.2.4 OPatchAuto behavior in '-norestart' mode
      • 10.4.4.2.5 OPatchAuto fails to apply an incoming subset patch inside a SystemPatch
      • 10.4.4.2.6 OPatchAuto fails in 'srvctl start home' with error code CRS-2717
      • 10.4.4.2.7 Failure in creating SystemInstance
    • 10.4.4.3 Datapatch is Run on All Nodes
    • 10.4.4.4 Datapatch Does Not Run When OPatchAuto Resumes
    • 10.4.4.5 OPatchAuto Fails without an Error Message
• 10.5 Common Error Symptoms/Conditions
  • 10.5.1 Rootcrs.pl Postpatch
  • 10.5.2 Patcherr

A OPatch Syntax and Commands

• A.1 OPatch Syntax
• A.2 apply
• A.3 compare
• A.4 lsinventory
• A.5 lspatches
• A.6 napply
• A.7 nrollback
• A.8 rollback
• A.9 query
• A.10 version
• A.11 prereq
• A.12 util

B OPatchAuto Syntax and Commands

• B.1 OPatchAuto Commands
  • B.1.1 apply
  • B.1.2 resume
  • B.1.3 rollback
  • B.1.4 help
  • B.1.5 version

Glossary

Index