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.
- Stop the AEM Forms server.
- Navigate to the
/jboss/standalone/deploymentsdirectory in your AEM Forms installation. - Use a package manager tool (such as 7zip) to unpack the
adobe-livecycle-jboss.earfile. - Obtain the
xalan-2.7.2.jarfile from the official Apache Xalan project or another trusted source. - Add the
xalan-2.7.2.jarfile to theadobe-livecycle-jboss.ear/libdirectory. - Close the package manager tool to ensure changes are saved.
- Start the server and perform the bootstrap step again.
- Verify that the server starts without the ClassNotFoundException error.