Trouble with WildFly / JBOSS and Embedded Converters - "NoClassDefFoundError"

If you are using WildFly or late versions of JBOSS and Docmosis embedded Converters, you may have trouble starting Docmosis with errors like:

"java.lang.NoClassDefFoundError: com/sun/star/connection/NoConnectException"

This is due to class loader implementations that make it impossible for Docmosis to be able to load the necessary libraries to launch the soffice process successfully.  This means you need to use what we call "remote converters", which simply means this dependency is externalized (run independently of the application server). 

To switch to using remote converters, this is what you do:

1. use a script like the "remoteConverter.sh"/"remoteConverter.bat" to run the converter. Download an example bundle which includes the scripts and readme to run the converters.
2. change your application converter pool (typically configured via converterPoolConfig.xml) to connect to the remote converters instead of launching them.  If you look at converterPoolConfig.xml in the download bundle you'll see it specifying host and port.  If you are not using a converterPoolConfig.xml file, then your code will be creating a Configuration object to define the pool.  In this case, use the setConverterPoolConfiguration(String) method like this:
   
   config.setConverterPoolConfiguration("localhost:2100,localhost:2101");
   to connect to two remote converters running on the local host.

Please feel free to contact Support for help with setting up your environment.