Skip to main content
Version: 10.0

Java environment

The Java Runtime Engine (JRE) used by webPDF can be found in the jre/ subfolder. Actually the OpenJDK is used.

Below you will find a list of the files that provide the setting options for the Java VM (JVM).

tip

If you want to convert large files or run many converter instances at the same time, you will have to change the memory settings of the JVM.

Windows

In Windows, the JVM needs to be configured with the two files with the .vmoptions extension (ASCII files). These two files are found in the server's installation directory.

webPDF.vmoptions - Java settings when the server is run as a normal (console) application (under Windows or Linux).
webPDF.service.vmoptions - Java settings when the server is run as a Windows service.

These files contain the (line-by-line) options for the Java Virtual Machine (JVM).

Example: The following two settings are used to set the memory settings for the JVM (-Xmx and -Xms options).

# Memory settings  
-Xmx4096m
-Xms512m
tip

The correct setting of the memory can be checked via the Admin portal and the “System information”.

Linux

The settings for the JVM for webPDF in Linux are configured directly in webpdf.sh or webpdf.service (depending on the init system being used).

SysVinit

Symbol link in /etc/init.d/webpdf to opt/webpdf/webpdf.sh.

webpdf.sh
javaOpt="-Xmx4096m -Xms1024m ..."

Systemd

Installed under /usr/lib/systemd/system/webpdf.service with ExecStart as reference to webpdf.starter.sh.

webpdf.service
ExecStart=/opt/webpdf/webpdf.starter.sh

You can use the environment variable JAVA_PARAMETERS to modify the JVM parameters.

webpdf.starter.sh
_PARAMETERS="${JAVA_PARAMETERS:--Xmx4g -Xms1g}"

This can be done via the default environment mechanism of Systemd.

Example: Adjusting the memory of the JVM

webpdf.service
Environment="JAVA_PARAMETERS=--Xmx8g"
tip

The correct setting of the memory can be checked via the Admin portal and the “System information”.