Google is committed to advancing racial equity for Black communities. See how.

4.50.00 Edge for Private Cloud release notes

This section describes version 4.50.00 of the Edge for Private Cloud Feature Release.

Release summary

The following table summarizes the changes in this release:

New Features

This release includes the following new features:

○ TLS connection information now available in API proxies
○ Zookeeper upgrade
○ Availability of the Drupal 8 portal, and EOL of Drupal 7

For more information about each of these new features, see New features.

Backward Compatibility The following issues affecting backward compatibility were introduced in this version of Apigee Edge for Private Cloud:
     
  • Due to the fix for issue 132443137 (as described in the 19.03.01 Public Cloud release notes), Message Processors now ignore headers that begin with X-Apigee-*. As a result, you must refactor any code that uses X-Apigee-* headers and replace those headers with supported ones.
  • The name of the Cassandra log files has changed. It is now:

    /opt/apigee/var/log/apigee-cassandra/system.log
Included Releases

Since the previous Edge for Private Cloud Feature Release, the following releases have occurred and are included in this release:

○ Edge:
   20.04.06 (Runtime, API Mgmt, Monetization Mgmt)
   20.04.07 (Integrated portal)
   20.03.27 (UI)
   20.03.16 (Edge Analytics)
   20.03.13 (UI)
   20.03.11 (UI)
   20.03.04 (Integrated Portal)
   20.02.27 (API Monitoring)
   20.02.24 (UI)
   20.02.21 (Integrated Portal)
   20.02.19 (Integrated Portal)
   20.02.12 (Integrated Portal)
   20.02.03 (API Monitoring)
   20.01.29 (UI)
   20.01.22 (UI)
   20.01.06 (API Mgmt/Runtime)
○ Edge (continued):
   20.01.06 (UI)
   19.11.13 (API Security Reporting)
   19.11.05 (Integrated Portal)
   19.10.14 (Integrated Portal)
   19.10.03 (Integrated Portal)
   19.10.01 (UI)
   19.09.26 (Edge UI/Portal)
   19.09.18 (Integrated Portal)
   19.09.17 (Integrated Portal)
   19.09.06 (Integrated Portal)
   19.08.27 (UI)
   19.08.15 (API Security Reporting)
   19.08.14 (Integrated Portal)
   19.07.31 (Integrated Portal)
   19.07.29 (UI)
   19.07.25 (Integrated Portal)
○ Portal:
   20.05.27.00
   20.04.13.00
   20.03.20.00
   19.12.20.00
   19.11.21.00
   19.09.25.00
Retirements None
Deprecations

With the release of 4.50.00, the following are deprecated:

  • 4.18.05: Version 4.18.05 of Apigee Edge for Private Cloud is now deprecated.

For more information, see Apigee deprecations, retirements, and CPS changes.

Bug Fixes

This release includes the following bug fixes:

○ QPid dependency conflict while installing patch (152574421)
○ Cache memory limiter not respecting max L1 cache size (151449163)
○ Backup scripts failing (150710952)
○ QPid server sending extra log messages (148231209)
○ Backup of Postgresql not storing SSO information (147458330)
○ apigee-nginx version not upgraded. (146872858)
○ `Try the new UI` message no longer appearing (145419621)
○ Apigee SmartDocs API Vulnerability (145340106)
○ Postgres backup script fails (145254693)
○ Various security fixes (142150706)
○ High rate of Router to Message Processor timeouts (138107618)
○ SSO setup script failure (135616498)
○ JMX ports (132044907)
○ Intermittent 404s for runtime traffic due to race condition (130653816)
○ OpenLDAP corruption during upgrade (120799182)
○ DataAccessException in multiple data center configurations (76087166)
○ FormatMessage set to false in MessageLogging policy not working (68722102)

For more information about each of these fixes, see Bug fixes.

Known Issues

This release includes the following known issues:

○ JWT validation fails (159788170)
○ Mint rating servers memory leak (137865184)
apigee-monit not supported on Amazon Linux 1 (122370980)
○ Message Processor backup not backing up the correct set of files (121095148)

