Upgrading OpenSDN using In-Place Upgrade Procedure

date:

2021-01-19

Note

This procedure can be used for OpenSDN upgrades to OpenSDN Release 2003 or earlier only.

If you are upgrading to OpenSDN Release 2005 or later using an in-place upgrade procedure, see How to Perform a Zero Impact OpenSDN Upgrade using the Ansible Deployer.

This document provides steps to upgrade OpenSDN using in-place upgrade procedure.

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

Tip

You must take snapshots of your current system before proceeding with the upgrade process.

For a list of supported platforms for all OpenSDN releases, see OpenSDN Supported Platforms List  .

  1. Update kernel version on all the compute nodes.

    yum -y update kernel*

    Note

    You must not update kernel version if you are upgrading from Contrail Networking Release 1910 to Release 1911.

  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 OpenSDN Registry 20xx  .

  3. Run the following commands from contrail-ansible-deployer directory.

    For OpenSDN with OpenStack deployment:

    cd contrail-ansible-deployer
    ansible-playbook -i inventory/ -e orchestrator=openstack playbooks/configure_instances.yml
    ansible-playbook -e orchestrator=openstack -i inventory/ playbooks/install_contrail.yml

  4. Reboot the compute node.

  5. Check the status of Contrail service on the compute node.

    All services must be active .

    sudo contrail-status

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