Help us improve your experience.

Let us know what you think.

Do you have time for a two-minute survey?

 
 

Before You Install

SUMMARY This topic provides a list of pre-requisities for installing the Juniper Cloud-Native Router including the required host configuration and licenses.

The Juniper Cloud-Native Router (JCNR) is a container-based software solution, orchestrated by Kubernetes(K8s). It combines the containerized routing protocol process (cRPD) and a Data Plane Development Kit (DPDK)-enabled virtual router (vRouter). Using the JCNR, you can enable full Junos routing control plane with enhanced forwarding capabilities.

This section provides a list of pre-requisites for installing JCNR.

  1. Review the JCNR System Requirements to setup and configure the host machines.
  2. JCNR supports an all-in-one or multinode Kubernetes cluster, with master and worker nodes running on virtual machines (VMs) or bare metal servers (BMS). Kubernetes installation or management instructions are not provided in this documentation. Please see https://kubernetes.io for Kubernetes documentation.
    Note:

    It is not recommended to deploy Juniper Cloud-Native Router if Kubernetes cpumanager is enabled in your Kubernetes cluster.
  3. Ensure the host is enabled with SR-IOV and VT-d in the system's BIOS.
  4. Hugepage and iommu setting is mandatory for the vRouter to come up. You can set them at grub level with the below options:
    1. Add below params by adjusting the no of hugepages (64 here is just an example) in /etc/default/grub and reboot the host: "

      Update grub and reboot the host. For example:

    2. To verify hugepage is set , execute these commands on the host:
  5. Ensure VLAN driver is enabled on the host machine at startup. You can verify it by issuing the lsmod | grep 8021q command.
  6. Enable virtual functions (VFs) on host NICs at startup. (Only for L2 deployments)
  7. Enable Trust and Disable Spoofcheck on VF's assigned to vRouter using the commands (Only for L2 deployments):
  8. Ensure you have the latest version of helm3 installed.
  9. Download the JCNR tarball, Juniper_Cloud_Native_Router_release_nunber.tgz from the Juniper Support Site, to a directory on your host machine. You must perform the file transfer in binary mode when transferring the file to your server, so that the compressed tar file expands properly.
  10. Ensure you have a valid cRPD license available. The JCNR license format has changed, you must request a new license key before deploying or upgrading to 23.2 release. See JCNR Licensing for more information.
  11. Review the JCNR Deployment Modes topic to understand the various deployment modes supported by JCNR.