openstack
/
nova
Code Issues Proposed changes

Merge "Update docs for live_migration_progress_timeout option"

This commit is contained in:
Zuul 2018-09-12 18:17:58 +00:00 committed by Gerrit Code Review
parent c5a80f4843 f34877f936
commit 06e533bc96
3 changed files with 9 additions and 15 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

12
doc/source/admin/configuring-migrations.rst
View File

@ -231,18 +231,6 @@ memory-intensive instances succeed.
example, shared-storage live migration of an instance with 8GiB memory will
time out after 6400 seconds.
#. **Live migration progress timeout**
The Compute service also aborts a live migration when it detects that memory
copy is not making progress for a certain time. You can set this time, in
seconds, through the configurable parameter
``live_migration_progress_timeout``.
In Ocata, the default value of ``live_migration_progress_timeout`` is 0,
which disables progress timeouts. You should not change this value, since
the algorithm that detects memory copy progress has been determined to be
unreliable. It may be re-enabled in future releases.
#. **Instance downtime**
Near the end of the memory copy, the instance is paused for a short time so

7
doc/source/admin/live-migration-usage.rst
View File

@ -239,8 +239,9 @@ out:
live migration not completed after 1800 sec
The Compute service also cancels migrations when the memory copy seems to make
no progress. Ocata disables this feature by default, but it can be enabled
using the configuration parameter ``live_migration_progress_timeout``. Should
no progress. This feature is `disabled by default`_, but it can be enabled
using the configuration parameter
:oslo.config:option:`libvirt.live_migration_progress_timeout`. Should
this be the case, you may find the following message in the log:
.. code-block:: console
@ -248,6 +249,8 @@ this be the case, you may find the following message in the log:
WARNING nova.virt.libvirt.migration [req-...] [instance: ...]
live migration stuck for 150 sec
.. _disabled by default: https://review.openstack.org/#/c/431635/
Addressing migration timeouts
-----------------------------

5
nova/conf/libvirt.py
View File

@ -397,7 +397,10 @@ Related options:
cfg.IntOpt('live_migration_progress_timeout',
default=0,
deprecated_for_removal=True,
deprecated_reason="Serious bugs found in this feature.",
deprecated_reason="""
Serious bugs found in this feature, see
https://bugs.launchpad.net/nova/+bug/1644248 for details.
""",
mutable=True,
help="""
Time to wait, in seconds, for migration to make forward progress in