Chapter 2 Configuration

After installation, you can configure the supplied Tomcat Web server and StarOffice 8 Server - PDF Converter.

Tomcat

For the configuration of Tomcat see documentation on www.apache.org. Basic configuration instructions can be found in the file <socs-installation-dir>/engine/RUNNING.txt.

StarOffice 8 Server - PDF Converter

The configuration of the StarOffice 8 Server - PDF Converter is specified in the file <socs-installation-dir>/engine/webapps/soserv/WEB-INF/config.properties. This file contains a number of entries of key-value-pairs, one line for each entry, which are described in the following:

• workdir

  This is the directory that is used by StarOffice 8 Server - PDF Converter to store intermediate files.

  Example: workdir=/tmp

  Default: Default: <socs-installation-dir>/engine/work

• instances

  The number of StarOffice Server Engine processes, which are used simultaneously by StarOffice 8 Server - PDF Converter to convert documents. An instance is a distinct version of the soffice.bin binary, running on the server machine.

  Example: instances=2

  Default: 2

• maxAge

  Every StarOffice Server Engine instance has a certain lifetime, that is, number of conversions, the instance is allowed to do. After that number of conversions the converting instance is terminated automatically, and a fresh instance of the StarOffice Server Engine is created.

  Example: maxAge=50

  Default: 50

• maxLatency

  Describes the overall time in seconds, in which a conversion job must have finished. If a conversion is not finished in time, an error will be generated.

  Example: maxLatency=180

  Default: 180

• converterServiceURL

  The URL for the StarOffice 8 Server - PDF Converter Webservice.

  Example: converterServiceURL=http://localhost:8080/soserv/SOConverter

  Default: http://localhost:8080/soserv/SOConverter