Chapter 11. Upgrading the overcloud

Procedure

1. Log in to the undercloud host as the stack user.

2. Source the stackrc undercloud credentials file:

   $ source ~/stackrc

   Copy to Clipboard Toggle word wrap

3. If you do not have a DCN or multi-cell deployment that includes ML2/OVN, upgrade RHOSP on all nodes in your main stack:

   $ openstack overcloud upgrade run --yes --stack <stack> --debug --limit allovercloud,undercloud --playbook all

   Copy to Clipboard Toggle word wrap
   Important

   Do not modify the --limit option. You must upgrade all nodes in the stack at once to avoid breaking your workloads. If you need assistance, contact Red Hat Support.

   • Replace <stack> with the name of the overcloud stack that you want to upgrade the nodes on.

     Repeat this step for each stack in your RHOSP deployment.

4. If you have a DCN or multi-cell deployment that includes ML2/OVN, upgrade the OVN containers and all host packages on each stack. For DCN deployments, you must upgrade the central stack last. For multi-cell deployments, you must upgrade the control stack last:

   $ openstack overcloud upgrade run --stack <stack> --tags setup_packages,ovn --limit allovercloud --yes

   Copy to Clipboard Toggle word wrap

   • Replace <stack> with the name of the stack you are upgrading.

     1. Verify that the ovn-controller is updated on all overcloud nodes:

        $ sudo podman ps | grep ovn_controller

        Copy to Clipboard Toggle word wrap

        Sample output

        5ddc21ef9056  undercloud-0.ctlplane.redhat.local:8787/rh-osbs/rhosp17-openstack-ovn-controller:17.1_20230905.1
        kolla_start  20 hours ago  Up 20 hours (healthy)  ovn_controller

        Copy to Clipboard Toggle word wrap

     2. Upgrade the service containers and update the host packages on each stack, starting with the central stack or control stack:

        $ openstack overcloud upgrade run --stack <stack> --skip-tags ovn --limit allovercloud --yes

        Copy to Clipboard Toggle word wrap