Installing the Contrail Packages, Part Two (CentOS or Ubuntu) — Installing on the Remaining Machines
Preinstallation Checklist
 | Note: This procedure assumes that you have first completed the following procedures: |
And the following system tasks are accomplished:
- All of the servers are time synced.
- All servers can ping from one to another, both on management and on data and control, if part of the system.
- All servers can ssh and scp between one another.
- All host names are resolvable.
- If using CentOS or RHEL, SELinux has been disabled (
/etc/sysconfig/selinux).
Each step in this procedure contains instructions for installing on a CentOS system or an Ubuntu system. Be sure to follow the instructions specific to your operating system.
To copy and install Contrail packages on the remaining machines in your cluster, you can use scp and yum localinstall as on the first server (for CentOS) or scp and dpkg -I (for Ubuntu), as in Installing the Contrail Packages, Part One (CentOS or Ubuntu), or you can use a Fabric utility to copy onto all machines at once, as follows:
- Ensure that the testbed.py file
has been created and populated with information specific to your cluster
at
/opt/contrail/utils/fabfile/testbeds.See Setting Up the Testbed Definitions File.
Note: If you are installing to a CentOS system, to prevent accidental renaming of CentOS interfaces, uncomment the following env.interface_rename statement if it is present in the testbed.py:
#To disable installing contrail interface rename package
#env.interface_rename = False
Uncomment the statement so that it reads:
#To disable installing contrail interface rename package
env.interface_rename = False
- Run Fabric commands to install packages as follows:
CentOS: /opt/contrail/utils/fab install_pkg_all:/tmp/contrail-install-packages-1.xx-xxx~openstack_version..el6.noarch.rpm
Ubuntu: /opt/contrail/utils/fab install_pkg_all:/tmp/contrail-install-packages-1.xx-xxx~openstack_version_all.deb
Note: Fab commands are always run from
/opt/contrail/utils/ - Ubuntu: Always use the Contrail-recommended
kernel version for Ubuntu-based systems. To see the recommended kernel
version, refer to the Platform Support section in the Release Notes
for your version of Contrail.
To get the recommended kernel version installed, use the following fabric-utils command
/opt/contrail/utils/fab upgrade_kernel_all
Note: This step installs the recommended kernel version, as an upgrade or as a downgrade, in all nodes and performs reboot. Reconnect to perform remaining tasks.
- After reboot, install the required Contrail packages in
each node of the cluster:
cd opt/contrail/utils
fab install_contrail
Note: To install Contrail with an existing OpenStack node:
fab install_without_openstack # Script will install nova-compute in the compute node
or
fab install_without_openstack:no # User installs nova-compute in the compute node
- If your installation has multiple interfaces (see Supporting Multiple Interfaces on Servers and Nodes), run setup_interface:
fab setup_interface
- Provision the entire cluster:
fab setup_all
Note: To provision Contrail with an existing OpenStack node, use one of the following:
- fab setup_without_openstack # Script provisions vrouter and nova-compute services in the compute nodes and the compute nodes are rebooted on completion
- fab setup_without_openstack:no # Only vrouter services are provisioned, the nova-compute service is not provisioned and compute nodes are rebooted on completion
- fab setup_without_openstack:no,False # Only vrouter services are provisioned, the nova-compute service is not provisioned and the compute nodes are not rebooted on complet
- CentOS only: Alternatively, if the contrail-install-packages is already installed (as part of installing the Contrail ISO via netboot), follow steps 2, 4, and 5.
When finished, proceed to Configuring the Control Node.
