2b5d8f3b80
- Split protocols into individual chapters - Reorganize summary to flow more logically - Fill in missing parameters in configuration index - Normalize spaces for ordered and unordered lists - Re-wrap lots of text for readability - Fix incorrect XML snippets - Normalize table formatting - Improve internal links with anchors - Update content to reflect new address model - Resized architecture images to avoid excessive white-space - Update some JavaDoc - Update some schema elements - Disambiguate AIO & ASYNCIO where necessary - Use URIs instead of Objects in code examples
1.1 KiB
Graceful Server Shutdown
In certain circumstances an administrator might not want to disconnect all
clients immediately when stopping the broker. In this situation the broker can
be configured to shutdown gracefully using the graceful-shutdown-enabled
boolean configuration parameter.
When the graceful-shutdown-enabled configuration parameter is true and the
broker is shutdown it will first prevent any additional clients from connecting
and then it will wait for any existing connections to be terminated by the
client before completing the shutdown process. The default value is false.
Of course, it's possible a client could keep a connection to the broker
indefinitely effectively preventing the broker from shutting down gracefully.
To deal with this of situation the graceful-shutdown-timeout configuration
parameter is available. This tells the broker (in milliseconds) how long to
wait for all clients to disconnect before forcefully disconnecting the clients
and proceeding with the shutdown process. The default value is -1 which means
the broker will wait indefinitely for clients to disconnect.