Contents

Title and Copyright Information

Preface

• Intended Audience
• Documentation Accessibility
• Related Documents
• Conventions

1 Oracle Fusion Middleware Patching and Upgrade Overview

• 1.1 Installation, Patching, and Upgrade Terminology
  • 1.1.1 Patching
  • 1.1.2 Migration
  • 1.1.3 Upgrade
  • 1.1.4 Installation
• 1.2 Patching and Upgrade Tools
• 1.3 About Database Patches for Oracle Fusion Middleware

2 Patching Oracle Fusion Middleware with Oracle OPatch

• 2.1 About Patching with Oracle OPatch
  • 2.1.1 Types of Patches That Are Applied Using OPatch
  • 2.1.2 Types of Patches that Cannot be Applied with OPatch
• 2.2 About OPatch
  • 2.2.1 Getting OPatch
  • 2.2.2 Getting Patches that Can be Applied with OPatch
  • 2.2.3 OPatch Environment Variables
  • 2.2.4 OPatch System Requirements
  • 2.2.5 Backup and Recovery Considerations for Patching
• 2.3 OPatch in a Fusion Middleware Environment
  • 2.3.1 A Typical Patching Scenario
  • 2.3.2 Patching a Fusion Middleware Product
  • 2.3.3 Patching in a Distributed Environment
    • 2.3.3.1 Patching with a Local Middleware Home
    • 2.3.3.2 Patching with a Shared Middleware Home
  • 2.3.4 Patching Artifacts Deployed Outside the Oracle Home
• 2.4 Running OPatch
  • 2.4.1 Applying Patches and Deploying Patched Artifacts to WebLogic Servers
    • 2.4.1.1 Using the OPatch Property File
    • 2.4.1.2 Using the -auto Option
    • 2.4.1.3 Using the apply Command
    • 2.4.1.4 Sample Output for the apply Command
  • 2.4.2 Rolling Back Patches and Deploying Patched Artifacts to WebLogic Servers
  • 2.4.3 Deploying Patched Artifacts to WebLogic Servers
  • 2.4.4 Listing the Source Oracle Homes
  • 2.4.5 Listing the Domains Created from the Middleware Home or Oracle Home
  • 2.4.6 Listing the Applicable Oracle Homes for a Patch
  • 2.4.7 Listing Patches Applied to an Oracle Home or WebLogic Domain
  • 2.4.8 Starting or Stopping a Runtime Instance
• 2.5 Troubleshooting OPatch in a Fusion Middleware Environment
  • 2.5.1 Notes About Patching the MDS Repository
  • 2.5.2 Setting the Machine Name and Listen Address

3 Applying the Latest Oracle Fusion Middleware Patch Set

• 3.1 Oracle Fusion Middleware Patching Process Overview
• 3.2 Oracle Fusion Middleware Patching Process Roadmap
• 3.3 Before You Begin
  • 3.3.1 Special Instructions for Patching a Distributed Environment
  • 3.3.2 Special Instructions for Patching Oracle SOA Suite
  • 3.3.3 Special Instructions for Patching Oracle WebLogic Server 10.3.6 with SOA Suite
  • 3.3.4 Special Instructions for Patching Oracle WebCenter Portal
  • 3.3.5 Special Instructions for Patching Oracle WebCenter Content
    • 3.3.5.1 Enabling WebCenter Content Components Before Upgrade
    • 3.3.5.2 Disabling Obsolete Components Before Upgrade
  • 3.3.6 Special Instructions for Patching Oracle WebCenter Enterprise Capture
  • 3.3.7 Special Instructions for Patching Oracle Portal, Forms, Reports and Discoverer
• 3.4 General Pre-Patching Tasks
  • 3.4.1 Reviewing System Requirements and Certification
    • 3.4.1.1 System Requirements and Specifications
    • 3.4.1.2 Certification and Supported Platforms
    • 3.4.1.3 Verify that the Java Development Kit (JDK) Version is Supported and Certified with Oracle Fusion Middleware 11g (11.1.1.9)
    • 3.4.1.4 Updating the setDomainEnv Script File with Upgraded JDK Location
  • 3.4.2 Reviewing the Oracle Fusion Middleware Interoperability and Compatibility Guide
  • 3.4.3 Stopping the Servers and Processes
  • 3.4.4 Backing Up Your Middleware Home, Domain Home and Oracle Instances
  • 3.4.5 Backing Up Your Database and Database Schemas
  • 3.4.6 Backing Up Additional Configuration Information
  • 3.4.7 Upgrading Oracle WebLogic Server and Applying Required WebLogic Server Patches
  • 3.4.8 Renaming the emCCR File for Silent Patching
