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 document are shown in the respective installation sections.
  3. Download the Contrail Networking Manifests and Tools package (Manifests and Tools) 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 your repository login credentials in the downloaded manifests.

    If you're running release 22.1, this step does not apply to you. The release 22.1 manifests are prepopulated with working credentials.

    If you're running release 22.2 or higher, you'll need to add your repository login credentials to the contrail-manifests-k8s and contrail-tools manifests. See Configure Repository Credentials for one way to do this.

  5. 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 as per the example cluster you want to install (for example, 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 (must be chrony)
      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.
  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.