Resolving ClassNotFoundException for org.apache.xpath.XPathAPI in AEM Forms 6.5.2 LTS

This article explains how to resolve a ClassNotFoundException for org.apache.xpath.XPathAPI that occurs during the deployment of AEM Forms 6.5.2 LTS due to a missing dependency.

Description description

Environment

Adobe Experience Manager Forms 6.5.2 LTS (all platforms)

Issue/Symptoms

  • After you install AEM Forms 6.5.2 LTS on a new server, the application deployment fails.

  • The issue occurs on a clean installation where no previous AEM Forms installation is present.

  • The server logs contain errors similar to the following:

    code language-none
    java.lang.ClassNotFoundException: org.apache.xpath.XPathAPI from [ Module "deployment.adobe-livecycle-jboss.ear.um.jar" from Service Module Loader]
    
    com.adobe.idp.common.errors.exception.IDPException: Failed to load default configuration. error:jakarta.ejb.EJBException: WFLYEJB0442: Unexpected Error
    
  • The deployment failure prevents the application from starting correctly.

Cause

The User Management module requires the xalan-2.7.2.jar dependency. The required JAR file is not included by default in AEM Forms 6.5.2 LTS, so the module cannot load org.apache.xpath.XPathAPI.

Resolution resolution

Follow the steps below to resolve the issue.

  1. Stop the AEM Forms server.
  2. Navigate to the /jboss/standalone/deployments directory in your AEM Forms installation.
  3. Use a package manager tool (such as 7zip) to unpack the adobe-livecycle-jboss.ear file.
  4. Obtain the xalan-2.7.2.jar file from the official Apache Xalan project or another trusted source.
  5. Add the xalan-2.7.2.jar file to the adobe-livecycle-jboss.ear/lib directory.
  6. Close the package manager tool to ensure changes are saved.
  7. Start the server and perform the bootstrap step again.
  8. Verify that the server starts without the ClassNotFoundException error.
recommendation-more-help
experience-cloud-kcs-help-kbarticles