|Oracle® Fusion Middleware Patching Guide
11g Release 1 (22.214.171.124.0)
Part Number E16793-25
|PDF · Mobi · ePub|
This chapter describes how to patch your existing Oracle Fusion Middleware software to the latest version. The specific patching instructions you follow depend on the version of your current software. Instructions in this chapter are provided for software versions 126.96.36.199.0 and later.
The following pre-patching procedures must be completed before you can update your software to Release 188.8.131.52.0:
If you have Oracle Fusion Middleware 11g Release 1 (184.108.40.206.0), you must update to Release 1 (220.127.116.11.0) before you can update your software to Release 18.104.22.168.0. See Appendix C, "Using Patch Assistant to Migrate from 11g Release 1 (22.214.171.124.0) to Release 1 (126.96.36.199.0)"for instructions.
If you have Oracle Identity and Access Management 11g Release 1 (188.8.131.52.0) components, you must update to Release 1 (184.108.40.206.0) before you can update your software to Release 220.127.116.11.0. See Section 7.2, "Patching Oracle Identity and Access Management 18.104.22.168.0 Components"
Figure 3-1 shows the general patching procedures for Oracle Fusion Middleware. Review the overview before you begin your patching procedures to ensure you understand the process.
Figure 3-1 Oracle Fusion Middleware Patching Process Overview and Roadmap
Table 3-1 provides links to additional information for each of the patching steps.
Table 3-1 Summary of Patching Procedures and Links to Documentation
Perform the following general pre-patching tasks before you begin the patching process:
If you are patching in silent mode, see Renaming the emCCR File for Silent Patching.
Download and start the appropriate installer for your product:
For details, see Downloading the Installer.
Update the software in your Oracle home using the downloaded Installer.
If necessary, update your database schemas with the Patch Set Assistant.
To see if you need to run the Patch Set Assistant, refer to Table 4-1, "Schemas That Require Updating for the Latest Release".
For more information, see Updating Your Schemas with Patch Set Assistant.
Perform any necessary post-patching tasks (for example, starting the servers and processes in a domain, starting Oracle instances, running scripts or modifying configuration files). The tasks that need to be performed will vary depending on the version of your existing software and components configured in your environment. Refer to the tables in the following sections for details:
Post-patching tasks related to Oracle WebCenter Portal are described here:
Start the servers and processes.
For more information, see Section 3.8, "Starting the Servers and Processes".
Verify that your patch installation is complete.
For more information, see Section 3.9, "Verifying Your Patch Set Installation".
Before you begin the patching procedures discussed in this chapter, complete any applicable pre-patching tasks outlined in this section. The "Special Instructions" sections in this chapter will help you determine if there are any special pre-patching tasks required for your environment.
The procedures you need to follow for patching your existing Oracle WebCenter software depend on your current software version. Chapter 6, "Patching Oracle WebCenter Portal" describes the procedures for patching the various versions of Oracle WebCenter. For patching Oracle WebCenter, you can directly navigate to Chapter 6 and follow the instructions there. Many of the steps listed in refer back to this and other chapters of this guide.
To prevent compatibility issues with other Fusion Middleware products, Oracle recommends that Oracle Portal, Forms, Reports, and Discoverer be installed in its own Middleware home directory that it does not share with any other Oracle Fusion Middleware products. For more information on the compatibility and interoperability of Fusion Middleware products, see the Oracle Fusion Middleware Interoperability and Compatibility Guide.
This Oracle Fusion Middleware patch set provides Oracle Portal 22.214.171.124.0 which is the latest version of Oracle Portal. The Patch Set Assistant for this release upgrades the PORTAL schema to this version. As a result, a schema update is not required if Oracle Portal 126.96.36.199.0 has already been installed.
If you are currently using the 188.8.131.52.0 versions of Oracle Identity Manager, Oracle Access Manager or Oracle Adaptive Access Manager, you will need to upgrade to 184.108.40.206.0 before applying the latest patch set (220.127.116.11.0). For more information, see Section 7.2, "Patching Oracle Identity and Access Management 18.104.22.168.0 Components".
Before applying the latest patch set for Oracle Identity and Access Management 11g Release 1 (22.214.171.124.0), see "Patch Set Interoperability Between Oracle Identity Management and Oracle Identity and Access Management" in Oracle Fusion Middleware Interoperability and Compatibility Guide for interoperability issues between these products.
If you are running your products in a distributed environment (for example, you have Managed Servers running in multiple domains on multiple systems) and you have set up a shared Middleware home on a shared network drive mounted to each machine that is part of your domain, then this patching procedure only needs to be done once (see Section 2.3.3, "Patching in a Distributed Environment").
If your distributed environment has a separate Middleware home on each system, then this patching procedure must be repeated for each domain on each system.
More information about distributed topologies can be found in the Enterprise Deployment Guide for your specific product.
Before upgrading from a previous release to 126.96.36.199.0, make sure all Edit sessions in SOA Composer are committed or reverted.
SOA Composer provides DT@RT functionality to edit rules dictionaries after deployment. After upgrading to the latest version, all uncommitted sessions in SOA Composer will be lost or there can be issues accessing the edit sessions. This is because the MDS sandboxes (used for handling sessions) are not updated by the patch set.
To commit or revert the sessions:
Log in to the SOA Composer (
/soa/composer) as any user with active sessions.
Go to Open > My Edits to view all of your active sessions.
Open each document listed in "My Edits" and do one of the following:
Click Commit to commit the session changes.
Select Revert > Clear all session edits and saved changes to abort the changes.
Either step will result in the session being closed.
After installing the latest version of Oracle WebLogic Server (version 10.3.6), you must install the required patches as described on the "Known Issues for Oracle SOA Products and Oracle AIA Foundation Pack" page on Oracle Technology Network at:
This section describes tasks that should be completed before you patch your software:
Before you begin to update your software, you should make sure that your system environment and configuration meet the minimum requirements for the software you want to install in order to perform the update. This section contains links to several key pieces of documentation you should review:
For certification information, refer to the System Requirements and Supported Platforms for Oracle Fusion Middleware 11gR1 document on the Oracle Fusion Middleware Supported System Configurations page at the following URL:
This page contains information related to hardware and software requirements, minimum disk space and memory requirements, database schema requirements, and required system libraries, packages, or patches.
Read the System Requirements and Supported Platforms for Oracle Fusion Middleware 11gR1 document. This document contains certification information related to supported 32-bit and 64-bit operating systems, databases, web servers, LDAP servers, adapters, IPv6, JDKs, and third-party products. It is located on the Oracle Fusion Middleware Supported System Configurations page.
You will need to have the latest supported JDK version installed in your patched environment. Consult the System Requirements and Supported Platforms for Oracle Fusion Middleware 11gR1 document at
http://www.oracle.com/technetwork/middleware/downloads/fmw-11gr1certmatrix.xls for the latest certified JDK versions for your patch set.
You can access the latest JDK from the Oracle Software Downloads page on the Oracle Technology Network at
http://www.oracle.com/technetwork/indexes/downloads/index.html. Follow the installation instructions provided with each download.
Oracle Fusion Middleware 11g Release 1 (188.8.131.52.0) does not include an updated version of Oracle WebLogic Server; this release is supported for use with Oracle WebLogic Server 10.3.6, which was released with Oracle Fusion Middleware 11g Release 1 (184.108.40.206.0).
As a result, some Oracle Fusion Middleware products may require a JDK version higher than the one that is embedded with Oracle WebLogic Server 10.3.6. In such cases, you must manually upgrade your JDK to the supported version.
Apply the FMW Patch Set before updating the JDK used with Oracle WebLogic Server 10.3.6, in order to ensure a certified and latest WLS/JDK/FMW combination.
Oracle Java SE (JDK/JRE) may be installed as part of the Oracle Fusion Middleware (FMW) 11g product or installed on your system beforehand. In either case, it is supported to update this Java SE (or JDK/JRE if separate) to the latest release, as long as it remains on a certified version.
See the System Requirements and Supported Platforms for Oracle Fusion Middleware 11gR1 document on the Oracle Fusion Middleware Supported System Configurations page for supported JDK versions.
Read "Patch Set Interoperability" in the Oracle Fusion Middleware Interoperability and Compatibility Guide before you begin your patching process. This document contains important information regarding the ability of Oracle Fusion Middleware products to function with previous versions of other Oracle Fusion Middleware, Oracle, or third-party products. This information is applicable to both new Oracle Fusion Middleware users and existing users who are upgrading their existing environment.
Some versions of Oracle Identity Management products are not compatible with previous versions. For detailed information, see the Oracle Fusion Middleware Interoperability and Compatibility Guide.
Before you run the installer to update your software, you should stop all servers and processes (including OPMN) on all machines which are part of any domain used from the Middleware home.
Instructions for stopping an Oracle Fusion Middleware environment are provided in "Stopping an Oracle Fusion Middleware Environment" in Oracle Fusion Middleware Administrator's Guide.
If your environment is running Oracle Process Manager and Notification Server (OPMN), you should also stop OPMN with the
opmnctl stopall command.
If you are running Node Manager, you should also stop Node Manager. You can do this by closing the console window in which Node Manager is running, or by using the
stopNodeManager WLST command.
In order for the
stopNodeManager command to work, Node Manager must be configured with
See "stopNodeManager" in Oracle Fusion Middleware WebLogic Scripting Tool Command Reference for more information.
After stopping the servers and processes, back up your Middleware home directory (including the Oracle home directories inside the Middleware home), your local Domain home directory, your local Oracle instances, and also the Domain home and Oracle instances on any remote systems that use the Middleware home.
Backing up your environment before applying your patch is an important step in the patching process. If your patch set installation is unexpectedly interrupted, or if you choose to cancel out of the installation before it is complete, you may not be able to install the patch unless you restore your environment to the previous configuration before running the Installer again.
For more information on backing up your environment, see "Backing Up Your Environment" in the Oracle Fusion Middleware Administrator's Guide.
If your database schemas require updating, you should also back up your database before you begin the patching procedure. Make sure this back up includes the schema version registry table, as each Fusion Middleware schema has a row in this table. The name of the schema version registry table is
SYSTEM.SCHEMA_VERSION_REGISTRY$. Refer to your database documentation for instructions on how to do this.
If you run the Patch Set Assistant to update an existing schema and it does not succeed, you must restore the original schema before you can try again. Make sure you back up your existing database schemas before you run the Patch Set Assistant.
To see if your schemas require updating, refer to Table 4-1, "Schemas That Require Updating for the Latest Release" in "Updating Your Schemas with Patch Set Assistant".
Depending on your specific environment, you might also need to back up the following before performing any patching procedures:
Back Up Configurations and Stores
Each WebLogic Server domain must be updated using the
upgradeOpss() WLST command. Before running the
upgradeOpss() command, make sure that you backup the store to be updated. In case of a LDAP store, backup all data under the root node of the store (which is specified as a property of the store in the configuration file). For example, to backup OID as LDAP store, do the following:
For more information about how to backup the OID DB, see "Backing Up and Restoring Oracle Internet Directory" in Oracle Fusion Middleware Administrator's Guide for Oracle Internet Directory.
All the Oracle Internet Directory data you need to backup and restore is in the underlying Oracle Database. For more information about how to backup and restore the Oracle database, see Oracle Database Backup and Recovery User's Guide.
For more information on how to backup and restore your FMW Oracle home and Oracle instance, see Oracle Fusion Middleware Administrator's Guide.
ldapsearch backup from the root
(-b "") to get and ldif backup without operational attributes (which could be imported with ldap tools later if required). For example,
ldapsearch -h <oid host> -p <oid port> -D cn=orcladmin -w <password> -L -s sub -b "" objectclass=* > /tmp/ldapsearchOfAllEntries.ldif
ldifwrte from the root
(basedn="") to get an ldif backup with operational attributes (which could be imported with bulkload restore option later if required). For example,
ldifwrite connect=oiddb basedn="" ldifile="/tmp/ldifwriteOfAllEntries.ldif"
In case of an update failure, restore that node entirely.
For more information, see "Upgrading Policies with upgradeOpss" in Oracle Fusion Middleware Security Guide.
Save OmniPortlet and WebClipping Customizations for Oracle WebCenter or Oracle Portal
If you are using OmniPortlet and WebClipping customizations, and they are being used with a file-based preferences store, you must save your customizations.
Save XEngine Customizations for Oracle B2B
This procedure is needed only if you use custom XEngine configurations in cases where B2B server is integrated with B2B EDI endpoints. In such cases, all B2B domains created from the same installation share the a single XEngine configuration stored within a single directory. This directory must be backed up prior to patching, and then restored after patching is complete.
For more information, see Section 5.9.9, "Saving and Restoring XEngine Customizations for Oracle B2B".
Back Up Existing Oracle BI Presentation Catalogs
When updating your Oracle Business Intelligence (BI) software from Release 220.127.116.11.0 to 18.104.22.168.0, you must manually update your Oracle BI Presentation Catalogs. See Section 5.12.2, "Updating Oracle BI Presentation Catalogs" for more information.
Back Up Files for Oracle Data Integrator Java EE Standalone Agent
Make sure the following files and directories are backed up (they should be if you backed up your Oracle home directory, as specified in Section 3.4.4, "Backing Up Your Middleware Home, Domain Home and Oracle Instances"):
/oracledi/agent/bin/odiparams.sh (on UNIX operating systems) or
\oracledi\agent\bin\odiparams.bat (on Windows operating systems) file.
/oracledi/agent/drivers (on UNIX operating systems) or
\oracledi\agent\drivers (on Windows operating systems) directory.
After Oracle Data Integrator is patched, follow the instructions in Section 5.13.3, "Reconfiguring the ODI Standalone Agent".
Back up custom JSPs for Oracle Identity Federation
If you are updating your Oracle Identity Federation to the latest release, you should back up any custom JSPs before patching to the latest version. The patching process will overwrite the JSPs included in the
After the patching process is complete, you should restore your custom JSPs.
If Oracle WebLogic Server is already installed on your system, make sure you have updated Oracle WebLogic Server to either version 10.3.6 or 10.3.5 (both are supported in Release 22.214.171.124.0) using the Upgrade installer.
To update the WebLogic Server :
Download the Upgrade installer from My Oracle Support.
For instructions, see "Downloading an Upgrade Installer From My Oracle Support" in Oracle Fusion Middleware Installation Guide for Oracle WebLogic Server.
Run the Upgrade installer in graphical mode to patch your WebLogic Server.
For instructions, see "Running the Upgrade Installer in Graphical Mode" in Oracle Fusion Middleware Installation Guide for Oracle WebLogic Server.
If you want to run the Upgrade installer in silent mode (for example, you have an environment where you need to patch multiple instances of Oracle WebLogic Server), see the instructions in "Running the Installation Program in Silent Mode" in Oracle Fusion Middleware Installation Guide for Oracle WebLogic Server.
If you have Oracle Fusion Middleware 11g Release 1 (126.96.36.199.0), and you are installing Oracle WebLogic Server for the first time to upgrade to Release 1 (188.8.131.52.0) or later, see the "Installation Overview" in the Oracle Fusion Middleware Installation Guide for Oracle WebLogic Server.
If you are patching your software in silent mode, you may encounter the following error messages:
"SEVERE:Values for the following variables could not be obtained from the command line or response file(s): MYORACLESUPPORT_USERNAME(MyOracleSupportUsername)"
To work around this issue, rename the
/ccr/bin/emCCR (on UNIX operating systems) or
\ccr\bin\emCCR (on Windows operating systems) file.
For example, on a UNIX operating system:
cd ORACLE_HOME/ccr/bin mv emCCR emCCR_LAST
On a Windows operating system:
cd ORACLE_HOME\ccr\bin mv emCCR emCCR_LAST
See "Silent Oracle Fusion Middleware Installation and Deinstallation" in Oracle Fusion Middleware Installation Planning Guide for more details about silent installation.
The following sections contain instructions on how to obtain the proper installer required to patch your product:
The installers you use to apply the latest Oracle Fusion Middleware patch sets vary in their behavior and capabilities, depending upon the product you are using. Before you begin the patching process, review Table 3-2 for information about the types of installers and what to expect when you run the installer to apply the latest patch set.
Note that this table is not a complete list of Oracle Fusion Middleware products. For a complete list of the products available with each patch set release, see the Oracle Fusion Middleware Download, Installation, and Configuration ReadMe Files.
Table 3-2 Summary of the Oracle Fusion Middleware Installers Used to Apply the Latest Patch Set
|Products||Type and Behavior of the Installer|
Oracle Application Developer Runtime
Oracle SOA Suite
Oracle Service Bus
Oracle WebCenter Portal
Oracle WebCenter Content
These installers are full installers that can also function as update installers. You can use them to update an existing 11g Release 1 Oracle home, or you can use them to install a new, complete Oracle home.
Oracle Identity Management
Oracle Web Tier
Oracle Business Intelligence
These installers are full installers that can also function as update installers. They can be used to update an existing 11g Release 1 Oracle home, or they can be used to install a new, complete Oracle home.
These installers also offer a configuration option. When using them to apply a patch set, you must select the option to install the software only. Do not select the option to configure the software. The domain you are patching is already configured and does not require any reconfiguration.
Oracle Forms, Reports and Discover
Note that Oracle Portal will remain 11g Release 184.108.40.206.0 as it is not being updated in this release.
This installer is an update-only installer, which requires an existing Oracle Fusion Middleware 11g Release 1 Oracle home.
To download and unpack the Installer files for your product:
Download the installer from the Oracle Technology Network, My Oracle Support, or Oracle Software Delivery Cloud (formerly E-Delivery).
For more information, see "Select an Oracle Fusion Middleware Software Download Site" and "Download the Software Required for Your Starting Point" in Oracle Fusion Middleware Download, Installation, and Configuration ReadMe Files.
Unpack the downloaded archive that contains the installer and software that you want to install into a directory on the target computer.
The following sections contain instructions on how to start the installer and apply the patch set for your product:
To start the installer you just downloaded and unpacked:
Change directory to the
Disk1 folder inside the unpacked archive folder.
Start the Installer:
On UNIX operating systems:
On Windows operating systems:
Depending on your system environment and product you are updating, you may be prompted to provide the location of a JRE/JDK on your system when you start the installer. When you installed Oracle WebLogic Server, a JRE was installed in the
version directory inside the Middleware home; you can use this location to start the installer.
If you do not have Oracle WebLogic Server installed on your system, you can use the JDK in the
jdk directory inside the Oracle home.
Make sure you specify the absolute path to your JRE/JDK location; relative paths are not supported.
The Installer can also be run in silent mode. See "Silent Oracle Fusion Middleware Installation and Deinstallation" in Oracle Fusion Middleware Installation Planning Guide for more details.
After you have started the Installer, follow the instructions on the screen to apply the patch set to your existing Middleware home.
If your domain includes multiple host computers, you must run the Installer separately on each host to update the software on that host.
As you review each screen of the installer, note that there are two significant differences between applying a patch set and installing software for the first time:
When you are applying a patch set, you must identify an existing Middleware home on the Specify Installation Location screen.
If you are installing Oracle Identity Management, Oracle Business Intelligence, or Oracle Web Tier, then you must perform a software only install and select the existing Middleware home and Oracle home you want to patch. There is no need to configure or re-configure your existing software.
Table 3-3 provides a summary of the typical installation screens you will see when you are applying a patch set to an existing Middleware home.
Oracle Fusion Middleware products in this release can be updated with their usual product installer.
If you need additional help with any of the installation screens, refer to Appendix A, "Installer Screens" or click Help to access the online help.
Table 3-3 Typical Installation Flow For Installing a Patch Set
This page introduces you to the Oracle Fusion Middleware installer.
Select the method you want to use for obtaining software updates, or select Skip Software Updates if you do not want to get updates.
If updates are found, the installer will automatically attempt to apply them at this point; make sure that the server you are using to perform the installation is connected to the Internet.
Some updates will require that the installer be restarted; if this happens, the Install Software Updates screen will not be seen the next time.
Verify that your system meets all necessary prerequisites.
Specify Oracle Middleware home and Oracle home locations.
The Oracle Common home (
Select the application server and specify its location.
Verify the information on this screen, then click Install to begin the installation.
This screen shows the progress of the installation.
When the progress shows 100% complete, click Next to continue.
Click Save to save your configuration information to a file. This information includes port numbers, installation directories, URLs, and component names which you may need to access at a later time.
After saving your configuration information, click Finish to dismiss the installer.
To see if your schema requires updating with the Patch Set Assistant, refer to Table 4-1, "Schemas That Require Updating for the Latest Release" in "Which Schemas Need to be Updated with Patch Set Assistant?".
If the product you are patching uses one of the schemas listed in the table, follow the instructions in Chapter 4, "Updating Your Schemas with Patch Set Assistant" to update your schemas.
If the product you are patching does not use one of these schemas, you can skip this section and proceed to Chapter 5, "Post-Patching Procedures".
After you have finished patching your software and performing any necessary post-patching tasks, you are ready to start the servers and processes.
Procedures for starting and stopping Oracle Fusion Middleware, including the Administration Server, Managed Servers, and components are provided in "Starting and Stopping Oracle Fusion Middleware" in Oracle Fusion Middleware Administrator's Guide.
Once the servers are restarted, you may need to clear your browser cache. See your internet browser documentation for information on clearing cache.
After you have successfully patched your environment, you can verify the status of your installation by performing any combination of the following:
View the log file located in the
/oracle_common/upgrade/logs (on UNIX operating systems) or
\oracle_common\upgrade\logs (on Windows operating systems) directory for details about the upgrade.
Check the domain server logs, which are located in the
servers directory inside the domain home directory. For example, on UNIX systems:
On Windows systems:
opmnctl status command from the
/bin (on UNIX operating systems) or
\bin (on Windows operating systems) directory in your instance home location. The example below shows the output on a UNIX system:
> ./opmnctl status Processes in Instance: asinst_1 ---------------------------------+--------------------+---------+--------- ias-component | process-type | pid | status ---------------------------------+--------------------+---------+--------- emagent_asinst_1 | EMAGENT | 11849 | Alive wc1 | WebCache-admin | 11333 | Alive wc1 | WebCache | 11332 | Alive ohs1 | OHS | 11207 | Alive
This information shows the components configured for this installation. The status "Alive" means the component is up and running.
You can also run the
opmnctl status -l command to obtain a list of ports used by the components. The example below shows the output on a UNIX system:
> ./opmnctl status -l Processes in Instance: asinst_1 ---------------------------------+--------------------+---------+----------+------------+----------+-----------+------ ias-component | process-type | pid | status | uid | memused | uptime | ports ---------------------------------+--------------------+---------+----------+------------+----------+-----------+------ emagent_asinst_1 | EMAGENT | 11849 | Alive | 1133259606 | 4204 | 0:09:38 | N/A wc1 | WebCache-admin | 11333 | Alive | 1133259605 | 43736 | 0:15:35 | http_admin:8091 wc1 | WebCache | 11332 | Alive | 1133259604 | 63940 | 0:15:35 | http_stat:8092,http_invalidation:8093,https_listen:8094,http_listen:8090 ohs1 | OHS | 11207 | Alive | 1133259603 | 50744 | 0:15:43 | https:8889,https:8890,http:8888
Verify that you can access your installed and configured products, as shown in Table 3-4:
Table 3-4 Installed Product URLs
|Product or Component||URL|
Administration Server Console
Enterprise Manager Console
Enterprise Manager Agent
Oracle Discoverer Viewer