Choose your language

Choose your login


PaperCut on Linux errors with "Java heap space"


There have been a few reports of customers running a combination of 32-bit Linux virtual machines with smaller amounts of system RAM having problems starting later versions of the PaperCut NG or PaperCut MF Application Server. This appears to be limited to environments with 2GB or less of system RAM.

Users who have experienced this issue will see similar errors in their server.log located in [app-path]\server\logs\.

2011-10-17 08:40:27,523 FATAL AppServer:197 - Unable to start
 application server. Java heap space [WrapperSimpleAppMain]
 java.lang.OutOfMemoryError: Java heap space

Note: As of version 17.1 of PaperCut NG and PaperCut MF, a 32-bit variant for Linux is no longer made available.

Current resolution

Customers have reported that increasing the amount of system RAM has resolved this issue.

Possible resolution

It is possible that this error may be resolved by increasing the RAM fraction that the Application Server has access to. Testing of the Java Heap error has not been able to reproduce this issue as at the time of writing, so this is something to try if increasing the system RAM is not possible.

PaperCut NG and PaperCut MF’s Application Server requires at least 192MB of RAM, and we would recommend 256MB of RAM or more in most environments. By default the Application Server will use 25% of available system RAM; this means that to meet the minimum requirement of 192MB of RAM, the system should have at least 768MB of system RAM. To meet 256MB you would therefore require 1GB of RAM.

If you cannot increase the amount of physical RAM, you can try increasing the fraction of RAM available to the Application Server by following this KB article: Managing the amount of memory used by PaperCut NG/MF

Categories: Troubleshooting Articles , Administration



Last updated February 15, 2024