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

3. Enable the new OpenStack Platform repository:

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

4. Disable updates to the overcloud base images:

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

5. Stop the main OpenStack Platform services:

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

   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

8. Run the following command to upgrade the undercloud:

   $ openstack undercloud upgrade

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

3. Enable the new OpenStack Platform repository:

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

4. Disable updates to the overcloud base images:

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

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

   $ sudo yum update -y python-tripleoclient

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

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

3. Set the RHEL version to RHEL 7.9:

   $ sudo subscription-manager release --set=7.9

4. Enable the new OpenStack Platform repository:

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

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

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

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

   $ sudo yum update -y python-tripleoclient

7. Run the following command to upgrade the undercloud:

   $ openstack undercloud upgrade

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

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

3. Stop and disable the mongod service:

   $ sudo systemctl stop mongod
   $ sudo systemctl disable mongod