Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

The guide covers the installation details which are related to IOT Gateway Blueprint only.  Before going through this guide its is recommended to go through the steps specified in ELIOT Release 2 Installation Guide under ELIOT Blueprints Common Documentation.

This guide provides the information for setting up the ELIOT Environment which includes ELIOT Manager and ELIOT Edge Node(s) (IoT Gateway) with details of software and hardware specifications for IOT IoT Gateway Blueprint.

For Release-2.0 the scope of the guide covers two ELIOT deployments one is using Kubernetes and the other one using Kubeedge (Lightweight Kubernetes).  

The ELIOT Manager can be any Cloud Virtual Machine or Bare Metal having Ubuntu OS 16.04 and should be able to ping and SSH to the Eliot ELIOT Edge Node - IoT Gateway Node.  The ELIOT Edge Node will be a Virtual Machine having Ubuntu 0S 16.04.

...

The common features which are application for both the ELIOT blueprints (IoT Gateway and SD-WAN / WAN/ uCPE) include ELIOT Lightweight Tailored OS VM Installation, ELIOT UI , ELIOT Command Line Interface to bootstrap the ELIOT Cluster Installation.  These features are developed to ease the use and provide value added features for deployment, usage and monitoring of ELIOT Cluster.

Note

The common features installation are add on feature provided to manage the ELIOT Cluster. For detail usage and installation please refer to the link :- ELIOT Release 2 - Recommended ELIOT Operation & Management Features Installation Document (Optional)

How to use this document

The document includes details of prerequisites /pre-installation, installation and uninstalls steps. For the common ELIOT Platform component ELIOT Release 2 Installation Guide has to be referred.

...

Currently ELIOT Deployment have been done in Virtual Machines only but the installation steps and scripts will hold good for execution in Bare Metal also if the hardware and software prerequisites are met.  Refer section Virtual Deployment Guide for deployment of ELIOT IoT Gateway on Virtual Machines.

Info
ELIOT IoT Gateway blueprint installation is not done or tested in Bare-Metal Environment.

Creating a Node Inventory File

...

Virtual Deployment Guide

For Virtual Deployment two Ubuntu VM's minimum two Virtual machines are required one for ELIOT Manager and ELIOT Edge Node both (IoT Gateway). Both the node should have internet connectivity , network interface and network connectivity between the two VM's

Standard Deployment Overview

ELIOT IoT Gateway Deployment using Kubernetes

Clone the ELIOT git repo in ELIOT Manager node. It will create eliot folder, for executing the script go to $HOME/eliot/blueprint/iotgateway/scripts folder.

Edit the nodelist file with ELIOT Edge Node details.  Replace the below contents with the actual value with '|' separated. 

The below details are required in the setup.sh for sshpass command. The details are required by sshpass to login to ELIOT Edge Node from ELIOT Manager and execute the deployment scripts in the ELIOT Edge Node.

<eliotedgenodeusername>|<eliotedgenodeip>|<eliotedgenodepassword>

  • eliotedgenodeusername – ELIOT Edge Node User Name. Example : akraino-slave-002
  • eliotedgenodeip – ELIOT Edge Node IP. Example : 159.123.1.50
  • eliotedgenodepassword - ELIOT Edge Node Password used in setup.sh script to login to ELIOT Edge node from ELIOT Manager to execute scripts in ELIOT Edge node.

...

No Format
root@akraino-slave-001:~/eliot/blueprints/iotgateway/scripts#./setup.sh

ELIOT IoT Gateway Deployment using KubeEdge

Clone the ELIOT git repo in ELIOT Manager node. It will create eliot folder, for executing the script go to $HOME/eliot/blueprints/iotgateway/scripts/src folder.

Edit the config_kubeedge file with ELIOT Manager and ELIOT Edge Node

...

The setup.sh script will install the ELIOT Manager and one ELIOT Edge Node ( depending on the number of edge nodes configured in the nodelist configuration file).  The script deploys the Kubernetes cluster and also installs EdgexX platform,  NGINX, Prometheus and cAdvisor and verifies whether the cluster by checking if EdgeX platform , NGINX Server is deployed successfully or not. If the deployment is not successful then the ELIOT setup script will exit.


After script execution is completed the kubernetes Kubernetes cluster setup can be checked by executing kubectl get nodes. It will show both the ELIOT Manager and the ELIOT Edge Node as ready.

...