Upgrade considerations for Gateway 11.2 which is integrated with Portal

Products

• CA API Gateway
• CA API Developer Portal

Issue/Introduction

Update Portal integration post upgrade to Gateway 11.2 fails.

Environment

API Gateway 11.2

API Developer Portal 5.3.x and 5.4

Resolution

Verify that Cross-APIM Product Compatibility Considerations for Gateway 11.2 has been performed before running Update Portal integration

https://techdocs.broadcom.com/us/en/ca-enterprise-software/layer7-api-management/overview/apim/product-compatibility/cross-apim-product-compatibility-for-gw11-2.html

API Developer Portal Version 5.4

Upgrading the Gateway on Existing Proxies

Ensure the following steps are completed prior to upgrading your API proxies (Gateways) to version 11.2 or newer:

1. 1. Use Rate and Quota Policy Template v2.0.7 or Newer

   If you are using the Portal's Rate and Quota Policy Template, you

   MUST

   ensure that the version of the template deployed to your Proxies (Gateways) is version

   2.0.7

   or newer. This ensures that

   Evaluate JSON Expression (V2)

   and the latest component libraries are used.
2.    Use the Latest OTK Version

   Ensure that OTK is running version 

   4.6.4

   or newer. If you are unable to upgrade from an older version of the OTK, contact Broadcom Support.
3.   Check the Portal Integration Bundle Installed On Your Proxies

   If your current integration bundle is older than

   UTC.20251021.1200.00

   , you must run an update script before updating the integration bundle.

   The script updates the proxy's trusted certificate from PSSG to APIM to enable mutual authentication between the proxy and Portal (version 5.4 or newer) when updating the Portal Integration bundle. This is also a prerequisite step to ensure that the PSSG and DSSG legacy components are removed from the Portal.
4.   Update your Portal Integration Software On Your Proxies

   Refer to Supported Integration Bundle Software for the latest bundle version that should be installed on your proxies for connection to Portal 5.4. For steps in updating your integration bundle, see Update Portal Integration Software.

   Installing the Portal Integration bundle associated with Portal 5.4 GA (i.e.,

   UTC.20251021.1200.00

   or newer) shall replace the assertion,

   Evaluate JSON Path Expression (V1)

   with

   Evaluate JSON Path Expression (V2)

   .
5.   Upgrade Proxies to Gateway Version 11.2

   Follow Gateway upgrade procedures from here.