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 Pentaho Server from time to time. To avoid errors, increase the memory allocation so you can start the Pentaho Server automatically.

These instructions apply if you installed the Pentaho software graphically (as opposed to manually) and are Linux users.

  1. Go to /pentaho/server/pentaho-server/tomcat/bin/ directory and run the ./shutdown.sh command to stop the appropriate server.

  2. Change the directory to pentaho-server/tomcat/scripts.
  3. Edit the ctl.sh file.
  4. Locate the line under start tomcat, which looks like the following code: 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 number (a parameter that specifies the maximum memory limit for the Java virtual machine) to a higher number, if you prefer. However, a problem occurs when there is not enough contiguous memory available to assign to the Java virtual machine (JVM), which appears to happen more often on Microsoft Windows at lower thresholds. If the JVM refuses to start with increased limits, then you will have to add more RAM to your system, stop some memory-intensive services, or lower the maximum memory limit allocation.