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 CN2 manifests from the Juniper Networks download site (https://support.juniper.net/support/downloads/?p=contrail-networking) and access the container repository at https://enterprise-hub.juniper.net.
  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 (Manifests) and extract the tgz 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.

    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 CN2 Tested Integrations matrix at https://www.juniper.net/documentation/us/en/software/cn-cloud-native/cn2-tested-integrations/cn-cloud-native-tested-integrations/concept/cn-cloud-native-tested-integrations.html).
    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
        Note:

        If you're running systemd-resolved on Ubuntu, ensure that /etc/resolv.conf is linked to /run/systemd/resolve/resolv.conf, and not to /run/systemd/resolve/stub-resolv.conf.

        See https://kubernetes.io/docs/tasks/administer-cluster/dns-debugging-resolution/#known-issues for more information.
      • 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 Contrail tools.
    See Install Contrail Tools.
  7. 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. Extract and copy the kubectl-contrailstatus executable to /usr/local/bin.
If you're installing a multi-cluster, then repeat steps 3 to 7 for each cluster.