3. Allocating Memory to Tomcat

By default Tomcat (the bundled web server) is configured to use a maximum of 2 GB of memory which is quite sufficient in majority of cases. In case this proves insufficient for you, you can increase it as follows:

  1. First determine the amount of memory you want to allocate. Typically, it should not exceed half of your installed RAM. For example, if you have 4 GB of RAM, then you can safely allocate 2 GB to Tomcat. Let's assume you want to set it to 4 GB i.e. 4000 MB.
  2. Stop Celoxis
  3. Set the system environment variable CATALINA_OPTS to -Xms512M -Xmx4000M (Note the dash in front of the X.)

On Microsoft Windows:

  1. Right click My Computer.
  2. Click Properties.
  3. Click the Advanced tab (or click Advanced system settings in Windows Vista).
  4. Click the Environment Variables button
  5. Under System variables, click New.
  6. Set variable name to CATALINA_OPTS and variable value to -Xms512M -Xmx4000M
  7. Click OK.
  8. Click OK on the Advanced tab to close the window. 

On Linux:

  1. Open a terminal and login as the user that starts Celoxis.
  2. In the appropriate profile file (e.g. .bash_profile or .profile), type: export CATALINA_OPTS=-Xms512M -Xmx4000M
  3. Save the file.
  4. Logout and Login again.
  5. Start Celoxis.
     

Celoxis needs to start with a minimum of 512 MB and hence, we set the -Xms value to 512M.

For 32-bit operating system, you need to set both the -Xms and -Xmx parameters as seen in the above screenshot. However, the Xmx parameter should only be set to 1GB i.e 1024M.