Appendix A: Installing and Configuring OpenOffice

The report generator uses the OpenOffice / LibreOffice package to output reports in PDF and DOC formats. The installation to the computer containing the application server and configuration of this package is described below.

Installing and Configuring OpenOffice for Microsoft Windows

Download the application at http://openoffice.org.
Install the application.
In the reporting.openoffice.path application property, specify the path to OpenOffice.org, for example:

reporting.openoffice.path = C:/Program Files (x86)/OpenOffice.org 3/program

Installing and Configuring LibreOffice on Ubuntu Server

Install the libreoffice package, for example, by running the following command:

$ sudo apt-get install libreoffice

In the reporting.openoffice.path application property, specify the path to LibreOffice:

reporting.openoffice.path = /usr/lib/libreoffice/program

If the server does not have window interface installed, LibreOffice will start with the error, Caused by: java.awt.HeadlessException: No X11 DISPLAY variable was set, but this program performed an operation which requires it, or will simply terminate without error messages. To resolve this, set the reporting.displayDeviceUnavailable application property:

reporting.displayDeviceUnavailable = true

You can run the following command to diagnose errors when starting LibreOffice:

$ strace -e trace=signal /usr/lib/libreoffice/program/soffice.bin --headless --accept="socket,host=localhost,port=8100;urp" --nologo --nolockcheck

Installing and Configuring LibreOffice for macOS

Download the application at https://www.libreoffice.org/get-help/install-howto/os-x/.
Install the application.
In the reporting.openoffice.path application property, specify the path to LibreOffice.app, for example:

reporting.openoffice.path = /Applications/LibreOffice.app