Download Patches Using the Patching Tool Utility

Oracle WebLogic Server for Oracle Cloud Infrastructure 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.

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 and BSU (BEA Smart Update) for 11g.

    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.

    Note: You can also download unencrypted patches.

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

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