Red Hat Training
A Red Hat training course is available for Red Hat OpenStack Platform
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 in to director as the
stack
user. 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
Disable updates to the overcloud base images:
$ sudo yum-config-manager --setopt=exclude=rhosp-director-images* --save
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/24
to192.168.24.0/24
. If you used default network values in your previousundercloud.conf
file, your Provisioning/Control Plane network is set to192.0.2.0/24
. This means you need to set certain parameters in yourundercloud.conf
file to continue using the192.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 the192.0.2.0/24
CIDR during future upgrades. Ensure your network configuration set correctly before running theopenstack undercloud upgrade
command.-
Run
yum
to 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 in to director as the
stack
user. 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
Disable updates to the overcloud base images:
$ sudo yum-config-manager --setopt=exclude=rhosp-director-images* --save
Run
yum
to upgrade the director’s main packages:$ sudo yum update -y python-tripleoclient
-
Edit the
/home/stack/undercloud.conf
file and check that theenabled_drivers
parameter does not contain thepxe_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. 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 in to director as the
stack
user. Disable the current OpenStack Platform repository:
$ sudo subscription-manager repos --disable=rhel-7-server-openstack-12-rpms
Set the RHEL version to RHEL 7.9:
$ sudo subscription-manager release --set=7.9
Enable the new OpenStack Platform repository:
$ sudo subscription-manager repos --enable=rhel-7-server-openstack-13-rpms
Re-enable updates to the overcloud base images:
$ sudo yum-config-manager --setopt=exclude= --save
Run
yum
to 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. Disabling deprecated services on the undercloud
After you upgrade the undercloud, you must disable the deprecated openstack-glance-registry
and mongod
services.
Procedure
-
Log in to the undercloud as the
stack
user. Stop and disable the
openstack-glance-registry
service:$ sudo systemctl stop openstack-glance-registry $ sudo systemctl disable openstack-glance-registry
Stop and disable the
mongod
service:$ sudo systemctl stop mongod $ sudo systemctl disable mongod
3.5. Next Steps
The undercloud upgrade is complete. You can now configure a source for your container images.