For more information about each of these known issues, including workarounds, see Known issues.

Upgrade paths

The following table shows the upgrade paths for this release:

From 4.19.01 or 4.19.06 Directly upgrade from 4.19.01/4.19.06 → 4.50.00
From 4.18.05 Directly upgrade from 4.18.05 → 4.50.00

New features

This section lists new features in this release. Additionally, this release includes all features in the Edge UI, Edge Management, and Portal releases listed in Included Releases.

In addition to the following enhancements, this release also contains multiple usability, performance, security, and stability enhancements.

TLS connection information now available in API proxies

During a request to an API proxy through a virtual host that supports TLS, Edge can capture information about the TLS connection. Your API proxy can now access that information through flow variables to perform additional analysis and validation. See Accessing TLS connection information in an API proxy for more.

Zookeeper upgrade

This release contains Zookeeper 3.4.14.

Availability of the Drupal 8 portal, and EOL of Drupal 7

Supported software

This release includes the following changes to supported software:

Support Added No Longer Supported

This release adds support for the following platforms:

  • Red Hat Enterprise Linux (RHEL) 7.8
  • CentOS 7.8
  • Oracle Linux 7.8

The following platforms are no longer supported with this release:

  • Red Hat Enterprise Linux (RHEL) 6.10
  • CentOS 6.10
  • Oracle Linux 6.9

For a complete list of supported platforms, see Supported software and supported versions.

Bug fixes

This section lists the Private Cloud bugs that were fixed in this release. Additionally, this release includes all bug fixes in the Edge UI, Edge Management, and Portal releases shown in Included Releases.

Issue ID Description
152574421

QPid dependency conflict while installing patch

The correct version of QPid is now installed.
151449163

Cache memory limiter not respecting max L1 cache size

The Cache memory limiter now respects max L1 cache size.
150710952

Backup scripts failing

The backup procedure has been updated based on the updated backup scripts.
148231209

QPid server sending extra log messages

The QPid server no longer sends extra log messages.
147458330

Backup of Postgresql not storing SSO information

Postgresql backup now storing SSO information.
146872858

apigee-nginx version not upgraded.

apigee-nginx version now upgraded correctly.
145419621

`Try the new UI` message no longer appearing

The UI no longer displays the `Try the new UI` message.
145340106

Apigee SmartDocs API Vulnerability

Updated Apigee SmartDocs proxy to address security vulnerability. See the SmartDocs installation procedure for further information and required steps.
145254693

Postgres backup script fails

The Postgres backup script now works correctly.
142150706

Various security fixes

Fixes for security issues, including #111390246.
138107618

High rate of Router to Message Processor timeouts

This issue has been resolved.
135616498

SSO setup script failure

An issue was fixed where using file-scheme URLs caused SSO setup script failure.
132044907

JMX ports

JMX ports should not be open to external access, only to internal servers.
130653816

Intermittent 404s for runtime traffic due to race condition

Fixed a race condition during MP bootstrap which led to some proxies not being deployed correctly.
120799182

OpenLDAP corruption during upgrade

This issue has been resolved.
76087166

DataAccessException in multiple data center configurations

In multiple data center configurations, if one datastore becomes unavailable, you no longer see the DataAccessException error.
68722102

FormatMessage set to false in MessageLogging policy not working

You can now set FormatMessage to false in the MessageLogging policy.

Known issues

The following table lists known issues in this release:

Issue ID Description
159788170

JWT validation fails

JWT validation fails for RSA keys smaller than 2048 bits.

Workaround:

Ensure that your keys are 2048 bits or larger.
137865184

Mint rating servers memory leak

When a new Qpid instance is registered in an mxgroup, the queues build without consumers, which results in the queue depth growing until it uses all available resources.

Workaround:

None.
122370980

apigee-monit not supported on Amazon Linux 1

Workaround:

None.
121095148

Message Processor backup not backing up the correct set of files

Workaround:

Run the backup a second time and it should back up the correct set of files.

Next step

To get started with Edge for Private Cloud 4.50.00, use the following links:

New installations:
New installation overview
Existing installations:
Upgrade paths