Difference between revisions of "AppSuite:ReaderEngineConfig"

m (added description for ENGINE_MAX_VMEM_MB config item)
(Updates according to latest implementation changes / renaming to actually used property keys within the documentconverter.properties file)
Line 1: Line 1:
 
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.
 
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.
  
; String ENGINE_INSTALLDIR = "/opt/readerengine"
+
; com.openexchange.documentconverter.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. <br>
 
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. <br>
Attention: If not set correctly, the complete web service will be nonfuntional.
+
Attention: If not set correctly, the complete web service will be nonfunctional.
  
; String ENGINE_CACHEDIR = "/var/opt/open-xchange/readerengine.cache“
+
; com.openexchange.documentconverter.cacheDir=/var/spool/open-xchange/documentconverter/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.
 
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"
+
; com.openexchange.documentconverter.scratchDir=/var/spool/open-xchange/documentconverter/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.
 
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.
Line 16: Line 16:
 
Attention: If not set correctly, the complete web service will be nonfunctional.
 
Attention: If not set correctly, the complete web service will be nonfunctional.
  
; String ENGINE_LOGFILE  = "/var/log/open-xchange/readerengine.log"
+
; com.openexchange.documentconverter.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.
 
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
+
; com.openexchange.documentconverter.logLevel=1
  
 
This item determines the amount and detail of logging data. Possible values are:
 
This item determines the amount and detail of logging data. Possible values are:
Line 28: Line 28:
 
   * 3 = errors only
 
   * 3 = errors only
  
; int ENGINE_JOB_PROCESSOR_COUNT = 3
+
; com.openexchange.documentconverter.jobProcessorCount=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.   
 
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
+
; com.openexchange.documentconverter.jobRestartCount=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,
 
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
+
; com.openexchange.documentconverter.jobExecutionTimeoutMilliseconds=60000
  
 
This item determines the timeout in milliseconds, after which the execution of a single job is terminated.
 
This item determines the timeout in milliseconds, after which the execution of a single job is terminated.
  
; ENGINE_MAX_VMEM_MB = 2048
+
; com.openexchange.documentconverter.maxVMemMB=2048
  
 
This item determines the maximum size in megabytes (MB) of virtual memory that each started readerengine process is allowed to consume. If a job tries to consume more VMem than set via this config item, the processing of the current job for the appropriate readerengine process will be aborted and the underlying process is restarted to avoid memory corruption.
 
This item determines the maximum size in megabytes (MB) of virtual memory that each started readerengine process is allowed to consume. If a job tries to consume more VMem than set via this config item, the processing of the current job for the appropriate readerengine process will be aborted and the underlying process is restarted to avoid memory corruption.
Line 46: Line 46:
 
Set this value to -1 for no upper limit.
 
Set this value to -1 for no upper limit.
  
; long ENGINE_MAX_CACHESIZE_MB = 1024
+
; com.openexchange.documentconverter.maxCacheSizeMB=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.
 
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.
Line 52: Line 52:
 
Set this value to -1 for no upper limit.
 
Set this value to -1 for no upper limit.
  
; long ENGINE_MAX_CACHEENTRIES = -1
+
; com.openexchange.documentconverter.maxCacheEntries=-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.
+
This item determines the maximum number of converter jobs cached at runtime. The value affects the amount of runtime job information to be cached as well as the number of file entries within the cache directory.
 
<br>
 
<br>
 
Set this value to -1 for no upper limit.
 
Set this value to -1 for no upper limit.
 +
 +
; com.openexchange.documentconverter.cacheEntryTimeoutSeconds=3600
 +
 +
This item determines the timeout in seconds, after which a cached  job result is automatically removed from the cache.
 +
<br>
 +
Set this value to 0 to disable the timeout based removal of cached job results.
 +
 +
; com.openexchange.documentconverter.servletLocalFileUrls=false
 +
 +
This item determines, if the documentconverter servlet should be allowed to handle file Urls of the form file://... The file Url itself is a resource that locates files that are locally accessible on the machine, the documentconverter backend is running on .

Revision as of 11:32, 14 February 2013

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.

com.openexchange.documentconverter.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 nonfunctional.

com.openexchange.documentconverter.cacheDir=/var/spool/open-xchange/documentconverter/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.

com.openexchange.documentconverter.scratchDir=/var/spool/open-xchange/documentconverter/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.

com.openexchange.documentconverter.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.

com.openexchange.documentconverter.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
com.openexchange.documentconverter.jobProcessorCount=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.

com.openexchange.documentconverter.jobRestartCount=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,

com.openexchange.documentconverter.jobExecutionTimeoutMilliseconds=60000

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

com.openexchange.documentconverter.maxVMemMB=2048

This item determines the maximum size in megabytes (MB) of virtual memory that each started readerengine process is allowed to consume. If a job tries to consume more VMem than set via this config item, the processing of the current job for the appropriate readerengine process will be aborted and the underlying process is restarted to avoid memory corruption.
Set this value to -1 for no upper limit.

com.openexchange.documentconverter.maxCacheSizeMB=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.

com.openexchange.documentconverter.maxCacheEntries=-1

This item determines the maximum number of converter jobs cached at runtime. The value affects the amount of runtime job information to be cached as well as the number of file entries within the cache directory.
Set this value to -1 for no upper limit.

com.openexchange.documentconverter.cacheEntryTimeoutSeconds=3600

This item determines the timeout in seconds, after which a cached job result is automatically removed from the cache.
Set this value to 0 to disable the timeout based removal of cached job results.

com.openexchange.documentconverter.servletLocalFileUrls=false

This item determines, if the documentconverter servlet should be allowed to handle file Urls of the form file://... The file Url itself is a resource that locates files that are locally accessible on the machine, the documentconverter backend is running on .