Skip to main content
Pentaho Documentation

Increase the Memory Limit in Aggregation Designer

Pentaho Aggregation Designer's startup script uses the default memory settings for your Java environment, which may be insufficient for your work. If you're experiencing an OutOfMemory exception, you must increase the amount of heap space available to Aggregation Designer by changing the Java options that set memory allocation. Follow the directions below to accomplish this.

Note: In the examples below, the memory size notations are m for megabytes and g for gigabytes. You can use whichever is most appropriate for your situation.
  1. Exit Aggregation Designer if it is currently running.
  2. Edit the startaggregationdesigner script and modify your Java command to include an -Xmx line that specifies a large upper memory limit.

    Linux/Solaris shell script:

    "$_PENTAHO_JAVA" $LICENSEPARAMETER -Xmx2g -jar "$DIR/lib/launcher-1.0.0.jar"

    Windows batch file:

    "%_PENTAHO_JAVA%" %LICENSEPARAMETER% -Xmx2g -jar "%~dp0lib\launcher-1.0.0.jar"
  3. Start Aggregation Designer and ensure that there are no memory-related exceptions.
The Java virtual machine instance that Aggregation Designer uses now has access to more heap space, which should solve OutOfMemory exceptions and increase performance.