From 7a0b2d34822d5347a8a83d1bb68592f6c1a1d102 Mon Sep 17 00:00:00 2001 From: Artom Lifshitz Date: Wed, 9 Jun 2021 13:38:18 -0400 Subject: [PATCH] docs: Explicitly state lack of support for node renaming Nova does not support renaming a node once it has been deployed. Previously, this was not mentioned anywhere in our docs. This patches adds a warning to that effect to the installation guide. Change-Id: I0f34c89855069119974d75d31833b974ba705306 --- doc/source/install/overview.rst | 8 ++++++++ 1 file changed, 8 insertions(+) diff --git a/doc/source/install/overview.rst b/doc/source/install/overview.rst index 25a3b56f6ff3..9781973d9f36 100644 --- a/doc/source/install/overview.rst +++ b/doc/source/install/overview.rst @@ -48,6 +48,14 @@ Object Storage require additional nodes. or how to determine which architecture is required, see the `Architecture Design Guide `_. +.. warning:: + + Once a cloud has been deployed, changing the host name of *any* node in the + deployment is not supported. In some cases, it may be possible to remove a + node from the deployment, and add it again under a different host name. + Renaming a node in situ will result in problems that will require multiple + manual fixes. + This example architecture differs from a minimal production architecture as follows: