CA API Gateway 9.2

PDF
index 10.0 congw.10.0 9.4 9.3 9.2 9.1 9.0
English

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.
 Be sure to back up your Gateway before installing a patch. For more information, see  Back Up Gateways.
Obtain the Patch Files
 
To obtain the patch files
:
  1. Go to the CA Support site: https://casupport.broadcom.com 
  2. Sign into your account.
  3. Select 
    Download Management
     and search for "CA 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 CA 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.