Patch Management Using the Patching Utility Tool on Windows

Use the patching utility tool in Oracle WebLogic Server for OCI to list, download, and get information about patches. You can also view the patching utility version and upgrade the patching utility.

Note:

For information on connecting to the Compute instance using the Remote Desktop, see Connecting to WebLogic Server for OCI Windows Images Deployed on Private Subnet

View Patching Utility Tool Version

Use the patching utility tool to view the build version along with the Oracle license and copyright information.

  1. Connect to the Compute instance as the opc user with Remote Desktop.
  2. Bring up a command window and print the build version.
    patch-utils -v

    Sample output:

    Weblogic Cloud Patch-Utils <Patch version number>
    Copyright (c) 2020, Oracle Corporation and/or its affiliates.Licensed under the Universal Permissive License v 1.0 as shown at
    https://oss.oracle.com/licenses/upl.

Configure Initial Setup

The patches are hosted on the object storage locations in the regions supported by the patching tool. Currently, the regions: us-phoenix-1, us-ashburn-1, eu-frankfurt-1, ap-mumbai-1, ap-tokyo-1, and sa-saopaulo-1 are supported.

Ensure that you establish a connection from the WebLogic compute instance where you are running patch-utils to the object storage endpoints for the regions that are listed in the following table.

Table 8-4 Object Storage Endpoints for the Supported Regions

Region Object Storage Endpoint

us-phoenix-1

https://objectstorage.us-phoenix-1.oci.oraclecloud.com

us-ashburn-1

https://objectstorage.us-ashburn-1.oraclecloud.com

eu-frankfurt-1

https://objectstorage.eu-frankfurt-1.oraclecloud.com

ap-mumbai-1

https://objectstorage.ap-mumbai-1.oraclecloud.com

ap-tokyo-1

https://objectstorage.ap-tokyo-1.oraclecloud.com

sa-saopaulo-1

https://objectstorage.sa-saopaulo-1.oraclecloud.com

Note:

You must configure a NAT gateway to use the patching tool functionality if:
  • Your WebLogic compute instance is deployed in a region different from those listed in the Table 8-3.
  • Your WebLogic compute instance is deployed in a region different than the region where you set up the patching tool configuration.

  1. Connect to the Compute instance as the opc user with Remote Desktop.
  2. Bring up a command window and set up the configuration:
    patch-utils setup

    Sample output:

    Choose wls version ['12.2.1.4','14.1.1.0']: 12.2.1.4
    Choose oci region for patch download ['us-ashburn-1', 'eu-frankfurt-1', 'ap-mumbai-1', 'ap-tokyo-1', 'us-phoenix-1', 'sa-saopaulo-1']: us-phoenix-1
    Created config file [C:\Users\opc\.patchutils\config]

List Patches

Use the patching utility to list all the available patches in the object storage. You can also list current patches and latest patches that are available in the patching utility repository.

Note:

