As of Docmosis 2.2, the reason for startup failure and suggestions should be provided in the output. This is almost always due to an error when the converter attempts to launch LibreOffice or OpenOffice. There are five known causes of this:
- incorrectly set LD_LIBRARY_PATH variable in Linux/Unix environments. See the runConverter.sh script in the download bundles to see how to set the LD_LIBRARY_PATH variable. Note this is not required in Docmosis versions from 1.2.0 onwards.
- On 64-bit Linux systems a 32 bit install of Java must be present. LibreOffice (which is a key component of the Docmosis Converter) must be able to locate a 32 bit java install.
- If you are using OpenOffice 2.3 on a linux platform, you may need to have the open office "headless" package installed. This is particularly likely if you see the error "X11 error: Can't open display".
- If you are using OpenOffice 3.0 on Ubuntu with no X11 or client GUI, you may need to install another version of Java. The JDK that comes with some versions of Ubuntu can disagree with OpenOffice 3.0.
- Sites have occasionally reported that re-installing openoffice (even as late as version 3.0) has corrected the problem. The root cause has not been established or why the install did not work correctly the first time through.