Upgrading Contrail Software from Release 2.21 or Greater to Release 3.0

Use the following procedure to upgrade an installation of Contrail software from one release to a more recent release. This procedure is valid for Contrail Release 2.21 and later.

Note: If you are installing Contrail for the first time, refer to the full documentation and installation instructions in Installing the Operating System and Contrail Packages.

Instructions are given for both CentOS and Ubuntu versions. The only Ubuntu versions supported for upgrading are Ubuntu 12.04 and 14.04.2.

To upgrade Contrail software from Contrail Release 2.21 or later:

1. Download the contrail-install-packages-x.xx-xxx.xxx.noarch.rpm | deb file from https://www.juniper.net/support/downloads/?p=contrail#sw and copy it to the /tmp directory on the config node, as follows:

   CentOS : scp <id@server>:/path/to/contrail-install-packages-x.xx-xxx.xxx.noarch.rpm /tmp

   Ubuntu : scp <id@server>:/path/to/contrail-install-packages-x.xx-xx~havana_all.deb /tmp

   Note: The variables xxx.-xxx and so on represent the release and build numbers that are present in the name of the installation packages that you download.

2. Install the contrail-install-packages, using the correct command for your operating system:

   CentOS: yum localinstall /tmp/contrail-install-packages-x.xx-xxx.xxx..noarch.rpm

   Ubuntu: dpkg –i /tmp/contrail-install-packages_x.xx-xxx~icehouse_all.deb

3. Set up the local repository by running the setup.sh:

   cd /opt/contrail/contrail_packages; ./setup.sh

4. Ensure that the testbed.py file that was used to set up the cluster with Contrail is intact in the /opt/contrail/utils/fabfile/testbeds/ directory.
   • Ensure that the testbed.py file has been set up with a combined control_data section (required in Contrail Release 1.10 and later).

   See Setting Up the Testbed Definitions File.

5. In release packages prior to Contrail Release 3.0, the packaged Cassandra version is 1.2.11. In the 3.0 release, the packaged Cassandra version is 2.1.9. Upgrading Cassandra from 1.2.11 to 2.1.9 is not supported by Cassandra. For more information, refer to DataStax Upgrade Guide, Cassandra 2.1.x restrictions.

   Consequently, during the Contrail upgrade procedure (fab upgrade_contrail), the Cassandra SSTables are upgraded, which takes a long time if the Cassandra data is huge (usually because the Contrail Analytics keyspace is huge).

   There is an option to minimize upgrade down time by dropping the Contrail Analytics keyspace before the upgrade, by issuing the following fab command:

   fab drop_analytics_keyspace

6. Upgrade the software, using the correct set of commands to match your operating system and vRouter, as described in the following:

   Change directory to the utils folder:

   cd /opt/contrail/utils; \

   Select the correct upgrade procedure from the following to match your operating system and vRouter. In the following, <from> refers to the currently installed release number, such as 2.0, 2.01, 2.1, or 2.2:

   CentOS Upgrade Procedure:

   fab upgrade_contrail:<from>,/tmp/contrail-install-packages-x.xx-xxx.xxx.noarch.rpm;

   Ubuntu 12.04 Procedure:

   fab upgrade_contrail:<from>,/tmp/contrail-install-packages-x.xx-xxx~icehouse_all.deb;

   Ubuntu 14.04 Upgrade, Two Procedures:

   There are two different upgrade procedures for the upgrade to Contrail Release 3.0, depending on which vRouter (contrail-vrouter-3.13.0-35-generic or contrail-vrouter-dkms) is installed in your current setup.

   In Contrail Release 3.0 and later, the recommended kernel version for an Ubuntu 14.04-based system is 3.13.0-40. Both procedures can use the command fab upgrade_kernel_all to upgrade the kernel.

   Ubuntu 14.04 Upgrade Procedure For a System With contrail-vrouter-3.13.0-35-generic:

   Use the following upgrade procedure for Contrail Release 3.0 systems based on Ubuntu 14.04 with the contrail-vrouter-3.13.0-35-generic installed. The command sequence upgrades the kernel version and also reboots the compute nodes when finished.

   fab install_pkg_all:/tmp/contrail-install-packages-x.xx-xxx~icehouse_all.deb;

   fab migrate_compute_kernel;

   fab upgrade_contrail:<from>,/tmp/contrail-install-packages-x.xx-xxx~icehouse_all.deb;

   fab upgrade_kernel_all;

   fab restart_openstack_compute;

   Ubuntu 14.04 Upgrade Procedure For System with contrail-vrouter-dkms:

   Use the following upgrade procedure for Contrail Release 3.0 systems based on Ubuntu 14.04 with contrail-vrouter-dkms installed. The command sequence upgrades the kernel version and also reboots the compute nodes when finished.

   fab upgrade_contrail: <from>,/tmp/contrail-install-packages-x.xx-xxx~icehouse_all.deb;

   All nodes in the cluster can be upgraded to kernel version 3.13.0-40 by using the following fab command​:

   fab upgrade_kernel_all

7. (For Contrail Storage option, only.)

   Contrail Storage has its own packages.

   To upgrade Contrail Storage, download the file:

   contrail-storage-packages_x.x-xx*.deb

   from https://www.juniper.net/support/downloads/?p=contrail#sw

   and copy it to the /tmp directory on the config node, as follows:

   Ubuntu: scp <id@server>:/path/to/contrail-storage-packages_x.x-xx*.deb /tmp​

   Note: Use only Icehouse packages (for example, contrail-storage-packages_2.0-22~icehouse_all.deb) because OpenStack Havana is no longer supported.

   Use the following statement to upgrade the software:

   ​cd /opt/contrail/utils; \

   Ubuntu: fab upgrade_storage:<from>,/tmp/contrail-storage-packages_2.0-22~icehouse_all.deb;