Chapter 3. Updating the Overcloud

Procedure

1. Source the stackrc file:

   $ source ~/stackrc

   Copy to Clipboard Toggle word wrap

2. Run the update preparation command:

   $ openstack overcloud update prepare \
       --templates \
       -r <ROLES DATA FILE> \
       -n <NETWORK DATA FILE> \
       -e <ENVIRONMENT FILE> \
       -e <ENVIRONMENT FILE> \
       ...

   Copy to Clipboard Toggle word wrap

   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)
3. Wait until the update preparation completes.

Procedure

1. Source the stackrc file:

   $ source ~/stackrc

   Copy to Clipboard Toggle word wrap

2. Run the openstack overcloud external-update run command against tasks tagged with the container_image_prepare tag:

   $ openstack overcloud external-update run --tags container_image_prepare

   Copy to Clipboard Toggle word wrap

Procedure

1. Source the stackrc file:

   $ source ~/stackrc

   Copy to Clipboard Toggle word wrap

2. Run the update command:

   $ openstack overcloud update run --nodes Controller

   Copy to Clipboard Toggle word wrap
3. Wait until the Controller node update completes.

Procedure

1. Source the stackrc file:

   $ source ~/stackrc

   Copy to Clipboard Toggle word wrap

2. Run the update command:

   $ openstack overcloud update run --nodes Compute

   Copy to Clipboard Toggle word wrap
3. Wait until the Compute node update completes.

Procedure

1. Source the stackrc file:

   $ source ~/stackrc

   Copy to Clipboard Toggle word wrap

2. Run the update command:

   $ openstack overcloud update run --nodes ComputeHCI

   Copy to Clipboard Toggle word wrap
3. Wait until the node update completes.

4. Run the Ceph Storage update command. For example:

   $ openstack overcloud ceph-upgrade run \
       --templates \
       -e <ENVIRONMENT FILE> \
       -e /home/stack/templates/overcloud_images.yaml

   Copy to Clipboard Toggle word wrap

   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)
5. Wait until the Compute HCI node update completes.

Procedure

1. Source the stackrc file:

   $ source ~/stackrc

   Copy to Clipboard Toggle word wrap

2. Run the update command:

   $ openstack overcloud update run --nodes CephStorage

   Copy to Clipboard Toggle word wrap
3. Wait until the node update completes.

4. Run the Ceph Storage container update command:

   $ openstack overcloud external-update run --tags ceph

   Copy to Clipboard Toggle word wrap
5. Wait until the Ceph Storage container update completes.

Procedure

1. Source the stackrc file:

   $ source ~/stackrc

   Copy to Clipboard Toggle word wrap

2. Run the openstack overcloud external-update run command against tasks tagged with the online_upgrade tag:

   $ openstack overcloud external-update run --tags online_upgrade

   Copy to Clipboard Toggle word wrap

Procedure

1. Source the stackrc file:

   $ source ~/stackrc

   Copy to Clipboard Toggle word wrap

2. Run the update finalization command:

   $ openstack overcloud update converge \
       --templates \
       -e <ENVIRONMENT FILE> \
       -e <ENVIRONMENT FILE> \
       ...

   Copy to Clipboard Toggle word wrap

   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)
3. Wait until the update finalization completes.