Teamwork Cloud 18.5 SP3 Documentation

Skip to end of metadata
Go to start of metadata

This page provides the information you need to change Java heap space (Xmx) for both Cassandra and TWCloud on Linux and Windows respectively.

Configuring Java heap space for Cassandra

On Linux

To configure Java heap space for Cassandra on Linux, you need to set it from the variable, MAX_HEAP_SIZE, which is commented by default in the file cassandra-env.sh. The location of the file cassandra-env.sh depends on the type of Cassandra installation.

  • Package installation: /etc/cassandra/cassandra-env.sh
  • Tarball installation: <Cassandra install folder>/conf/cassandra-env.sh

If you do not explicitly specify the heap size, Cassandra will calculate the heap size based on the system's memory using the following formula.

max(min (1/2 ram), 1024MB), min(1/4, 8GB))

The following describes the formula in details:

  • For the system memory 0-2 GB: use half of it.
  • For the system memory 2-4 GB: use 1 GB.
  • For the system memory 4-32 GB: use a quarter of it.
  • For the system memory more than 32 GB: use 8 GB.

On Windows

It is recommended in the Cassandra document that you should set the min (-Xms) and max (-Xmx) heap to the same value to avoid making the GC pauses during resizing.

  • If you start Cassandra from cassandra.bat, you can change the min and max heap size from -Xms and -Xmx accordingly by searching for them in cassandra.bat.
  • If you start Cassandra from Windows service, you need to change the value using Registry Editor.

    To change the value using Registry Editor
    1. Run regedit from the command line
    2. Browse for the key HKEY_LOCAL_MACHINE\SOFTWARE\WOW6432Node\Apache Software Foundation\Procrun 2.0\DataStax_Cassandra_Community_Server\Parameters\Java.
    3. Right-click Options and select Modify.... You can change the min and max heap size from -Xms and -Xmx accordingly. 

Configuring Java heap space for TWCloud

On Linux

  • If you start TWCloud from the executable file, twcloud, you can configure the -Xmx parameter from the file twcloud.ini located in the same folder.
  • If you start TWCloud from service, you can configure the -Xmx parameter from the file <TWCloud install folder>/scripts/linux/twcloud.

On Windows

  • If you start TWCloud from the executable file, twcloud.exe, you can configure the -Xmx parameter from the file twcloud.ini located in the same folder.
  • If you start TWCloud from Windows service, you need to use Registry Editor to update the value.

    To change the value using Registry Editor
    1. Run regedit from the command line.
    2. Browse for the key HKEY_LOCAL_MACHINE\SOFTWARE\WOW6432Node\Apache Software Foundation\Procrun 2.0\Teamwork Cloud\Parameters\Java.
    3. Right-click the JvmMx and select Modify....
    4. Select Base to Decimal and change the value. The value is in megabytes (mb).


On this page

  • No labels