Chapter 7. Allocating Memory to Tomcat

By default Tomcat (the bundled web server) is configured to use a maximum of 768 MB 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 2 GB i.e. 2048 MB.

  2. Stop Celoxis

  3. Set the system environment variable CATALINA_OPTS to -Xmx2048M (Note the dash in front of the X)

    On Microsoft Windows

    1. Right click on My Computer

    2. Click Properties

    3. Click on the Advanced tab (or click on 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 -Xmx2048M

    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=-Xmx2048M

    3. Save the file

    4. Logout and Login again

  4. Start Celoxis