From a3c08c09417db78c85b203e6c0d6b21dbc597b1b Mon Sep 17 00:00:00 2001 From: Alex-Welsh Date: Fri, 8 Nov 2024 11:29:27 +0000 Subject: [PATCH] Add upgrade host configure warning for ceph nodes --- doc/source/operations/upgrading-openstack.rst | 18 ++++++++++++++---- 1 file changed, 14 insertions(+), 4 deletions(-) diff --git a/doc/source/operations/upgrading-openstack.rst b/doc/source/operations/upgrading-openstack.rst index 23fc8b67f..700f093f7 100644 --- a/doc/source/operations/upgrading-openstack.rst +++ b/doc/source/operations/upgrading-openstack.rst @@ -969,17 +969,27 @@ would be applied: kayobe overcloud host configure --check --diff When ready to apply the changes, it may be advisable to do so in batches, or at -least start with a small number of hosts.: +least start with a small number of hosts: .. code-block:: console kayobe overcloud host configure --limit -Alternatively, to apply the configuration to all hosts: -.. code-block:: console +.. warning:: + + Take extra care when configuring Ceph hosts. Set the hosts to maintenance + mode before reconfiguring them, and unset when done: + + .. code-block:: console + + kayobe playbook run $KAYOBE_CONFIG_PATH/ansible/ceph-enter-maintenance.yml --limit + kayobe overcloud host configure --limit + kayobe playbook run $KAYOBE_CONFIG_PATH/ansible/ceph-exit-maintenance.yml --limit - kayobe overcloud host configure + **Always** reconfigure hosts in small batches or one-by-one. Check the Ceph + state after each host configuration. Ensure all warnings and errors are + resolved before moving on. .. _building_ironic_deployment_images: