Skip to main content
Pentaho Documentation

Increase Memory Limits on Linux with a Graphical Install

By default, Tomcat has a relatively low memory allotment. This can cause out-of-memory errors in the BA Server from time to time. To avoid errors, increase the memory allocation so you can start the BA Server automatically.

These instructions apply if you installed Pentaho Business Analytics using the graphical installer as opposed to manual installer and are Linux users.

  1. Go to /pentaho/server/biserver-ee/tomcat/bin/ directory and run the ./shutdown.sh command to stop the appropriate server.
  2. Change the directory to biserver-ee/tomcat/scripts.
  3. Edit the ctl.sh file.
  4. Locate the line under start tomcat, which looks like this: export JAVA OPTS="-Dpentaho.installed.licenses.file=/opt/pentaho/.installedLicenses.xml -Xms128m Xmx768m -XX-MaxPermSize=256m -Dsun.rmi.dyc.client.gcInterval=3600000 -Dsun.rmi.dgc.server.gcInterval=3600000"
  5. Set the memory to a minimum of 4096 M and a maximum of 6144 M, depending on your computer's memory capabilities.
  6. Start the Tomcat server or service.
Your Tomcat server now has increased minimum and maximum memory limits. You can adjust the JvmMx parameter to specify a higher maximum limit if you prefer. However, if the Java virtual machine refuses to start with increased limits, then you will have to add more RAM to your system, stop some memory-intensive services, or reduce the maximum memory limit to a lower number. This problem occurs when there is not enough contiguous memory available to assign to the JVM, and appears to happen more often on Microsoft Windows at lower thresholds than on other operating systems.