"Shutdown failed -- must use -force" from "gateway.sh stop" on Software Gateway

Products

• CA API Gateway
• API SECURITY

Issue/Introduction

After executing "/opt/SecureSpan/Gateway/runtime/bin/gateway.sh stop" for stopping the Software Gateway , the following messages were shown.

=======================================

Stopping Process Controller...

Shutting down Gateway Services: done.

Shutdown failed -- must use -force

=======================================

Why is the "Shutdown failed -- must use -force" message shown?

What should we do for it?

Environment

Release : 9.3

Component : API GATEWAY

Resolution

This messages is shown when the Gateway.jar process couldn't be shutdown. The PID of the Gateway process is recorded in the "/opt/SecureSpan/Gateway/node/default/var/ssg.pid" file.

The PID can be accidentally assigned to another non-Gateway process because PIDs are reused by the Operating System.

In such case, this message is shown by the "gateway.sh stop" command. The following steps need to be done for this "Shutdown failed -- must use -force" message.

1. Check the process with the command "ps -wwfp <PID number>". The <PID number> is stored in the /opt/SecureSpan/Gateway/node/default/var/ssg.pid file.
   
2. If it is the Gateway process (Java process for Gateway.jar), use the "-force" option along with the instruction in the message.
3. If the UID of the process is not "gateway", just remove the "/opt/SecureSpan/Gateway/node/default/var/ssg.pid" file.