• 3.5 Downloading the Installer
  • 3.5.1 About the Installers Used for Patching
  • 3.5.2 Downloading the Required Installer
• 3.6 Patching Oracle Fusion Middleware
  • 3.6.1 Starting the Installer
  • 3.6.2 Applying the Patch Set
  • 3.6.3 Performing the Required Post Patching Procedures
• 3.7 Upgrading Your Schemas with Patch Set Assistant
• 3.8 Starting the Servers and Processes
• 3.9 Verifying Your Patch Set Installation
  • 3.9.1 Verifying the Upgrade Log
  • 3.9.2 Verifying the Domain Server Logs
  • 3.9.3 Verifying OPMN Status
  • 3.9.4 Checking Browser URLs

4 Upgrading Your Schemas with Patch Set Assistant

• 4.1 Creating a Non-SYSDBA User to Upgrade Schemas
• 4.2 Which Schemas Need to be Upgraded with Patch Set Assistant?
• 4.3 Special Instructions for Standalone Oracle Portal Repository Schemas
• 4.4 Before You Begin Using the Patch Set Assistant
  • 4.4.1 Verify that the Java Development Kit (JDK) Version is Supported and Certified with Oracle Fusion Middleware 11g (11.1.1.9)
  • 4.4.2 Upgrade Oracle WebLogic Server and Apply Mandatory Patches
  • 4.4.3 Back Up Your Database and Database Schemas
  • 4.4.4 Check Your Database and Schemas
  • 4.4.5 Create an Edition on the Database Server for Editions-Based Redefinition
  • 4.4.6 Shut Down All Components Using the Schemas You Want to Upgrade
  • 4.4.7 Check the aq_tm_processes Value for Oracle Portal
  • 4.4.8 Setting ORACLE_HOME and JAVA_HOME Environment Variables
• 4.5 Running the Patch Set Assistant
  • 4.5.1 Using the Patch Set Assistant Graphical Interface
  • 4.5.2 Using the Patch Set Installer from the Command Line
  • 4.5.3 Verifying the Schema Version Number After Upgrade
  • 4.5.4 Checking for Invalid Database Objects
• 4.6 Patch Set Assistant Log Files

5 Post-Patching Procedures

• 5.1 General Post-Patching Tasks
  • 5.1.1 Starting the Servers
    • 5.1.1.1 Starting the Node Manager
    • 5.1.1.2 Starting the WebLogic Administration Server
    • 5.1.1.3 Starting the Managed Server(s)
• 5.2 Post-Patching Tasks If Your Starting Point is Release 11.1.1.2
• 5.3 Post-Patching Tasks If Your Starting Point is Release 11.1.1.3
• 5.4 Post-Patching Tasks If Your Starting Point is Release 11.1.1.4
• 5.5 Post-Patching Tasks If Your Starting Point is Release 11.1.1.5
• 5.6 Post-Patching Tasks If Your Starting Point is Release 11.1.1.6
• 5.7 Post-Patching Tasks If Your Starting Point is Release 11.1.1.7
• 5.8 Post-Patching Tasks If Your Starting Point is Release 11.1.1.8
  • 5.8.1 Patching the ADF UI Domain for WebCenter Content
• 5.9 Post-Patching Tasks for System Components
  • 5.9.1 Upgrading System Components
  • 5.9.2 Upgrading Oracle Configuration Manager
  • 5.9.3 Resolving JDBC Errors in Oracle Reports and Oracle Portal
  • 5.9.4 Adding Datafiles to the OLTS_CT_STORE and OLTS_ATTRSTORE Tablespaces for Oracle Internet Directory
  • 5.9.5 Generating the BASE64 Encoded Encryption Key for OPSS
  • 5.9.6 Enabling Dynamic Audit Metadata Model for OPSS Running in JavaSE Mode
  • 5.9.7 Configuring Diagnostic Framework Dump Sampling
  • 5.9.8 Adding Batik Library Jar Files to the JRF Template for IBM WebSphere
• 5.10 Post-Patching Tasks for Oracle Identity Management Components
  • 5.10.1 Enabling New Features of Oracle Directory Integration Platform (DIP) with OUD and ODSEE
  • 5.10.2 Upgrading Configuration Properties in Oracle Identity Federation
  • 5.10.3 Using Oracle Enterprise Manager to View Oracle Identity Management Metrics and Configuration Settings
