Installing ioFog on Ubuntu

Follow these instructions to install the ioFog product on your Linux machine. Pay special attention to the system requirements and make sure you meet the requirements before installing ioFog in order to avoid undue troubles.

Supported versions

ioFog is supported on the following 64-bit versions of Ubuntu Linux (both desktop and server)

System requirements

In order to run ioFog, your system must meet the following requirements

Prerequisites installation

Install Java Runtime 8 or higher.

You will need to accept the license agreement for the Oracle edition of Java 8

sudo add-apt-repository ppa:webupd8team/java

sudo apt-get update

sudo apt-get install oracle-java8-installer

Install Docker

You can install the latest version of Docker with following command:

curl -fsSL https://get.docker.com/ | sh

ioFog installation

Use the command line to install ioFog. There are few commands that you need to enter.

Add the iotracks package repository to your system

curl -s https://packagecloud.io/install/repositories/iotracks/iofog/script.deb.sh | sudo bash

Install ioFog (it will automatically detect your system architecture, such as ARM or AMD64)

sudo apt-get install iofog


Get to know your ioFog installation

You can access ioFog immediately after installation! Here are a couple of commands you can use to get to know how you can work with ioFog using the command line.

Start the ioFog daemon service

ioFog is a daemon. It runs in the background. Immediately after installation, the daemon is not running. You can start it with this command. You can also just reboot your Linux machine and the daemon will be running automatically the next time you boot up.

sudo service iofog start

View the ioFog help menu

This command will show you all of the commands that are available for ioFog and the different options that you can enter for the commands. You can access this menu at any time. It is a complete menu, so if you can't find what you want here, it shouldn't exist. You can enter these commands using auto-complete, too. Just hit the 'tab' key to see suggestions.

sudo iofog help

Show the ioFog status

You can get a lot of information about the health and status of ioFog with this command. Use this whenever you like, and also whenever you think there may be something wrong with network connectivity or message throughput.

sudo iofog status

Show the current ioFog configuration

As you will see in the 'help' menu for ioFog, there are quite a few configuration settings you can use to fine-tune your installation. You can see all of the current configuration settings with this command.

sudo iofog info

Provision your ioFog for use

Your ioFog instance will not be able to do very much until it becomes part of an edge processing fabric. You simply need to provision it with an 8-character provisioning key that you generate in the ioAuthoring software. Provisioning keys are only good for a single use and they only last for 20 minutes. If you have trouble provisioning with a certain key, just generate a new one and use that one instead.

sudo iofog provision ABCDWXYZ