Rate and give feedback:  Feedback Received. Thank You!

Rate and give feedback: 

X

This document helped resolve my issue

Yes No

Additional Comments

800 characters remaining

May we contact you if necessary?

Name:  

E-mail: 

Enter a valid Email ID

Need product assistance? Contact Juniper Support

Submit

This site is protected by hCaptcha and its Privacy Policy and Terms of Service apply.

English  

English

Upgrading Contrail Software

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

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 version supported for upgrading is Ubuntu 14.04.2.

To upgrade Contrail software from Contrail Releases 2.21 and later to Release 3.1:

1. Download the contrail-install-packages-x.x.x.x-xxnoarch.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.x.x.x-xxnoarch.rpm /tmp

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

   Note: The variables x.x.x.x-xx 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.x.x.x-xx.noarch.rpm

   Ubuntu: dpkg –i /tmp/contrail-install-packages_x.x.x.x-xx~_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.

   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 directly is not supported by Cassandra. For more information, refer to DataStax Upgrade Guide, Cassandra 2.1.x restrictions.

   The fab upgrade_contrail command sequence enables upgrading Cassandra from 1.2.11 to 2.1.9 by performing necessary intermediate upgrades. 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.21.2, 2.22.2, 3.0.2.0, and so on:

   CentOS Upgrade Procedure:

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

   Ubuntu 14.04 Upgrade, Two Procedures:

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

   In Contrail Release 3.0.2.0 and later, the recommended kernel version for an Ubuntu 14.04-based system is 3.13.0-85-. 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-X-generic:

   Use the following upgrade procedure for Contrail systems based on Ubuntu 14.04 without the contrail-vrouter-3.13.0-85-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.x.x.x-xx~<openstack_version>_all.deb;

   fab migrate_compute_kernel;

   fab upgrade_contrail:<from>,/tmp/contrail-install-packages-x.x.x.x-xx~<openstack_version>_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 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.x.x.x-xx~<openstack_version>_all.deb;

   All nodes in the cluster can be upgraded to kernel version 3.13.0-85 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.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.x.x-xx*.deb /tmp​

   Use the following statement to upgrade the software:

   ​cd /opt/contrail/utils; \

   Ubuntu: fab upgrade_storage:<from>,/tmp/contrail-storage-packages_x.x.x.x-xx~<openstack_version>_all.deb;