Introduction

In this tutorial we will use a tutorial project to set up a local ECN with a set of example Microservices.

Familiar with the Core Concepts?

If you aren't already familiar with the core concepts of ioFog, you'll want to check out our Core Concepts section.

Prerequisites

The ioFog demo requires one of the following systems and tools to be installed. The scripts in this demo do not install any of these tools, but they check for sufficient versions.

Supported operating systems:

• Linux (kernel v3.10+)
• macOS 10.12+

Required tools:

• Docker 1.10+: Open platform for developing, shipping, and running applications. (installation instructions)
• potctl 1.0.0+: CLI tool and a one-stop-shop for all your ioFog needs. (installation instructions)

Make sure to follow the Docker post-installation instructions so that the Docker daemon can work without sudo. Otherwise, the commands in this guide will not work.

Setup Demo Project

On Unix based systems, download our tar.gz package.

mkdir -p /tmp/iofog/demo
cd /tmp/iofog/demo
curl -L -o demo.tar.gz https://github.com/eclipse-iofog/demo/archive/v3.0.0-alpha1.tar.gz
tar -zxvf demo.tar.gz --strip-components=1

Bootstrap the Project

To get going, all we need to do is run:

./start.sh tutorial

We can optionally verify the ioFog stack is provisioned correctly. The automated tests run a smoke test suite on the ioFog stack, testing basic operations.

./test.sh

Under the hood, those shell scripts are using potctl and YAML files to set up your environment. You'll get to use potctl directly in the next few sections. Impatient to know more? Dive directly into its documentation.

Get To Know ioFog

With a working ioFog environment set up, we're now ready to get to know ioFog.

Continue To Next Step: Get To Know ioFog.

Questions? Run into issues?

If you run into an issue, have a question, or just want to get plugged into the community, head over to our Discussion Forum. We'd love to have you!

See anything wrong with the document? Help us improve it!