• 5.11 Post-Patching Tasks for Your WebLogic Server Domain
  • 5.11.1 Upgrading Fusion Middleware Shared Libraries
  • 5.11.2 Upgrading Configurations and Stores
  • 5.11.3 Upgrading Oracle WSM Configurations
  • 5.11.4 Enabling WS-AtomicTransaction
  • 5.11.5 Optimizing Performance for WebLogic Server Domains on 64-Bit Platforms
  • 5.11.6 Upgrading the Plug-In Configuration When Using a Proxy with WebLogic Server
• 5.12 Post-Patching Tasks for Oracle SOA Suite
  • 5.12.1 Loading the Oracle SOA Suite Purge Scripts for Database Management
  • 5.12.2 Removing the tmp Folder for SOA Composer, BPM Workspace and B2B
  • 5.12.3 Upgrading the "BPEL Message Recovery Required" Warning Message Duration
  • 5.12.4 Upgrading MAXRECOVERATTEMPT Attribute to 2
  • 5.12.5 Upgrading the soa-infra Application in Warning State
  • 5.12.6 Running bpm-ps6-upgrade.py to Upgrade the Policy Store
  • 5.12.7 Running soa-upgrade.py to Upgrade the Policy Store and Deploy a Shared Library
  • 5.12.8 Upgrading the Oracle Data Integrator Clients if BAM-ODI Integration is Enabled
  • 5.12.9 Saving and Restoring XEngine Customizations for Oracle B2B
  • 5.12.10 Configuring Oracle JMS Adapter with IBM WebSphere MQ JMS
  • 5.12.11 Extending the SOA Domain with UMS Adapter Features
  • 5.12.12 Extending the SOA Domain with Business Process Management Features
• 5.13 Post-Patching Tasks for Oracle WebCenter Content
  • 5.13.1 Upgrading Oracle WebCenter Content: Imaging
  • 5.13.2 Upgrading Oracle Application Adapters for Oracle WebCenter Content
  • 5.13.3 Configuring the Report Library for Records Management in Content Server
  • 5.13.4 Using Fusion Middleware Control to Monitor IBR
  • 5.13.5 Starting Oracle WebCenter Content Server with SOA or BAM
  • 5.13.6 Enabling System Components for WebCenter Content
• 5.14 Post-Patching Tasks for Oracle Service Bus
  • 5.14.1 Upgrading an Oracle Service Bus Domain After Applying the Latest Patch Set
  • 5.14.2 Using Oracle Service Bus With WebLogic Server 10.3.5
  • 5.14.3 Using Oracle Service Bus With WebLogic Server 10.3.6
  • 5.14.4 Performing Additional Post-Upgrade Tasks for Oracle Service Bus IDE
    • 5.14.4.1 Deleting Oracle WebLogic Server 11g Release 1 (10.3.3)
    • 5.14.4.2 Creating Servers
• 5.15 Post-Patching Tasks for Oracle Business Intelligence
  • 5.15.1 Enabling the WebLogic JMS Queue for WebCenter Content Delivery Channel
  • 5.15.2 Upgrading Oracle Business Intelligence Code Grants
  • 5.15.3 Upgrading Oracle BI Presentation Catalogs
  • 5.15.4 Enabling bicontentserver Features
  • 5.15.5 Enabling Oracle Business Intelligence Composer Features
  • 5.15.6 Enabling JBIPS Features for the Smartview Client
  • 5.15.7 Re-encrypting the Essbase Studio Password
  • 5.15.8 Upgrading Oracle Real-Time Decisions
    • 5.15.8.1 Upgrading the rtd_ils Resource Type Using WLST
    • 5.15.8.2 Adding Permissions to the BIAdministrator Principle Using EM
    • 5.15.8.3 Removing JMS
  • 5.15.9 Configuring the Business Intelligence Mobile App Designer Apps Library
• 5.16 Post-Patching Tasks for Oracle Data Integrator
  • 5.16.1 Finalizing Repository Patching
  • 5.16.2 Reconfiguring the Java EE Agent
  • 5.16.3 Reconfiguring the ODI Standalone Agent
  • 5.16.4 Reconfiguring Oracle Enterprise Manager Properties
  • 5.16.5 Reconfiguring the ODI Console
  • 5.16.6 Adding the Version Number for the odi-sdk-ws Application in config.xml

6 Patching Oracle WebCenter Portal

• 6.1 New Product Names for Oracle WebCenter and Oracle Enterprise Content Management Suite
• 6.2 Patching an Oracle WebCenter Portal 11.1.1.8.x Installation
• 6.3 Patching an Oracle WebCenter Portal 11.1.1.7.0 Installation
• 6.4 Patching an Oracle WebCenter Portal 11.1.1.6.0 Installation
• 6.5 Patching an Oracle WebCenter 11.1.1.4.0 or 11.1.1.5.0 Installation
• 6.6 Patching an Oracle WebCenter 11.1.1.2.0 or 11.1.1.3.0 Installation
  • 6.6.1 Managed Server Changes
  • 6.6.2 Migration Roadmap for Oracle WebCenter 11.1.1.2.0 or 11.1.1.3.0
  • 6.6.3 Updating Oracle WebCenter Portal Using WLST Commands
• 6.7 Patching an Oracle WebCenter 11.1.1.1.0 Installation
• 6.8 Troubleshooting Issues
  • 6.8.1 Troubleshooting Issues with Patching Oracle WebCenter Portal
  • 6.8.2 Troubleshooting Post-Patching Issues
    • 6.8.2.1 Related Items Tab Not in Focus
    • 6.8.2.2 Content Getting Clipped and Inner Scrollbars Appearing
    • 6.8.2.3 Pretty URLs Not Working for Page Navigation
    • 6.8.2.4 Content Queries Not Rendered in Navigation Model
    • 6.8.2.5 Blog Posts Not Displayed in Portals
    • 6.8.2.6 Comments and Likes Not Displayed in Activity Stream
• 6.9 Pre-Patching Tasks for Oracle WebCenter Portal
  • 6.9.1 Exporting Deployment Descriptor for Portlet Producer Applications Secured with OWSM
  • 6.9.2 Saving Your OmniPortlet and Web Clipping Customizations
  • 6.9.3 Running purgeMetadata() for WebCenter Spaces
  • 6.9.4 Considerations for Upgrading Oracle WebCenter Content or Oracle ECM
    • 6.9.4.1 Upgrading Oracle ECM
• 6.10 Post Patching Tasks for Oracle WebCenter Portal
  • 6.10.1 Importing Web Service Deployment Descriptors for Portlet Producers Secured with OWSM
  • 6.10.2 Running the upgradeOpss WLST Command
  • 6.10.3 Extending the Domain Using the Pagelet Producer Upgrade Template
  • 6.10.4 Updating SSO and OHS Configuration
    • 6.10.4.1 Updating OHS Configuration for Pagelet Producer
    • 6.10.4.2 Updating SSO Configuration for Pagelet Producer
    • 6.10.4.3 Updating SSO Configuration for Portlet Producer Applications
    • 6.10.4.4 Updating SSO Configuration for Oracle SES
    • 6.10.4.5 Verifying SSOFilter Grant
  • 6.10.5 Performing Post-Patching Tasks for Oracle WebCenter 11.1.1.2.0 or 11.1.1.3.0 Installations
    • 6.10.5.1 Migrating Oracle Wiki Pages and Blogs
    • 6.10.5.2 Migrating Content Presenter Custom Templates
    • 6.10.5.3 Updating the Configuration for WebCenter REST APIs
    • 6.10.5.4 Updating Multi-Calendar Layouts
    • 6.10.5.5 Restoring Your OmniPortlet and Web Clipping Customizations
    • 6.10.5.6 Extending a Domain to Install Oracle WSM Policy Manager
    • 6.10.5.7 Remove openusage Properties in setDomainEnv
    • 6.10.5.8 Redeploying your Custom Applications to Upgraded Custom Managed Servers
    • 6.10.5.9 Remove the LD_LIBRARY_PATH Entry from the setDomainEnv Script
    • 6.10.5.10 Migrating WSRP Portlet Preferences
  • 6.10.6 Performing Post-Patching Tasks for the WebCenter Portal Application
    • 6.10.6.1 Setting the Web Server Context Root on the Content Server Connection
    • 6.10.6.2 Configuring WebCenter Portal Workflows
    • 6.10.6.3 Updating the Timezone Attribute
    • 6.10.6.4 Updating the Portal Display Mode
    • 6.10.6.5 Choosing a Default Start (or Landing) Page
    • 6.10.6.6 Migrating WebCenter Portal Customizations
    • 6.10.6.7 Upgrading Process Spaces
    • 6.10.6.8 Granting Permissions to Manage Assets
  • 6.10.7 Adding Oracle Single Sign-On Authentication Provider to the List of Authentication Providers
  • 6.10.8 Adding New Features to Oracle WebCenter Portal
    • 6.10.8.1 Installing Activity Graph, Analytics, Pagelet Producer, Personalization Server, and Services Portlets
    • 6.10.8.2 Adding Portal Framework Features to WebCenter Custom Applications
  • 6.10.9 Running the upgradeWebCenterPermissions WLST Command
  • 6.10.10 Resetting Search Customizations
  • 6.10.11 Updating Resource Protection Level in OAM 11.1.2.2.0
  • 6.10.12 Restoring Profile Page Customizations
  • 6.10.13 Removing the -noverify Flag

