Out of Memory – Kiuwan

Problem

Under this general category are memory-related problems (out of memory).

Every Kiuwan analysis step is executed as a forked process running in a JVM. That forked execution is run with some default memory parameters (min and max).

By default, a forked JVM is configured to run with a maximum of 1024 Mb. If the analysis needs more memory, the execution will finish with this error.

The most common out-of-memory error messages are:

Exception in thread "main" com.als.core.OptimythException: GC overhead limit exceeded
Caused by: java.lang.OutOfMemoryError: GC overhead limit exceeded

Exception in thread "main" com.als.core.OptimythException: Java heap space
Caused by: java.lang.OutOfMemoryError: Java heap space

All of them can be solved increasing the memory allocated to Kiuwan analysis.

GUI mode

If you are using Kiuwan Local Analyzer in GUI mode, a dialog will open indicating this error:

Click Analyzer log to open a window where the log file (temp/agentGUI.log) is displayed. You will see the following error message.

You will find some lines as follows, indicating that an Out of Memory error is produced.

WARN 2016-10-05 11:13:21,314 - Exception in thread "main" com.als.core.OptimythException: GC overhead limit exceeded

WARN 2016-10-05 11:13:21,316 - Caused by: java.lang.OutOfMemoryError: GC overhead limit exceeded

CLI mode

If you are using Kiuwan Local Analyzer in CLI mode, this error is reported to the standard output.

An error code will be returned to the calling process.

Please visit Local Analyzer Return Codes for further information on return codes.

Solution

The solution consists of providing more memory to Kiuwan.

You can do it in two ways:

Change the memory parameters
Modify the conf/analyzer.properties file

Change the memory parameters

Click Advanced in the analysis configuration window
Select Analysis Configuration
Modify the Max memory size property (set by default to 1024 Mb)
After modifying the value, click Save to open the next dialog
Save = This configuration will apply only to the current applications.
Save as defaults = The configuration changes will apply to all the applications of your Kiuwan Local Analyzer installation.

Modify conf/analyzer.properties file

An alternative way to change this memory value is by modifying the conf/analyzer.properties file.

To do it, edit “memory-max” property:

# Maximum size for heap memory (1024m = 1 Gigabyte)
memory.max=1024m

If you have a specific configuration for an application and you want the change only to be applied to that specific application, you will need to modify this property in the conf/apps/<name_of_your_app>.properties file.

In case you increase this parameter too high, it’s possible that the Operating System cannot allocate such free memory.

If this happens, you will get a Not enough Memory error. In this case, please read the next section.

Related to