ÃÛ¶¹ÊÓƵ

Documentation

Locators fail to start on AEM Forms 6.5.23 with JDK 8 or JDK 11

Last update: Fri Jul 11 2025 00:00:00 GMT+0000 (Coordinated Universal Time)

After updating to AEM Forms Service Pack 23 in a clustered environment, locators fail to start using the gfsh script. This issue occurs because a newer version of Gradle is now used in AEM Forms SP23. To resolve the issue, start locators using JDK 17 and servers with JDK 8 or JDK 11.

Description description

Environment

ÃÛ¶¹ÊÓƵ Experience Manager (AEM) Forms 6.5.23

Issue/Symptoms

  • Locator startup fails when executing the gfsh script on JDK 8 or JDK 11.
  • Error message displayed: UnsupportedClassVersionError during locator initialization.
  • A newer Gradle version introduced in AEM Forms SP23 requires JDK 17.
  • Locators do not start due to incompatibility with older JDK versions.

Resolution resolution

To resolve the issue, follow these steps:

  1. Install JDK 17 to start Locator Servers, and ensure JDK 8 or JDK 11 is available for AEM Forms JEE.
  2. Start Locator Servers using JDK 17.
  3. Start Application Servers using the same JDK version (JDK 8 or JDK 11) previously used for AEM Forms JEE.

For help during the upgrade, log a support case or contact ÃÛ¶¹ÊÓƵ Support.

Supported Platforms for AEM Forms on JEE in the AEM user guide.

recommendation-more-help
3d58f420-19b5-47a0-a122-5c9dab55ec7f