Start the Edge

Introduction

The following steps will guide you through the configuration and how to run the edge elements locally.

Prerequisites

Prerequisite 1: Docker

Air’s CLI is wrapped in a docker container to ease the installation process:

• Docker

Running Steps

Step 1: Get Project Air Infrastructure endpoints

Query the service list. Take note of the returned information as it will be used to configure AIR Edge components in subsequent steps.

minikube service list

You should see something like this:

|----------------------|------------------------------------|--------------------|-----------------------------|
|      NAMESPACE       |                NAME                |    TARGET PORT     |             URL             |
|----------------------|------------------------------------|--------------------|-----------------------------|
| default              | kubernetes                         | No node port       |
| default              | minikube-air-app-manager-service   | appmanager-http/80 | http://192.168.99.117:30640 |
| default              | minikube-air-cors-anywhe-service   | ca-http/80         | http://192.168.99.117:31118 |
| default              | minikube-dgraph-alpha              | No node port       |
| default              | minikube-dgraph-alpha-headless     | No node port       |
| default              | minikube-dgraph-ratel              | No node port       |
| default              | minikube-dgraph-zero               | No node port       |
| default              | minikube-dgraph-zero-headless      | No node port       |
| default              | minikube-mosquitto-service         | mosquitto/443      | http://192.168.99.117:30987 |
| kube-system          | ingress-nginx-controller-admission | No node port       |
| kube-system          | kube-dns                           | No node port       |
| kubernetes-dashboard | dashboard-metrics-scraper          | No node port       |
| kubernetes-dashboard | kubernetes-dashboard               | No node port       |
|----------------------|------------------------------------|--------------------|-----------------------------|

Step 2: Download basic demo

Download the basic demo file

Unzip basicdemo.zip

Then, change to the folder just unzipped

cd basicdemo

Step 3: Start Edgex Core components

Inside your basicdemo folder run

./startEdgex.sh

Step 4: Get Edgex Gateway API security token

Inside your basicdemo folder run

./getSecurityToken.sh

Copy the access token for tibuser, you will need it to configure AIR components.

Step 5: Configure Edgex Air Components

Use the information from step 1 (endpoints) and step 4 (security token) to modify the basicdemo/.env file. This file is used to provide AIR environment variables to docker-compose.

Open the file and replace the following variables using values for your environment and the information returned from the service list:

GATEWAY_ID=changeme
GATEWAY_DESCRIPTION=changeme
GATEWAY_HOSTNAME=localhost
GATEWAY_LATITUDE=36.0
GATEWAY_LONGITUDE=-98.0
GATEWAY_ACCESS_TOKEN=changeme
GATEWAY_METADATA_PUBLISH_INTERVAL_SECS=30
AIR_MQTT_HOSTNAME=changeme
AIR_MQTT_PORT=changeme
AIR_MQTT_USER=mqtt_admin
AIR_MQTT_PASSWORD=mqtt_admin
AIR_MQTT_DATA_TOPIC=EdgexGatewayData
AIR_MQTT_NOTIFICATION_TOPIC=EdgexGatewayNotification

Please note that the GATEWAY_ID is the identifier that will be used to identify your deployment in the AIR UI.

Step 6: Start Edgex Air components

Inside your basicdemo folder run

./startEdgeAIR.sh

Congratulations!! Project Air edge basic demo is running

Uninstallation Steps

Step 1: stop the demo

Inside your basicdemo folder run

./stopEdgex.sh