diff options
| author | Stephen Finucane <sfinucan@redhat.com> | 2018-10-16 17:41:17 +0100 |
|---|---|---|
| committer | Matt Riedemann <mriedem.os@gmail.com> | 2018-12-14 14:08:35 -0500 |
| commit | ae2e5650d14a2c81dd397727d67b60f9b8dd0dd7 (patch) | |
| tree | 6127a2739f717932bff075c345813d3546c27cb4 /doc/source/common | |
| parent | 7fa740491e53195021036af69a0ddfde183daef5 (diff) | |
| download | nova-ae2e5650d14a2c81dd397727d67b60f9b8dd0dd7.tar.gz | |
Fail to live migration if instance has a NUMA topology
Live migration is currently totally broken if a NUMA topology is
present. This affects everything that's been regrettably stuffed in with
NUMA topology including CPU pinning, hugepage support and emulator
thread support. Side effects can range from simple unexpected
performance hits (due to instances running on the same cores) to
complete failures (due to instance cores or huge pages being mapped to
CPUs/NUMA nodes that don't exist on the destination host).
Until such a time as we resolve these issues, we should alert users to
the fact that such issues exist. A workaround option is provided for
operators that _really_ need the broken behavior, but it's defaulted to
False to highlight the brokenness of this feature to unsuspecting
operators.
Change-Id: I217fba9138132b107e9d62895d699d238392e761
Signed-off-by: Stephen Finucane <sfinucan@redhat.com>
Related-bug: #1289064
Diffstat (limited to 'doc/source/common')
| -rw-r--r-- | doc/source/common/numa-live-migration-warning.txt | 10 |
1 files changed, 10 insertions, 0 deletions
diff --git a/doc/source/common/numa-live-migration-warning.txt b/doc/source/common/numa-live-migration-warning.txt new file mode 100644 index 0000000000..7b695f2188 --- /dev/null +++ b/doc/source/common/numa-live-migration-warning.txt @@ -0,0 +1,10 @@ +.. important:: + + Unless :oslo.config:option:`specifically enabled + <workarounds.enable_numa_live_migration>`, live migration is not currently + possible for instances with a NUMA topology when using the libvirt driver. + A NUMA topology may be specified explicitly or can be added implicitly due + to the use of CPU pinning or huge pages. Refer to `bug #1289064`__ for more + information. + + __ https://bugs.launchpad.net/nova/+bug/1289064 |