Create an Edge Application
This article describes all the required steps to create an Edge Application with the weeve Manager.

What are Edge Applications?

A weeve Edge Application is software that runs on the edge. The software is built in a modular way. The Edge Application Builder in the weeve Manager allows the platform operator to create and configure Edge Applications (data pipelines/apps), following an intuitive building block approach. These Edge Applications consist of modules (docker containers), which are categorized into three different types; input, process and output. Each Edge Application consists of at least one module from each type. The input (ingress) module defines the source of the data, the processing module(s) defines how the data is treated while the output module (egress) defines the data target. The target is controlled by the data owner and can for example be a database, dashboard or third-party service provider. Each module needs to be configured individually according to its corresponding settings.
Edge Applications can be saved in the Edge Application Library and be deployed to multiple weeve Edge—Nodes directly from the Edge Application Builder. In order to deploy an Edge Application, it must be created and configured according to the platform requirements as well as to the data input type and capacity of the executing hardware. The weeve Edge—Nodes need to be registered and provisioned to the platform before the deployment.

How to create an Edge Application

1. Access the Edge Application builder

On the dashboard, select Builder from the menu bar on the left or click on the left modal on the main screen that says Build a new Edge Application.
Click "Design a new Edge Application" or "Builder".

2. Select the modules for your Edge Application

In the modules panel on the left, use the filter option to select all input modules. To build a working edge application you need to select at least one input, one process, and one output module and connect them.
Select the input icon in the filter section to see all available input modules.
You will find the following input modules
  • HTTP Ingress
  • MODBUS TCP Ingress
  • MQTT Ingress
  • DEV-Random

3. Place your input module

Drag the desired module out of the panel and drop it onto the canvas.
Drag and drop the module onto the canvas.

4. Adjust the module properties

Click on the module to open up the properties panel on the right. Here you can specify the modules settings and click Apply.
Adjust the module properties in the panel on the right side.

5. Place process and output modules

Repeat steps 1 to 4 to place a process module as well as an output module on the canvas.
Available process modules are
  • AGGREGATOR
  • COMPARISON FILTER
  • CLEANER
  • HASH-TO-INT
  • BATCHER
Available output modules are
  • VONAGE
  • SLACK ALERT
  • AWS DYNAMODB EGRESS
  • HTTP EGRESS
  • SAP HANA DATABASE

6. Connect all modules

Now, you need to connect the modules. Click on the bottom connector dot of the input module, drag out a line and drop it on the top connector dot of the process module. Repeat this step to connect the process module and the output module.
Connect the modules by pulling a line out of the connector dots.

7. Save your Edge Application

Now is a good time to save the edge application you just built. You may save it any time during the building process but in order to move to the deployment part saving is mandatory. Enter a name (and potentially a number for the version) in the input field in the top right corner. Now the deploy button is active and you can click it to proceed.
Save and deploy in the top right corner.

8. Select nodes to deploy your Edge Application to

In the table you will find all available nodes. Select them by clicking inside the checkbox on the left of each column. You can deploy your Edge Application to several nodes at once. To start the deployment process, click the deploy button in the top right corner.
Select nodes and press the deploy button.

9. Deployment Status and Undeployment

While the deployment process is running in the background you have the option to check the status of the nodes you selected previously. Click on the Node Status button to go to the deployment status page. In the table you can find all nodes that are running your Edge Application. If you like to undeploy your Edge Application from any of these nodes, simply click on the trashcan icon on the right side of each column.
Click Node Status to see the process of your deployment.
Click on the trashcan if you want to undeploy the Edge Application from this node