AppSuite:DocumentConverter Installation Guide

Configuration

After deployment of both components readerengine and Web service, the administrator needs to make some adjustments to the configuration of the OX Document Converter installation.

The component readerengine works with the default configuration settings.

A summary of all configuration items, together with each default value, is given below. Although the defaults have been carefully chosen for a real life deployment, the admin should take a closer look at each of them and adjust them accordingly, if necessary.

OSGi variant: The configuration is located at

/opt/open-xchange/etc/documentconverter.properties 

war variant: All settings necessary for the web service to find the corresponding readerengine installation and definition of working directories and service parameters are configured within the documentconverterws.war package in the WebContent/web.xml file.

Configuration Items

String ENGINE_INSTALLDIR = "/opt/readerengine"

This item contains the the directory of the libreaderengine installation. The libreaderengine installation directory in general contains the ./program directory, which itself contains the engine executables.
Attention: If not set correctly, the complete web service will be nonfuntional.

String ENGINE_CACHEDIR = "/var/opt/open-xchange/readerengine.cache“

This item contains the directory that will make up the cache for persistent job data. The directory itself does not need to exist at startup, but the parent directory needs to exist and needs to have write permissions for the user running the servlet, in order for the servlet to create this cache directory at runtime.

String ENGINE_SCRATCHDIR = "/var/opt/open-xchange/readerengine.scratch"

This item contains the directory, that will make up the runtime enironment for the readerengine. The directory itself does not need to exist at startup, but the parent directory needs to exist and needs to have write permissions for the user running the servlet , in order for the servlet to create this cache directory at runtime.
Attention: If not set correctly, the complete web service will be nonfunctional.

String ENGINE_LOGFILE = "/var/log/open-xchange/readerengine.log"

This item contains the path to the log file for recording informational output from the servlet. The file itself does not need to exist at startup, but the parent directory needs to exist and needs to have write permissions for the user running the servlet, in order for the servlet to create this file at runtime.

int ENGINE_LOGLEVEL = 1

This item determines the amount and detail of logging data. Possible values are:

 * 0 = disabled
 * 1 = errors and warnings and infos
 * 2 = errors and warnings
 * 3 = errors only

int ENGINE_JOB_PROCESSOR_COUNT = 3

This item determines the number of engines working in parallel for job execution. The value needs to be greater or equal to 1, with best performance results about (n+1), where n specifies the number of available CPU cores of the machine the service is running on.

int ENGINE_JOB_RESTART_COUNT = 16

This item determines the maximum number of executed jobs after which a single engine is automatically restarted in order to avoid memory fragmentation and possible memory leaks within one libreaderengine instance,

long ENGINE_JOB_EXECUTION_TIMEOUT_MILLISECONDS = 60000

This item determines the timeout in milliseconds, after which the execution of a single job is terminated.

long ENGINE_MAX_CACHESIZE_MB = 1024

This item determines the maximum size in megabytes (MB) of all persistently cached converter job entries at runtime. A larger value may drastically reduce the time for conversion jobs, e.g. in case of a repeated creation of document previews.
Set this value to -1 for no upper limit.

long ENGINE_MAX_CACHEENTRIES = -1

This item determines the maximum count of converter jobs cached at runtime. The value only affects the amount of runtime job information to be cached.
Set this value to -1 for no upper limit.