Release Notes 10.0
Summary of enhancements, fixes, and open issues.
This page contains important upgrade notes and a distribution archives list for the Layer7 API Gateway version 10.0
Gateway Version 10.0 CR2
Changes to Layer7 API Gateway Techdocs
The release of Gateway version 10.0 CR2 also marks a significant change to how Gateway documentation is published. Content that's exclusive to the installation, configuration, and operation of the Container Gateway has been moved to the new Layer7 API Container Gateway Techdocs site. All content relevant to the other form factors, including the appliance or software form factors, will continue to be published and maintained on this Layer7 API Gateway Techdocs site.
Techdocs documentation for the API Gateway Policy Plugin is now available.
Gateway Version 10.0 CR1
[Issued September 10, 2020] For customers using the API Gateway with the Layer7 API Developer Portal, a sync issue exists that renders some Portal-published APIs incompatible with API Gateway version 10 CR1. As a temporary workaround, we recommend API Portal customers to use other versions of the API Gateway while a fix is being worked on. In the case where an upgrade has been performed and a rollback is not possible, you can download and manually install an attached revised policy from Broadcom Support. See KB 199747: Compatibility with API Portal 4.x and API Gateway 10 CR1 for details.
Expedited Appliance Upgrade Procedure Required
Applies to hardware appliance and virtual appliance API Gateways. Includes customers hosting the Gateway on AMI and Azure.
Due to the CentOS 7.x platform requirement of this major release, the Expedited Appliance Upgrade procedure is
requiredwhen upgrading an earlier Gateway version to Gateway version 10.0. If you intend to migrate multiple appliance Gateway 9.4 clusters to Gateway 10.0, consider using the Automated Expedited Upgrade procedure.
Software Gateway customers can upgrade to version 10.0 by using the standard patching process.
It's also strongly recommended that you review the Known Issues related to the CentOS 7 platform prior to performing the upgrade.
CentOS 7 allows customers to take advantage of the new Gateway features and enhancements listed here.
If you are using Gateway solution toolkits such as the OAuth Toolkit or the Mobile API Gateway for your virtual appliance Gateway, you must manually back up all customized system properties prior to reinstalling the solution toolkits on the new Gateway version 10.0 instance.
Impact on Gateway Solution Toolkits
Changes to Enterprise Service Manager Support
Please be advised that new releases of Enterprise Service Manager (ESM) are not planned after version 1.19. While it is not officially packaged with Gateway version 10.0, ESM version 1.19 should continue to work with Gateway version 10.0 as designed.
However, it is highly recommended that customers with an existing ESM license who plan to continue using ESM host it on an exclusive Gateway server that's dedicated to the operation of the ESM version 1.19. Because the ESM was last officially packaged with the Gateway in the version 9.4 CR4 Gateway image, the dedicated server should have Gateway 9.4 CR4 installed.
New Gateway Licenses
New Gateway version 10.0 licenses can be requested through the Customer Care Web Form. When filling out the form, be sure to select
Licensing - CA Enterprise Softwareas the Request Type.
Release 10.0 is distributed across the following .ZIP archives. Download the ones you need. For detailed instructions on how to access these archives, see "Obtain the Patch Files" in Patch a Software Gateway.
Distribution Archives for 10.0
Layer7 API Gateway Software Installer Upgrader-10.0.00
Gateway software install for CentOS, Application Upgrade patch file - L7P
Layer7 API Gateway CustomAssertions-10.0.00
Custom Assertion installation files
The Apply DFDL Transformation Assertion is the only custom assertion to be included in the Gateway Version 10 custom assertions archive. If you must use or install any other custom assertions, please find them in the distribution archives for Gateway version 9.4.
Layer7 API Gateway DevelopmentTools-10.0.00
Gateway Management Developer Kit, Gateway Migration Utility
Layer7 API Gateway PolicyManager-10.0.00
Policy Manager installers (Windows & Linux)
Layer7 API Gateway Virtual CentOS Appliance OVA-10.0
Virtual CentOS Appliance Gateway OVA image
Layer7 API Gateway Virtual CentOS Appliance Imager-10.0
Virtual CentOS Appliance Imager
Layer7 Gateway Hardware CentOS Appliance Imager X7-10.0
Hardware CentOS Appliance Imager for X7
Layer7 API Gateway XVC-10.0
XML VPN Client for Windows and Linux
Layer7 API Gateway Hardware CentOS Appliance Imager X5-10
Hardware CentOS Appliance Imager for X5
OTK Installers 4.4
OAuth Toolkit Installer Solution Kit and Database Scripts
Most Layer7 API Management technical documentation is contained within this TechDocs site (https://techdocs.broadcom.com). Legacy documentation in non-Web format include:
Layer7 API Management Technical Documentation
- ca_api_gateway_secure_installation_guide,_v9.2.pdf (Common Criteria; most recent certified version is v9.2)
Access related documentation from the TechDocs site.
Other Layer7 API Management Online Documentation
A PDF version of the Layer7 API Gateway documentation is available for deployments where Internet access is disabled due to security reasons. Look for the PDF button near the top of the techdocs.broadcom.com page.
Layer7 API Gateway Offline Documentation