How to increase the heap or memory available of CA Workload Automation DE?

Document ID : KB000077030
Last Modified Date : 10/04/2018
Show Technical Document Details
Introduction:
The CA Workload Automation DE is a Java application.  By default the heap is set to 1 GB.  This may be increased if the server is constantly at or above 80-90% of the Maximum memory available (see screenshot below).
System Dashboard
Question:
How to increase the maximum memory (heap) of CA Workload Automation DE?
Environment:
CA Workload Automation DE 11.3 / R12.x
Answer:
The heap can only be changed on the server side.  
For DE running on Linux/UNIX system
1. Login to the server,
2. Navigate to DE install directory.  You can get install location by entering getproperty property("lax.root.install.dir") in CLI (Desktop Client)
CLI getproperty

3.  Next, change directory (cd) to bin directory and locate startServer file.
4.  Edit or vi the startServer file and look for "MAX_HEAP_SIZE".  Change the heap number accordingly.
           E.g. If you want to increase to 6 GB, then heap will be like this: MAX_HEAP_SIZE=6144
5. Once done, save the file and you restart the DE service.

For DE running on Windows OS
1. Login to the server,
2. Navigate to DE install directory.  E.g. C:\Program Files\CA\Workload Automation . (See above screenshot to get the install location).
3. Then change directory (cd) to bin directory and locate startServer.lax file.
4.  Edit or vi the startServer.lax file and look for "MAX_HEAP_SIZE".  Change the heap number.
           E.g. If you want to increase to 4 GB, then heap will be like this: MAX_HEAP_SIZE=4096
5. Once done, save the file and you restart the DE service.

Note: Always backup files before making changes to them.
 
Additional Information:
The entire server (OS) does not need to be rebooted.  Only restart the CA WA DE service for the change to take affect.
The total memory set in DE must always be available or free at system level.  Never set the heap to maximum system level memory.  Always leave 30-40% of physical memory for OS and other applications.