Step 1: Modify the Tomcat startup script

The Tomcat startup script must be modified to include the CATALINA_OPTS variable.

CATALINA_OPTS indicates the amount of memory to allocate. It also indicates where Pentaho licenses are installed.

Perform the following steps to include the CATALINA_OPTS variable:

1. Make sure the Tomcat web application server is not running. Open a Terminal window and type ps -A at the prompt.

2. If the server is running, stop it.

3. Use a text editor to open the startup .sh file, which is in the pentaho/server/pentaho-server/tomcat/bin directory.

4. Locate the #Check that target executable exists line and add this code above it.

   DI_HOME=<your pentaho directory>/pentaho-solutions/system/kettle

5. Add the Java option pentaho.installed.licenses.file to CATALINA_OPTS.

   You need to modify the setting of the CATALINA_OPTS variable at the end of the file by adding the Java option. See the following example.

   EXPORT CATALINA_OPTS="-Xms4096m -Xmx6144m -XX:MaxPermSize=256m -Dsun.rmi.dgc.client.gcInterval=3600000 -Dsun.rmi.dgc.server.gcInterval=3600000 
   -Dpentaho.installed.licenses.file=$PENTAHO_INSTALLED_LICENSE_PATH -DDI_HOME=$DI_HOME"
   

6. Save and close the file.