mirror of
https://github.com/apache/activemq-artemis.git
synced 2025-02-07 02:29:08 +00:00
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
20 lines
1.1 KiB
Markdown
20 lines
1.1 KiB
Markdown
# 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.
|