Help us improve your experience.

Let us know what you think.

Do you have time for a two-minute survey?

 
 

Upgrade to Contrail Cloud v16.2

The procedure below guides you through the upgrade to Contrail Cloud v16.2. This delivers upgraded Contrail containers, Red Hat RHEL/RHOSP/storage content, and kernel version.

Note:

There will be a major disruption in service during the upgrade. Whole services will be taken down during the upgrade process. Plan for a long period of disruption for the upgrade process to complete. The upgrade preserves existing overcloud configurations. For example: images, projects, networks, volumes, virtual machines, and so on.

As the contrail user, (su - contrail from root), run the following scripts in the CLI from the jump host:

  1. Upgrade the Jump host
    Run the contrail-cloud-upgrade-jumphost.sh script to upgrade the jump host from RHEL 7.9 to 8.2.

    The contrail-cloud-upgrade-jumphost.sh script run is interrupted during the leapp upgrade. The jump host reboots as part of the leapp upgrade process, and you must rerun the script after each subsequent reboot:

    Perform the following steps after the reboot from the previous script run:
    1. Enter the uname -a command to check that the kernel information is correct. From the jump host CLI:
    2. Enter the cat /etc/redhat-release command to verify that your RHEL version is now RHEL v8.2. From the jump host CLI:
    3. Rerun the script for a second time after the jump host reboot and version verification:
      This will:
      • Update the packages and containers on the jump host.
    4. Rerun the script for a third and final time after the jump host reboots:
      This will:
      • perform a yum cleanup on the jump host.
  2. Upgrade the Undercloud
    Run this script to upgrade the undercloud virtual machine (VM) on the jump host. This process also prepares the undercloud for the overcloud upgrade, pulls new images, and redeploys the undercloud services into containers.

    This will:

    • Update the packages and containers on the undercloud VM.
    • Update Red Hat OpenStack Platform Director on the undercloud VM, and organize registry with overcloud containers.
    • Update image on the undercloud VM used to provision all new overcloud role instances.
      • overcloud-image-full is upgraded and used to provision any new overcloud role instance.
  3. Prepare Contrail Cloud for the upgrade.
    Run this script to upgrade your network configurations, prepare new scripts for reregistration, and prepare the RHOSP control plane for upgrade.

    This will:

    • Disable STONITH.
    • Resync Leapp files.
    • Applies fixes for the overcloud which align node configuration for upgrade.
  4. Prepare the Overcloud and RHOSP control plane for the upgrade.
    Run the script to prepare the RHOSP control plane and OpenStack overcloud for upgrade.

    This will:

    • Runs openstack overcloud upgrade prepare to generate the necessary Ansible configurations for overcloud upgrade.
  5. Run the overcloud batch upgrades.

    Run the upgrade script for each named batch until all batches have successfully upgraded and there are no longer any named batches left to process. The script will not automatically go through all named batches in one run. You must manually run the upgrade script for each unique named batch.

    The overcloud upgrade (contrail-cloud-upgrade-overcloud-step2.sh) will:
    • Upgrade all nodes as defined in the upgrade_plan['batches'][<batch>]['nodes_list'] and is configured in the config/site.yml file.
    • Upgrade node packages and containers according to the batch upgrade_type.
      • Parallel = all at the same time.
      • Sequence = one at a time
    • Upgrade one batch per script run, as configured in the upgrade_plan.
    • Automatically create a lockfile when the batch has been processed. This is how the script knows to move on to the next batch the next time the script is run.
    • You rerun the script until there are no longer any batches left to upgrade.
  6. Converge the Overcloud Upgrade
    Run this script to converge the overcloud heat stack, and then upgrade Ceph from Version 3 to Version 4 (if Ceph is enabled).

    This will:

    • Ensure that the stack resource structure aligns with the new packages and configurations.
    • Converge the overcloud and runs openstack overcloud upgrade converge to complete the task.
    • Upgrade the Ceph cluster configuration and runs openstack overcloud external-upgrade run –tags ceph to complete the task.
    • Finalize the overcloud update.

Related Documentation