You're viewing **Apigee Edge** documentation. [Go to the **Apigee X** documentation](http://cloud.google.com/apigee/docs). info This section describes version 4.50.00 of the Edge for Private Cloud Feature Release. > [!NOTE] > For more information, see the following resources: > > - *[Edge for Private Cloud 4.50.00 documentation](https://docs.apigee.com/private-cloud/v4.50.00)* > - *Questions or issues?* Contact [Apigee Edge Support](https://docs.apigee.com/api-platform/troubleshoot/support) > - *Release notifications* : See [Get Apigee Edge release notifications](https://docs.apigee.com/release/get-release-notifications) ## Release summary The following table summarizes the changes in this release: [New Features](https://docs.apigee.com/release/notes/45000-edge-private-cloud-release-notes#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](https://docs.apigee.com/release/notes/45000-edge-private-cloud-release-notes#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](https://docs.apigee.com/release/notes/190301-apigee-edge-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)](https://docs.apigee.com/release/notes/200406-apigee-edge-public-cloud-release-notes) [20.03.27 (UI)](https://docs.apigee.com/release/notes/20032700-apigee-edge-public-cloud-release-notes-ui) [20.03.16 (Edge Analytics)](https://docs.apigee.com/release/notes/20031601-apigee-edge-public-cloud-release-notes-ui) [20.03.11 (UI)](https://docs.apigee.com/release/notes/20031100-apigee-edge-public-cloud-release-notes-ui) [20.02.27 (API Monitoring)](https://docs.apigee.com/release/notes/200227-apigee-api-monitoring-release-notes) [20.02.24 (UI)](https://docs.apigee.com/release/notes/20022400-apigee-edge-public-cloud-release-notes-ui) [20.02.03 (API Monitoring)](https://docs.apigee.com/release/notes/200203-apigee-api-monitoring-release-notes) [20.01.29 (UI)](https://docs.apigee.com/release/notes/20012900-apigee-edge-public-cloud-release-notes-ui) [20.01.22 (UI)](https://docs.apigee.com/release/notes/20012200-apigee-edge-public-cloud-release-notes-ui) [20.01.06 (API Mgmt/Runtime)](https://docs.apigee.com/release/notes/200106-apigee-edge-public-cloud-release-notes) ○ Edge (continued): [20.01.06 (UI)](https://docs.apigee.com/release/notes/20010600-apigee-edge-public-cloud-release-notes-ui) [19.11.13 (API Security Reporting)](https://docs.apigee.com/release/notes/191113-apigee-api-security-release-notes) [19.10.01 (UI)](https://docs.apigee.com/release/notes/191001-apigee-edge-public-cloud-release-notes-ui) [19.09.26 (Edge UI/Portal)](https://docs.apigee.com/release/notes/190926-apigee-edge-public-cloud-release-notes-integrated-portal) [19.08.27 (UI)](https://docs.apigee.com/release/notes/190827-apigee-edge-public-cloud-release-notes-ui) [19.08.15 (API Security Reporting)](https://docs.apigee.com/release/notes/190815-apigee-api-security-release-notes) [19.07.29 (UI)](https://docs.apigee.com/release/notes/190729-apigee-edge-public-cloud-release-notes-ui) ○ Portal: [20.05.27.00](https://docs.apigee.com/release/notes/20052700-apigee-developer-services-portal-release-notes) [20.04.13.00](https://docs.apigee.com/release/notes/20041300-apigee-developer-services-portal-release-notes) [20.03.20.00](https://docs.apigee.com/release/notes/20032000-apigee-developer-services-portal-release-notes) [19.12.20.00](https://docs.apigee.com/release/notes/19122000-apigee-developer-services-portal-release-notes) [19.11.21.00](https://docs.apigee.com/release/notes/19112100-apigee-developer-services-portal-release-notes) [19.09.25.00](https://docs.apigee.com/release/notes/19092500-apigee-developer-services-portal-release-notes) Retirements None Deprecations With the release of 4.50.00: - **4.18.05:** Version 4.18.05 of Apigee Edge for Private Cloud is now deprecated. Features deprecated in this release include: - Support for Node.js proxies and Secure Vaults - Support for OAuth v1 policies - Support for Concurrent Rate Limit policy - Support for Apigee adapter for Istio - Support for the Teams early access feature For more detailed information about the deprecations including removal timelines, see [Apigee deprecations and retirements](https://docs.apigee.com/release/deprecated-features). [Bug Fixes](https://docs.apigee.com/release/notes/45000-edge-private-cloud-release-notes#fixes) This release includes the following bug fixes: ○ Message Processor fails to load environments when keystores are configured with similar names or aliases. (154428338) ○ 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](https://docs.apigee.com/release/notes/45000-edge-private-cloud-release-notes#fixes). [Known Issues](https://docs.apigee.com/release/notes/45000-edge-private-cloud-release-notes#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) ○ Increased Cache miss ratio after upgrade (160109014) ○ HTTP 408 response for GET request with empty body and Content-Encoding: gzip. (159858015) For more information about each of these known issues, including workarounds, see [Known issues](https://docs.apigee.com/release/notes/45000-edge-private-cloud-release-notes#known-issues). ## Upgrade paths > [!NOTE] > [Apigee mTLS](https://docs.apigee.com/private-cloud/v4.50.00/mtls-intro) is supported only on Apigee Edge for Private Cloud versions 4.19.01 to 4.19.06. You cannot upgrade `apigee-mtls` for versions 4.18.\* or lower. See [Upgrade Apigee mTLS](https://docs.apigee.com/private-cloud/v4.50.00/mtls-upgrade). 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](https://docs.apigee.com/private-cloud/v4.50.00/update-apigee-edge-4190x-45000) | | From 4.18.05 | Directly [upgrade from 4.18.05 → 4.50.00](https://docs.apigee.com/private-cloud/v4.50.00/update-apigee-edge-41805-45000) | > [!WARNING] > **WARNING:** This release includes updates and bug fixes that may affect your API implementations. > > As always, we strive to introduce updates that are backwards compatible and don't break your > code. However, it's possible that one or more updates may affect the behavior of your solution > in places, including workarounds. Apigee recommends that you test the upgrade on a > non-production before rolling it out to your production system. ## 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](https://docs.apigee.com/release/notes/45000-edge-private-cloud-release-notes#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](https://docs.apigee.com/api-platform/system-administration/tls-vars) for more. ### Zookeeper upgrade This release contains Zookeeper 3.4.14. ### Availability of the Drupal 8 portal, and EOL of Drupal 7 Drupal 8 has succeeded Drupal 7 as the Apigee-recommended developer portal for Private Cloud. Because Drupal 7 itself will reach the end of its long term support in November, 2021, the Apigee modules for Drupal 7 will not be supported as of November, 2021. While still available, the install/upgrade scripts for Drupal 7 should no longer be used and will be removed in a future release. To learn about the Drupal 8 modules that integrate with Apigee, see: [Build your portal using Drupal 8](https://docs.apigee.com/api-platform/publish/drupal/open-source-drupal-8). ### 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](https://docs.apigee.com/release/supported-software). ## 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](https://docs.apigee.com/release/notes/45000-edge-private-cloud-release-notes#included-releases). > [!NOTE] > **NOTE:** The bug lists are primarily for users checking to see if *their* support tickets have been fixed. They are not designed to provide detailed information for all users. | Issue ID | Description | |---|---| | 154428338 | **Message Processor fails to load environments when keystores are configured with similar names or aliases.** We have fixed a regex lookup conflict when loading keystores that have similar naming convention. This was causing the Message Processor to fail to load environments associated to the keystore, or fail to start when multiple conflicting keystores were returned during the lookup. | | 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. | | 160109014 | **Increased Cache miss ratio after upgrade**
After upgrade to release 4.50.00, proxies may exhibit an increased cache miss ratio. These misses may be accompanied by increased error messages in the MP logs similar to: ``` InvalidClassException when fetching cps cache entry from second level - com.apigee.jsonparser.LinkedJSONObject; local class incompatible: stream classdesc serialVersionUID = -8575741446425131573, local class serialVersionUID = 752634431212433936. Considering it as cache miss. ```

**Workaround:** None. The cache hit ratio is expected to stabilize over time. | | 159858015 | **HTTP 408 response for GET request with empty body and Content-Encoding: gzip.**
An API client will receive a 408 Timeout response when it makes a GET request with the header `Content-Encoding: gzip` and an empty request body.
**Workaround:** Omit the `Content-Encoding` header when making GET requests with an empty body. | ## Next step To get started with Edge for Private Cloud 4.50.00, use the following links: New installations: : [New installation overview](https://docs.apigee.com/private-cloud/v4.50.00/installation-overview) Existing installations: : [Upgrade paths](https://docs.apigee.com/private-cloud/v4.50.00/upgrade-paths)