NetWorker: How to change the java heap size for the NetWorker Management Console (NMC)

Résumé: How to change the java heap size for the NetWorker Management Console (NMC)?

Cet article concerne Cet article ne concerne pas Cet article n’est associé à aucun produit spécifique. Toutes les versions du produit ne sont pas identifiées dans cet article.
Consulter d’autres ressources

Instructions

The NetWorker Management Console (NMC) uses a Java Runtime on the host accessing the console. The console uses the file gconsole.jnlp, which it downloads from the NMC server. This file defines Java memory limits for the host accessing the NMC. The default memory limit is 2 GB. In some scenarios, you may observe "running out of memory" errors in the NMC, even though the host accessing the NMC still has sufficient memory available. This happens when the NMC is nearing the Java heap limit for the NMC. This is expected behavior when performing some operations in the NMC, particularly in larger environments, or environments with a lot of data. 

 

The Java heap size may be changed from the default NMC value to accommodate various environment configurations.  

In the following example, the java heap size is increased on the NMC from 2 GB (-Xmx2048m) to 4 GB (-Xmx4096m) on the NetWorker Management Console Server. The new value applies to any NetWorker Management Console workstations connecting to the NetWorker Management Console Server.

  1. 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 
  1. 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 -Xmx4096m"/>
  1. Restart the NMC services.
    • Linux: systemctl restart gst
    • Windows (PowerShell syntax): net stop gstd ; net start gstd
  1. From the NMC workstation (host accessing the NMC), clear the Java cache. The following articles apply for NetWorker Runtime Environment (NRE):
  1. Launch the NMC.
NOTE: The heap size can be extended beyond 4GB; however, it is important to consider the memory configurations of the hosts accessing the NMC. Increasing the heap too high can result in high memory consumption on the hosts accessing the NMC.

Informations supplémentaires

If there is a requirement to decrease the default java heap size on the NMC, 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 NMC, but it may be decreased if there are limitations in the environment.

Produits concernés

NetWorker, NetWorker Management Console

Produits

NetWorker Family
Propriétés de l’article
Numéro d’article: 000019476
Type d’article: How To
Dernière modification: 20 Jan 2026
Version:  5
Trouvez des réponses à vos questions auprès d’autres utilisateurs Dell
Services de support
Vérifiez si votre appareil est couvert par les services de support.