WoodWing Help Center

Elvis 6 memory configuration

Elvis 6 memory configuration

After the installation of Elvis 6 Server, sufficient memory should also be allocated to the Java Virtual Machine (JVM) instance in which Elvis Server itself is run, specifically to the Java heap memory.

Optimal Java heap size memory settings

The optimal performance settings for the initial and maximum Java heap memory size depends on whether or not Elvis Server is configured to act as a Search node:

Elvis Server acting as a Search node? Java heap size memory allocation
Maximum (-Xmx) Initial (-Xms)
Yes Allocate 25% of the machine's total with a minimum of 1GB Same as -Xmx
No Allocate about 40–50% of the machine's total with a minimum of 1GB Same as -Xmx

About the maximum Java heap memory (-Xmx)

The -Xmx option controls just the Java heap memory block. The actual Java process may use more memory because it also has blocks of non-heap and native memory. It is advisable to leave sufficient memory available for the operating system.

Note: Most modern operating systems will use any remaining memory to speed up the disk cache. This can hugely improve performance of the search engine.

Changing the Java heap settings

The following samples show how to modify the Java heap memory settings on all platforms. The samples assume a machine with the following configuration:

  • Amount of RAM: 16GB
  • Elvis Server acting as a Search node: yes

This results in about 4GB that can be assigned to the Java heap memory.

Note: For platforms with a higher or lower amount of memory, adjust the memory values according to the recommendations outlined above.

Tip: Use a converter to convert Gigabits to Megabits.

On Windows

  • Open the Jetty config in Notepad or another text editor.

<Program Files>\Elvis Server\elvis-service\elvis-service.conf

  • Change the following lines and save the changes:

wrapper.java.initmemory=4096

wrapper.java.maxmemory=4096

  • Restart Elvis Server.

On Mac OS X

  • Open the Terminal and type the following:

$ sudo nano /Library/LaunchDaemons/com.dutchsoftware.elvis.server.launchd.plist

  • Change the Xmx and Xms settings:

<string>-Xms4g</string>

<string>-Xmx4g</string>

  • Save the changes and exit by typing Ctrl+X followed by Y.
  • Restart Elvis Server.

On Linux

  • Type the following in the command line:

$ sudo nano /srv/elvis-server/app/wrapper/conf/wrapper.conf

  • Comment-out:

wrapper.java.initmemory=1024

wrapper.java.maxmemory=6144

  • At the end of the file, change.:

wrapper.java.additional.1 = -Xms4g

wrapper.java.additional.2 = -Xmx4g

  • Save the changes and exit by typing Ctrl+X followed by Y.
  • Restart Elvis Server.
Was this article helpful?
0 out of 0 found this helpful / Created: / Updated:
Have more questions? Submit a request

0 Comments

Please sign in to leave a comment.