IBM Support

Setting Maximum Heap Size for IBM Support Assistant Team Server 5 Heap Analysis Tools

Product Documentation


Abstract

Heap dump analysis tools need a large amount of memory to analyze heap dumps that are very large and sometimes the default heap size isn't large enough. IBM Support Assistant Team Server 5 provides ways to set the maximum heap size for the various editions of its heap dump analysis tools.

Content

Sometimes java.lang.OutOfMemoryError (OOM) exceptions occur when analyzing large heap dumps with the IBM Support Assistant Team Server 5 heap dump analysis tools. They include:

  • HeapAnalyzer [Desktop]
  • Memory Analyzer [Desktop]
  • Memory Analyzer [Report]
  • Memory Analyzer [Web]

Often the solution to OOM exceptions is to increase the maximum heap size for these tools. The methods for doing so are different for the various tool editions.

Report and Web tool configuration

Many problem determination tools available for IBM Support Assistant allow customization. These tools include properties files that you can edit to change the default behavior.

For example, follow these steps to increase the maximum heap size for Memory Analyzer [Report].

  1. Open a command window, shell, or file system browser on the system running IBM Support Assistant Team Server 5.
  2. Copy <install_dir>/ISA5/ToolBox/com.ibm.java.diagnostics.memory.analyzer/com.ibm.java.diagnostics.memory.analyzer.properties to <install_dir>/ISA5/ToolBox/properties.
  3. Edit <install_dir>/ISA5/ToolBox/properties/com.ibm.java.diagnostics.memory.analyzer.properties. You will see a property named jvm.args.
  4. Increase the value of the -Xmx argument. For example, increase the default -Xmx2048M to -Xmx4096M and then save the file.
  5. If you changed property values for the Web edition of Memory Analyzer, then restart IBM Support Assistant Team Server to load the updated property values.

The next time you analyze a heap dump the new maximum heap size will be used.

See Tool Specific Configuration Options in the IBM Support Assistant 5 Knowledge Center for more information on configuring problem determination tools.

Desktop tool configuration

Beginning with IBM Support Assistant Team Server 5.0.1 you can customize the minimum and maximum heap sizes for desktop tools each time you launch them from the Tools tab. Follow these steps:

  1. Start a session with IBM Support Assistant Team Server.
  2. Click the Tools tab.
  3. Select a desktop tool from the list of tools.
  4. Click the "Launch" button above the tool details. A dialog opens with fields to set the minimum and maximum heap sizes.
  5. Set the minimum and maximum heap size values in MB.
  6. Click the "Launch" button on the dialog to start the tool.

Have questions or comments? You can post them to the IBM Support Assistant forum.

Have an idea for a new feature? You can open a Request for Enhancement.

[{"Product":{"code":"SSLLVC","label":"IBM Support Assistant"},"Business Unit":{"code":"BU053","label":"Cloud & Data Platform"},"Component":"Tool Add-ons","Platform":[{"code":"PF002","label":"AIX"},{"code":"PF016","label":"Linux"},{"code":"PF033","label":"Windows"}],"Version":"5.0.1;5.0","Edition":"TeamServer","Line of Business":{"code":"","label":""}},{"Product":{"code":"SSNVBF","label":"Runtimes for Java Technology"},"Business Unit":{"code":"BU059","label":"IBM Software w\/o TPS"},"Component":"Out of Memory","Platform":[{"code":"","label":""}],"Version":"","Edition":"","Line of Business":{"code":"LOB36","label":"IBM Automation"}},{"Product":{"code":"SSNVBF","label":"Runtimes for Java Technology"},"Business Unit":{"code":"BU059","label":"IBM Software w\/o TPS"},"Component":"Debugging Tools","Platform":[{"code":"","label":""}],"Version":"","Edition":"","Line of Business":{"code":"LOB36","label":"IBM Automation"}}]

Document Information

Modified date:
17 June 2018

UID

swg27040548

Page Feedback