Skip to content

Document shutdown_clients_timeout - #1608

Open
sirainen wants to merge 4 commits into
dovecot:mainfrom
sirainen:reload-keep-clients
Open

sirainen wants to merge 4 commits into
dovecot:mainfrom
sirainen:reload-keep-clients

Conversation

@sirainen

Copy link
Copy Markdown
Contributor

DOV-9754

@sirainen
sirainen force-pushed the reload-keep-clients branch 5 times, most recently from 5f9ca82 to 34a7585 Compare September 16, 2026 19:03
The upgrading page is the one with the "Changed Setting Defaults", "New
Features" and "Removed Features" sub-sections; an include file is just the
text that the Pro documentation shares. Move the headings and the removed
settings out of the include files, so that every version's changes are listed
in the same place, and only once.
shutdown_clients is replaced by service_shutdown_clients_timeout, which also
allows everything in between its two endpoints: a reload can keep the existing
sessions running for a while, e.g. to take new SSL certificates into use
without disconnecting anyone.

The upgrading note goes to an include file, so that the Pro documentation can
use the same text instead of duplicating it.
Overrides service_shutdown_clients_timeout for a single reload.
"doveadm process status" and "doveadm service status" tell which configuration
generation a process belongs to and when the master process is going to signal
it next. "doveadm service status -a" lists also the older generations, which
are around because of service_shutdown_clients_timeout.
@cmouse

cmouse commented Sep 17, 2026

Copy link
Copy Markdown
Contributor

The core branch also carries config: Don't accept "y" or "1" as a boolean setting value (b7382a52af), which has no upgrade note here.

It is a config compatibility break: settings_value_check() calls str_parse_get_bool_strict() for every SET_BOOL with no dovecot_config_version gate, so an existing mail_debug = 1 now fails the whole config load:

doveconf: Fatal: Error in configuration file dovecot.conf line 2: mail_debug: Invalid boolean value: 1 (use yes or no)

shutdown_clients in this PR is handled the other way round - version-gated automatic conversion, documented in include/2.4.6-shutdown-clients.inc. The boolean change needs either the same treatment or an upgrade note stating that such values must be changed to yes/no by hand.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants