From 974cfb247f96eb5759cc42342cf153b2e8d58c79 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Harald=20Jens=C3=A5s?= Date: Thu, 20 Dec 2018 21:07:11 +0100 Subject: [PATCH] Stack Update - NetworkDeploymentActions Add a page regarding network configuration changes in post deployment. Network configuration changes are disabled by default, parameter override is required to enable network re-configuration when necessary. Related-Bug: #1804642 Change-Id: I0f834af0391649ac51e41fc1e9bbf3db458beac6 --- .../post_deployment/post_deployment.rst | 1 + ..._network_configuration_post_deployment.rst | 32 +++++++++++++++++++ 2 files changed, 33 insertions(+) create mode 100644 doc/source/install/post_deployment/updating_network_configuration_post_deployment.rst diff --git a/doc/source/install/post_deployment/post_deployment.rst b/doc/source/install/post_deployment/post_deployment.rst index 8e70e61f..e852f3cf 100644 --- a/doc/source/install/post_deployment/post_deployment.rst +++ b/doc/source/install/post_deployment/post_deployment.rst @@ -17,3 +17,4 @@ In this chapter you will find advanced management of various |project| areas. upload_single_image update_undercloud_ssh_keys fernet_key_rotation + updating_network_configuration_post_deployment diff --git a/doc/source/install/post_deployment/updating_network_configuration_post_deployment.rst b/doc/source/install/post_deployment/updating_network_configuration_post_deployment.rst new file mode 100644 index 00000000..9c35071a --- /dev/null +++ b/doc/source/install/post_deployment/updating_network_configuration_post_deployment.rst @@ -0,0 +1,32 @@ +.. _update_network_configuration_post_deploymenet: + +Updating network configuration on the Overcloud after a deployment +================================================================== + +By default, subsequent change(s) made to network configuration templates +(bonding options, mtu, bond type, etc) are not applied on existing nodes when +the overcloud stack is updated. + +.. Warning:: Network configuration updates are disabled by default to avoid + issues that may arise from network reconfiguration. + + Network configuration updates should only be enabled when needed. + +To push an updated network configuration add ``UPDATE`` to list of actions set +in the ``NetworkDeploymentActions`` parameter. (The default is ``['CREATE']``, +to enable network configuration on stack update it must be changed to: +``['CREATE','UPDATE']``.) + +* Enable update of the network configuration for all roles by adding the + following to ``parameter_defaults`` in an environment file:: + + parameter_defaults: + NetworkDeploymentActions: ['CREATE','UPDATE'] + +* Limit the network configuration update to nodes of a specific role by using a + role-specific parameter, i.e: ``{role.name}NetworkDeploymentActions``. For + example to update the network configuration on the nodes in the Compute role, + add the following to ``parameter_defaults`` in an environment file:: + + parameter_defaults: + ComputeNetworkDeploymentActions: ['CREATE','UPDATE']