Help us improve your experience.

Let us know what you think.

Do you have time for a two-minute survey?

 
 

Before You Install

  1. Set up an account with Juniper Networks so you can download Contrail manifests, container packages, and tools.
  2. Set up the fabric network and connect your nodes to the fabric.
    The example networks used in this procedure are shown in Figure 1 for single cluster Contrail and in Figure 1 for multi-cluster Contrail.
  3. Download the Contrail Networking Manifests and Tools package (Manifests and Tools) from Juniper Networks and extract it onto the host where you plan on running the installation. This host must be able to reach the cluster nodes.
  4. Configure the cluster nodes.
    1. Install a fresh OS on all servers/VMs that you'll use as cluster nodes. Ensure the OS and kernel versions on the cluster nodes are on the list of supported OSes and kernels (see the Cloud-Native Contrail Networking Supported Platforms matrix at https://www.juniper.net/documentation/en_US/release-independent/contrail-cloud-native/topics/reference/cloud-native-contrail-supported-platforms.pdf).
    2. Configure the OS on each node minimally for the following:
      • static IP address and mask (172.16.0.11/24 through 172.16.0.13/24 in our single cluster example) and gateway
      • access to one or more DNS servers
      • SSH connectivity including root SSH access
      • NTP
      The cluster nodes in our examples are running Ubuntu.
    3. If you're planning on running with a DPDK data plane, prepare each cluster node that is running DPDK.
      For an example on how to do this, see Prepare a Cluster Node for DPDK.
  5. Make sure the cluster nodes are capable of running Contrail.
    1. Locate the preflight.sh script and the manifest that you want to apply from the downloaded package.
    2. Copy the script and the manifest(s) you plan on using to every node in the cluster. You're not applying the manifest yet. You're just making the manifest available for the preflight.sh script to read.
    3. Log in as root to each node in the cluster and run the script.

      where <deployer-manifest>.yaml is the name of the manifest(s) that you plan to apply to this node.

      The script checks to make sure that the node is capable of supporting the resources required by the <deployer-manifest>.yaml file. Address any errors flagged by the script before proceeding.

  6. Install contrailstatus on the machine where you plan on running kubectl. Contrailstatus is a kubectl plug-in you can use to query Contrail microservices and Contrail-specific resources.
    The contrailstatus executable is packaged within the downloaded tools package. Change permissions on the kubectl-contrailstatus executable and copy it to /usr/local/bin.
If you're installing a multi-cluster, then repeat steps 3 to 6 for each cluster.