Help us improve your experience.

Let us know what you think.

Do you have time for a two-minute survey?

Upgrade Contrail Service Orchestration from Release 5.1.1 to Release 5.1.2


Follow this procedure to upgrade from CSO Release 5.1.1 to CSO Release 5.1.2.

Take snapshot of your current configuration and VMs from your hypervisor management utility before you proceed with the upgrade process.

You can roll back to the previous CSO release if the upgrade is unsuccessful, provided you have taken snapshots of the VMs.

Upgrade Contrail Service Orchestration


You must have at least 40 GB in the /root directory to run the upgrade script.

You must not delete previously installed CSO 5.1.1 folder from the startupserver VM.

Follow this procedure to upgrade from CSO Release 5.1.1 to CSO Release 5.1.2.

  1. Download the CSO Release 5.1.2 installer package from the CSO Downloads page to the startupserver_1 VM.
  2. Log in to the startupserver_1 VM as root.
  3. On the startupserver_1 VM, extract the installer package.

    For example, if the name of the installer package is Contrail_Service_Orchestration_5.1.2.tar.gz,

    root@host:~/# tar –xvzf Contrail_Service_Orchestration_5.1.2.tar.gz

    The contents of the installer package are extracted in a directory with the same name as the installer package.

  4. Navigate to the CSO Release 5.1.2 directory in the startupserver_1 VM.
    root@host:~/# cd Contrail_Service_Orchestration_5.1.2
  5. You can view the list of files in the Contrail_Service_Orchestration_5.1.2.
    root@host:~/Contrail_Service_Orchestration_5.1.2# ls

    The file includes the script.

  6. Run the script.Warning

    Before you upgrade ensure that all ongoing jobs in Administration Portal and Customer Portal are stopped; otherwise, the upgrade process will fail.

    root@host:~/Contrail_Service_Orchestration_5.1.2# ./

    Depending on your deployment, it may take up to 60 minutes to complete this task.

    You can view the upgrade.log file which is available at root/Contrail_Service_Orchestration_5.1.2/logs folder.

    If an error occurs, you must fix the error and re-run the script. When you re-run the script, the script continues to execute from the previously failed step.

    If it fails after 2 attempts, contact Juniper Networks support for further assistance.

    You can run ./ deploy_manager/utils/ command to decrypt the passwords for each infrastructure component.

After a successful upgrade, CSO is functional and you can log in to the Administrator Portal and the Customer Portal.