Help us improve your experience.

Let us know what you think.

Do you have time for a two-minute survey?

 

Upgrading Contrail Service Orchestration Overview

 

If your installed version is Contrail Service Orchestration (CSO) Release 3.2.1, you can use a script to directly upgrade to CSO Release 3.3.

Note

You can upgrade to CSO Release 3.3 only from CSO Release 3.2.1. If your installed version of CSO is not Release 3.2.1, then you must perform a fresh installation of CSO 3.3.

You can roll back to CSO Release 3.2.1, if the upgrade is unsuccessful.

To upgrade to CSO Release 3.3, you must run the scripts that are available in the Contrail_Service_Orchestration_3.3.tar.gz file in the following order:

  1. upgrade.sh—This script upgrades CSO software from Release 3.2.1 to Release 3.3. The upgrade.sh script, puts CSO in maintenance mode, takes a snapshot of all VMs so that you can roll back to the previous release if the upgrade fails (optional), upgrades all microservices and infrastructure components if required, performs health checks at various levels, validates if all VMs, infracomponents, and microservices are up and running, and puts the CSO in live mode.

    Note

    Before you upgrade ensure that all ongoing jobs are stopped; otherwise during the upgrade the ongoing jobs are stopped. During the upgrade, you experience a downtime as CSO goes into maintenance mode.

  2. revert.sh—Run this script only if the upgrade fails and if you have taken a snapshot of all VMs. This script reverts to the previously installed version.

Figure 1: High-level Overview of Upgrading to CSO Release 3.3
High-level Overview of Upgrading to CSO Release 3.3

Upgrade to CSO Release 3.3 is independent of the deployment type (HA and non- HA), environment type (trial or production), infrastructure components and microservices used, and the hypervisor type (KVM or VMware ESXi).

To ensure a smooth upgrade, the scripts perform a number of health checks before and after the upgrade. Health checks are performed to determine the operational condition of all components, the host, and VMs. If there is an error during the health check, the upgrade process is paused. You can rerun the script to rectify the error that you encounter.

Following are the types of health checks that are performed:

  • Component Health Checks—Checks the operational condition of the infrastructure components and microservices.

  • System Health Checks—Checks the following parameters of VMs and the host machine.

    • Available space on the host machine and VMs

    • Operating System (OS) version of the host machine and VMs

    • Kernel version of the host machine and VMs

    • Disk space on the host machine and VMs

Limitations

Upgrade to CSO Release 3.3 has the following limitations:

  • The upgrade is applicable only to CSO software and is not applicable to the existing devices and sites in CSO. After a successful upgrade, the existing sites and devices continue to have the same functionality of the previously installed version, that is, CSO Release 3.2.1.

  • There are no changes to the device image or device configurations.

Impact of the CSO Upgrade

Table 1 describes the impact of the CSO upgrade to Release 3.3.

Table 1: Impact of the CSO Upgrade

Feature

After the Upgrade

Security Management

  • Release 3.3 security management-related features is supported on devices that are onboarded in Release 3.2.1.

SD-WAN

  • For the Application Visibility feature, the trend data is reset after the upgrade. You can access the Release 3.2.1 trend data through the REST APIs.

  • The Application Quality of Experience (AppQoE) feature works only for the tenants that you create in Release 3.3. For more information on AppQoE, see Application Quality of Experience (AppQoE) Overview in the Contrail Service Orchestration User Guide.

  • Device Management functions work for Release 3.2.1 sites.

Cloud CPE

  • All functionalities of centralized and distributed deployments continues to work on Release 3.2.1 sites or devices that are onboarded in Release 3.2.1.

  • Multi-region support for centralized deployment is not supported on Release 3.2.1 sites or devices that are onboarded in Release 3.2.1.

  • Device Management functions work for Release 3.2.1 sites.

  • High availability (HA) for VRRs are not supported for sites that are created in Release 3.2.1.