Chapter 3. Updating the Overcloud
This process updates the overcloud.
Prerequisites
- You have updated the undercloud to the latest version.
3.1. Running the overcloud update preparation
The update requires running openstack overcloud update prepare
command, which performs the following tasks:
- Updates the overcloud plan to OpenStack Platform 15
- Prepares the nodes for the update
Procedure
Source the
stackrc
file:$ source ~/stackrc
Run the update preparation command:
$ openstack overcloud update prepare \ --templates \ -r <ROLES DATA FILE> \ -n <NETWORK DATA FILE> \ -e <ENVIRONMENT FILE> \ -e <ENVIRONMENT FILE> \ ...
Include the following options relevant to your environment:
-
Custom configuration environment files (
-e
) -
If using your own custom roles, include your custom roles (
roles_data
) file (-r
) -
If using custom networks, include your composable network (
network_data
) file (-n
)
-
Custom configuration environment files (
- Wait until the update preparation completes.
3.2. Running the container image preparation
The overcloud requires the latest OpenStack Platform 15 container images before performing the update. This involves executing the container_image_prepare
external update process. To execute this process, run the openstack overcloud external-update run
command against tasks tagged with the container_image_prepare
tag. These tasks:
- Automatically prepare all container image configuration relevant to your environment.
- Pull the relevant container images to your undercloud, unless you have previously disabled this option.
Procedure
Source the
stackrc
file:$ source ~/stackrc
Run the
openstack overcloud external-update run
command against tasks tagged with thecontainer_image_prepare
tag:$ openstack overcloud external-update run --tags container_image_prepare
3.3. Updating all Controller nodes
This process updates all the Controller nodes to the latest OpenStack Platform 15 version. The process involves running the openstack overcloud update run
command and including the --nodes Controller
option to restrict operations to the Controller nodes only.
Procedure
Source the
stackrc
file:$ source ~/stackrc
Run the update command:
$ openstack overcloud update run --nodes Controller
- Wait until the Controller node update completes.
3.4. Updating all Compute nodes
This process updates all Compute nodes to the latest OpenStack Platform 15 version. The process involves running the openstack overcloud update run
command and including the --nodes Compute
option to restrict operations to the Compute nodes only.
Procedure
Source the
stackrc
file:$ source ~/stackrc
Run the update command:
$ openstack overcloud update run --nodes Compute
- Wait until the Compute node update completes.
3.5. Updating all HCI Compute nodes
This process updates the Hyperconverged Infrastructure (HCI) Compute nodes. The process involves:
-
Running the
openstack overcloud update run
command and including the--nodes ComputeHCI
option to restrict operations to the HCI nodes only. -
Running the
openstack overcloud ceph-upgrade run
command to perform an update to a containerized Red Hat Ceph Storage 3 cluster.
Currently, the following combinations of Ansible with ceph-ansible
are supported:
-
ansible-2.6
withceph-ansible-3.2
-
ansible-2.4
withceph-ansible-3.1
If your environment has ansible-2.6
with ceph-ansible-3.1
, run the following commands to update ceph-ansible
to the newest version:
# subscription-manager repos --enable=rhel-7-server-rhceph-3-tools-rpms # subscription-manager repos --enable=rhel-7-server-ansible-2.6-rpms # yum update ceph-ansible
Procedure
Source the
stackrc
file:$ source ~/stackrc
Run the update command:
$ openstack overcloud update run --nodes ComputeHCI
- Wait until the node update completes.
Run the Ceph Storage update command. For example:
$ openstack overcloud ceph-upgrade run \ --templates \ -e <ENVIRONMENT FILE> \ -e /home/stack/templates/overcloud_images.yaml
Include the following options relevant to your environment:
-
Custom configuration environment files (
-e
) -
The environment file with your container image locations (
-e
). Note that the update command might display a warning about using the--container-registry-file
. You can ignore this warning as this option is deprecated in favor of using-e
for the container image environment file. -
If applicable, your custom roles (
roles_data
) file (--roles-file
) -
If applicable, your composable network (
network_data
) file (--networks-file
)
-
Custom configuration environment files (
- Wait until the Compute HCI node update completes.
3.6. Updating all Ceph Storage nodes
This process updates the Ceph Storage nodes. The process involves:
-
Running the
openstack overcloud update run
command and including the--nodes CephStorage
option to restrict operations to the Ceph Storage nodes only. -
Running the
openstack overcloud external-update run
command to runceph-ansible
as an external process and update the Red Hat Ceph Storage 3 containers.
Procedure
Source the
stackrc
file:$ source ~/stackrc
Run the update command:
$ openstack overcloud update run --nodes CephStorage
- Wait until the node update completes.
Run the Ceph Storage container update command:
$ openstack overcloud external-update run --tags ceph
- Wait until the Ceph Storage container update completes.
3.7. Performing online database updates
Some overcloud components require an online upgrade (or migration) of their databases tables. This involves executing the online_upgrade
external update process. To execute this process, run the openstack overcloud external-update run
command against tasks tagged with the online_upgrade
tag. This performs online database updates to the following components:
- OpenStack Block Storage (cinder)
- OpenStack Compute (nova)
Procedure
Source the
stackrc
file:$ source ~/stackrc
Run the
openstack overcloud external-update run
command against tasks tagged with theonline_upgrade
tag:$ openstack overcloud external-update run --tags online_upgrade
3.8. Finalizing the update
The update requires a final step to update the overcloud stack. This ensures the stack’s resource structure aligns with a regular deployment of OpenStack Platform 15 and allows you to perform standard openstack overcloud deploy
functions in the future.
Procedure
Source the
stackrc
file:$ source ~/stackrc
Run the update finalization command:
$ openstack overcloud update converge \ --templates \ -e <ENVIRONMENT FILE> \ -e <ENVIRONMENT FILE> \ ...
Include the following options relevant to your environment:
-
Custom configuration environment files (
-e
). -
If applicable, your custom roles (
roles_data
) file (--roles-file
) -
If applicable, your composable network (
network_data
) file (--networks-file
)
-
Custom configuration environment files (
- Wait until the update finalization completes.