Help us improve your experience.

Let us know what you think.

Do you have time for a two-minute survey?

 

Upgrade Instructions

 

Instructions for upgrading to Contrail Cloud Release 13.0.2 from Contrail Cloud Release 13.0.1.

Upgrade from Contrail Cloud Release 13.0.1 to 13.0.2

Upgrade to Contrail Cloud Release 13.0.2 to apply the updated containers that are delivered with Contrail Networking 5.0.2. This update restarts each instance of overcloud roles, one-by-one, so there is a small disruption in service during the update. However, the update preserves existing overcloud configurations. For example: images, projects, networks, volumes, virtual machines, and so on.

To update Contrail Cloud to 13.0.2:

  1. Ensure that the overcloud is fully functional and that all services are active.
  2. Review the config/site.yml.
    1. Remove any overcloud.registry configuration

    2. Validate that the control host storage allocations use defined storage pools. If the defaults were not used then it might be necessary to adjust the control-host configuration.

  3. Review the config/overcloud-nics.yml, config/control-host-nodes.yml, and config/appformix-nodes.yml to rename all instances of ControlInterfaceDefaultRoute to ControlPlaneDefaultRoute.
  4. Send an email message to contrail_cloud_subscriptions@juniper.net to coordinate the deployment activation key from Contrail Cloud 13.0.1 to Contrail Cloud 13.0.2. An update script cc-update.sh is then provided.
  5. Download the cc-update.sh script to /var/lib/contrail_cloud/scripts/cc-upgrade.sh on the jumphost. Make this file executable:
  6. As the “Contrail” user, execute the following script on the jumphost to perform the update:/var/lib/contrail_cloud/scripts/cc-upgrade.sh.

Workaround for DPDK Compute Nodes

The update script does not update the contrail-vrouter-agent-dpdk container on the DPDK compute nodes.

Use the instructions below to update the Contrail Cloud 13.0.2 DPDK compute nodes:

  1. For each DPDK compute node, update /etc/sysconfig/network-scripts/network-functions-vrouter-dpdk-env to the following:
  2. Restart the vhost0 interface for the changes to take effect.

Workaround for Kernel vRouter Compute Nodes

The update script does not update the contrail-vrouter-kernel-init container on the kernel compute nodes.

Use the instructions below to update the Contrail Cloud 13.0.2 kernel vRouter compute nodes:

  1. For each kernel vRouter compute node, pull the latest Docker image:
  2. Find the docker image ID:
  3. Run the init container:
  4. Restart the vRouter agent and vhost0 interface:
  5. Reboot to apply the updates: