Layer7 API Developer Portal: Migration Tool does not finish the analyze step

Products

• CA API Developer Portal

Issue/Introduction

When running the Portal 3.x to 4.x migration tool the analyze step appears to hand indefinitely.

Environment

Release : 3.5

Component : API PORTAL

Cause

A review of the catalina.out will be needed to determine the exact cause. This is typically seen when you are migrating  a large database for one of two reasons:

1) The allocated heap space is too small (indicated by a Java OutOfMemoryError)

Aug 07, 2020 10:15:10 AM org.apache.coyote.AbstractProtocol$ConnectionHandler process
SEVERE: Failed to complete processing of a request
java.lang.OutOfMemoryError: Java heap space
 at java.base/java.util.Arrays.copyOf(Arrays.java:3746)
 at java.base/java.lang.AbstractStringBuilder.ensureCapacityInternal(AbstractStringBuilder.java:172)
 at java.base/java.lang.AbstractStringBuilder.append(AbstractStringBuilder.java:538)
 at java.base/java.lang.StringBuffer.append(StringBuffer.java:312)

2) The operation times out

Resolution

To address the OutOfMemoryError you can increase the memory allocated to the Portal by updating the  -Xmx setting in /opt/Deployments/lrs/server/bin/setenv.sh.

To increase the timeout setting edit the Apache configuration file (/etc/httpd/conf/httpd.conf) and change the timeout value from 60 to 180 and reload Apache (service httpd reload). The exact value may need some tuning but generally increasing up to 180 seconds will suffice.