search cancel

RA Agent fails to start with "error java.lang.OutOfMemoryError: Java heap space"


Article ID: 87615


Updated On:


CA Automic Workload Automation - Automation Engine


Error Message :
java.lang.OutOfMemoryError: Java heap space

The RA Agent fails to start and the above error message is displayed in the agent's log file.

Note:  This error may be seen on other RA Agents as well and is not specific to just the RA BusinessObjects Agent.


Release: AOMBOA99000-3.0-Automic-Operations Manager-Business Objects Agent


Cause type:
Root Cause: Not enough Heap Memory available to start the Java Virtual Machine


In order to avoid this problem the maximum amount of memory available to the RA Agent should be increased.It is however also advisable to increase the minimum amount of memory in case the server is using a lot of memory otherwise the lack of memory at startup will remain undetected.

In the documentation, the recommended startup string is the following:

java -jar -Xrs -Xmx256M ucxjcitx.jar disable_cache

In cases where the agent doesn't start, it is recommended to increase the max memory available (Xmx) to 512M and also set the minimum to be available/reserved at startup (Xms) to 256M.

Additional Information

In the example of RA.BusinessObject this gives the following in the Service Manger's smd-file:

DEFINE RA-BO-Agent;/java/jre1.6.0_25/bin/java -jar -Xrs -Xms256M -Xmx512M /ra-core-bobj/ucxjcitx.jar -i/ra-core-bobj/ucxjcitx_bo.ini ;/ra-core-bobj