Out Of Memory error resolution (NTC)

From NComputing Knowledge Base
Jump to: navigation, search

General information

The OutOfMemory exception indicates that the Java Virtual Machine (JVM) has run out of free memory. The Java VM is started as service with the default maximum memory value on windows machines. Some features like "Reports" requires more virtual memory due to the number of clients, groups and sessions in your NoTouch Center environment.

NComputing Virtual Appliance

If using the NComputing Virtual Appliance and getting an Out Of Memory error you need to assign more memory to the Virtual Appliance - please consult the documentation of your virtualization environment how to add more memory to virtual machine. NoTouch Center will automatically get a portion of the memory, so you don't need to change anything inside the Virtual Appliance.

Unsupported hint: Should, for whatever reason, you want or have to modify JVM memory settings, you can use SSH login and edit the file /etc/init/center.conf to adapt the java command line to your needs, such as adding a -Xmx parameter.

Windows installation

How to increase the memory size of your Java Virtual Machine?

  1. Stop your NoTouch Center service
  2. Open the windows registry with regedit
  3. Search for the key: "JVM Option Number 0" (chapter: HKEY_LOCAL_MACHINE/System/CurrentControlSet/Services/NoTouch Center)
  4. Edit the parameter "JVM Option Count" and set the value to 2
  5. Add the new String "JVM Option Number 1" with the value: "-Xmx1024m"
  6. Close regedit and start your NoTouch Center service

In case 1024m (1024MB/1GB) is not sufficient, you can increase the value; for example -Xmx2048m mean one 2GB should be used.

Generic instructions

Make sure Java is started with the "-Xmx" option and a reasonable value. If you run NTC with the standard Java command such as java -jar lib/core.jar, just modify this to java -Xmx256m -jar lib/core.jar or edit the start.sh file if you use that to start NTC.