Applying a Patch Using Smart Update

NOTE: Downloading and Installing Smart Update 3.3.0 (see http://docs.oracle.com/cd/E14759_01/doc.32/e14143/intro.htm#CHDCAJFC).

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. The directory MW_HOME\utils\bsu\cache_diris created as the default patch download directory when you install Smart Update 3.3.0. (see http://docs.oracle.com/cd/E14759_01/doc.32/e14143/intro.htm#CHDCAJFC

• 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.                                                                                                                                                                                                                                                                                                                      

• 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 (seehttp://download.oracle.com/docs/cd/E14759_01/doc.32/e14143/commands.htm#i1074489).

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.

1. Look for the patches you copied in the "Downloaded Patches" section at the bottom.

1. 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:

https://support.oracle.com/epmos/main/downloadattachmentprocessor?parent=DOCUMENT&sourceId=876004.1&attachid=876004.1:bsu_gui_viewlet&width=100%&height=100%

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=E5W8,WGQJ -verbose -instal
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

 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.



Command line examples to manage Patches in WLS :


[root@NA9F2RFV1 bsu]# pwd
/opt/thirdparty/Oracle/Middleware/utils/bsu

• Command to see all downloaded patches in system - 

[root@NA9F2RFV1 bsu]# ./bsu.sh -prod_dir=/opt/thirdparty/Oracle/Middleware/wlserver_10.3 -patch_download_dir=/opt/thirdparty/Oracle/Middleware/utils/bsu/cache_dir -status=downloaded -view -verbose

•  Command to see all applied patches in system -  

 ./bsu.sh -prod_dir=/opt/thirdparty/Oracle/Middleware/wlserver_10.3/ -status=applied -view -verbose

• Command to see install patchs - 

./bsu.sh -prod_dir=/opt/thirdparty/Oracle/Middleware/wlserver_10.3 -patchlist=21FC -verbose -install

• Command to see Uninstall/Remove patchs -

./bsu.sh -prod_dir=/opt/thirdparty/Oracle/Middleware/wlserver_10.3 -patchlist=21FC -verbose -remove


-- Srikanth Govada