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:
- Ensure that the overcloud is fully functional and that all services are active.
- Review the
config/site.yml.Remove any
overcloud.registryconfigurationValidate 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.
- Review the
config/overcloud-nics.yml,config/control-host-nodes.yml, andconfig/appformix-nodes.ymlto rename all instances ofControlInterfaceDefaultRoutetoControlPlaneDefaultRoute. - 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.shis then provided. - Download the
cc-update.shscript to/var/lib/contrail_cloud/scripts/cc-upgrade.shon the jumphost. Make this file executable:sudo chmod +x /var/lib/contrail_cloud/scripts/cc-upgrade.sh; sudo chown contrail /var/lib/contrail_cloud/scripts/cc-upgrade.sh
- 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:
- For each DPDK compute node, update
/etc/sysconfig/network-scripts/network-functions-vrouter-dpdk-envto the following:#!/bin/bash CONTRAIL_VROUTER_AGENT_DPDK_DOCKER_IMAGE=192.0.2.1:8787/contrail-vrouter-agent -dpdk:5.0.2-0.360-rhel-queens-13.0.2 #CONTRAIL_VROUTER_AGENT_DPDK_DOCKER_IMAGE=192.0.2.1:8787/contrail-vrouter-age nt-dpdk:5.0.1-0.214-rhel-queens CONTRAIL_VROUTER_AGENT_CONTAINER_NAME=contrail-vrouter-agent CONTRAIL_VROUTER_AGENT_DPDK_CONTAINER_NAME=contrail-vrouter-agent-dpdk DPDK_UIO_DRIVER=uio_pci_generic
- Restart the vhost0 interface for the changes to take effect.
sudo ifdown vhost0 sudo ifup vhost0
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:
- For each kernel vRouter compute node, pull the latest
Docker image:
docker pull 192.0.2.1:8787/contrail-vrouter-kernel-init:5.0.2-0.360-rhel-queens-13.0.2
- Find the docker image ID:
docker images | grep ker | grep 360 192.0.2.1:8787/contrail-vrouter-kernel-init 5.0.2-0.360-rhel-queens-13.0.2 17c02b0e122d 4weeks ago 1.6 GB
- Run the init container:
docker run -v /dev:/dev:rw -v /bin:/host/bin:rw -v /lib/modules:/lib/modules:rw -v /etc/sysconfig/network-scripts:/etc/sysconfig/network-scripts:rw 17c02b0e122d
- Restart the vRouter agent and vhost0 interface:
docker stop contrail_vrouter_agent ifdown vhost0 ifup vhost0 docker start contrail_vrouter_agent
- Reboot to apply the updates:
sudo reboot 0