Running Out of Memory

If you are working with a large amount of data, such as deploying large or multiple Solutions with Solution Deployment, the installation process might fail with one or both of the following indicators:

• In the gax.log, the following entry:

lang.OutOfMemoryError: Java heap space

• In the Genesys Administrator Extension interface, on the Solutions Packages screen, there might be an error message similar to:

Error while fetching lists of dns. There has been a server error.

This error is caused when the Java heap space is not large enough to support the current process. The default size of the heap is 64 MB. In the default installation, the heap size is set to 1024 MB (the Tomcat default is only 64 MB). If you still need to increase the memory assigned to Tomcat, do one of the the following, based on your operating system:

• On Linux, editing the $CATALINA_HOME/bin/setenv.sh file and adjust the memory file.
• On Windows, insert the following lines into the JavaServerStarter.ini file, creating the [JavaArgs] section line if necessary:

  [JavaArgs]
  -Xms2048m 
  -Xmx4096M

  This file is used only by Windows Services and sets the starting parameters for GAX as a Windows Service.

If you continue to see these errors, continue to increase the heap size as necessary.