11.10Error when signing large PDF files

Symptom

·     If a PDF file is too large, it is not added and does not appear in the list of files after selection. In addition, DATA Boreum may freeze, not respond or abort when attempting to sign a large PDF file. The following entry can be seen in the log file: java.lang.OutOfMemoryError: Java heap space. In this case, the Java option for the memory size must be changed.

When is a PDF file too large?

·     Data Boreum already slows down with files of 150 to 200 MB. From 500 MB PDF files, or even before, depending on the scenario, the memory size of the JVM must be increased. Please also note that DATA Boreum caches all files that have been selected for processing and that are displayed in the file list after selection. In addition, the hash value calculation of the files consumes memory space and generates processor load. You should take these factors into account when dimensioning the memory, see section "Troubleshooting".

Cause

·     The standard version of DATA Boreum has too little memory available to be able to sign very large PDF files.

Troubleshooting

·     Where do you need to change the settings? To increase the memory size, proceed as follows and first create a backup copy of the file you want to change:

-      Windows: If you have installed the MSI version of DATA Boreum, note that you need administrator rights and change the information in the ini-file under

C:\Program Files (x86)\Governikus KG\DATA Boreum\

-      Windows and Linux: If you have installed the portable version of DATA Boreum, change to the directory in which you unpacked DATA Boreum and change the information in the bat-file or in the sh-file.

·     Change memory size: For very large PDF files, the memory size (also maximum heap size) used by the Java virtual machine (JVM) must be increased. This maximum is set with the Java option -Xmx and is initially set to 2048m. The -Xmx settings can be found in the files mentioned above. Please note that you must first stop DATA Boreum, then change the Java option Xmx and then restart DATA Boreum.

·     Change Xmx: With this Java option, the m at the end of the entry means megabytes, for example -Xmx2048M. You can also add a g at the end, which means gigabytes. The letters can be written in lower or upper case. Please note the following: Never enter the maximum that your computer has as RAM, increase the value to -Xmx4096M or ‑Xmx3G, for example. The memory space specified in the Java option is reserved when DATA Boreum is started. If your computer is also running other memory-intensive programs, you should not increase this too much. If you omit the Xmx option completely, the JVM reserves ¼ of your computer's physical memory.

·     Use the smallest size for option -Xmx at which DATA Boreum can execute its signing function with large PDF files. Otherwise, DATA Boreum will reserve an unnecessarily large amount of memory on your system.

Hinweis

Note: Further information on the JVM parameter Xmx can be found in the Java Tuning White Paper in chapter 4