Java heap space error when migrating WA DE (ESP dSeries)

Products

• CA Workload Automation DE - Business Agents (dSeries)
• CA Workload Automation DE
• DSERIES- SERVER
• CA Workload Automation DE - System Agent (dSeries)
• CA Workload Automation DE - Scheduler (dSeries)

Issue/Introduction

User may see this error when trying to migrate all artifacts from an 11.3 server to R12.x

Increasing the allocated heap size to, e.g  "-Xmx2048m" results in same error.

Migration failed due to error
com.ca.wa.engine.migration.artifact.ArtifactReadException: 
Unable to read APPLICATION artifacts. 
Error: Error occurred in server thread; nested exception is: 
 java.lang.OutOfMemoryError: Java heap space

 

Environment

Release : 12.x

Component : CA WORKLOAD AUTOMATION DE (DSERIES)

Cause

The target (R12) server may not have enough memory.

The source DE instance (usually 11.3) is running out of memory.

Resolution

To Increase the amount of java heap in the migration script on target (R12.x) server.

1. Navigate to the bin directory where you have the Workload Automation DE 12.2 product installed. (Example: /opt/CA/WorkloadAutomationDE/12.2.00.00/bin/)
2. Make a backup of the original migrate.sh script so you can restore the original if needed.
3. Open the migrate.sh script for editing using your choice of editor.
4. At the bottom of the script you will see
   "${CAWA_HOME}/jre/bin/java" -cp "${CP}" \
                                                                  -Dlog4j.configurationFile=${LOG_CONFIG} \
                                                                  -DCAWA_HOME="${CAWA_HOME}" \
                                                                  com.ca.wa.engine.migration.Main \
                                                                  ${MIGRATION_CONFIG}
5. Change the above bolded/highlted line to reflect below:
   "${CAWA_HOME}/jre/bin/java" -Xmx4096m -cp "${CP}" \
                                                                  -Dlog4j.configurationFile=${LOG_CONFIG} \
                                                                  -DCAWA_HOME="${CAWA_HOME}" \
                                                                  com.ca.wa.engine.migration.Main \
                                                                  ${MIGRATION_CONFIG}
6. Save the changes to the migrate.sh script
7. Rerun the migration script.

----------

Additionally, check the sources (usually 11.3 or older DE instance) logs.  The errors.txt will show similar errors as below:

Error: Error occurred in server thread; nested exception is: 
 java.lang.OutOfMemoryError: Java heap space

If source server is no Unix/Linux, then edit the strartServer in <de_install_directroy>/bin and change 'MAX_HEAP_SIZE'.  Increase to 2048 or 4096

MAX_HEAP_SIZE=2048

 

For Windows, edit jvmproperty_3= in 'windows.service.properties' under <de_install_directroy>\bin.  Increase to 2048 or 4096

 

Note: Make sure server has enough free memory to accommodate MAX_HEAP_SIZE or jvmproperty_3 value.