KBEC-00038 - Improving ElectricCommander server performance by tuning memory allocation


ElectricCommander is distributed to work with a minimum memory configuration of 2 GB. Most modern server configurations have the ability to add more memory, which Commander can be tuned to use. Also, you can tune Commander to use less memory to prevent disk thrashing that is associated with excess paging on a 1 GB memory configuration. You can tune your configuration's memory to improve ElectricCommander server performance.


Java (JRE) solution

The Commander server is a Java application. As the Commander load increases, the small, default Java heap size is exhausted, which results in the following commander.log file message:

When the Commander server starts, a configuration file specifies the default Java heap size. On 32-bit systems, heap size can be set to a maximum of 1500 MB. If you have a large memory machine, increase maxmemory to the 1500 MB maximum. On small memory machines, specify a memory allocation as low as 256 MB to prevent thrashing.

Here is a list of JVM memory considerations:

  1. Out of the box, the Commander JVM heap size is configured to use 25% of the physical memory on the machine.
  2. In addition to the heap size, theres memory used by code, stacks, threads, etc., so the grand total usage may exceed 25%.
  3. Once the JVM has allocated memory from the OS, it never gives it back.
  4. Commander will configure it to allocate the 25% right away. Growing the heap can be expensive, and this is a server product, so that makes sense as a default.
  5. The JVM will tend to accumulate garbage until it nears the heap size limit, at which time it will garbage collect.
  6. Because of this behavior it often looks like the JVM is using more memory than it actually is, especially if youre looking at the virtual size of the process, as opposed to the RSS/working set.
  7. On a 8GB machine a 2.x GB is expected, based on the 25% number above.

After changing the configuration file, restart the Commander server. On Linux, use the script "commander restart" in /etc/init.d. On Windows, use the Control Panel, Services tab to restart the "ElectricCommander Server".


Java configuration example

The Java heap size attribute is located in the wrapper.conf file within the Commander server/conf directory.

As distributed, the Java heap size is percentage of memory.

On 64-bit OS systems this allocation usually works fine.

On 32-bit OS systems there are memory limitations considerations and it can be expanded to a maximum of 1500 MB on Windows and perhaps more on large memory 32-bit Linux machines or decreased to 256 MB for small memory machines.


  1. After Commander 4.0, you can configure the % or mb via ecconfigure and we should persist these values across an upgrade.

    ./ecconfigure --serverMaxMemory 30
    ./ecconfigure --serverMaxMemoryMB 1000
  2. After Commander 3.6, the wrapper memory values are a percentage of memory instead of a fixed memory value. This facilitates an easy general purpose install. On enterprise production Commander installs, it is best to place a physical number for the Java memory allocation.
  3. On Linux use the -Xmx command to determine the maximum memory setting of Java.
    java -Xmx2500m # gives usage page (which is OK)
    java -Xmx3000m # produces error message "The specified size exceeds the maximum representable size"

  4. The number of threads allocated in the server varies based on the number of cores in the system and how thread stacks consume address space. On 32-bit systems with many cores (say 8 or more), lower the maximum heap size on the 32-bit JVM by around 100 MB to prevent the JVM from running out of address space when there really is enough memory available. On Windows this means lower it to 1400 MB and on Linux lower it to 2300 MB.

Here is the extract of text from the file wrapper.conf where the changes are to be made:

# Initial Java Heap Size (in MB)

# Maximum Java Heap Size (in MB)
# If this is set too high, java will not run at all and the
# Commander server will not start. At least for 32-bit Windows,
# the limit is about 1500 MB.




Have more questions? Submit a request


Powered by Zendesk