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.
- Ensure that a compatible base operating system has been installed, using the installation instructions for that system.
- 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
- Copy the downloaded Contrail install packages file to
/tmp/on the first server for your system installation. - 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
- 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
- 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
- Populate the
testbed.pydefinitions 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. |
