Skip to end of metadata
Go to start of metadata

Table of Contents

What Java heap sizes are recommended for optimized ADSS Server performance and how to change these?

Background:

Java uses a memory heap system which is continuously managed by the Java garbage collector. Oracle recommends increasing this value for server applications; see Tuning Garbage Collection with the 5.0 Java[tm] Virtual Machine. By default ADSS Server has a heap size of min 256 MB and max 1 GB for Core and Console instances while max 2 GB for Service instance. This setting is sufficient in most cases. On Windows 32 systems you cannot go above 1.5 GB. You can have a larger maximum heap size on 64 bit operating systems. Ascertia recommends the heap size as following for the ADSS Server instances:

InstanceDefault MemoryRecommended Memory
Core10241024
Console10241024
Service20484096

Impact on System:

Increasing the heap size substantially may also have a performance impact on the system. If you set a large heap size, then garbage collection is slower, but it occurs less frequently meaning the JVM will not free up memory so quickly. If you set your heap size in accordance with your memory needs, full garbage collection is faster, but occurs more frequently.

For Windows OS: 

In order to change the default heap size within ADSS Server v4.3 and later releases on Windows, follow these steps: 

  1. Stop the ADSS Core, Console and Service instances from Windows NT Services panel.
  2. Uninstall ADSS Server by running the uninstall.bat file using Run as administrator from location: [ADSS Server Installation Directory]\setup\.
  3. Make sure that the ADSS Server services are no longer present in the Windows NT Services panel.
  4. Go to the location [ADSS Server Installation Directory]\tomcat\bin and edit these files in a text editor one by one:
    • install_core.bat
    • install_console.bat
    • install_service.bat
  5. On the end of last un-commented line before param exit, set the values for minimum and maximum java heap space to whatever you wish for your environment. The default configuration is shown here and you need to modify it accordingly:

    install_core.bat
    install_console.bat
    install_service.bat
    Icon

    From ADSS Server v4.8.4 or later, update the memory parameters in [ADSS Server Installation Directory]/setup/memory_params.properties file as well. By doing so you will not have to set the memory parameters again when ADSS Server is upgraded to the latest version.

  6. Save the changes and execute these files one by one by right clicking and choosing Run as administrator option:
    • install_core.bat
    • install_console.bat
    • install_service.bat
  7. Start the ADSS Core, Console and Service instances from Windows NT Services panel in order to take the memory changes into effect.


For UNIX OS:

In order to change the default heap size within ADSS Server v4.7.2 and later releases on UNIX follow these steps:

  1. Stop the ADSS Core, Console and Service instances from UNIX daemon.
  2. Go to the location [ADSS Server Installation Directory]/tomcat/bin and edit these files in a text editor one by one:
    • startup_core.sh
    • startup_console.sh
    • startup_service.sh
  3. Search for the parameter CATALINA_OPTS and set the values for minimum and maximum java heap space to whatever you wish for your environment for each file:

    startup_core.sh
    startup_console.sh
    startup_service.sh
    Icon

    From ADSS Server v4.8.4 or later, update the memory parameters in [ADSS Server Installation Directory]/setup/memory_params.properties file as well. By doing so you will not have to set the memory parameters again when ADSS Server is upgraded to the latest version.

  4. Save the changes.
  5. Start the ADSS Core, Console and Service instances from UNIX daemon.
  6. You can verify the heap size with jconsle.

Icon

ADSS Server v4.7.2 and later releases support the memory parameters for each instance separately while older versions support memory parameters configurations in setclasspath.sh for all instances. In order to change the default heap size within ADSS Server v4.7.1.x and below on UNIX follow these steps:

  1. Stop the ADSS Core, Console and Service instances from UNIX daemon.
  2. Go to the location [ADSS Server Installation Directory]/tomcat/bin
  3. Edit the setclasspath.sh and search for the parameter CATALINA_OPTS and set the values for minimum and maximum java heap space to whatever you wish for your environment 

  4. Save the changes.
  5. Start the ADSS Core, Console and Service instances from UNIX daemon.
  6. You can verify the heap size with jconsle.

 

 

  • No labels