Submit a ticketCall us

Training ClassThe Orion® Platform Instructor-led Classes

Provided by SolarWinds® Academy, these trainings will introduce users to the Orion Platform and its features, management, and navigation. These courses are suitable for users looking to discover new tips, tricks, and ways to adapt their Orion products to better suit their monitoring needs:
Deploying the Orion Platform
Configuring Orion views, maps, and accounts
Configuring Orion alerts and reports

Reserve your seat.

Home > Success Center > Storage Manager (STM) > STM - Knowledgebase Articles > Properly size Java heap space in STM

Properly size Java heap space in STM

Table of contents

Updated July 12, 2017


This article describes how to properly size Java heap space in STM (STM server and STM agent).


  • STM 4.11.x 
  • STM 5.0
  • STM 5.1
  • STM 5.2
  • STM 5.3
  • STM 5.3.3
  • STM 6.0
  • STM 6.1
  • STM 6.1.1
  • STM 6.2
  • STM 6.2.1
  • STM 6.3
  • STM 6.4


There must be a 2:1 ratio of total physical RAM on the box where STM (server or agent) is installed versus the Java requirement in terms of the Java software RAM. For example, if the box has 32 GB of RAM, then Java can safely latch 16 GB of RAM. To verify this information, right-click on My Computer and check the Installed Memory (RAM) information.


For STM servers, the total Java RAM requirement is the cumulative value of the following services:

  • Collector
  • Event Receiver
  • Maintenance
  • Polling engine
  • Apache Tomcat
  • MySQL

To individually verify the values:

  1. Open the STM Web Console and click the left navigation pane.
  2. Click Storage Manager Health Status to display the RAM allocation for each service.


For STM agents, the total Java RAM requirement by default is 512 MB XMX.

To verify this information:

  1. Stop the SolarWinds Storage Manager Collector service (STM server) or the SolarWinds Storage Manager Agent service (STM agent) using services.msc.
  2. Go to C:\Program Files\SolarWinds\Storage Manager Agent\.
  3. Open the Storage Manager Agent.ini file in Notepad. 
  4. Locate the following lines and change the XMX value:
    EXT_ARGS=-XX:MaxPermSize=256M -Xrs -Xms67108864 -Xmx536870912 -Djsnmp.ignoreV1V2PduSizeLimit=true -Duser.language=en -Duser.region=US -Dsun.lang.ClassLoader.allowArraySyntax=true -cp lib\kernel.jar com.tektools.bootstrap.BootRunner lib\core.jar

    Values with no preceding letters are calculated in byte notation such as MB and GB. The XMS value translates to the start or initialization value of Java. The XMX Java heap size translates to the maximum or end value that Java increases to once it starts getting into full stride. For example, if the box has a total of 8 GB RAM and serves only as an STM Java agent, you can increase the XMX value accordingly.
    In this example, change the XMX value to 4096M or 4 GB of RAM.
    The following is the result of the change:
    EXT_ARGS=-XX:MaxPermSize=256M -Xrs -Xms67108864 -Xmx4096m -Djsnmp.ignoreV1V2PduSizeLimit=true -Duser.language=en -Duser.region=US -Dsun.lang.ClassLoader.allowArraySyntax=true -cp lib\kernel.jar com.tektools.bootstrap.BootRunner lib\core.jar
  5. Save the Storage Manager Agent.ini file.
  6. Restart the service.


Last modified