You must set up the configuration file before running the patch-utils list command as described in Configure Initial Setup.

  1. Connect to the Compute instance as the opc user with Remote Desktop.
  2. Bring up a command window and list all patches for the applicable WebLogic Server version.
    patch-utils list

    Sample output:

     Patch Id       Description
    -------------------------------------------------------------------------------------  
    32471832  Generic Platform patch for WebLogic Server. Adds a system property to disable file store locks. Patch applicable for Oracle WebLogic Server on OKE.  
    32905339  Generic Platform Patch for Oracle Web Services Manager  
    34604561  FMW Thirdparty Bundle Patch 12.2.1.4.220915  
    32880070  Generic Platform Patch for Oracle Fusion Middleware  
    33059296  Testing WLS PATCH SET UPDATE 12.2.1.4.210629  
    33059296  Generic Platform Patch for Oracle WebLogic Server  
    32684757  Generic Platform Patch for Jdeveloper, WLS version: 12.2.1.4.210325  
    34535558  ADF Bundle Patch 12.2.1.4.220825  
    34653267  WLS Patch Set Update 12.2.1.4.220929  
    34566592  OWSM Bundle Patch 12.2.1.4.220905  
    34542329  Merge Request on Top of 12.2.1.4.0for Bugs 34280277 26354548 26629487 29762601  
    34545596  Coherence 12.2.1.4 Cumulative Patch 15(12.2.1.4.15)  
    33084721  Testing ADF BUNDLE PATCH 12.2.1.4.210706  
    32973297  Oracle Coherence Cummulative Patch  
    33084721  Generic Platform Patch for Jdeveloper  
    36068046  Coherence 12.2.1.4 Cumulative Patch 20(12.2.1.4.20)  
    36155700  WLS Patch Set Update 12.2.1.4.240104  
    36074941  ADF Bundle Patch 12.2.1.4.231205  
    36086980  FMW Thirdparty Bundle Patch 12.2.1.4.231207  
    35965629  ADR for Weblogic Server 12.2.1.4.0 Size Optimized for Jan 2024  
    35868571  OWSM Bundle Patch 12.2.1.4.231003  
    35778804  Coherence 12.2.1.4 Cumulative Patch 19(12.2.1.4.19) 
    28186730  Opatch 13.9.4.2.14 for EM 13.4, 13.5 and FMW/WLS 12.2.1.3.0, 12.2.1.4.0 and 14.1.1.0.0
  3. List the latest patches and other component patches for the relevant WebLogic Server version, from the available patches in catalog.
    patch-utils list -L

    Sample output:

    Choose the  component ['WLS', 'FusionMiddleware','Coherence', 'Forms', 'Database'] (default: ALL):   
    Patch Id  Patch Components        Description
    ------------------------------------------------------------------------------------------  
    36068046  WLS, FMW, COH       Coherence 12.2.1.4Cumulative Patch 20(12.2.1.4.20)  
    36155700  WLS, FMW            WLS Patch Set Update 12.2.1.4.240104  
    36074941  FMW                 ADF Bundle Patch 12.2.1.4.231205  
    36086980  WLS, FMW            FMW Thirdparty Bundle Patch 12.2.1.4.231207  
    35965629  WLS, FMW            ADR forWeblogic Server 12.2.1.4.0Size Optimized forJan 2024  
    35868571  WLS, FMW            OWSM Bundle Patch 12.2.1.4.231003

View Patch Details

Use the patching utility to view information of the specified patch.

The WebLogic Server patches include the readme file that provides the patch details and other useful information about patching.

  1. Connect to the Compute instance as the opc user with Remote Desktop.
  2. Bring up a command window and list all patches for the applicable WebLogic Server version.
    patch-utils info -i <Patch ID>

    The first ten lines of the readme.txt file are displayed.

    Sample output:

    Oracle Coherence 12.2.1.4.19 Release
    Released: September, 2023 
    
    Oracle Coherence 12.2.1.4.19 README
    =================================== 
    This README provides information about how to apply the patch update to OracleCoherence 12.2.1.4.0 using OPatch. 
    OPatch and Oracle Fusion Middleware Installation Documentation
    --------------------------------------------------------------
    .........more....

Download Patches

Use the patching utility to download the patches to a directory.

If your WebLogic compute instance does not have connectivity to the object storage endpoints for the regions that you configured in the initial setup, you must download the patches on the bastion host that you created with Oracle WebLogic Server for OCI and then copy the zip files to the WebLogic VM.

  1. Connect to the Compute instance as the opc user with Remote Desktop.
  2. Bring up a command window and download the latest patches for the applicable WebLogic Server version.
    patch-utils download -L -p <Location to download>
    Sample output:
    Choose the component ['WLS','FusionMiddleware','Coherence', 'Forms', 'Database'] (default: ALL):
    Successfully downloaded following patch(es). Please copy them to weblogic hosts and apply them using WebLogic opatch utility.
    ['p36068046_122140_Generic.zip', 'p36155700_122140_Generic.zip', 'p36074941_122140_Generic.zip', 'p36086980_122140_Generic.zip', 'p35965629_122140_MSWIN-x86-64.zip', 'p35868571_122140_Generic.zip', 'p28186730_122140_1394214_Generic.zip']
  3. You can also download a patch using the patch ID.
    patch-utils download -l <Patch ID> -p <Location to download>
    Sample output:
    Successfully downloaded following patch(es). 
    Please copy them to weblogic hosts and apply them using WebLogic opatch utility.
    ['p35778804_122140_Generic.zip']

Upgrade Patching Utility

Use the patching tool to upgrade the patching tool to the latest version.

Note:

Upgrading the patching utility requires elevated privileges. The command window must be opened with "Run as Administrator".

  1. Connect to the Compute instance as the opc user with Remote Desktop.
  2. Bring up a command window from the Start menu, right-click and select "Run as Administrator", and print the build version.
    patch-utils upgrade
    Sample output:
    Successfully updated patch-utils to [<Patch Utils version number>]. Please rerun patch-utils.