Current Release Notes for Adobe Experience Manager 6.5 LTS release-notes

Release Information release-information

Product
Adobe Experience Manager
Version
6.5 LTS
Type
Major release
General availability date
March 7, 2025

What’s New what-s-new

Adobe Experience Manager 6.5 LTS is an upgrade release to the Adobe Experience Manager 6.5 code base. It provides key customer fixes, high priority customer enhancements, and general bug fixes oriented toward product stabilization. It also includes Adobe Experience Manager 6.5 Service Pack releases up to SP22.

The list below provides an overview - while the subsequent pages list the full details.

Experience Manager Foundation experience-manager-foundation

The platform of Adobe Experience Manager 6.5 LTS builds on top of updated versions of the OSGi-based framework (Apache Sling and Apache Felix) and the Java™ Content Repository: Apache Jackrabbit Oak 1.68.x.

Eclipse Jetty 11.0.x is used as a servlet engine for the Quickstart.

Java™ Support java-support

  • Support for Java™ 17 and Java™ 21.
  • For optimal performance, override the default GC values with other values. For more information, see the install and update section.
  • Adobe distributes Java™ 17 and Java™ 21 maintenance updates for customer usage in AEM-related projects, when not publicly available from Oracle.

Uberjar Packaging uber-jar-packaging

Upgrade upgrade

Install and Update install-update

For setup requirements, see installation instructions.

For detailed instructions, see the upgrade documentation.

NOTE
For fresh AEM 6.5 LTS installations, index definitions must be installed separately. For more information, refer this.

Supported Platforms supported-platforms

Find the complete matrix of supported platforms including support-level on AEM 6.5 LTS technical requirements.

NOTE
Java™ 17/Java™ 21 are the recommended versions to use with AEM 6.5 LTS.

Deprecated and Removed Features deprecated-and-removed-features

Adobe continually reviews product capabilities to improve customer value by modernizing or replacing older features. These changes are made with careful attention to backward compatibility.

To communicate the impending removal or replacement of Adobe Experience Manager (AEM) capabilities, the following rules apply:

  1. Announcement of deprecation comes first. While deprecated, capabilities are still available but are not further enhanced.
  2. Removal of deprecated capabilities occurs in the following major release at the earliest. The actual target date for removal is planned for announcement later.

This process gives customers at least one release cycle to adapt their implementation to a new version or successor of a deprecated capability, before actual removal.

Deprecated features deprecated-features

This section lists features and capabilities that Adobe has deprecated in AEM 6.5 LTS. Typically, Adobe deprecates features before removing them in a future release and provides an alternative.

Customers are advised to review if they use the feature/capability in their current deployment, and make plans to change their implementation to use the alternative provided.

Area
Feature
Replacement
Version (SP)
Sites
SPA Editor
The preferred editors for managing headless content in AEM are:
- The Universal Editor for visual editing.
- The Content Fragment Editor for form-based editing.
6.5 LTS GA

Removed Features removed-features

This section lists features and capabilities that have been removed from AEM 6.5 LTS. Prior releases had these capabilities marked as deprecated.

Area
Feature
Replacement
Version (SP)
Commerce
AEM CIF Classic is not supported.
Migrate to AEM CIF.
6.5 LTS GA
Solutions
Social/Communities is not supported.
No replacement available.
6.5 LTS GA
Screens
Screens are not supported.
No replacement available.
6.5 LTS GA
Assets
dam-pim and dam-rating are not supported as bundles are dependent on social.
No replacement available.
6.5 LTS GA
Assets
com.day.cq.dam.scene7.api.model.Scene7ViewerConfig#getSettings() has been removed.
Use the alternate api com.day.cq.dam.scene7.api.model.Scene7ViewerConfig#getSettingsList() that has been added.
6.5 LTS GA
Portal
AEM Portal Director is not supported.
No replacement available.
6.5 LTS GA
Granite
Bundle com.adobe.granite.socketio is removed.
No replacement available.
6.5 LTS GA
Granite
com.adobe.granite.crx-explorer is not supported.
No replacement available.
6.5 LTS GA
Granite
crx2oak is not supported.
Pick the relevant version of oak-upgrade
6.5 LTS GA
Adobe
com.adobe.cq.cq-searchpromote-integration is not supported.
No replacement available.
6.5 LTS GA
Guava
All guava dependencies are now removed in AEM and hence the com.adobe.granite.osgi.wrapper.guava-15.0.0-0002 bundle is not part of AEM.
Customers can add guava on their own if they are dependent on guava or replace guava code with java collections or other alternates if possible.
6.5 LTS GA
We.Retail
We-retail sample site is not supported.
No replacement available.
6.5 LTS GA
Open Source
oak-solr-osgi bundle is not supported.
No replacement available.
6.5 LTS GA
Open Source
org.apache.servicemix.bundles.abdera-parser, org.apache.servicemix.bundles.jdom and org.apache.sling.atom.taglib are not supported.
No replacement available.
6.5 LTS GA
Open Source
org.apache.commons.io packages are now exported from org.apache.commons.commons-io.
No change required.
6.5 LTS GA
Open Source
javax.mail packages are being exported from the com.sun.javax.mail bundle.
No change required.
6.5 LTS GA
Open Source
org.apache.jackrabbit.api packages now are exported from the org.apache.jackrabbit.oak-jackrabbit-api bundle.
No change required.
6.5 LTS GA
Open Source
com.github.jknack.handlebars is not supported
Pick the relevant version
6.5 LTS GA

Known Issues known-issues

Issue with JSP scripting bundle in AEM 6.5.21-6.5.23 and AEM 6.5 LTS GA

AEM 6.5.21, 6.5.22, 6.5.23, and AEM 6.5 LTS GA ship with the org.apache.sling.scripting.jsp:2.6.0 bundle, which contains a known issue. The issue typically occurs under high load when the AEM instance handles many concurrent requests.

When this issue occurs, one of the following exceptions may appear in the error logs alongside references to org.apache.sling.scripting.jsp:2.6.0:

  • java.io.IOException: classFile.delete() failed
  • java.io.IOException: tmpFile.renameTo(classFile) failed
  • java.lang.ArrayIndexOutOfBoundsException: Index 0 out of bounds for length 0
  • java.io.FileNotFoundException

A hotfix cq-6.5.lts.0-hotfix-NPR-42640 is available to resolve this problem.

Dispatcher Connection Failure with SSL-Only Feature ssl-only-feature

When enabling the SSL-only feature in AEM deployments, there is a known issue that affects connectivity between the Dispatcher and AEM instances. After enabling this feature, health checks may fail and communication between Dispatcher and AEM instances can be disrupted.

Impact:

  • Health check failures with HTTP 500 response codes
  • Broken traffic between Dispatcher and AEM instances
  • Content cannot be properly served through the Dispatcher

Affected Environments:

  • AEM deployments with Dispatcher configurations
  • Systems where the SSL-only feature has been enabled

Solution:
If you experience this issue, please contact Adobe Customer Support. A hotfix cq-6.5.lts.0-hotfix-CQ-4359803 is available to resolve this problem. Do not attempt to enable SSL-only features until applying the necessary hotfix.

Restricted Websites restricted-sites

These websites are only available to customers. If you are a customer and need access, contact your Adobe account manager.

recommendation-more-help
51c6a92d-a39d-46d7-8e3e-2db9a31c06a2