nova/doc
Stephen Finucane 9999bce00f 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.

Conflicts:
	nova/conf/workarounds.py
	nova/tests/unit/api/openstack/compute/admin_only_action_common.py
	nova/tests/unit/api/openstack/compute/test_migrate_server.py
	nova/tests/unit/conductor/tasks/test_live_migrate.py

NOTE(stephenfin): stable/rocky conflicts due to removal of
'report_ironic_standard_resource_class_inventory' option and addition of
change Iaea1cb4ed93bb98f451de4f993106d7891ca3682 on master.

NOTE(stephenfin): stable/queens conflicts due to presence of
the 'enable_consoleauth' configuration option and change
I83b473e9ba557545b5c186f979e068e442de2424 (Mox to mock) in stable/rocky.
A hyperlink is removed from the config option help text as the version
of 'oslo.config' used here does not parse help text as rST (bug 1755783).

Change-Id: I217fba9138132b107e9d62895d699d238392e761
Signed-off-by: Stephen Finucane <sfinucan@redhat.com>
Related-bug: #1289064
(cherry picked from commit ae2e5650d1)
(cherry picked from commit 52b8973442)
2019-07-02 14:25:26 +00:00
..
api_samples Fix os-simple-tenant-usage result order 2019-01-22 18:09:21 +01:00
ext Fix the usage of instance.snapshot notification sample 2017-11-21 11:03:52 +00:00
notification_samples Null out instance.availability_zone on shelve offload 2018-09-28 14:07:15 -04:00
source Fail to live migration if instance has a NUMA topology 2019-07-02 14:25:26 +00:00
test add whereto for testing redirect rules 2017-10-30 12:37:23 -04:00
README.rst Fix the file name of development-environment.rst 2018-06-11 09:00:25 +00:00

README.rst

OpenStack Nova Documentation README

Both contributor developer documentation and REST API documentation are sourced here.

Contributor developer docs are built to: https://docs.openstack.org/nova/latest/

API guide docs are built to: https://developer.openstack.org/api-guide/compute/

For more details, see the "Building the Documentation" section of doc/source/contributor/development-environment.rst.