ironic/releasenotes/notes/sighup-service-reloads-configs-0e2462e3f064a2ff.yaml
Ruby Loo 398462021b reloads mutable config values on SIGHUP
This changes the ironic (ironic-api and ironic-conductor)
services so that when a SIGHUP signal is issued, the
service reloads (and uses) the values of mutable configuration
options.

The mutable configuration options (set by oslo.config Opts' mutable=True)
are:
- [DEFAULT]/pin_release_version
- [DEFAULT]/debug
- [DEFAULT]/log_config_append
and are indicated as such in ironic's sample config
(https://docs.openstack.org/ironic/latest/configuration/sample-config.html)
by "# Note: This option can be changed without restarting.".

Configuration options are mutable if their oslo.config Opt's mutable=True
is set. This mutable setting is respected when the oslo method
mutate_config_files is called instead of reload_config_files.
Icec3e664f3fe72614e373b2938e8dee53cf8bc5e allows services to tell
oslo.service they want mutate_config_files to be called by specifying the
'restart_method=mutate' parameter, which this patch does.

Change-Id: I0df46bb21dda035b25daad17737dbfedb861e868
Closes-Bug: #1585595
2018-02-28 23:46:30 +00:00

18 lines
670 B
YAML

---
features:
- |
Issuing a SIGHUP (e.g. ``pkill -HUP ironic``) to an ironic-api or
ironic-conductor service will cause the service to reload and use any
changed values for *mutable* configuration options. The mutable
configuration options are:
* [DEFAULT]/debug
* [DEFAULT]/log_config_append
* [DEFAULT]/pin_release_version
Mutable configuration options are indicated as such in the `sample configuration
file <https://docs.openstack.org/ironic/latest/configuration/sample-config.html>`_
by ``Note: This option can be changed without restarting``.
A warning is logged for any changes to immutable configuration options.