Skip to main content

         This documentation site is for previous versions. Visit our new documentation site for current releases.      

This content has been archived and is no longer being updated.

Links may not function; however, this content may be relevant to outdated versions of the product.

Troubleshooting: "TransformerFactoryImpl not found" in System Management Application (Tomcat)

Updated on May 7, 2019


When you try to add a node in the System Management Application running on Tomcat 5.5, the following error occurs:

javax.xml.transform.TransformerFactoryConfigurationError: Provider org.apache.xalan.processor.TransformerFactoryImpl not found     javax.xml.transform.TransformerFactory.newInstance(Unknown Source)    com.pega.jmx.connection.util.WriteXML.writeXmlFile( com.pega.jmx.connection.util.WriteXML.addNode( com.pega.jmx.connection.managenodes.NodeManager.addNode( com.pega.jmx.ui.action.ConnectionWizardAction.execute(     org.apache.struts.action.RequestProcessor.processActionPerform(
    org.apache.struts.action.RequestProcessor.process(       org.apache.struts.action.ActionServlet.process(



This error occurs if the Tomcat “compatibility” package (to allow use of a Java 1.4.x JVM in conjunction with Tomcat 5.5.x) is installed.

The Tomcat compatibility package installs two jar files into the endorsed directory:

  • xercesImpl.jar
  • xml-apis.jar

These Tomcat files supply functionality needed by Tomcat that is not present in JDK 1.4.x (but which is present in Java 5). They override the functionality present in the JDK. 

In the file xml-apis.jar, the TransformerFactoryImpl is set to to a class that is present in JDK 1.4.x but is omitted from Java 5: "org.apache.xalan.processor.TransformerFactoryImpl" (hence the error).

  1. Use Java 5 when running Tomcat 5.5
  2. Remove the Tomcat compatibility files (xercesImpl.jar and xml-apis.jar) from Tomcat’s common/endorsed directory.

Have a question? Get answers now.

Visit the Support Center to ask questions, engage in discussions, share ideas, and help others.

Did you find this content helpful?

Want to help us improve this content?

We'd prefer it if you saw us at our best. is not optimized for Internet Explorer. For the optimal experience, please use:

Close Deprecation Notice
Contact us