Merge "Update graceful shutdown known issue to list resize case also"

releasenotes/notes/nova-graceful-shutdown-task-tracking-13485c8346512ae4.yaml

@@ -10,15 +10,23 @@ features:
     always sleeping for the full timeout.
 known_issues:
   - |
-    There is a known issue where the ``live_migration_at_dest`` task may
-    be left in-progress if the live migration is rolled back during
-    ``pre_live_migration``. Since the source and destination compute
-    services track their tasks independently, the source compute cannot
-    end the task tracked on the destination in this case, leaving it
-    reported as still in-progress. Due to this bug, if live migration
-    is rolled back at ``pre_live_migration`` stage then destination
-    ``nova-compute`` service shutdown may take the full configured
+    There is a known issue where a migration-related task tracked on the
+    destination compute service may be left in-progress if an error on
+    the source compute ends the operation without notifying the
+    destination. Since the source and destination compute services
+    track their tasks independently, the source has no way to end the
+    task tracked on the destination in this case, leaving it reported as
+    still in-progress. Due to this bug, destination ``nova-compute``
+    service shutdown may take the full configured
     ``[DEFAULT]/manager_shutdown_timeout`` to shutdown, instead of
-    exiting as soon as live migration is rolled back. See
-    `bug 2166009 <https://bugs.launchpad.net/nova/+bug/2166009>`_ for
-    more details.
+    exiting as soon as the operation actually ends. Two known cases of
+    this are:
+
+    * The ``live_migration_at_dest`` task being left in-progress if the
+      live migration is rolled back during ``pre_live_migration``.
+    * The ``prep_resize_at_dest`` task being left in-progress if
+      ``resize_instance``/cold migration fails on the source compute
+      before it hands off to ``finish_resize`` on the destination.
+
+    See `bug 2166009 <https://bugs.launchpad.net/nova/+bug/2166009>`_
+    for more details.