Troubleshoot your IXIASOFT Output Generator installation

This section describes how to troubleshoot your IXIASOFT CCMS Output Generator installation.

Look at the CCMS Output Generator logs

If an error occurs, see the CCMS Output Generator logs. An error.zip file is also returned to the client in the output directory. See the service logs (wrapper.log) or the transformation and DITA Open Toolkit logs for more information.

Confirm that you are running the right version of Java

The CCMS Output Generator requires Java JRE 1.8.0_171 and up. To confirm that you are using the right version:
  1. Open the %OutputGenDir%/logs/ wrapper.log file.
  2. Look for the java version string; for example:
    STATUS | 2020/10/15 10:31:52 | Launching a JVM...
INFO   | 2020/10/15 10:31:52 | java version "1.8.0_171"
INFO   | 2020/10/15 10:31:52 | Java(TM) SE Runtime Environment (build 1.8.0_171-b11)
  3. If you are not using the right Java version:
    1. Install the required Java version.
    2. Make sure that you have correctly set the wrapper.java.command value in the %OutputGenDir%/conf/wrapper.conf file.

Check that the CCMS Output Generator is starting the JVM correctly

  1. Open the %OutputGenDir%/conf/wrapper.conf file with a text editor.
  2. Uncomment the following line:
    wrapper.java.command.loglevel=INFO
  3. Restart the CCMS Output Generator and look at the %OutputGenDir%/logs/ wrapper.log file. It will contain the complete Java command run by the CCMS Output Generator. This may provide additional information to troubleshoot your installation.

Linux only: Check if a .pid file is in the %OutputGenDir%/pid/ directory

A .pid file in the %OutputGenDir%/pid/ directory indicates that a process is already running. Kill the process (the process number is set in the .pid file) and try again.