nova/doc/source
Artom Lifshitz f77a9fee5b libvirt: remove default cputune shares value
Previously, the libvirt driver defaulted to 1024 * (# of CPUs) for the
value of domain/cputune/shares in the libvirt XML. This value is then
passed directly by libvirt to the cgroups API. Cgroups v2 imposes a
maximum value of 10000 that can be passed in. This makes Nova
unable to launch instances with more than 9 CPUs on hosts that run
cgroups v2, like Ubuntu Jammy or RHEL 9.

Fix this by just removing the default entirely. Because there is no
longer a guarantee that domain/cputune will contain at least a shares
element, we can stop always generating the former, and only generate
it if it will actually contain something.

We can also make operators's lives easier by leveraging the fact that
we update the XML during live migration, so this patch also adds a
method to remove the shares value from the live migration XML if one
was not set as the quota:cpu_shares flavor extra spec.

For operators that *have* set this extra spec to something greater
than 10000, their flavors will have to get updates, and their
instances resized.

Partial-bug: 1978489
Change-Id: I49d757f5f261b3562ada27e6cf57284f615ca395
2022-07-14 11:55:40 -04:00
..
_extra doc: Remove useless contributor/api-2 doc 2022-03-23 09:58:32 +00:00
_static docs: Remove references to XenAPI driver 2020-08-31 15:53:31 +01:00
admin libvirt: remove default cputune shares value 2022-07-14 11:55:40 -04:00
cli Follow up for nova-manage image property commands 2022-02-24 19:51:59 +00:00
common Deprecate CONF.workarounds.enable_numa_live_migration 2019-09-12 17:34:34 -04:00
configuration Complete phase-1 of RBAC community-wide goal 2022-02-24 16:33:34 +00:00
contributor Merge "Update contributor guide for Zed" 2022-03-25 06:21:17 +00:00
install docs: Explicitly state lack of support for node renaming 2021-06-09 13:39:43 -04:00
reference doc: Split up notifications document 2022-02-09 18:02:04 +00:00
user Merge "docs: Add new architecture guide" 2022-02-03 18:28:02 +00:00
conf.py docs: Add man pages for 'nova-policy' 2021-04-19 10:47:17 +01:00
index.rst doc: Split up notifications document 2022-02-09 18:02:04 +00:00