Default language.

Defining a heap size for the BMC Remedy Email Engine

The initial minimum (-Xms256m ) and maximum (-Xmx1024m ) Java heap sizes are set at the time of installation as JVM Options. You can increase these values by updating them in the appropriate locations depending on the operating system.

  • (Windows) Remedy Email Engine registry key for the Remedy Email Engine Service or the EmailStart.bat file
  • (UNIX) The emaild.sh file

If you run out of memory, you should adjust your heap size according to your memory needs.

Note

We cannot recommend the exact heap sizes to suit your environment; try to modify the minimum and maximum settings, and then stop and restart the BMC Remedy Email Engine. You might see dramatic improvements in performance.

Changing the heap size on Windows

You can change the minimum and maximum values for the Java heap size in two ways, depending on how you run the BMC Remedy Email Engine:

Important

If you are using Email Engine on Windows, do not run the Email Engine service and EmailStart.bat at the same time.

Updating the Windows registry key

  • Key: HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\BMC Remedy Email Engine - serverNameinstanceNumber\Parameters where instanceNumber is the number assigned to the instance of the BMC Remedy Email Engine for which you want to change the Java heap size.
  • Tag: JVM Option Number 2 (minimum) or JVM Option Number 3 (maximum)
  • Value: -XmsSize (minimum) or -XmxSize (maximum)
     When both the minimum and maximum Java heap size values are set in the registry, the JVM Option Count will be 4.

Updating the value in EmailStart.bat file

For example, the line for this setting might look like:


set JAVA_OPTS="-Xms256m -Xmx1024m"

Best practice
We recommend changing the minimum and maximum values for the Java heap size by updating both the Windows registry key and the value in the EmailStart.bat file.

Changing the heap size on UNIX

To change the minimum and maximum Java heap size values, edit the emaild.sh file to include the options:

  • -XmsSize to specify the minimum heap size
  • -XmxSize to specify the maximum heap size

For example, the line for this setting might look like:


java -Xms256m -Xmx1024m com.bmc.arsys.emaildaemon.EmailDaemon

 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*