Skip to content

The Basics

This tutorial demonstrates the basics of application management and node management on a single node using the Edge Builder GUI. The following topics are covered:

Initialize the Edge Builder server components

To initialize the Edge Builder server components and CLI, complete the following steps:

  1. Set up the environment as described in Tutorials Setup

  2. SSH into the master node:

    vagrant ssh master
    

  3. Start the Edge Builder server components using the following command:

    sudo edgebuilder-server up -a 192.168.56.10
    
    When the server components are up, you should see all server components up and running via the docker ps command:
    vagrant@master:~$ docker ps
    
    CONTAINER ID   IMAGE                                    COMMAND                  CREATED          STATUS          PORTS                                                                                                                                                     NAMES
    54216df43569   iotechsys/dev-eb-controller:1.2.0.dev    "./entrypoint.sh"        19 seconds ago   Up 16 seconds   0.0.0.0:8085->8085/tcp, :::8085->8085/tcp, 0.0.0.0:50000-50100->50000-50100/tcp, :::50000-50100->50000-50100/tcp, 0.0.0.0:1022->22/tcp, :::1022->22/tcp   eb-controller
    28e962d77a00   chronograf:1.8.8-alpine                  "./custom-entrypoint…"   21 seconds ago   Up 19 seconds   0.0.0.0:8888->8888/tcp, :::8888->8888/tcp                                                                                                                 eb-chronograf
    706d2b19acf4   postgres:alpine                          "./entrypoint.sh"        24 seconds ago   Up 21 seconds   5432/tcp                                                                                                                                                  eb-db
    83f4b4298be4   influxdb:1.8.1-alpine                    "./custom-entrypoint…"   24 seconds ago   Up 21 seconds   0.0.0.0:8086->8086/tcp, :::8086->8086/tcp                                                                                                                 eb-influxdb
    c2981b5cbce7   portainer/portainer-ce:2.1.0-alpine      "/portainer -H unix:…"   24 seconds ago   Up 20 seconds   0.0.0.0:8000->8000/tcp, :::8000->8000/tcp, 0.0.0.0:9000->9000/tcp, :::9000->9000/tcp                                                                      eb-portainer
    5d4110072447   iotechsys/dev-eb-redis:1.2.0.dev         "redis-server /etc/r…"   24 seconds ago   Up 20 seconds   6379/tcp                                                                                                                                                  eb-redis
    64901e67177b   iotechsys/dev-eb-webssh:1.2.0.dev        "wssh --address=0.0.…"   24 seconds ago   Up 21 seconds   0.0.0.0:8989->8989/tcp, :::8989->8989/tcp                                                                                                                 eb-webssh
    34811b289512   grafana/grafana:7.4.2                    "/run.sh"                24 seconds ago   Up 21 seconds   0.0.0.0:3000->3000/tcp, :::3000->3000/tcp                                                                                                                 eb-grafana
    ac79f2182e86   iotechsys/dev-eb-salt-master:1.2.0.dev   "/bin/sh -c 'sed -i …"   24 seconds ago   Up 20 seconds   0.0.0.0:4505-4506->4505-4506/tcp, :::4505-4506->4505-4506/tcp, 0.0.0.0:8099->8099/tcp, :::8099->8099/tcp                                                  eb-salt-master
    6583228fa467   kapacitor:1.5-alpine                     "/entrypoint.sh kapa…"   24 seconds ago   Up 21 seconds   9092/tcp                                                                                                                                                  eb-kapacitor
    6659e040296e   vault:1.7.1                              "./entrypoint.sh"        24 seconds ago   Up 21 seconds   8200/tcp                                                                                                                                                  eb-vault
    

  4. Access the GUI from a browser at http://192.168.56.10:9091 gui1

  5. Login using the following credentials:

    • Username: iotech
    • Password: EdgeBuilder123
  6. Add a license using the drop down menu in the top right corner

gui2

  • Select or drag and drop your license into the box provided, click Add

gui3

Add a node

In this section of the tutorial, we will add a node to Edge Builder. It is accessible on 192.168.56.11.

To add an edge node, complete the following steps:

  1. On the Nodes page of the UI, click the Add button (+).

gui4

  • We will use ssh to add this node, enable the ssh toggle to enable the fields required

  • Enter the following information

Name Description Labels Node Address Username Password Server Address
node1 A demo node vm
label1
192.168.56.11 vagrant vagrant 192.168.56.10
  • Click Create to add the node

gui5

  • Wait until the node status is Up

gui6

Deploy an Application

In this section we will create an app definition and deploy an app on node1.

  1. Select node1 and click on Deploy Apps in the actions dropdown menu

gui7

  • Add an App Definition by clicking the +

gui8

  • Enter the following information
Name Description Type
SimpleWebServer A Web Server Docker-Compose
  • Paste the following docker-compose file into the box on the right:
version: "3"

services:
    simple-webserver:
        image: nginx
        ports:
            - 55555:80
        volumes:
            - /home/vagrant/src:/usr/share/nginx/html
  • Click Create to add the App Definition

gui9

  • Select the App Definition you just created and click Next

gui10

  • Click Create to add the application to node1

gui11

Controlling and removing an Application

In this section we will start, restart and stop the application created above

  1. To start the application select it and press the start button in the action menu

gui12

  • The same menu can be used to restart and stop the app

gui13

  • Finally the app can be removed using the actions menu

gui14

Remove a node

This section will illustrate how an node can be removed

  1. On the Nodes page, select node1 and click on delete in the actions menu

gui15