Last Updated on
- Prevents Out Of Memory Errors
The recommendation below is assuming there is at least 8GB RAM on the Server and half of the provisioned memory is being allocated to Tomcat. Adjust Memory accordingly
Configuring Tomcat (Application)
- Edit Ephesoft_Installation_Folder\JavaAppServer\bin\startup.bat using a text editor.
- Please find JAVA_OPTS in startup.bat and copy the settings against JAVA_OPTS to a new instance of text editor. (in case we want to revert to earlier settings.)
- Now edit JAVA_OPTS by appending below mentioned settings to its end.
-Xms4096m –Xmx4096m –Xss512k -XX:MaxPermSize=1024m -XX:PermSize=1024m
- Please make sure that we don’t have duplicate entries for above mentioned optioned in JAVA_OPTS.
- Save startup.bat
Configuring Tomcat (Windows Service)
- Open tomcat service configuration by right clicking on the Ephesoft_Installation_Folder\JavaAppServer\bin\EphesoftEnterprise.exe file.
- Right Click and Select ‘Run as administrator’
- Go to Java tab.
- Now append following configuration under Java Options:
Please make sure none of above entries are duplicated in Java Options
Edit Initial memory pool option to value 4096.
Edit Maximum memory pool option to value 4096.
Thread Stack Size to 512
Apply these settings and start the server.
In Linux you need to edit the settings located in the /opt/Ephesoft/JavaAppServer/bin/setenv.sh
export JAVA_OPTS=‘-Djava.library.path=$EPHESOFT_NATIVE -Djava.io.tmpdir=$APP_SERVER_TEMP -Ddcma.home=$DCMA_HOME -Xmx4096m -Xms4096m -XX:PermSize=1024m -XX:MaxPermSize=1024m -Duser.language=en -Duser.country=US -Dcom.sun.management.jmxremote -Dcom.sun.management.jmxremote.port=8900 -Dcom.sun.management.jmxremote.authenticate=false -Dcom.sun.management.jmxremote.ssl=false -Dcom.sun.management.jmxremote.local.only=false -XX:-UseSplitVerifier -Djava.net.preferIPv4Stack=true -Djava.awt.headless=true’
By using these recommended minimum settings you will help prevent Out of Memory Errors (OOME). Please note that these are minimum specs for you memory configuration for Tomcat and should be used as a starting point. If you continue to receive OOME issues you may need to continue adjusting the Heap or Memory size in the Tomcat configurations or troubleshoot the reason why you are exceeding the memory for the application. (Tip: for troubleshooting Thread or memory issues use tools like jvisualVM)