From 03e59960e2dd3b9cf58670c597a19d5ffc57f297 Mon Sep 17 00:00:00 2001 From: Matt Crees Date: Fri, 14 Mar 2025 13:50:51 +0000 Subject: [PATCH] Docs: add warning about Ceph when updating packages --- doc/source/operations/upgrading-openstack.rst | 18 ++++++++++++++++++ 1 file changed, 18 insertions(+) diff --git a/doc/source/operations/upgrading-openstack.rst b/doc/source/operations/upgrading-openstack.rst index 8ee8288c5..591d2668e 100644 --- a/doc/source/operations/upgrading-openstack.rst +++ b/doc/source/operations/upgrading-openstack.rst @@ -989,6 +989,24 @@ the change: kayobe playbook run $KAYOBE_CONFIG_PATH/ansible/reboot.yml -l +.. warning:: + + Take extra care when updating packages on Ceph hosts. Docker live-restore + does not work until the Squid version of Ceph, so a reload of docker will + restart all Ceph containers. Set the hosts to maintenance mode before + updating packages, and unset when done: + + .. code-block:: console + + kayobe playbook run $KAYOBE_CONFIG_PATH/ansible/ceph-enter-maintenance.yml --limit + kayobe overcloud host package update --packages "*" --limit + kayobe playbook run $KAYOBE_CONFIG_PATH/ansible/reboot.yml -l + kayobe playbook run $KAYOBE_CONFIG_PATH/ansible/ceph-exit-maintenance.yml --limit + + **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. + If the host is a hypervisor, enable the Nova compute service. .. code-block:: console