Upgrading Contrail Service Orchestration Overview

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

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

• 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.