Updating Contrail Networking Containers Without Updating OpenStack

When to Use This Procedure

This procedure is used to upgrade Contrail Networking when it is running in environments using RHOSP version 16.2 (RHOSP16.2). RHOSP16.2 is not updated during this procedure.

The procedure in this document has been validated for the following Contrail Networking upgrade scenarios:

Prerequisites

This document makes the following assumptions about your environment:

• A Contrail Networking deployment using Red Hat Openstack version 16.2 (RHOSP16.2) as the orchestration platform is already operational.

• The overcloud nodes in the RHOSP16.2 environment have an enabled Red Hat Enterprise Linux (RHEL) subscription.

• Your environment is running Contrail Networking Release 21.4 and upgrading to Contrail Networking Release 21.4.L1 or later.

Before You Begin

We recommend performing these procedures before starting the update:

• Backup your Contrail configuration database before starting this procedure. See How to Backup and Restore Contrail Databases in JSON Format in Openstack Environments Using the Openstack 16.1 Director Deployment.

• Each compute node agent will go down during this procedure, causing some compute node downtime. The estimated downtime for a compute node varies by environment, but typically took between 12 and 15 minutes in our testing environments.

  If you have compute nodes with workloads that cannot tolerate this downtime, consider migrating workloads or taking other steps to accommodate this downtime in your environment.

Updating Contrail Networking

1. Register your nodes with the Contrail Networking Release 21.4 satellite key.
2. Prepare your container registry. The registry is often included in the undercloud, but it can also be a separate node.
3. Backup the Contrail TripleO Heat Templates. See Using the Contrail Heat Template.
4. Get the Contrail TripleO Heat Templates (stable/queens branch) from https://github.com/Juniper/contrail-tripleo-heat-templates.

   Prepare the new tripleo-heat-templates with latest available software from Openstack and Contrail Networking.
5. Update the parameter ContrailImageTag to the new version.

   The location of the ContrailImageTag variable varies by environment. In the most commonly-used environments, this variable is set in the contrail-services.yaml file.

   You can obtain the ContrailImageTag parameter from the README Access to Contrail Registry 21XX  .

   Note

   If you are using the undercloud as a registry, ensure the new contrail image is updated in undercloud before proceeding further.

6. Update the overcloud by entering the openstack overcloud update prepare command and include the files that were updated during the previous steps with the overcloud update.

   Example:
7. If you haven’t already migrated the workloads, migrate the workloads now.
8. Upgrade the Contrail controllers:

   Example:
9. Upgrade the Openstack controller node:
10. Upgrade the Contrail compute nodes:
11. Enter the openstack overcloud update converge command.

    Example:

    The Contrail containers should be up and running after this convergence operation is completed.

12. Confirm that the Contrail containers are up and running.

    There are many methods of performing this step. In this provided example, the contrail-status and podman ps commands are entered on a compute node to verify the Contrail containers on a compute node: