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). For the installation paths of these files on Windows and Linux, see Directory structure.
If you are diagnosing startup failures, memory pressure, or temporary JVM diagnostic settings, see Troubleshooting.
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
Additional line-based JVM options can be added temporarily for diagnostics, for example JVM system properties with -D.... Remove temporary analysis settings after the issue has been reproduced and documented.
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.
javaOpt="-Xmx4096m -Xms1024m ..."
Systemd
Installed under /usr/lib/systemd/system/webpdf.service with ExecStart as reference to webpdf.starter.sh.
ExecStart=/opt/webpdf/webpdf.starter.sh
You can use the environment variable JAVA_PARAMETERS to modify the JVM parameters.
_PARAMETERS="${JAVA_PARAMETERS:--Xmx4g -Xms1g}"
This can be done via the default environment mechanism of Systemd.
Example: Adjusting the memory of the JVM
Environment="JAVA_PARAMETERS=--Xmx8g"
If the expected memory setting does not seem to apply, first verify whether webPDF is started through the console launcher, the Windows service, webpdf.sh, or webpdf.starter.sh. Changes in the wrong startup path have no effect.
The correct setting of the memory can be checked via the Admin portal and the “System information”.