Patch a Software Gateway

This section describes how to patch gateways in the Software form factor.
gateway92
This section describes how to patch
Layer7 API Gateway
s in the Software form factor.
The Gateway provides patch management feature to help you organize the incremental patches for the Gateway. These patches may be issued by CA Technologies to update functionality in the Gateway software.
Before installing a patch, be sure to
  • Back up your Gateway before installing a patch. For more information, see Back Up Gateways.
  • Stop any running Gateways with the following command:
    /opt/SecureSpan/Gateway/runtime/bin/gateway.sh stop
Obtain the Patch Files
To obtain the patch files
:
  1. Go to the Support site: https://support.broadcom.com/
  2. Sign into your account.
  3. Select
    Download Management
    and search for "Layer7 API Gateway".
  4. Select your Gateway product from the results that appear. A list of DVD images is displayed.
  5. In the "Service Pack" column, '0000' indicates the base release, while a number such as '01' indicates a service pack release.
  6. Download the appropriate archive(s) to your hard drive and unzip them.
  7. Locate the necessary patch files in the archive and copy them to a temporary location on your hard drive.
    Tip:
    See List of Update Files for the names of patch files you need.
  8. Copy the patch files to the following directory on the Gateway:
    /opt/SecureSpan/Controller
Obtain Cumulative Release Patch Files
In between major releases, check the following site regularly for cumulative releases. You should receive proactive notification emails from Support when these are available.
To download cumulative release patch files for the Gateway:
Install a Patch
To install a patch
:
  1. Log in as the
    root
    user.
  2. Run the following command:
    # /opt/SecureSpan/Controller/bin/patch.sh <target> <action>
    Where:
    • "<target>"
      is either the patch API endpoint URI or the Process Controller home directory; if not specified, the <
      target
      > defaults to:
      /opt/SecureSpan/Controller
    • "<action>"
      is one of the actions in the table below.
  3. If you have installed a patch, you may be prompted to restart the Gateway.
Action
Description
upload
<filename>
Uploads the patch named
<filename>
to the Gateway.
install
<patch_ID>
Installs the patch with the identifier
<patch_ID>
. This patch must already be uploaded using the
upload
action.
The patch ID is normally the patch file name, excluding the extension.
A message indicates that the patch is successfully installed. On-screen messages notify you If further configuration is required or if a Gateway restart is necessary.
delete
<patch_ID>
Removes an uninstalled patch from the list of registered patches on the Gateway. It physically deletes the patch from the internal repository, but not from the original pre-upload location.
Note the following when deleting a patch:
  • Only patches in the UPLOADED state can be deleted.
  • Deleting a patch only sets its state to NONE -- the patch itself is not physically removed from the appliance.
  • A deleted patch may be uploaded and installed again if necessary.
list
Lists all the patches currently registered on the Gateway and their statuses.