Chapter 3. Upgrading the undercloud

Procedure

1. Log in to director as the stack user.

2. Disable the current OpenStack Platform repository:

   $ sudo subscription-manager repos --disable=rhel-7-server-openstack-10-rpms

   Copy to Clipboard Toggle word wrap

3. Enable the new OpenStack Platform repository:

   $ sudo subscription-manager repos --enable=rhel-7-server-openstack-11-rpms

   Copy to Clipboard Toggle word wrap

4. Disable updates to the overcloud base images:

   $ sudo yum-config-manager --setopt=exclude=rhosp-director-images* --save

   Copy to Clipboard Toggle word wrap

5. Stop the main OpenStack Platform services:

   $ sudo systemctl stop 'openstack-*' 'neutron-*' httpd

   Copy to Clipboard Toggle word wrap
   Note

   This causes a short period of downtime for the undercloud. The overcloud is still functional during the undercloud upgrade.

6. The default Provisioning/Control Plane network has changed from 192.0.2.0/24 to 192.168.24.0/24. If you used default network values in your previous undercloud.conf file, your Provisioning/Control Plane network is set to 192.0.2.0/24. This means you need to set certain parameters in your undercloud.conf file to continue using the 192.0.2.0/24 network. These parameters are:

   • local_ip
   • network_gateway
   • undercloud_public_vip
   • undercloud_admin_vip
   • network_cidr
   • masquerade_network
   • dhcp_start
   • dhcp_end

   Set the network values in undercloud.conf to ensure continued use of the 192.0.2.0/24 CIDR during future upgrades. Ensure your network configuration set correctly before running the openstack undercloud upgrade command.

7. Run yum to upgrade the director’s main packages:

   $ sudo yum update -y instack-undercloud openstack-puppet-modules openstack-tripleo-common python-tripleoclient

   Copy to Clipboard Toggle word wrap

8. Run the following command to upgrade the undercloud:

   $ openstack undercloud upgrade

   Copy to Clipboard Toggle word wrap
9. Wait until the undercloud upgrade process completes.

Procedure

1. Log in to director as the stack user.

2. Disable the current OpenStack Platform repository:

   $ sudo subscription-manager repos --disable=rhel-7-server-openstack-11-rpms

   Copy to Clipboard Toggle word wrap

3. Enable the new OpenStack Platform repository:

   $ sudo subscription-manager repos --enable=rhel-7-server-openstack-12-rpms

   Copy to Clipboard Toggle word wrap

4. Disable updates to the overcloud base images:

   $ sudo yum-config-manager --setopt=exclude=rhosp-director-images* --save

   Copy to Clipboard Toggle word wrap

5. Run yum to upgrade the director’s main packages:

   $ sudo yum update -y python-tripleoclient

   Copy to Clipboard Toggle word wrap
6. Edit the /home/stack/undercloud.conf file and check that the enabled_drivers parameter does not contain the pxe_ssh driver. This driver is deprecated in favor of the Virtual Baseboard Management Controller (VBMC) and removed from Red Hat OpenStack Platform. For more information about this new driver and migration instructions, see the Appendix "Virtual Baseboard Management Controller (VBMC)" in the Director Installation and Usage Guide.

7. Run the following command to upgrade the undercloud:

   $ openstack undercloud upgrade

   Copy to Clipboard Toggle word wrap
8. Wait until the undercloud upgrade process completes.

Procedure

1. Log in to director as the stack user.

2. Disable the current OpenStack Platform repository:

   $ sudo subscription-manager repos --disable=rhel-7-server-openstack-12-rpms

   Copy to Clipboard Toggle word wrap

3. Set the RHEL version to RHEL 7.9:

   $ sudo subscription-manager release --set=7.9

   Copy to Clipboard Toggle word wrap

4. Enable the new OpenStack Platform repository:

   $ sudo subscription-manager repos --enable=rhel-7-server-openstack-13-rpms

   Copy to Clipboard Toggle word wrap

5. Re-enable updates to the overcloud base images:

   $ sudo yum-config-manager --setopt=exclude= --save

   Copy to Clipboard Toggle word wrap

6. Run yum to upgrade the director’s main packages:

   $ sudo yum update -y python-tripleoclient

   Copy to Clipboard Toggle word wrap

7. Run the following command to upgrade the undercloud:

   $ openstack undercloud upgrade

   Copy to Clipboard Toggle word wrap
8. Wait until the undercloud upgrade process completes.

9. Reboot the undercloud to update the operating system’s kernel and other system packages:

   $ sudo reboot

   Copy to Clipboard Toggle word wrap
10. Wait until the node boots.

Procedure

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

2. Stop and disable the openstack-glance-registry service:

   $ sudo systemctl stop openstack-glance-registry
   $ sudo systemctl disable openstack-glance-registry

   Copy to Clipboard Toggle word wrap

3. Stop and disable the mongod service:

   $ sudo systemctl stop mongod
   $ sudo systemctl disable mongod

   Copy to Clipboard Toggle word wrap