Apply WebLogic Server (WLS) Patches Using Smart Update

How to Apply WebLogic Server (WLS) Patches Using Smart Update [Video] [ID 876004.1]
	修改时间 24-FEB-2012     类型 HOWTO     状态 PUBLISHED

In this Document
  Goal
  Solution
     1. Using Smart Update
     2. Applying the patch to the classpath manually
  References

Applies to:

Oracle Weblogic Server - Version: 9.0 and later   [Release: and later ]
Information in this document applies to any platform.

Goal

This document explains how to apply patches to a system using Smart Update.

Solution

There are two ways to apply patches to a system:

1. Using Smart Update

You can apply the patch using Smart Update with the following steps:

1. Download the patch from My Oracle Support (MOS). For more details, please refer to Master Note: How to Locate and Download Patches for WebLogic Server Using My Oracle Support Note 1302053.1.
2. Extract the contents from the zip file: you will have a jar file and patch-catalog_xxx.xml. A readme file may also be included.
3. Copy the files (for example, E5W8.jar and WGQJ.jar) and the patch-catalog_xxx.xml from the zip file to the target machine. You do not need the readme file. Copy the files to the appropriate cache_dir directory for the target system: for example, on Windows, %MIDDLEWARE_HOME%\utils\bsu\cache_dir, or on UNIX, $MIDDLEWARE_HOME/utils/bsu/cache_dir.

NOTE: Always copy the patch-catalog_xxx.xml file from the downloaded patch to the cache_dir along with the patch itself. Do NOT rename this file. If you see an "unrecognized patch ID" error, please refer to Note 1186923.1 for details on how to resolve it.

 

4. Run Smart Update and apply the patches and/or patch sets to the target system. This can be done using the Smart Update GUI or the command-line interface (see http://download.oracle.com/docs/cd/E14759_01/doc.32/e14143/commands.htm#i1074489).

a. Smart Update in graphical (GUI) mode

1. Run the <MIDDLEWARE_HOME>/utils/bsu/bsu script (bsu.sh for UNIX, bsu.cmd for Windows). This will start the Smart Update GUI.
2. Look for the patches you copied in the "Downloaded Patches" section at the bottom.
3. Select the "Apply" button for each patch you want to apply. This will validate the patch and apply it to the whole installation.

The following viewlet provides an example of using Smart Update in GUI mode:

Video - Applying a Patch Using Smart Update in GUI Mode (1:15)

b. Command-line interface

1. This is the syntax for the command to view the downloaded patches as below:

./bsu.sh -prod_dir=<weblogic_home> -patch_download_dir=<download dir of patch> -status=downloaded -view -verbose

For example:

./bsu.sh -prod_dir=/opt/bea/weblogic92 -patch_download_dir=/opt/bea/utils/bsu/cache_dir -status=downloaded -view -verbose

2. This is the syntax for the command to install a patch:

./bsu.sh -prod_dir=<weblogic_home> -patchlist=<patchID> -verbose -install

For example:

./bsu.sh -prod_dir=/opt/bea/weblogic92 -patchlist=E5W8 -verbose -install
./bsu.sh -prod_dir=/opt/bea/weblogic92 -patchlist=WGQJ -verbose -install

3. This is the syntax for the command to check if the patch is installed:

./bsu.sh -prod_dir=<weblogic_home> -patch_download_dir=<download dir of patch> -status=applied -verbose -view

For example:

./bsu.sh -prod_dir=/opt/bea/weblogic92 -status=applied -verbose -view

2. Applying the patch to the classpath manually

You can apply the patch to the system manually by extracting the actual patch and adding it to the classpath on the system:

1. Extract the actual patch jar file. It will be in the form <patch_id>.jar (for example: E5W8.jar). Inside this jar file is the actual patch jar file, which will be of the form CR326566_92mp3.jar. Extract the latter file for the following steps.
2. Add the extracted jar file as the first element of the classpath of the Admin server as well as the managed servers in the domain.
3. If you are starting servers using the WebLogic Server startup script, update the classpath in the startup script like this:

set CLASSPATH=<PATCH_DIR>\jars\CR326566_92mp3.jar;%CLASSPATH% (Windows)
CLASSPATH=<PATCH_DIR>/jars/CR326566_92mp3.jar:$CLASSPATH (UNIX)

where PATCH_DIR is the directory on the machine where you extracted/saved the patch file.

4. Similarly, if you are starting servers using Node Manager, add the patch jar to the beginning of the Class Path argument in the Server Start tab for the server(s).

NOTE: Applying the patch to the classpath manually (approach 2) is recommended only for releases prior to WLS 9.1. Smart Update should be used when it is available as it provides patch conflict and dependency checking.