Help us improve your experience.

Let us know what you think.

Do you have time for a two-minute survey?

Installation, Deployment, and Configuration Instructions

 
  • Installed on premises

  • Deployed on Amazon Web Services (AWS)

Note

We recommend that you contact Juniper Networks Technical Assistance Center (JTAC) for assistance to install, deploy, and configure Juke Multicloud Release 2.2.1.

For more information, see Requesting Technical Support.

These topics provide preinstallation instructions, steps to install Juke Multicloud on premises, steps to deploy Juke Multicloud on Amazon Web Services, and post-installation configuration instructions.

Preinstallation Instructions

Juke Multicloud Release 2.2.1 can be installed on a physical machine or a virtual machine running Ubuntu OS 16.04. You must ensure that you have the required packages preinstalled on the master node, valid cloud credentials to make API calls from the master node, and that the required ports are opened between the master node and resource nodes. For more information, see the Prerequisites section given below.

Prerequisites

These are the minimum requirements to install Juke Multicloud Release 2.2.1.

  • Physical machine or a virtual machine with the following requirements:

    • 4 vCPUs

    • 16 GB RAM

    • 60 GB Hard Disk

    • 10 GbE NIC

    • Internet Access

  • OS support

    • Ubuntu 16.04.5 Server LTS installed for Juke Multicloud On-prem installation.

      Note

      This installer does not support installation on public cloud instances.

    • See Deploying Juke Multicloud on Amazon Web Services to deploy Juke Multicloud Release 2.2.1 on a public cloud.

  • Master node with the following packages preinstalled:

    • bridge-utils—a bridge interface, br0, with internet access using a single Ethernet port.

    • python3-pip

    • python-netaddr

  • A static IP address for br0.

  • Eight sequential IP addresses assigned to Juke Multicloud components.

  • The following firewall/NAT rules are configured when you deploy Juke Multicloud 2.2.1 on premises:

    • TCP/UDP port 1194 must be open and directed to the Juke Multicloud compute service.

    • Find the IP address for Juke Multicloud compute service by:

      • Accessing the Juke Multicloud master node by using console or SSH.

      • Type sudo juke list.

      • Locate the IP address for the compute service from the list.

  • The following Amazon VPC/Security Group Configurations are met when you deploy Juke Multicloud nodes on Amazon Web Services:

    • Create a security group called juke-node on all zones where Juke Multicloud is deployed.

    • All firewall rules (inbound) are configured as given in Table 1.

      Table 1: AWS Firewall Rules

      TCP/UDP

      Port

      Description

      TCP

      8002

      Juke Admin Web UI

      UDP

      1194

      IPSec VPN

      TCP

      22

      SSH

      TCP

      5555

      Web Socket

      TCP

      19999

      Monitoring

      TCP

      8443

      Juke Container

      UDP

      68

      DHCP Service

      TCP

      9419–9425

      JUKEFS

      TCP

      8500

      Web Socket

      TCP

      33000-40000

      Container Access

  • Valid public cloud credentials to add compute and storage resources from the public cloud.

Installing Juke Multicloud On-Prem

Follow these steps to install Juke Multicloud Release 2.2.1 on premises.

Before you begin, ensure that the prerequisites provided in the Preinstallation Instructions section are met.

  1. Download the Juke Multicloud Storage and Compute installer file.

    juke-install

  2. Create the installer by running the chmod +x juke-install script.
  3. Run the following script as a super user.

    Where,

    • <FIRST-IP>—The first IP address used by Juke Multicloud when deploying services.

      Juke Multicloud uses a total of eight IP address including the one entered in the installation command given in step 3.

      Note

      The IP address entered above cannot be the same as the static IP address for br0.

    • <SUBNET>—Subnet mask in CIDR notation.

    • <GATEWAY>—IP address of the gateway to be used to access the Internet.

    • <DNS-IP>—IP address of the DNS to be used when performing name lookups.

  4. Once the installation is complete, the following message is displayed.

    Open a browser and navigate to http://<ip-address> to access the post-installation configuration wizard.

    For more information, see Post-Installation Configurations.

Deploying Juke Multicloud on Amazon Web Services

Follow these steps to deploy Juke Multicloud Release 2.2.1 on Amazon Web Services (AWS).

