Download Patches Using the Patching Tool Utility

Oracle WebLogic Server for OCI provides the patching tool utility to download the patches for the WebLogic Server instances. This utility can be used if you do not have access to the support portal to download the required patches.

Note:

  • The patching tool utility is available only for Oracle WebLogic Server for OCI instances provisioned after release 20.4.3 (December 23, 2020).
  • For instances provisioned prior to release 20.4.3 (before December 23, 2020), download the WebLogic Server patches by using the My Oracle Support website.
  • For UCM only license users, who does not have access to My Oracle Support, open a Support Ticket to get the unique link to download the quarterly Patch Set Updates (PSUs).

From release 21.3.3 onwards, you can use the patching tool utility to download patches for custom images that are created from Oracle WebLogic Server for OCI instance.

For custom images created from existing instances with older version of patching tool, the patching tool utility does not work. So, before you create custom images from existing instances, Oracle recommends you to upgrade the patching tool to the latest version using the patch-utils upgrade command. With the patching tool upgrade, the images use the latest version of patching tool utility with two keys for decryption.

For existing instances created from the Marketplace, you need not upgrade the patching tool. You can use the older version of the patching tool to download the patches.

You can use this patching tool utility on the WebLogic Server compute instance and the bastion instance.

If you provision an instance in a private subnet without a bastion (without NAT gateway), you must create a temporary bastion instance in the Oracle Cloud Infrastructure console, and then use the patching tool to download the patches on the bastion host.

These patches can then be applied only on the WebLogic Server VMs using the patching tool utility.

With this patching tool utility, you can list, download, apply, and upgrade the patches for the WebLogic Server instances.

Note:

