From 90f8748c727da6c482bcd9608cf9d13693adc9bb Mon Sep 17 00:00:00 2001 From: Jack Hodgkiss Date: Mon, 24 Nov 2025 22:44:30 +0000 Subject: [PATCH 1/3] docs: add warning for `Noble` upgrade on `Ceph` hosts See bug https://tracker.ceph.com/issues/66389 Signed-off-by: Jack Hodgkiss --- doc/source/operations/ubuntu-noble.rst | 8 ++++++-- 1 file changed, 6 insertions(+), 2 deletions(-) diff --git a/doc/source/operations/ubuntu-noble.rst b/doc/source/operations/ubuntu-noble.rst index 4ac5847168..a6d0784d5b 100644 --- a/doc/source/operations/ubuntu-noble.rst +++ b/doc/source/operations/ubuntu-noble.rst @@ -47,8 +47,11 @@ The following types of hosts will be covered in the future: .. warning:: - Ceph node upgrades have not yet been performed outside of a virtualised test - environment. Proceed with caution. + Due to `Bug 66389 `__ any Ceph + host that is upgraded to Noble without first upgrading to at least + Reef v18.2.5 will not be able to rejoin the cluster. Noble upgrade + for host running Ceph daemons will have to be postponed until the + Ceph cluster has been upgraded to at least v18.2.5. Prerequisites ============= @@ -353,6 +356,7 @@ Storage Potential issues ---------------- +- Ensure running at Ceph v18.2.5 or greater. - It is recommended that you upgrade the bootstrap host last. - Before upgrading the bootstrap host, it can be beneficial to backup ``/etc/ceph`` and ``/var/lib/ceph``, as sometimes the keys, config, etc. From 5cad0948ff4b3f7a45baee2054e0dddd07c327c5 Mon Sep 17 00:00:00 2001 From: Jack Hodgkiss Date: Mon, 24 Nov 2025 22:50:23 +0000 Subject: [PATCH 2/3] docs: apply suggested changes Co-authored-by: gemini-code-assist[bot] <176961590+gemini-code-assist[bot]@users.noreply.github.com> --- doc/source/operations/ubuntu-noble.rst | 11 +++++------ 1 file changed, 5 insertions(+), 6 deletions(-) diff --git a/doc/source/operations/ubuntu-noble.rst b/doc/source/operations/ubuntu-noble.rst index a6d0784d5b..a8454dc569 100644 --- a/doc/source/operations/ubuntu-noble.rst +++ b/doc/source/operations/ubuntu-noble.rst @@ -47,11 +47,10 @@ The following types of hosts will be covered in the future: .. warning:: - Due to `Bug 66389 `__ any Ceph - host that is upgraded to Noble without first upgrading to at least - Reef v18.2.5 will not be able to rejoin the cluster. Noble upgrade - for host running Ceph daemons will have to be postponed until the - Ceph cluster has been upgraded to at least v18.2.5. + Due to `Bug 66389 `__, do not upgrade + Ceph hosts to Noble until the Ceph cluster has been upgraded to at least + Reef v18.2.5. Upgrading a host prematurely will prevent its Ceph daemons + from starting, and it will not be able to rejoin the cluster. Prerequisites ============= @@ -356,7 +355,7 @@ Storage Potential issues ---------------- -- Ensure running at Ceph v18.2.5 or greater. +- Ensure the Ceph cluster is running at least Reef v18.2.5. Upgrading hosts with an older Ceph version will cause daemons to fail. - It is recommended that you upgrade the bootstrap host last. - Before upgrading the bootstrap host, it can be beneficial to backup ``/etc/ceph`` and ``/var/lib/ceph``, as sometimes the keys, config, etc. From 992a7b6c1d513187fe169de02584d2b65643a8db Mon Sep 17 00:00:00 2001 From: Jack Hodgkiss Date: Tue, 25 Nov 2025 12:36:04 +0000 Subject: [PATCH 3/3] docs(fix): add line wrap Signed-off-by: Jack Hodgkiss --- doc/source/operations/ubuntu-noble.rst | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/doc/source/operations/ubuntu-noble.rst b/doc/source/operations/ubuntu-noble.rst index a8454dc569..005ae8cb5c 100644 --- a/doc/source/operations/ubuntu-noble.rst +++ b/doc/source/operations/ubuntu-noble.rst @@ -355,7 +355,8 @@ Storage Potential issues ---------------- -- Ensure the Ceph cluster is running at least Reef v18.2.5. Upgrading hosts with an older Ceph version will cause daemons to fail. +- Ensure the Ceph cluster is running at least Reef v18.2.5. + Upgrading hosts with an older Ceph version will cause daemons to fail. - It is recommended that you upgrade the bootstrap host last. - Before upgrading the bootstrap host, it can be beneficial to backup ``/etc/ceph`` and ``/var/lib/ceph``, as sometimes the keys, config, etc.