Skip to content

Configuration

Jump to bottom
Simon Braconnier edited this page Sep 7, 2017 · 16 revisions

Configuration

JODConverter uses milliseconds for all time values.

When using a LocalOfficeManager, there are a number of settings that can be configured. Some of the default settings used by JODConverter have been chosen because they have a greater chance of working out of the box, but they are not necessarily the optimal ones.

🔢portNumbers  and/or  :capital_abcd:pipeNames

OOo inter-process communication can use either TCP sockets and/or named pipes. Named pipes have the advantage of not taking up TCP ports (with their potential security implications), and they are marginally faster. However they require a native library to be loaded by the JVM, and this means having to set the java.library.path system property. That's why it's not the default. The path that needs to be added to java.library.path is different depending on the platform, but it should be the directory in the OOo installation containing libjpipe.

  • On Linux it's e.g.: java -Djava.library.path=/opt/openoffice.org/ure/lib
  • On Windows it's e.g.: java "-Djava.library.path=C:\Program Files (x86)\OpenOffice 4\program"

 Default: TCP socket, on port 2002.

// This example will use 4 TCP ports, which will cause
// JODConverter to start 4 office processes when the
// OfficeManager will be started.
OfficeManager officeManager =
    LocalOfficeManager.builder()
        .portNumbers(2002, 2003, 2004, 2005)
        .build();

📁officeHome

This property sets the office home directory of the office installation that will be used to perform document conversions.

 Default: Auto-detected, starting with LibreOffice (over OpenOffice) and the most recent version.

// This example will force JODConverter to use the OpenOffice 4
// installation that can be found using the specified path.
OfficeManager officeManager =
    LocalOfficeManager.builder()
        .officeHome("D:\\Program Files (x86)\\OpenOffice 4")
        .build();

🔠processManager

A process manager is used when JODConverter needs to deal with a started office process. When JODConverter starts an office process, it must retrieve the PID of the started process in order to be able to kill it later if required.

 Default: By default, JODConverter will try to find the best process manager according to the OS on which JODConverter is running. But any process manager implementing the ProcessManager interface can be used if found on the classpath.

// This example will create an instance of the com.example.foo.CustomProcessManager
// class that will be used by the created OfficeManager.
OfficeManager officeManager =
    LocalOfficeManager.builder()
        .processManager("com.example.foo.CustomProcessManager")
        .build();

📁workingDir

This property sets the directory where temporary office profile directories will be created. An office profile directory is created per office process launched. This property will also be used to create a temporary directory where files will be created when conversions are done using InputStream/OutputStream.

 Default: The system temporary directory as specified by the java.io.tmpdir system property.

📁templateProfileDir

A LocalOfficeManager creates temporary profile directories for its OOo processes, to avoid interfering with e.g. another OOo instance being used by the user. Using this property, you can provide a template profile directory containing customized settings. The OfficeManager will copy such template directory to the temporary profile, so OOo will use the same settings while still keeping the OOo instances separate.

A profile can be customized in OOo by selecting the Tools > Options menu item. Settings that may be worth customizing for automated conversions include e.g.

  • Load/Save > General: you may e.g. want to disable "Save URLs relative to Internet" for security reasons
  • Load/Save > Microsoft Office: these options affect conversions of embedded documents, e.g. an Excel table contained in a Word document. If not enabled, the embedded table will likely be lost when converting the Word document to another format.

 Default: By default, this temporary profile will be a new one created by OOo with its own defaults settings, and relies on the -nofirststartwizard command line option.

✅killExistingProcess

This property specifies whether an existing office process is killed when starting a new office process for the same connection string.

 Default: true.

⌚processTimeout

This property sets the timeout, in milliseconds, when trying to execute an office process call (start/terminate).

 Default: 120000 (2 minutes)

⌚processRetryInterval

This property sets the delay, in milliseconds, between each try when trying to execute an office process call (start/terminate).

 Default: 250 (0.25 seconds)

⌚taskExecutionTimeout

This property sets the maximum time allowed to process a task. If the processing time of a task is longer than this timeout, this task will be aborted and the next task is processed.

 Default: 120000 (2 minutes)

🔢maxTasksPerProcess

This property sets the maximum number of tasks an office process can execute before restarting.

 Default: 200

⌚taskQueueTimeout

This property is used to set the maximum living time of a task in the conversion queue. The task will be removed from the queue if the waiting time is longer than this timeout and an OfficeException will be thrown.

 Default: 30000 (30 seconds)

Clone this wiki locally