List of Update Files

This section lists the files that are required to upgrade your gateway to Release 10.0. These instructions apply to both Software and Appliance Gateway form factors (Hardware and Virtual).
gateway10
This section lists the files that are required to upgrade your
Layer7 API Gateway
to Release 10.0. These instructions apply to both Software and Appliance Gateway form factors (Hardware and Virtual).
For detailed instructions on upgrading your Gateway, see Upgrade a Software Gateway.
The update files are contained in image files from the distribution archives. For more information, see "Distribution Archive Files" in Release Notes.
Contents:
Background
The Gateway is designed around two major components: Platform and Application.
  • The
    Platform
    consists of the server that runs the API Gateway appliance and the dependency applications and tools that are located on it. This includes (but not limited to) the Linux kernel, OpenSSL, and MySQL.
  • The
    Application
    is the Java component of the API Gateway. The Application comprises the JDK and the Java programs that comprise the API Management suite.
    AdoptOpenJDK and Gateway Version 10.0 CR3
    We recommend the use of AdoptOpenJDK 8u275-b01 for Gateway version 10.0 CR3.
    AdoptOpenJDK and Gateway Version 10.0 CR2
    We recommend the use of AdoptOpenJDK 8u265-b01 for Gateway version 10.0 CR2.
    AdoptOpenJDK and Gateway Version 10.0 CR1
    We recommend the use of AdoptOpenJDK 8u252-b09 for Gateway version 10.0 CR1.
    AdoptOpenJDK and Gateway Version 10.0
    We recommend the use of AdoptOpenJDK 8u242-b08 for Gateway version 10.0. Before upgrading your Gateway to version 10.0, save a copy of your java.security file in case you have customized it.
Components are designed to be updated separately, allowing systems administrators to upgrade the Platform without upgrading the Application. This ensures that the Gateway remains compliant with security protocols and is protected against common threats. A Gateway upgrade involves upgrading both the Platform and Application.
Upgrading Hardware Appliances and Virtual Appliances
Platform updates are required for Hardware Appliances and Virtual Appliances. They are not required for Software Gateways. Ensure that the host computer on which the Gateway is installed is updated according to best practices.
You must use one of the expedited upgrade procedures to get to Gateway 10.0.
The Manual Expedited Upgrade Procedure consists of installing a new Gateway, then manually migrating data from the older Gateway version. The current procedure is supported for migrating from Gateway 9.x to Gateway 10.0.
An alternative to this manual procedure is the Automated Expedited Upgrade Procedure. The benefits of the automated procedure include ease of backup and configuration, and the ability to upgrade multiple Gateway clusters simultaneously. The Automated Expedited Upgrade procedure is only supported for migrating data from Gateway 9.4 to Gateway 10.0.
The Standard Upgrade Procedure using sequential platform patches is not supported between 9.x to 10.x.
If you have an Appliance Gateway (either hardware or virtual), use the following update files:
  • Layer7_API_Gateway_v10.0.00.L7P
  • CA_SSO_SDK_Compact_v12.52.L7P
  • (Available in version 10.0 CR1)
    CA_SSO_SDK_Compact_v12.8.03.L7P (required only if your Gateway communicates with the CA Single Sign-On product; install after
    Layer7_API_Gateway_v10.0.00.L7P
    ).
Starting in version 10.0, Hardware Appliance Gateways and Virtual Appliance Gateways run only on CentOS 7.
Upgrading Software Appliances
If you have a Software Gateway, use the appropriate update files based on your host operating system (RHEL/CentOS):
  • Layer7_API_Gateway_v10.0.00.L7P
  • CA_SSO_SDK_Compact_v12.52.L7P (required only if your Gateway communicates with the CA Single Sign-On product; install after
    Layer7_API_Gateway_v10.0.00.L7P
    ). This file installs the compact version (reduced size) of the SSO SDK.
  • (Available in version 10.0 CR1)
    CA_SSO_SDK_Compact_v12.8.03.L7P (required only if your Gateway communicates with the CA Single Sign-On product; install after
    Layer7_API_Gateway_v10.0.00.L7P
    ).
CA Single Sign-On Users, note the following if you are using API Gateway v10.0:
  • If the CA Single Sign-On SDK v12.51 or higher
    already exists
    on the Gateway, applying the "CA_SSO_SDK_Compact" patch will
    upgrade
    the SDK to v12.52.01.09 (for both Software and Appliance Gateways).
  • If the CA Single Sign-On SDK v12.51 or higher
    does not already exist
    on the Gateway, applying the "CA_SSO_SDK_Compact" patch will
    not
    install
    the v12.52.01.09 SDK. If you need this SDK, see Install the CA Single Sign-On SDK for Software Gateways to install it manually.
  • If the CA Single Sign-On SDK v12.8.03
    does not already exist
    on the Gateway, applying the "CA_SSO_SDK_Compact" patch will
    not
    install
    the v12.8.03 SDK. If you need this SDK, see Install the CA Single Sign-On SDK for Software Gateways to install it manually. This is applicable for both Software and Appliance Gateways.