IBM Support

Error 500: java.lang.OutOfMemoryError: Java heap space

Troubleshooting


Problem

When attempting to access the IBM Storage Protect for VMware GUI at https://localhost:9081/TsmVMwareUI/, the message “Error 500: java.lang.OutOfMemoryError: Java heap space” is displayed.

Symptom

When attempting to log in to the IBM Storage Protect for Virtual Environments – Data Protection for VMware GUI, the login fails and displays an error 500. The issue occurs when accessing the following URL:

https://localhost:9081/TsmVMwareUI/

Error Message:

Exception thrown by application class 'java.util.zip.ZipFile.getEntryBytes:-2'
java.lang.OutOfMemoryError: Java heap space
at java.util.zip.ZipFile.getEntryBytes(Native Method)
at java.util.zip.ZipFile.getZipEntry(ZipFile.java:632)
at java.util.zip.ZipFile.getEntry(ZipFile.java:367)
at java.util.jar.JarFile.getEntry(JarFile.java:335)
at com.ibm.oti.vm.AbstractClassLoader.findResourceImpl(AbstractClassLoader.java:213)
at com.ibm.oti.vm.AbstractClassLoader.access$100(AbstractClassLoader.java:38)
at com.ibm.oti.vm.AbstractClassLoader$1.run(AbstractClassLoader.java:183)
at java.security.AccessController.doPrivileged(AccessController.java:691)
at com.ibm.oti.vm.AbstractClassLoader.findResource(AbstractClassLoader.java:180)

 

 

Cause

This error occurs when the IBM Storage Protect for VMware Web GUI process exhausts its allocated Java heap memory.

Large or corrupted Java cache files, accumulated Java core and dump files, or insufficient heap allocation in the Web GUI JVM can cause memory pressure. As a result, the application cannot load required JAR or ZIP resources, leading to a java.lang.OutOfMemoryError: Java heap space condition.

Resolving The Problem

  1. Stop the IBM Spectrum Protect Web Server and Derby Database (vmcli) services.

  2. Clean up Java dump and Java core files:
    Delete all Java core/dump/crash files from the following directories:

    • C:\Program Files\Tivoli\TSM\baclient

    • C:\IBM\SpectrumProtect\webserver\usr\servers\veProfile

  3. Increase the Java heap space:
    Edit the JVM.options file located at:

    C:\IBM\SpectrumProtect\webserver\usr\servers\veProfile 

     

    Add or modify the following entry to increase maximum heap size to 5 GB:

    -Xmx5120m 

  4. Restart the IBM Spectrum Protect Web Server and Derby Database (vmcli) services.

Document Location

Worldwide

[{"Type":"MASTER","Line of Business":{"code":"LOB69","label":"Storage TPS"},"Business Unit":{"code":"BU048","label":"IBM Software"},"Product":{"code":"SSERB6","label":"IBM Spectrum Protect for Virtual Environments"},"ARM Category":[{"code":"a8m3p000000hAaNAAU","label":"Data Protection-\u003EVirtual Environments (VE)"}],"ARM Case Number":"","Platform":[{"code":"PF033","label":"Windows"}],"Version":"and future releases;8.1.2"}]

Document Information

Modified date:
17 November 2025

UID

ibm17251396

Page Feedback