How to increase policy manager heap size to fix out-of-memory error when installing solution kit

Products

• CA API Gateway
• API SECURITY
• CA API Gateway Precision API Monitoring Module for API Gateway (Layer 7)
• CA API Gateway Enterprise Service Manager (Layer 7)
• STARTER PACK-7
• CA Microgateway

Issue/Introduction

When install a solution kit (for example, the AWS solution kit), or any other operation, if the policy manager popup an error message,

"The Policy Manager encountered an internal error or misconfiguration and was unable to complete the operation"

Click the "Report" button on the error window, the report shows following message,

"java.lang.OutOfMemoryError: Java heap space"

 

That indicates the policy manager has no enough memory to finish the operation. 

 

Environment

Release : 9.4

Component : API GATEWAY

Cause

The default heap size of policy manager could be too small on old versions, for example, on gateway 9.0, the default is -Xmx256M

Resolution

• on windows

edit "Layer 7 Policy Manager.ini" file under policy manager install folder, and change the heap size to -Xmx2048M

• on linux or macOS

edit "Manager.sh" file under policy manager install folder, and change the heap size to -Xmx2048M

 

Restart the policy manager to take effect.

If still have the out-of-memory error, double the heap size.