npm package: @mdslab/iotronic-lightning-rod
Description: Implementation of the Lightning-rod, the Stack4Things node-side probe (this version works with the standalone version of IoTronic) http://stack4things.unime.it/
Author: Nicola Peditto
Latest version: 2.3.6

# Stack4Things Lightning-rod (standalone version)

[![npm version](https://badge.fury.io/js/%40mdslab%2Fiotronic-lightning-rod.svg)](https://badge.fury.io/js/%40mdslab%2Fiotronic-lightning-rod)

Stack4Things is an Internet of Things framework developed by the Mobile and Distributed Systems Lab (MDSLab) at the University of Messina, Italy. Stack4Things is an open source project that helps you in managing IoT device fleets without caring about their physical location, their network configuration, their underlying technology. It is a Cloud-oriented horizontal solution (integrated with OpenStack) providing IoT object virtualization, customization, and orchestration. Stack4Things provides you with an out-of-the-box experience on several of the most popular embedded and mobile systems.

More details about Stack4Things can be found [here](https://github.com/MDSLab/stack4things).

Lighthing-rod is the board-side component in the Stack4Things architecture. In this repository, you find the version that works with the standalone version of the IoTronic service that you can find [**here**](https://github.com/MDSLab/s4t-iotronic-standalone).

Lightning-rod (in its standalone version) has been tested to work on:

* Raspberry Pi 2 and 3
* Arduino YUN / Linino ONE
* Ubuntu 16.04 / 14.04
* Docker containers
* LXD containers


## Installation guides

### Docker
Lightning-rod was also delivered via Docker container both "x86_64" and "ARMv7" architectures (Debian-like). In particular we tested this container on Ubuntu 16.04 and on Raspberry Pi 3 (Raspbian OS).

* [Installation on Docker](https://github.com/MDSLab/s4t-lightning-rod/blob/master/docs/docker.md)

### Raspberry Pi

We tested this procedure on Raspberry Pi 3 with Raspbian OS and "ubuntu-16.04-preinstalled-server" image:
* [Installation guide for Raspberry Pi 3](https://github.com/MDSLab/s4t-lightning-rod/blob/master/docs/raspberrypi3.md)

and on a Raspberry Pi 2 with Raspbian OS:

* [Installation guide for Raspberry Pi 2](https://github.com/MDSLab/s4t-lightning-rod/blob/master/docs/raspberrypi2.md)

### Arduino YUN/Linino ONE

We tested this procedure on an Arduino YUN with LininoOS and LininoIO installed. Everything needs to be run as root. For the installation to be completed successfully, you need a working Node.js environment and a working kernel with gre, tun, ipv6, tunnel4, tunnel6, and ip6_tunnel module packages (kmod-*) installed.

* [Installation guide for Arduino YUN/Linino ONE](https://github.com/MDSLab/s4t-lightning-rod/blob/master/docs/arduinoyun.md)

### Generic machine

* [Installation guide for Ubuntu 16.04](https://github.com/MDSLab/s4t-lightning-rod/blob/master/docs/ubuntu1604.md)
* [Installation guide for Ubuntu 14.04](https://github.com/MDSLab/s4t-lightning-rod/blob/master/docs/ubuntu1404.md)

<!--
### LXD
If you want to install Lightning-rod within an LXD container, you can follow the first part of the IoTronic installation guide you can find [here](https://github.com/MDSLab/s4t-iotronic-standalone/blob/master/docs/installation_lxd.md).
-->