A Installer Screens

• A.1 Welcome
• A.2 Install Software Updates
• A.3 Prerequisite Checks
• A.4 Specify Installation Location
• A.5 Application Server
• A.6 Installation Summary
• A.7 Installation Progress
• A.8 Installation Complete

B Patch Set Assistant Screens

• B.1 Welcome
• B.2 Select Component
• B.3 Prerequisites
• B.4 Content Server Directory (WebCenter Content Only)
• B.5 Schema Database Credentials
• B.6 Records Directory (WebCenter Content Only)
• B.7 Examine
• B.8 Upgrade Summary
• B.9 Upgrade Progress
• B.10 Upgrade Success

C Using Patch Assistant to Migrate from 11g Release 1 (11.1.1.1.0) to Release 1 (11.1.1.2.0)

• C.1 Overview of Oracle Fusion Middleware 11g Release 1 (11.1.1.2.0) Patch Assistant
• C.2 Migration Process
• C.3 Preparing to Migrate
  • C.3.1 Evaluating and Reviewing your Oracle Fusion Middleware 11g Release 1 (11.1.1.1.0) Environment
  • C.3.2 Preparing to Migrate Your Configuration
    • C.3.2.1 Prerequisites
    • C.3.2.2 Extracting the Contents of Patch Assistant
    • C.3.2.3 Setting Up the Patch Assistant Environment
    • C.3.2.4 Stopping Oracle Fusion Middleware
    • C.3.2.5 Setting Logging Properties
• C.4 Migrating to Oracle Fusion Middleware 11g Release 1 (11.1.1.2.0)
  • C.4.1 Migration Roadmap
  • C.4.2 Migration Procedure
    • C.4.2.1 Stopping the Old Domain
    • C.4.2.2 Installing Oracle Software for 11.1.1.2.0
    • C.4.2.3 Downloading Patch Assistant
    • C.4.2.4 Migrating the Schema
    • C.4.2.5 Creating a WebLogic Domain for 11.1.1.2.0
    • C.4.2.6 Migrating the Domain
    • C.4.2.7 Migrating an Instance
    • C.4.2.8 Registering the Instance
    • C.4.2.9 Starting or Stopping the 11.1.1.2.0 Domain
    • C.4.2.10 Completing Post-Migration Tasks
    • C.4.2.11 Decommissioning the 11.1.1.1.0 Installation
  • C.4.3 Post-Migration Configuration for Oracle Fusion Middleware Components
    • C.4.3.1 Post-Migration Configuration for Oracle Fusion Middleware Audit Framework
    • C.4.3.2 Post-Migration Configuration for Oracle Business Intelligence Discoverer
    • C.4.3.3 Post-Migration Configuration for Oracle Directory Integration Platform
    • C.4.3.4 Post-Migration Configuration for Oracle Identity Federation
    • C.4.3.5 Post-Migration Configuration for Oracle Platform Security Services
    • C.4.3.6 Post-Migration Configuration for Oracle Reports
    • C.4.3.7 Post-Migration Configuration for Oracle SOA
    • C.4.3.8 Post-Migration Configuration for Oracle User Messaging Service
    • C.4.3.9 Post-Migration Configuration for Oracle WebCenter
    • C.4.3.10 Post Migration Configuration for Oracle Web Services Manager
  • C.4.4 Installation Process
  • C.4.5 Configuration Process
  • C.4.6 Properties in the patchMaster.properties File
    • C.4.6.1 Overriding Properties Set in the patchMaster.properties File
  • C.4.7 Oracle Fusion Middleware Components Supported by Patch Assistant

D Sample Patch Master Properties File