Allocate Virtual Memory for Aternity Servers (JVM Heap Size)

When deploying Aternity on-premise, you must configure the memory allocation of the underlying Java virtual machine (JVM), known as the JVM Heap Size in the following servers:

If you deploy several Aternity components on the same computer, you only configure the JVM heap size once per machine.

Before you begin

Complete the setup of the Aternity components for this computer.

Procedure

  1. Step 1 Open and edit c:\data\Aternity\watchdog\custom-jvm-properties in a plain text editor.
    Configure the JVM heap size for this computer
  2. Step 2 Edit only the line starting with HEAP_SIZE=.

    There are four values written in a very specific notation, where m indicates number of megabytes set aside in different cases. Always set the following values to be the same:

    • -Xmx should always be the same as the value of -Xms

    • -XX:NewSize should always be the same as the value of -XX:MaxNewSize

  3. Step 3 Set the values for each component according to the hardware requirements for your deployment.
  4. Step 4 Save the file and exit from the editor.
  5. Step 5 Restart the computer.
  6. Step 6 To set the ActiveMQ heap size (Aternity Management Server only):
    1. a Open and edit C:\data\Aternity\mesgbroker\bin\activemq.bat in a plain text editor.
    2. b Search for set ACTIVEMQ_OPTS=
      Set the ActiveMQ heap size

      There are two values written in a very specific notation. -Xmx should always be the same as the value of -Xms

      For example: if "%ACTIVEMQ_OPTS%" == "" set ACTIVEMQ_OPTS=-Xms1G -Xmx1G -Djava.util.logging.config.file=...