Using this utility, you cannot apply the patch for a bastion instance.

  1. Identify the following IP address of the node in your domain:
    • The public IP address to the Administration Server node.
    • The public IP address of the bastion and the private IP address of the compute instance.
  2. From your computer, run the ssh command to connect to the domain's Administration Server node as the opc user.
    ssh -i <path_to_private_key> opc@<node_IP_address>

    Or,

    ssh -i <path_to_private_key> -o ProxyCommand="ssh -W %h:%p -i <path_to_private_key> opc@<bastion_public_ip>" opc@<node_private_ip>
  3. Run the following commands:
    Command Output/Result Description

    patch-utils -v

    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.

    Displays the build version, and Oracle license and copyright information

    patch-utils setup

    Enter middleware home (default: /u01/app/oracle/middleware):

    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 [/home/opc/.patchutils/config]

    Configures the region from where to download the patches and creates the configuration file in the specified middleware Home.

    Note: The user can download the patches from the five specified regions only.

    patch-utils list

    <Patch number> ADF Bundle Patch for Bug: <Bug number>, WLS version: <WLS version number>

    <Patch number> OPSS Patch Bundle Patch for Bug:<Bug number>, WLS version: <WLS version number>

    <Patch number> PATCH <Patch number> - OPATCH <OPatch version number> FOR FMW/WLS <WLS version number> AND <WLS version number>

    <Patch number> Oracle Coherence Patch Bundle Patch for Bug:<Bug number>, WLS version: <WLS version number>

    <Patch number> Weblogic Service Patch Bundle Patch for Bug:<Bug number>, WLS version: <WLS version number>

    Lists the patches in the patch catalog for the applicable WebLogic Server version.

    Note: You must set up the configuration file before running the patch-utils list command.

    patch-utils list -a

    Listing current patches

    Oracle Interim Patch Installer version <Patch version number>)

    Copyright (c) 2020, Oracle Corporation. All rights reserved

    Oracle Home : /u01/app/oracle/middleware

    Central Inventory : /u01/app/oraInventory

    from : /u01/app/oracle/middleware/oraInst.loc

    OPatch version : <OPatch Version number>

    OUI version : <OUI Version number>

    Log file location : /u01/app/oracle/middleware/cfgtoollogs/opatch/<opatchtimestamp>.log

    OPatch detects the Middleware Home as "/u01/app/oracle/middleware"

    Lsinventory Output file location : /u01/app/oracle/middleware/cfgtoollogs/opatch/lsinv/<lsinventoryopatchtimestamp>.txt

    Local Machine Information:

    Hostname: testwls-wls-0.wlssubnet.subnet1.oraclevcn.com

    ARU platform id: <ID number>

    ARU platform description:: Linux x86-64

    Interim patches (2):

    Patch <WebLogic 12c version number>: applied on <day month date time>

    Unique Patch ID: <Patch ID number>

    Patch description: "Bundle patch for Oracle Coherence Version <WebLogic 12c version number>"

    Created on <date month year time>

    Bugs fixed:<Bug number>

    Patch <Patch number>: applied on <day month date time>

    Unique Patch ID: <Patch ID number>

    Patch description: "ADF Bundle patch <WebLogic 12c version number>"

    Created on <date month year time>

    Bugs fixed:<Bug number1>, <Bug number2>, <Bug number3>

    OPatch succeeded.

    Lists all the current patches based on OPatch utility for 12c.

    Note: You must set up the configuration file before running the patch-utils list -a command.

    patch-utils info -n <Patch ID>

    Patch Set Update (PSU) for Bug: <Bug number>

    Date: Fri Feb 28 17:33:37 2020

    Platform Patch for : Generic

    Product Patched : ORACLE WEBLOGIC SERVER

    Product Version : <WLS version number>

    This document describes how to install patch for bug # 31985811.It includes the following sections:

    Section 1: Known Issues

    .......

    more

    ....

    Displays information of the specified patch.

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

    Note: You can use the -l parameter to print the specified number of lines from the readme file.

    Example:

    patch-utils info -n <Patch ID> -l 25

    patch-utils download -l <Patch ID> -p <Location to download>

    Successfully downloaded following patches.

    Please copy them to weblogic hosts and apply them locally.['<Patch ID_Generic.zip']

    Downloads the patches to the specified location.

    To download multiple patches, specify the patch IDs as comma separated values.

    patch-utils apply -l <Patch ID>

    Applying OPATCH patch <OPatch ID>

    Oracle Interim Patch Installer version <OPatch Version number>

    Copyright (c) 2020, Oracle Corporation. All rights reserved.

    Oracle Home : /u01/app/oracle/middleware

    Central Inventory : /u01/app/oraInventory

    from : /u01/app/oracle/middleware/oraInst.loc

    OPatch version : <OPatch Version number>

    OUI version : <OUI Version number>

    Log file location : /u01/app/oracle/middleware/cfgtoollogs/opatch/<opatchtimestamp>.log

    OPatch detects the Middleware Home as "/u01/app/oracle/middleware"

    Verifying environment and performing prerequisite checks...

    OPatch succeeded.

    Leverages the OPATCH utility found in the middleware home to apply individual patches.

    If you receive an error that the Weblogic servers are running on the host, you must stop the servers. See Start and Stop a Domain

    The patches that are already installed in the middleware Home are not applied. You can apply multiple patches by specifying the patch IDs as comma separated list. The patches are applied in the order they are specified.

    patch-utils apply -f /tmp/<Patch ID>.zip

    Listing opatch inventory before applying new patches

    Oracle Interim Patch Installer version <OPatch Version number>

    Copyright (c) 2020, Oracle Corporation.  All rights reserved.

    Oracle Home : /u01/app/oracle/middleware

    Central Inventory : /u01/app/oraInventory

    from : /u01/app/oracle/middleware/oraInst.loc

    OPatch version : <OPatch Version number>

    OUI version : <OUI Version number>

    Log file location : /u01/app/oracle/middleware/cfgtoollogs/opatch/<opatchtimestamp>.log

    OPatch detects the Middleware Home as "/u01/app/oracle/middleware"

    Local Machine Information:

    Hostname: testwls-wls-0.wlssubnet.subnet1.oraclevcn.com

    ARU platform id: <ID number>

    ARU platform description:: Linux x86-64

    Interim patches (2):

    Patch <WebLogic 12c version number>: applied on <day month date time>

    Unique Patch ID: <Patch ID number>

    Patch description: "Bundle patch for Oracle Coherence Version <WebLogic 12c version number>"

    Created on <date month year time>

    Bugs fixed:<Bug number>

    Patch <Patch number>: applied on <day month date time>

    Unique Patch ID: <Patch ID number>

    Patch description: "ADF Bundle patch <WebLogic 12c version number>"

    Created on <date month year time>

    Bugs fixed:<Bug number1>, <Bug number2>, <Bug number3>

    OPatch succeeded

    Applying OPATCH patch <_ OPatch ID.zip>

    Oracle Interim Patch Installer version <OPatch Version number>

    Copyright (c) 2020, Oracle Corporation. All rights reserved.

    Oracle Home : /u01/app/oracle/middleware

    Central Inventory : /u01/app/oraInventory

    from : /u01/app/oracle/middleware/oraInst.loc

    OPatch version : <OPatch Version number>

    OUI version : <OUI Version number>

    Log file location : /u01/app/oracle/middleware/cfgtoollogs/opatch/<opatchtimestamp>.log

    OPatch detects the Middleware Home as "/u01/app/oracle/middleware"

    Verifying environment and performing prerequisite checks...

    OPatch succeeded.

    Applies the patch using the local zip file.

    Note: In case of private subnets that do not have network access to outside of Oracle Cloud, you must download the patching zip file on the bastion host, and copy the zip file that has the tool and the VM key to the Weblogic Server VM in the private subnet.

    If you receive an error that the Weblogic servers are running on the host, you must stop the servers. See Start and Stop a Domain.

    The patches that are already installed in the middleware Home are not applied. You can apply multiple patches by specifying the patch numbers as comma separated lists. The patches are applied in the order they are specified.

    patch-utils upgrade

    Note: This command is used to upgrade VMs if the NAT Gateway is enabled on the WebLogic Server subnet.

    Successfully updated patch-utils to [<Patch Utils version number>]. Please rerun patch-utils.

    Upgrades the patching tool utility to the latest version.