I See This Error in My SSG Logs: 'SEVERE' error: 'java.lang.OutOfMemoryError: GC overhead limit exceeded'

book

Article ID: 4930

calendar_today

Updated On:

Products

CA API Gateway

Issue/Introduction

The following will be observed:

  • The SSG log reports SEVERE errors which state the following: java.lang.OutOfMemoryError: GC overhead limit exceeded.

The following may be observed in addition to the error noted above, but not in all cases:

  • Depending on the frequency of the error above, the CA API Gateway may or may not be able to handle requests. Requests may fail to be processed.
  • Available memory is exhausted. This can be confirmed with the output of this command: free -m
  • Performance may be slower than is typical for the environment.

Cause

The java.lang.OutOfMemoryError: GC overhead limit exceeded error is indicative of the CA API Gateway application spending too much time performing Garbage Collection to free up memory. If over 98% of the total time is spent doing Garbage Collection and less than 2% of the heap is recovered, this error will occur.

Environment

This affects all versions of the CA API Gateway product.

Resolution

Allocate more memory to the CA API Gateway Appliance via the instructions below:

Hardware or Virtual Appliance:

  1. Allocate more memory to the appliance. If virtual, access to VMware will be required. A VMware administrator can perform this task.
    • Ensure it is running with the minimum requirements at the very least, likely needing double that in a production environment.
  2. Restart the appliance (Gateway application will scale the heap size up to half the Gateways detected memory).

Software:

  1. Allocate more memory to the appliance.
    • Ensure it is running with the minimum requirements at the very least, likely needing double that in a production environment.
  2. Adjust the java heap size by modifying the file /opt/SecureSpan/Gateway/node/default/etc/conf/node.properties to include: node.java.heap=X
    • It is recommended that X = half the MBs of the Gateway's allocated memory.
  3. Restart the appliance.

Additional Information