By default, tomcat comes Tomcat is installed with the memory setting of 256MB , whereas the recommended memory for OpenSpecimen is 2GB. This could lead to out of memory error when processing large amount of data. E.g. bulk upload, export, etc.
This document describes the steps to increase the memory for Java process in tomcat.
If OpenSpeicmen installed using the installer, it will set above memory settings by default. Set below settings if tomcat is not installed using OpenSpecimen installer or not using recommended settings.
fix this.
How to check what is max memory set for java processthe current memory setting?
- Open $TOMCAT_HOME/logs/catalina.out file.
- Search for the string "-Xmx"
It will look like -Xmx2048m . If memory is less than 2048 then it means max memory is less than 2 GB.if set to 2GB.
How to set
...
memory
...
?
Windows:
- Delete the existing tomcat Tomcat service with command: SC DEL <name of the tomcat service>. The service name can be checked in the services.
- Open $TOMCAT_HOME/bin/service.bat in any text editor.
- Search for the string "--JvmMx"
- Change the max memory to 2 GB (recommended)
> Before --JvmMx 256
>After --JvmMx 2048 - Save the file.
- Open command prompt
- Go to $TOMCAT_HOME/bin
- Run the command service.bat install
- Start the newly installed Apache Tomcat service.
Linux:
- Create a new file setenv.sh inside $TOMCAT_HOME/bin/ directory. Add the below line in newly created setenv.sh file :
export JAVA_OPTS="-Dfile.encoding=UTF-8 -Xms128m -Xmx2048m -XX:PermSize=64m -XX:MaxPermSize=512m" - Restart the tomcat Tomcat service using command - su service <service_name> restart.