Skip to main content
Pentaho Documentation

Increase Memory Limits on Microsoft Windows with a Wizard Installation

The Tomcat server has a relatively low memory allotment by default. This can cause out-of-memory errors by the Pentaho Server for Windows users who installed the Pentaho software using the install wizard instead of a manual installation. You can increase the memory allotment so this error does not occur by performing the  following steps:

  1. Stop the Pentaho Server by navigating to the server\pentaho-server\tomcat\bin folder and double-clicking the shutdown.bat file.

  2. Double-click the pentahoserverw.exe file in the server\pentaho-server\tomcat\bin folder to open the Pentaho Server Properties window. You may need to right-click the file and select Run as Administrator, depending on your user permission settings.
  3. Select the Java tab as shown in the following example:

  4. Increase the default Initial memory pool value from 4096 MB to 6144 MB and the default Maximum memory pool value from 6144 MB to 8192 MB, depending on your computer's memory capabilities, then click OK.
  5. Start the Tomcat server by navigating to the server\pentaho-server\tomcat\bin folder and double-clicking the  startup.bat file.
  6. You can verify that the new memory settings are used by inspecting your Catalina log file.

If there is not enough contiguous memory available to assign to the Java virtual machine (JVM), the JVM may refuse to start. To resolve this problem, perform one or more of the following tasks:

  • Add more RAM to your system.
  • Stop some memory-intensive services.
  • Lower the maximum memory limit allocation.