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.
Red Hat users: To integrate Red Hat OpenStack with Contrail nodes, see: Installing Contrail with Red Hat OpenStack.
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-x.xx-xxx~openstack_version.el6.noarch.rpm, where x.xx-xxx~openstack_version represents the release number, build number, and OpenStack common version name 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-x.xx-xxx~openstack_version_all.deb, where x.xx-xxx~openstack_version represents the release number, build number, and OpenStack common version name for the included Contrail install packages.
It is expected that you already have a compatible Ubuntu operating system installed before installing the Contrail packages. For more information, see Supported Platforms.
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-x.xx-xxx~openstack_version.el6.noarch.rpm
Ubuntu: contrail-install-packages-x.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-x.xx-xxx~openstack_version.el6.noarch.rpm /tmp
Ubuntu: scp <id@server>:/path/to/contrail-install-packages-x.xx-xxx~openstack_version_all.deb /tmp
- Install the Contrail packages:
CentOS: yum localinstall /tmp/contrail-install-packages-x.xx-xxx~openstack_version.el6.noarch.rpm
Ubuntu: dpkg -i /tmp/contrail-install-packages-x.xx-xxx~openstack_version_all.deb
- Run the setup.sh script. This
step creates 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 Setting Up the Testbed Definitions File.
 | Note: In Contrail, Apache ZooKeeper resides on the database node. Because a ZooKeeper ensemble operates most effectively with an odd number of nodes, it is required to have an odd number (3, 5, 7, and so on) of database nodes in a Contrail system. |
