API Gateway v10.1 upgrade error -- the gateway process cannot start up

Products

• CA API Gateway

Issue/Introduction

We have our gateways currently running on v10 CR03 and had attempted to upgrade our dev clusters to v10.1 using the upgrade patches.
However after installing both the patches and upgrading the DB, the gateway didn't come up, it went to won't start status.

This is the sequence in which we installed the patches while performing the upgrade :

Layer7_API_PlatformUpdate_64bit_v10.1.00-CentOS.L7P

Layer7_API_Gateway_v10.1.00.11620.L7P

[gateway@gwserv13-d bin]$ ./gateway.sh run
Unrecognized VM option 'PrintGCDateStamps'
Error: Could not create the Java Virtual Machine.
Error: A fatal exception has occurred. Program will exit.

 

Environment

Release : 10.1

Component :

Cause

Java 11 is new with 10.1 upgrade there are multiple Java options that are not supported by the newer JDK 

Resolution

In Java 11, some JVM flags including those used in Java 8 for Garbage Collection Logging have been removed.

If these are still contained in the JVM flags specified in the appliancedefs.sh (/opt/SecureSpan/Gateway/runtime/etc/profile.d/appliancedefs.sh ), then the JVM will not be able to start.

It's known that the following options are unrecognized in Java 11:

• -d64
• PrintGCTimeStamps
• PrintGCDateStamps
• PrintTenuringDistribution
  
• PrintGCCause
  
• UseGCLogFileRotation
• NumberOfGCLogFiles
• GCLogFileSize

 

An example to translate the old gc options to the new format,

old options:

NODE_OPTS= -XX:+UseParallelOldGC -XX:+PrintGCDetails -XX:+PrintGCDateStamps -XX:+UseGCLogFileRotation -XX:NumberOfGCLogFiles=10 -XX:GCLogFileSize=20M -Xloggc:var/logs/ssg_gc.log -XX:+UseCompressedOops

 

new options:

NODE_OPTS="$NODE_OPTS -Xlog:gc*:var/logs/ssg_gc.log"