Chapter 3. Upgrading the undercloud
This following procedures upgrades the undercloud to Red Hat OpenStack Platform 13. You accomplish this by performing an upgrade through each sequential version of the undercloud from OpenStack Platform 10 to OpenStack Platform 13.
3.1. Upgrading the undercloud to OpenStack Platform 11
This procedure upgrades the undercloud toolset and the core Heat template collection to the OpenStack Platform 11 release.
Procedure
-
Log into the director as the
stackuser. Disable the current OpenStack Platform repository:
$ sudo subscription-manager repos --disable=rhel-7-server-openstack-10-rpms
Enable the new OpenStack Platform repository:
$ sudo subscription-manager repos --enable=rhel-7-server-openstack-11-rpms
Stop the main OpenStack Platform services:
$ sudo systemctl stop 'openstack-*' 'neutron-*' httpd
NoteThis causes a short period of downtime for the undercloud. The overcloud is still functional during the undercloud upgrade.
The default Provisioning/Control Plane network has changed from
192.0.2.0/24to192.168.24.0/24. If you used default network values in your previousundercloud.conffile, your Provisioning/Control Plane network is set to192.0.2.0/24. This means you need to set certain parameters in yourundercloud.conffile to continue using the192.0.2.0/24network. 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.confto ensure continued use of the192.0.2.0/24CIDR during future upgrades. Ensure your network configuration set correctly before running theopenstack undercloud upgradecommand.-
Run
yumto upgrade the director’s main packages:$ sudo yum update -y instack-undercloud openstack-puppet-modules openstack-tripleo-common python-tripleoclient
Run the following command to upgrade the undercloud:
$ openstack undercloud upgrade
- Wait until the undercloud upgrade process completes.
You have upgraded the undercloud to the OpenStack Platform 11 release.
3.2. Upgrading the undercloud to OpenStack Platform 12
This procedure upgrades the undercloud toolset and the core Heat template collection to the OpenStack Platform 12 release.
Procedure
-
Log into the director as the
stackuser. Disable the current OpenStack Platform repository:
$ sudo subscription-manager repos --disable=rhel-7-server-openstack-11-rpms
Enable the new OpenStack Platform repository:
$ sudo subscription-manager repos --enable=rhel-7-server-openstack-12-rpms
Install the
ceph-ansiblepackage when overcloud is configured with Ceph storage:$ sudo yum install -y ceph-ansible
Run
yumto upgrade the director’s main packages:$ sudo yum update -y python-tripleoclient
-
Edit the
/home/stack/undercloud.conffile and check that theenabled_driversparameter does not contain thepxe_sshdriver. 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. Run the following command to upgrade the undercloud:
$ openstack undercloud upgrade
- Wait until the undercloud upgrade process completes.
You have upgraded the undercloud to the OpenStack Platform 12 release.
3.3. Upgrading the undercloud to OpenStack Platform 13
This procedure upgrades the undercloud toolset and the core Heat template collection to the OpenStack Platform 13 release.
Procedure
-
Log into the director as the
stackuser. Disable the current OpenStack Platform repository:
$ sudo subscription-manager repos --disable=rhel-7-server-openstack-12-rpms
Enable the new OpenStack Platform repository:
$ sudo subscription-manager repos --enable=rhel-7-server-openstack-13-rpms
Run
yumto upgrade the director’s main packages:$ sudo yum update -y python-tripleoclient
Run the following command to upgrade the undercloud:
$ openstack undercloud upgrade
- Wait until the undercloud upgrade process completes.
Reboot the undercloud to update the operating system’s kernel and other system packages:
$ sudo reboot
- Wait until the node boots.
You have upgraded the undercloud to the OpenStack Platform 13 release.
3.4. Next Steps
The undercloud upgrade is complete. You can now configure a source for your container images.
