"OutOfMemoryError: Java heap space" in Truesight Orchestration - INCLUDES VIDEO

Knowledge Article

"OutOfMemoryError: Java heap space" in Truesight Orchestration - INCLUDES VIDEO
OutOfMemoryError, after which peer stops working. How to increase the heap space?
TrueSight Orchestration Platform
TrueSight Orchestration Platform
TrueSight Orchestrtion Platform, All versions.
TrueSight Orchestration Platform
TrueSight Orchestration Platform
TrueSight Orchestrtion Platform, All versions.

"OutOfMemoryError: Java heap space" error in BMC Atrium Orchestrator (BAO) / TrueSight Orchestration (TSO) logs, after which the peer stops working. How we can increase heap space and how to fix this issue?

To increase the heap space of the peer uses, by editing its startup settings. This information can find specific memory recommendations on the page "System Requirements" in the documentation for the version of BAO/TSO. In general, BMC recommends using a heap space maximum of eight gigabytes for job-processing peers, including Configuration Distribution Peers.
 

Linux / Solaris, all versions of BAO/TSO:
 

  1. Login to the server on which you installed TSO and navigate to the $TSO_HOME\bin directory.
  2. Edit the server.sh file using the following command: vi server.sh
  3. Press i to enter insert mode.
  4. Navigate through the file and locate the following string (this can be the beginning of a long line; there can be additional parameters): JAVA_OPTS="-server -Xmx1280"
  5. Change the current numeric value to the desired value.
  6. Press Esc, then hold the Shift key and type zz to save the file and exit vi.
  7. Restart the TSO service.


Windows, BAO 7.6.03:
 

  1. Login to the server on which you installed BAO.
  2. Run the command "[BAO_HOME]\tomcat\bin\tomcat6w.exe //ES/BAO-CDP1", substituting your BAO installation directory and the name of your BAO service
  3. Click the Java tab.
  4. Change the "Maximum memory pool" parameter to the new heap size
  5. Save the changes and close the window.
  6. Restart the BAO service.


Windows, BAO 7.7.00 through 7.8.01:
 

  1. Login to the server on which you installed BAO.
  2. Run the command "[BAO_HOME]\tomcat\bin\tomcat7w.exe //ES/BAO-CDP1", substituting your BAO installation directory and the name of your BAO service
  3. Click the Java tab.
  4. Change the "Maximum memory pool" parameter to the new heap size
  5. Save the changes and close the window.
  6. Restart the BAO service.


Windows, BAO 7.8.02 , 7.9.xx and TSO 8.1.xx.xxx
 

  1. Login to the server on which you installed BAO/TSO.
  2. Run the command "[BAO_HOME/TSO_HOME]\tomcat\bin\tomcat8w.exe //ES/BAO-CDP1", substituting your BAO installation directory and the name of your BAO/TSO service
  3. Click the Java tab.
  4. Change the "Maximum memory pool" parameter to the new heap size
  5. Save the changes and close the window.
  6. Restart the BAO service.


Windows, TSO 8.2, 20.02 and 22.2:
 

  1. Login to the server on which you installed TSO.
  2. Run the command "[TSO_HOME]\tomcat\bin\tomcat9w.exe //ES/BAO-CDP1", substituting your BAO installation directory and the name of your BAO/TSO service
  3. Click the Java tab.
  4. Change the "Maximum memory pool" parameter to the new heap size
  5. Save the changes and close the window.
  6. Restart the BAO service.
PLEASE NOTE: For TSO 20.02 and later versions, it is recommended to have the allocated memory to 8 GB to avoid any kind of issues.



TSO has many of the options available as JVM settings. This includes maximum and minimum heap space, PermGen space, and other options. You can find a full description of available parameters at http://www.oracle.com/technetwork/java/javase/tech/vmoptions-jsp-140102.html.

Please note that we recommend setting maximum and minimum heap space to the same value for optimum performance so that the peer will have that much of memory available at its startup.
TrueSight Orchestration Platform
TrueSight Orchestration Platform
TrueSight Orchestrtion Platform, All versions.
Attachment(s):