Before you begin, ensure that the prerequisites provided in the Preinstallation Instructions section are met.

  1. Subscribe to Juke Multicloud Control Plane, Data Plane, and Node images from AWS Marketplace.

    Follow these steps to subscribe:

    1. Go to https://aws.amazon.com/marketplace.
    2. Search for Juke.
    3. Click JUKE Multi-Cloud Control and Data Plane.
    4. Click Continue to Subscribe.
    5. Repeat steps b through d to subscribe to JUKE Nodes image.

    Once you subscribe, you can access Juke Node images, and deploy Juke controller and nodes from your AWS account.

  2. Launch Juke Controller instance.Note

    You can launch the Juke Controller image through your EC2 Management Console.

    Follow these steps to launch Juke Controller instance:

    1. Click Instances.
    2. Click Launch Instance.
    3. Click AWS Marketplace.
    4. In the page that is displayed, search for JUKE.
    5. Click Select next to the Juke Multi-Cloud Data and Control Plane option.
    6. Review the information displayed and click Continue.

      A list of recommended instances are displayed.

    7. Select the image of your choice.

      The following instances are available for launching a Juke Controller:

      • General Purpose

        • m5.large

        • m5.xlarge

        • m5.2xlarge

      • Compute Optimized

        • c5.xlarge

        • c5.2xlarge

      • Memory Optimized

        • r4.xlarge

      Select an instance based on your requirement and size of deployment.

    8. Click Review and Launch.

      Detailed information about the instance is displayed for final review.

    9. Click Launch.Note

      Once you click launch, a security group is automatically created and the required ports are opened. Storage resources are automatically created and assigned as well.

      You are now directed to select an existing key pair or create a new key pair.

    10. Select either Choose an existing key pair or Create a new key pair from the list, and click Launch Instance.

      The Juke Controller is launched and is available in the EC2 Management Console.

    11. Access the Juke Controller from https://<ip-address>:8002.

      You are redirected to the Juke Controller configuration wizard.

      Note
      • Ensure that you use the public IP address in the URL instead of the DNS IP address when you access the configuration wizard.

      • When you access the configuration wizard for the first time, a “Privacy Error” screen may be displayed. Click Advanced and then click Proceed to access the configuration wizard.

        For more information, see Post-Installation Configurations.

Post-Installation Configurations

Once you have completed installing Juke Multicloud Release 2.2.1 on premises and/or deployed Juke Multicloud on Amazon Web Services, follow the steps given below to complete the post-installation configurations.

  1. Access the Juke Admin Web UI by clicking http://<ip-address>:8002.

    The Admin Info page of the configuration wizard is displayed.

  2. Complete the following steps.
    1. Enter the following information in the Admin Info page.
      1. Enter first name in the Name field.
      2. Enter last name in the Last name field.
      3. Enter business email address in the Email (later used a Juke’s username) field.
      4. Enter phone number in the Phone number field.
      5. Enter password in the Password field.
      6. Re-enter password in the Confirm password field.
      7. Enter the name of the company you work for in the Company field.
      8. Enter your designation in the Job title field.
      9. Select the check boxes next to Amazon Web Services and Google Cloud to enable cloud credentials.
    2. Click Next.

      The License Agreement page is displayed.

    3. Select the check box to accept the license agreement and click Next.

      The Cloud Credentials page is displayed.

    4. Enter your AWS and Google Cloud credentials.

      You are prompted to enter your cloud credentials if you have selected to enable your cloud credentials from the Admin Info screen. For more information on your Access ID Key and Secret Access Key, see Preinstallation Instructions.

    5. Click Next.

      The SMTP Configuration page is displayed.

    6. Enter SMTP configuration information in the SMTP Configuration page.
      1. Select Yes to enable email notifications.
      2. Enter the desired URL and port information in the URL and Port fields, respectively.
      3. Enter the username and password in the Username and Password fields, respectively.
      4. Select Login as the authentication mode.
      5. Select SSL as the encryption type.
      6. Click Next.

        The Final Setup page is displayed.

        Once the installation is completed, an Installation Completed message is displayed.

Juke Multicloud Release 2.2.1 is now installed and configured.