Help us improve your experience.

Let us know what you think.

Do you have time for a two-minute survey?


Upgrading Contrail Networking using contrail-ansible Deployer

Take snapshots of your current configurations before you proceed with the upgrade process. For details, refer to How to Backup and Restore Contrail Databases in JSON Format in Openstack Environments Using the Openstack 13 or Ansible Deployers.


This procedure can be used for Contrail Networking upgrades to Contrail Networking Release 2003 or earlier.

If you are upgrading to Contrail Networking Release 2005 or later using the Ansible deployer, see How to Perform a Zero Impact Contrail Networking Upgrade using the Ansible Deployer.

Use the following procedure to upgrade Contrail Networking using contrail-ansible deployer.

The procedure supports incremental model and you can use it to upgrade from Contrail Networking Release N-1 to N.

  1. Navigate to the directory where the contrail-ansible-deployer-<xxxx>.<NN>.tgz was untarred.

    See Sample instances.yml File.

    Example using Contrail Networking Release 2003:

    cd contrail-ansible-deployer-2003.33/contrail-ansible-deployer/config/

    vi contrail-ansible-deployer-2003.33/contrail-ansible-deployer/config/instances.yaml

    Sample instances.yaml files for various other deployments are available at the same directory.

  2. Update CONTRAIL_VERSION and CONTRAIL_CONTAINER_TAG to the desired version tag in this instances.yml file.

    Access CONTRAIL_CONTAINER_TAG located at README Access to Contrail Networking Registry 20xx.

    For example:

  3. Run the following commands from contrail-ansible-deployer directory.
    • For Contrail with OpenStack deployment:

      cd contrail-ansible-deployeransible-playbook -e orchestrator=openstack -i inventory/ playbooks/install_openstack.yml -vansible-playbook -e orchestrator=openstack -i inventory/ playbooks/install_contrail.yml -v

    • For Contrail with Kubernetes deployment:

      cd contrail-ansible-deployeransible-playbook -e orchestrator=kubernetes -i inventory/ playbooks/install_k8s.yml -vansible-playbook -e orchestrator=kubernetes -i inventory/ playbooks/install_contrail.yml -v

The ansible playbook logs are available on the terminal during execution. You can also access it at /var/log/ansible.log.