This page describes the different ways to shutdown REST server gracefully. It also describes the behaviour of the REST server if the license server goes down.
The XML Data Compare REST server can be shutdown using following options:
System wide shutdown
Using REST Server shutdown end point
In all above cases, the REST server will check for any running comparisons before initiating the shutdown. REST Server will shut itself down after completing all the running comparisons. At same time, the REST server will not accept any new comparison.
REST Server shutdown end point
Simple shutdown call from Postman:
Use the POST command with this string: http://0.0.0.0:8080/api/xml-data-compare/v1/shutdown
<shutdownInfo> <initiateTime>2020-08-28T07:24:42.960+0000</initiateTime> <runningComparisons>2</runningComparisons> <info>REST Server shut down initiated. It will be completed after finishing the running comparisons.</info> </shutdownInfo>
Shutdown due to License Server
A license server can go down for several reasons such as:
Intentional license server shutdown
The REST server is constantly checking for a license server heartbeat and it will be lost if the license server goes down. The REST Server will be try to reconnect to the license server 2 times after some defined interval. The REST Server will initiate the graceful shutdown if it fails to reconnect.