Help us improve your experience.

Let us know what you think.

Do you have time for a two-minute survey?

Navigation
Guide That Contains This Content
[+] Expand All
[-] Collapse All

    Installing the Contrail Packages, Part One (CentOS or Ubuntu)

    This procedure includes instructions for installing Contrail for either a CentOS-based system or an Ubuntu-based system. In each step, be sure to follow the instructions for your operating system type.

    All installation files are available from https://www.juniper.net/support/downloads/?p=contrail#sw .

    CentOS Systems

    Contrail packages for CentOS are provided either as part of the Contrail ISO installation or separately in an RPM file with the format: contrail-install-packages-1.xx-xxx~openstack_version.el6.noarch.rpm, where xx-xxx~openstack_version represents the release number, build number, and OpenStack common version name (such as Havana or Icehouse) for the included Contrail install packages.

    If you already have a compatible operating system installed, you can choose to copy only the Contrail packages after the base operating system installation is complete. The base operating system can be installed using netboot or a USB, using installation instructions for that operating system.

    Ubuntu Systems

    Contrail packages for Ubuntu are provided only as packages in a Debian file of the format: contrail-install-packages-1.xx-xxx~openstack_version_all.deb, where xx-xxx~openstack_version represents the release number, build number, and OpenStack common version name (such as Havana or Icehouse) for the included Contrail install packages.

    It is expected that you already have a compatible Ubuntu operating system installed, such as Ubuntu12.04.3 LTS, kernel version 3.13.0-2934 generic, before installing the Contrail packages.

    Note: the stock kernel version as part of 12.04.3 or 12.04.4 LTS is older than 3.13.0-34. In such cases, the following Fabric task can be used to upgrade the kernel version to 3.13.0-34 in all nodes.

    cd /opt/contrail/utils; fab upgrade_kernel_all

    Installing Contrail Packages for CentOS or Ubuntu

    This procedure provides instructions for installing Contrail packages onto either a CentOS-based system or an Ubuntu-based system.

    1. Ensure that a compatible base operating system has been installed, using the installation instructions for that system.
    2. Download the appropriate Contrail install packages file from https://www.juniper.net/support/downloads/?p=contrail#sw :

      CentOS: contrail-install-packages-1.xx-xxx~openstack_version.el6.noarch.rpm

      Ubuntu: contrail-install-packages-1.xx-xxx~openstack_version_all.deb

    3. Copy the downloaded Contrail install packages file to /tmp/ on the first server for your system installation.
    4. On one of the config nodes in your cluster, copy the Contrail packages as follows:

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

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

    5. Install the Contrail packages:

      CentOS: yum localinstall /tmp/contrail-install-packages-1.xx-xxx~openstack_version.el6.noarch.rpm

      Ubuntu: dpkg -i /tmp/contrail-install-packages-1.xx-xxx~openstack_version_all.deb

    6. Run the setup.sh script. This step will create the Contrail packages repository as well as the Fabric utilities (located in /opt/contrail/utils) needed for provisioning:
      cd /opt/contrail/contrail_packages;   ./setup.sh  
    7. Populate the testbed.py definitions file, see Populating the Testbed Definitions File.

    Note: As of Contrail Release 1.10, Apache ZooKeeper resides on the database node. Because a ZooKeeper ensemble operates most effectively with an uneven number of nodes, it is required to have an uneven number (3, 5, 7, and so on) of database nodes in a Contrail system.

    Modified: 2015-09-02