By default, Tomcat has a relatively low memory allotment. This can cause out-of-memory errors in the BA Server from time to time. The below instructions will explain how to increase the memory so you don't get this error. Instructions are also included for renaming the tomcat6 executable file so that BA Server starts automatically.
These instructions are for those who installed Pentaho Business Analytics graphically (as opposed to manually) and are Windows users.
- Go to the Windows Search Box and enter C:\Program Files\pentaho\server\biserver-ee\tomcat\bin\shutdown.bat to shutdown the Pentaho BA Server.
- Type services.msc into the Windows Search Box.
- Find the Pentaho Server name (Pentaho BA Server or Pentaho BI Server) and open it so you can find the service name. The service name should appear at the top of the first tab (General). It will be pentahobaserver.
- Go into the bin file (C:\Program Files\pentaho\server\biserver-ee\tomcat\bin\) and rename the tomcat6w.exe file to match the service name (pentahobaserver or pentahobiserver). This will ensure that the server starts with the software.
- After you have renamed the file, open it by double-clicking on it. This will not open the file, it will allow you to edit it. You may need to right-click and select Run as Administrator. This depends on your user permission settings. The Properties Window will open.
- Select the Java tab.
- Set the memory setting to a minimum of 4096 M and a maximum of 6144 M, depending on your computer's memory capabilities.
- Start the Tomcat server or service.