How to change the java heap size for the NetWorker Management Console?

Summary: How to change the java heap size for the NetWorker Management Console?

This article applies to This article does not apply to This article is not tied to any specific product. Not all product versions are identified in this article.

Instructions

The jave heap size may be changed from the default NetWorker Management Console value to accommodate various environment configurations.  

In the following example the java heap size will be decreased on the NetWorker Management Console from 2 GB (-Xmx2048m) to 1 GB (-Xmx1024m) on the NetWorker Management Console Server.  The new value will apply to any NetWorker Management Console workstations connecting to the NetWorker Management Console Server.
  • Open the gconsole.jnlp file on the NetWorker Management Console Server.
    • Default Linux: /opt/lgtonmc/web/gconsole.jnlp
    • Default Windows: C:\Program Files\EMC NetWorker\Management\GST\web\gconsole.jnlp 
  • Change the line for the Java heap memory max size:
    • Existing: <j2se version="1.8+"  java-vm-args="-XX:+IgnoreUnrecognizedVMOptions --add-modules=java.se.ee -Xms256m -Xmx2048m"/>
    • Changed: <j2se version="1.8+"  java-vm-args="-XX:+IgnoreUnrecognizedVMOptions --add-modules=java.se.ee -Xms256m -Xmx1024m"/>
  • Restart the NetWorker Management Console services.
  • From the NetWorker Management console workstation launch the web page (http://[NETWORKER_SERVER]:9000/) and select the start button.
  • A pop-up may be displayed if it is configured lower than the default value "The configured JVM max memory setting is less than the recommended value. Do you want to continue?".  Pop up "The configured JVM max memory setting is less than the recommended value. Do you want to continue?".
  • Select Yes in the pop-up and the NetWorker Management Console will launch with the Java heap size of 1 GB.
In the following example the java heap size will be decreased on the NetWorker Management Workstation from 2 GB (-Xmx2048m) to 1 GB (-Xmx1024m).  The new value will only apply to any NetWorker Management Console workstation connecting to the NetWorker Management Console Server.
  • From the NetWorker Management Console workstation download the gconsole.jnlp from the NetWorker Management Console web page: http://[NETWORKER_SERVER]:9000/gconsole.jnlp
  • Open the downloaded gconsole.jnlp in a text editor.
  • Change the line for the Java heap memory max size:
    • Existing: <j2se version="1.8+"  java-vm-args="-XX:+IgnoreUnrecognizedVMOptions --add-modules=java.se.ee -Xms256m -Xmx2048m"/>
    • Changed: <j2se version="1.8+"  java-vm-args="-XX:+IgnoreUnrecognizedVMOptions --add-modules=java.se.ee -Xms256m -Xmx1024m"/>
  • Save the changes to the gconsole.jnlp.
  • Launch the gconsole.jnlp from the NetWorker Management Console workstation.
  • A pop-up may be displayed if it is configured lower than the default value "The configured JVM max memory setting is less than the recommended value. Do you want to continue?".
Pop up "The configured JVM max memory setting is less than the recommended value. Do you want to continue?".
  • Select Yes in the pop-up and the NetWorker Management Console will launch with the Java heap size of 1 GB.

Additional Information

If there is a requirement to decrease the default java heap size on the NetWorker Management Console it may impact the responsiveness of the NetWorker Management Console. It is recommended to use the default java heap size or higher value on the NetWorker Management Console, but it may be decreased if there are limitations in the environment.

Affected Products

NetWorker Management Console
Article Properties
Article Number: 000019476
Article Type: How To
Last Modified: 29 July 2025
Version:  4
Find answers to your questions from other Dell users
Support Services
Check if your device is covered by Support Services.