Gateway won't start after Upgrade (Gateway version 11.0 to 11.1.2)

Products

• CA API Gateway

Issue/Introduction

After upgrading the gateway version from 11.0 to 11.1.2, all the steps/patching as documented in the Techdocs and noted in KB383746 were performed.

After rebooting, the gateway status shows WONT_START. The SSG logs are not being updated after the reboot.

Environment

Gateway 11.0, 11.1.2

Portal 5.2

OTK 4.6.X

Cause

The Garbage collection was customized:  It was changed from G1GC to UseParallelOldGC based on the old KB208868

Gateway 11.1.2 uses JDK 17 (Java 17 based) switched to use G1GC with default settings. Starting with JDK 15 UseParallelOldGC has been obsoleted. 

REF: https://bugs.openjdk.org/browse/JDK-8235860

Resolution

Switch back to G1GC

modifiy:  /opt/SecureSpan/Gateway/runtime/etc/profile.d/appliancedefs.sh

Uncomment or add the following two lines for the NODE_OPTS parameter: 

# Setting larger permsize for java 1.6

NODE_OPTS="-Xss256k -XX:+UseG1GC -Xmx${java_ram}k -Xms${java_ram}k -XX:G1HeapRegionSize=${G1HeapRegionSize} -XX:+AlwaysPreTouch -XX:+ParallelRefProcEnabled -XX:+UnlockExperimentalVMOptions -XX:InitiatingHeapOccupancyPercent=70 -XX:G1NewSizePercent=20 -XX:G1MaxNewSizePercent=60"

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

Additional Information

The issue was discovered by starting the gateway manually in console mode

#  su - gateway 

$ /opt/SecureSpan/Gateway/runtime/bin/gateway.sh start -console

Console Error message:

$ Unrecognized VM option 'UseParallelOldGC'

Did you mean '(+/-)UseParallelGC'? Error: Could not create the Java Virtual Machine.

Error: A fatal exception has occurred. Program will exit.