Help us improve your experience.

Let us know what you think.

Do you have time for a two-minute survey?

 
ON THIS PAGE
 

Install Juniper BNG CUPS

SUMMARY This section describes installation procedures and system requirements for Juniper BNG CUPS.

Juniper BNG CUPS is a cloud application that creates the control plane component of a disaggregated Broadband Network Gateway. You install and run Juniper BNG CUPS on clusters that the Juniper’s Bbe-cloudsetup application configures.

The installation instructions in this guide are for the disaggregated control plane component of the Juniper BNG CUPS solution. In the Juniper BNG CUPS solution, the control plane is referred to as Juniper BNG CUPS Controller (BNG CUPS Controller).

Before You Begin

Before you begin installing and running BNG CUPS Controller, make sure you have the following:

  • A Linux host running Ubuntu 18.04LTS for running the bbecloudsetup utility.

  • Access to the download site for any additional applications that you want to install on the cluster.

  • A list of the broadband edge (BBE) cloud applications to be installed on the cluster and a list of the associated package files (.deb).

  • The type of nodes that will be used to install the cluster (either virtual or physical machines). A node is a Linux system running Ubuntu 18.04 LTS that has a management address and a domain name.

  • Three worker nodes and one primary node, each of which meets the following system requirements:

    • Primary Node

      • CPU cores—4 (hyperthreading preferred)

      • RAM—30 GB

      • Disk space—100 GB of free disk storage in the root partition

    • Worker Nodes

      • CPU cores—7 (hyperthreading preferred)

      • RAM—62 GB

      • Disk space—64 GB of free disk storage in the root partition

  • Node access and authentication. You must have root-level SSH access using key-based authentication to all nodes.

To use Juniper BNG CUPS, you must purchase a license for both the Juniper BNG CUPS Controller (control plane) and the Juniper BNG User Planes (user planes) associated to the Juniper BNG CUPS Controller. For information about how to purchase a software license, contact your Juniper Networks sales representative at https://www.juniper.net/in/en/contact-us/.

The MX Series devices that you are using in your Juniper BNG CUPS environment also require their own separate licenses. For information about how to purchase hardware, contact your Juniper Networks sales representative at https://www.juniper.net/in/en/contact-us/.

Install Juniper BNG CUPS Controller

SUMMARY Use this procedure to install Juniper BNG CUPS Controller.

Before you begin, confirm that you have met the hardware and software requirements for the BNG CUPS Controller installation.

  1. Download the Juniper BNG CUPS software package from Juniper Networks software download page, and save it to a server that will not be a part of the Kubernetes cluster.
  2. Unpack the TAR file (tar.gz). The filename includes the release number as part of the name. The release number has the format -m.n.r, where:
    $ tar zxvf jnpr-bng-cups-controller-pkg-m.n.r.tar.gz

    The TAR file contains two Debian packages:

    • bbecloudsetup_1.1.0_all.deb— The utility package that establishes the application's runtime environment.

    • dbng-22.1R1.10.deb—The BNG CUPS Controller application that is installed in the runtime environment.

Establish the BNG CUPS Controller Runtime Environment

SUMMARY Set up the BNG CUPS Controller runtime environment.

Juniper BNG CUPS Controller is a Kubernetes orchestrated application. You use the bbecloudsetup_1.1.0_all.deb utility to construct a Kubernetes cluster consisting of one primary node and three worker nodes. If you established the runtime environment previously, you can skip this step.

Note:

You must unpack the bbecloudsetup_1.1.0_all.deb utility on a separate Linux system from the system or systems where you plan to construct the Kubernetes cluster.
  1. Unpack the bbecloudsetup_1.1.0_all.deb utility. Use the Debian package manager to install the bbecloudsetup_1.1.0_all.deb utility.
  2. Verify the installation.
  3. Install BNG CUPS Controller.
    Note:

    These instructions are specific to installing Juniper BNG CUPS Controller. You use the bbecloudsetup_1.1.0_all.deb utility for both Juniper BNG CUPS Controller (dbng) and Juniper Address Pool Manager (apm). Therefore, you will see an option to install Juniper Address Pool Manager.

    During installation, enter the following information when prompted:

    • Overwrite product selections?—Enter y. This prompt does not appear during a first-time installation. It appears only if you have installed the application previously.

    • Install apm?—Enter n if you are not installing APM at this time.

    • Install dbng?—Enter y.

    • Provide path to dbng Debian package:—Enter the package location.

    • Overwrite nodes?

      —Enter y.

    • Master Node:—Enter the DNS name for the primary node, and verify that the name is correct by entering y.

    • Worker Node #1—Enter the DNS name for each worker node (at least three worker nodes). When finished, press Enter and verify that the names are correct by entering y.

  4. (Optional) After the cluster has been established, remove the bbecloudsetup_1.1.0_all.deb package from the Linux host that you used to establish the cluster.

Set Up and Start BNG CUPS Controller

SUMMARY Use this procedure to set up BNG CUPS Controller and to start BNG CUPS Controller services.

After completing the BNG CUPS Controller installation, you can set up and start BNG CUPS Controller.

To set up and start BNG CUPS Controller:

  1. Log in to the primary node of the Kubernetes cluster that was installed by bbecloudsetup_1.1.0_all.deb and run the BNG CUPS Controller setup.
  2. Enter the required information when prompted. To accept the default value, press Enter. Otherwise, enter the desired value and press Enter.
  3. Monitor the setup process. Setup displays information for each step. When the setup is complete, in the verification step you can view the Kubernetes objects that were created.
  4. Verify that the correct BNG CUPS Controller version was installed.
  5. On the primary node of the Kubernetes cluster, execute the following command to start BNG CUPS Controller.