summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorZuul <zuul@review.openstack.org>2019-02-26 01:48:45 +0000
committerGerrit Code Review <review@openstack.org>2019-02-26 01:48:45 +0000
commitd64677701cfe41fc7691105e1e4d273841efa3ff (patch)
tree7513558f266df12f30a56b4e0dd3080de0a1027f
parent1ae9a85840ea6af4786c64dd484a6b46b65f6dfb (diff)
parent4ceba48697201dede5d17020ca7bc4f5af244ea5 (diff)
downloadpython-novaclient-d64677701cfe41fc7691105e1e4d273841efa3ff.tar.gz
Merge "Add a note in "nova service-delete" help about deleting computes"
-rw-r--r--doc/source/cli/nova.rst6
-rw-r--r--novaclient/v2/shell.py16
2 files changed, 20 insertions, 2 deletions
diff --git a/doc/source/cli/nova.rst b/doc/source/cli/nova.rst
index 64bdf2da..e9de8a0a 100644
--- a/doc/source/cli/nova.rst
+++ b/doc/source/cli/nova.rst
@@ -3289,6 +3289,12 @@ nova service-delete
Delete the service.
+.. important:: If deleting a nova-compute service, be sure to stop the actual
+ ``nova-compute`` process on the physical host *before* deleting the
+ service with this command. Failing to do so can lead to the running
+ service re-creating orphaned **compute_nodes** table records in the
+ database.
+
**Positional arguments:**
``<id>``
diff --git a/novaclient/v2/shell.py b/novaclient/v2/shell.py
index a88aa022..cb0b1c4a 100644
--- a/novaclient/v2/shell.py
+++ b/novaclient/v2/shell.py
@@ -3700,7 +3700,13 @@ def do_service_force_down(cs, args):
help=_('ID of service as an integer. Note that this may not '
'uniquely identify a service in a multi-cell deployment.'))
def do_service_delete(cs, args):
- """Delete the service by integer ID."""
+ """Delete the service by integer ID.
+
+ If deleting a nova-compute service, be sure to stop the actual
+ nova-compute process on the physical host before deleting the
+ service with this command. Failing to do so can lead to the running
+ service re-creating orphaned compute_nodes table records in the database.
+ """
cs.services.delete(args.id)
@@ -3708,7 +3714,13 @@ def do_service_delete(cs, args):
@api_versions.wraps('2.53')
@utils.arg('id', metavar='<id>', help=_('ID of service as a UUID.'))
def do_service_delete(cs, args):
- """Delete the service by UUID ID."""
+ """Delete the service by UUID ID.
+
+ If deleting a nova-compute service, be sure to stop the actual
+ nova-compute process on the physical host before deleting the
+ service with this command. Failing to do so can lead to the running
+ service re-creating orphaned compute_nodes table records in the database.
+ """
cs.services.delete(args.id)