Limitation about openstack remove with a running VM

Change-Id: Icfabdb05f6129b73d284722f2272449e56be8984
Signed-off-by: Suzana Fernandes <Suzana.Fernandes@windriver.com>

doc/source/_includes/limitation-to-remove-openstack-when-running-vm-089ff8668643.rest

@@ -0,0 +1,10 @@
+
+.. note::
+
+   To remove the OpenStack application, first you need to remove all OpenStack
+   resources (including VMs) and then remove the OpenStack.
+
+   If the application fails to re-apply due to VMs orphaned from the previous remove,
+   check :ref:`uninstall_delete-r7` for more details.
+
+

doc/source/backup/openstack/restore-openstack-from-a-backup.rst

@@ -25,6 +25,8 @@ You can restore |prod-os| from a backup with or without Ceph.
 
         Images and volumes will remain in Ceph.
 
+    .. include:: /_includes/limitation-to-remove-openstack-when-running-vm-089ff8668643.rest
+
     .. parsed-literal::
 
         ~(keystone_admin)$ system application-remove |prefix|-openstack

doc/source/deploy_install_guides/release/openstack/uninstall_delete.rst

@@ -24,6 +24,25 @@ includes:
 -   Removing all volumes, volume backups, volume snapshots
 -   Removing all Glance images
 
+.. note::
+
+      When OpenStack is removed (``system application-remove stx-openstack``) while a
+      guest Virtual Machine (OpenStack VM) is still running in one of the compute
+      nodes, further application re-applies (``system application-apply stx-openstack``)
+      may fail.
+
+      If the application fails to re-apply due to VMs orphaned from the previous
+      application, before re-applying the OpenStack application, it is necessary to ``ssh``
+      into the specific compute node that is presenting the issue (same node
+      where the OpenStack VM was left behind) and manually delete the remaining
+      OpenStack VM using the ``virsh`` CLI. For example:
+
+      .. code-block:: none
+
+            $ ssh compute-2
+            $ sudo virsh list --all # Identify and copy the name of the remaining OpenStack VM
+            $ sudo virsh undefine <instance-name> # Remove the VM
+
 -----------------------------
 Bring down OpenStack services
 -----------------------------

doc/source/developer_resources/backup_restore.rst

@@ -448,6 +448,8 @@ Steps:
     a.  Delete the old OpenStack application and upload the application again.
         (Note that images and volumes will remain in Ceph.)
 
+        .. include:: /_includes/limitation-to-remove-openstack-when-running-vm-089ff8668643.rest
+
         .. parsed-literal::
 
             system application-remove |prefix|-openstack

doc/source/developer_resources/move_to_new_openstack_version_in_starlingx.rst

@@ -207,6 +207,8 @@ Here are some tips for testing and debugging your upgrade:
 #. Use `system application management <sys_app_management>`_ commands to manage
    the application. For example:
 
+   .. include:: /_includes/limitation-to-remove-openstack-when-running-vm-089ff8668643.rest
+
    .. parsed-literal::
 
           system application-upload -n |prefix|-openstack |prefix|-openstack-1.0-16.tgz