Debian Codegraph @

doc/source/configuration/mutable.rst

raw
1 ==========================
2 Changing config at runtime
3 ==========================
4
5 OpenStack Newton introduces the ability to reload (or 'mutate') certain
6 configuration options at runtime without a service restart. The following
7 projects support this:
8
9 * Compute (nova)
10
11 Check individual options to discover if they are mutable.
12
13
14 In practice
15 ~~~~~~~~~~~
16
17 A common use case is to enable debug logging after a failure. Use the mutable
18 config option called 'debug' to do this (providing ``log_config_append``
19 has not been set). An admin user may perform the following steps:
20
21 #. Log onto the compute node.
22 #. Edit the config file (EG ``nova.conf``) and change 'debug' to ``True``.
23 #. Send a SIGHUP signal to the nova process (For example, ``pkill -HUP nova``).
24
25 A log message will be written out confirming that the option has been changed.
26 If you use a CMS like Ansible, Chef, or Puppet, we recommend scripting these
27 steps through your CMS.