top of page

How to create Endpoint Node and Endpoint Node Group

Updated: Jul 11

Endpoint Node is the compute host machine of Bumblebee Endpoint, it can host multiple Endpoints. Supported form factors for Endpoint Node are virtual machine (OVA), hardware device and AWS AMI.


An Endpoint Node Group represents a group of Endpoint Nodes in one on-premise location. The Endpoints for the same App Service but are hosted on different Endpoint Nodes in the same Endpoint Node group form a scaling group. This scaling group load balances traffic initiated from devices in the on-premise network. The relationship between Endpoint, Endpoint Node and Endpoint Node Group is described in the diagram below.



Illustration of Endpoint Node and Endpoint Node Group
Illustration of Endpoint Node and Endpoint Node Group


Create Endpoint Node


  1. Login to the Bumblebee portal.

  2. Click Endpoint Nodes on the main navigation menu, then click Create Endpoint Node. A pop up window should appear. Enter a name for the Endpoint Node.

  3. Click New Group to enter a new group name or click Use Existing to select an already created Node Group.

  4. Click Create Endpoint Node.

  5. Select a desired form factor.

    1. Download OVA. Select this option if you intend to run the endpoint node as a virtual machine. OVA is free to download.

      1. Click Preparing for OVA for Download

      2. Click Download OVA.

      3. The OVA is built to work with Intel based servers. For help deploying OVA, follow the instructions here.

    2. Hardware Device. Select this option if you intend to purchase hardware device shipped to you. Hardware device incurs a one time charge. For hardware device, plug in the Ethernet cable to the port labeled WAN0.

      1. Click Continue

      2. Enter shipping address of the deployment destination. The Hardware device is plug and play with zero touch for deployment.

    3. AWS AMI. Select this option if you intend to create an endpoint in Network Mode in AWS.

      1. Click Continue

      2. Click Generate Cloud Init Data. Copy the data. You need this data when launching the AMI in AWS

      3. Click this Cloud Formation script link to launch Bumblebee Node AMI in AWS. This CF takes you to AWS and launch the Bumblebee Node instance in your desired region. Make sure you launch the Bumblebee Node instance in a private subnet that can reach *.bumblebeenet.com

  6. Make sure DHCP is enabled on the subnet where the node is deployed. Once the the node is installed and started, it should automatically registers with the Bumblebee platform. For hardware device, plug in the Ethernet cable to the port labeled WAN0 and this port requires DHCP for the WAN0 port to reach the Internet.

  7. Login to the Bumblebee platform, you should see the Endpoint Node is registered. The Admin State for the Endpoint Node should be in "registered" state and the Op State should be in "up" state.


Network Mode Endpoint Node Configuration

This section only applies to the Endpoint Node in Network Mode


For Endpoint Node in Network Mode, WAN0 port is designated as the port for registering with Bumblebee platform.


If the deployment calls for separate LAN and WAN ports, you need to enable LAN interface and configure DHCP Relay and, optionally, setup VRRP for redundancy.


Configure LAN Interface

In this setup, the Node acts as the default gateway for the LAN subnet.


  1. Login to Bumblebee portal

  2. Click Endpoint Nodes on the left navigation menu

  3. Select the node

  4. Click Actions -> Configure LAN Interface

  5. Click Enable LAN Interface

  6. Enter the LAN interface IP address with the subnet size. For example, 192.168.77.1/24 where 192.168.77.1 is the LAN interface IP address and /24 is the subnet size.

  7. Click Submit


The above configuration steps also apply when you need to disable LAN interface.


Setup DHCP Relay

DHCP Relay function enables dynamic IP address assignments by a remote DHCP server. When DHCP Relay is enabled on a Endpoint Node, host machines and devices on the local subnet can dynamically obtain their IP addresses via a DHCP server installed in the central location such as a corporate data center.


Since DHCP Relay function applies to all Endpoint Nodes in the same Node group, the configuration is at the Node group level and automatically applies to all nodes in the same group.


To configure follow the steps below.


  1. Login to Bumblebee portal

  2. Clink Endpoint Nodes on the left navigation menu

  3. Click Manage Endpoint Node Groups on the top right corner

  4. Select the Node Group

  5. Click Actions -> Setup DHCP Relay

  6. Click Enable DHCP Relay

  7. Enter DHCP server IP address.

  8. Click Submit


The above configuration steps also applies when you need to disable DHCP Relay.


Setup VRRP

VRRP enables high availability for two or more routers such as Endpoint Nodes in Network Mode. When VRRP is enabled on a Endpoint Node group, it presents to the host machines on the same subnet with a single virtual IP address as their default gateway for the next hop.


Follow the steps below to configure:


  1. Login to Bumblebee portal

  2. Clink Endpoint Nodes on the left navigation menu

  3. Click Manage Endpoint Node Groups on the top right corner

  4. Select the Node Group

  5. Click Actions -> Setup VRRP

  6. Click Enable VRRP

  7. Enter VRRP IP address.

  8. Click Submit


The above configuration steps also applies when you need to disable VRRP.

38 views0 comments

Comments


bottom of page