From ed6eab94044d9fa5c0f85c78b1b57a79626b1fc9 Mon Sep 17 00:00:00 2001 From: Pierre Riteau Date: Tue, 27 Feb 2024 10:59:26 +0100 Subject: [PATCH] Document update of IPA kernel URL This may be required when migrating pre-Ussuri deployments. --- doc/source/operations/rocky-linux-9.rst | 29 ++++++++++++++++++++----- 1 file changed, 24 insertions(+), 5 deletions(-) diff --git a/doc/source/operations/rocky-linux-9.rst b/doc/source/operations/rocky-linux-9.rst index c21c50f13..22b9323ae 100644 --- a/doc/source/operations/rocky-linux-9.rst +++ b/doc/source/operations/rocky-linux-9.rst @@ -45,11 +45,6 @@ The following patches have been **merged** to the downstream StackHPC ``stackhpc - https://review.opendev.org/c/openstack/kayobe/+/898563 (to fix ``kayobe overcloud deprovision``) - https://review.opendev.org/c/openstack/kayobe/+/898284 (if deployment predates Ussuri) - - - TODO: Put this into the procedure. - - **Must reprocess inspection data to update IPA kernel URL (see - release note)** - - https://review.opendev.org/c/openstack/kayobe/+/898777 - https://review.opendev.org/c/openstack/kayobe/+/898915 - https://review.opendev.org/c/openstack/kayobe/+/898905 @@ -119,6 +114,30 @@ The error from NetworkManager was: [1697192659.9611] keyfile: ipv4.routing-rules: invalid value for "routing-rule1": invalid value for "table" +Updating the IPA kernel URL +--------------------------- + +If the enrolment of the overcloud nodes in Bifrost predates Ussuri, the +``deploy_kernel`` configuration probably still points to the old +``ipa.vmlinuz`` file, resulting in the following error in Bifrost: + +.. code-block:: shell + + Failed to prepare to deploy: Validation of image href http://10.161.0.3:8080/ipa.vmlinuz failed, reason: Got HTTP code 404 instead of 200 in response to HEAD request. + +Switch the deployment kernel to ``ipa.kernel``: + +.. code-block:: shell + + (bifrost-deploy) OS_CLOUD=bifrost baremetal node set --driver-info deploy_kernel=http://:8080/ipa.kernel + +Alternatively, the node inspection data can be reprocessed, but this may erase +any manual configuration changes applied since the last inspection: + +.. code-block:: shell + + (bifrost-deploy) OS_CLOUD=bifrost baremetal introspection reprocess + Switching to iPXE -----------------