Updating Contrail Networking using the Zero Impact Upgrade Process in an Environment using Red Hat Openstack 13
This document provides the steps needed to update a Contrail Networking deployment that is using Red Hat Openstack 13 as it’s orchestration platform. The procedure provides a zero impact upgrade (ZIU) with minimal disruption to network operations.
If you are using Contrail Networking in an environment that is using a Red Hat Openstack 16-based release, see Updating Contrail Networking using the Zero Impact Upgrade Process in an Environment using Red Hat Openstack 16
When to Use This Procedure
This procedure is used to upgrade Contrail Networking when it is running in environments using RHOSP13.
The procedure in this document has been validated for the following Contrail Networking upgrade scenarios:
Starting Contrail Networking Release |
Target Upgraded Contrail Networking Release |
---|---|
1912.L0 or later 1912.L release |
1912.L1 or later 1912.L release Note:
You can upgrade from any 1912.L release to any other 1912.L release. |
1912.L0 |
2003 |
2003 |
2005 |
2005 |
2008 |
2008 |
2011 |
2011 |
Any 2011.L Release |
Any 2011.L Release |
Any 2011.L Release |
You cannot run Contrail Networking in environments using Red Hat Openstack 13 orchestration using Contrail Networking Release 21-based releases. The first Contrail Networking Release 21-based release is Contrail Networking Release 21.3.
A different procedure is followed for upgrading to earlier target Contrail Networking releases in environments using RHOSP13 orchestration. See Upgrading Contrail Networking with Red Hat Openstack 13 using ISSU.
If you want to use this procedure to upgrade your Contrail Networking release to other releases, you must engage Juniper Networks professional services. Contact your Juniper representative for additional information.
Prerequisites
This document makes the following assumptions about your environment:
A Contrail Networking deployment using Red Hat Openstack version 13 (RHOSP13) as the orchestration platform is already operational.
The overcloud nodes in the RHOSP13 environment have an enabled Red Hat Enterprise Linux (RHEL) subscription.
Your environment is running Contrail Release 1912 and upgrading to Contrail Release 1912-L1 or to Contrail Release 2003 or later.
If you are updating Red Hat Openstack simultaneously with Contrail Networking, we assume that the undercloud node is updated to the latest minor version and that new overcloud images are prepared for an upgrade if needed for the upgrade. See the Upgrading the Undercloud section of the Keeping Red Hat OpenStack Platform Updated guide from Red Hat.
If the undercloud has been updated and a copy of the heat templates are used for the deployment, update the copy of the heat template from the Red Hat’s core heat template collection at
/usr/share/openstack-tripleo-heat-templates
. See the Understanding Heat Templates document from Red Hat for information on this process.
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 13 or Ansible Deployers.
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.
If you are updating Red Hat Openstack simultaneously with Contrail Networking, update Red Hat Openstack to the latest minor release version and ensure that the new overcloud images are prepared for the upgrade. See the Upgrading the Undercloud section of the Keeping Red Hat OpenStack Platform Updated guide from Red Hat for additional information.
If the undercloud has been updated and a copy of the heat templates are used for the deployment, update the Heat templates from Red Hat’s core Heat template collection at
/usr/share/openstack-tripleo-heat-templates
. See the Understanding Heat Templates document from Red Hat for additional information.
Updating Contrail Networking in an Environment using Red Hat Openstack
To update Contrail Networking in an environment that is using Red Hat Openstack as the orchestration platform: