Installation & Administration Guide

Installation

There are two ways of installing the JSON IoT Agent: using Git or Docker image.

Using GIT

In order to install the LoRaWAN IoT Agent, just clone the project and install the dependencies:

Requirements

Cloning the GitHub repository

  1. Clone the repository with the following command:
git clone https://github.com/Atos-Research-and-Innovation/IoTagent-LoRaWAN.git
  1. Once the repository is cloned, you have to download the dependencies for the project, and let it ready to the execution. From the root folder of the project execute:
npm install
  1. Launch the IoT Agent with the default configuration
node bin/iotagent-lora

You can use a custom configuration file:

node bin/iotagent-lora custom_config.js

The bootstrap process should finish with:

info: Loading devices from registry
info: LoRaWAN IoT Agent started
  1. Check that the IoTA is running correctly:
curl -v http://localhost:4061/iot/about

The result must be similar to:

{ "libVersion": "2.6.0-next", "port": 4061, "baseRoot": "/" }

Using Docker

A ready to use Docker image is provided

docker run -p 4061:4061 ioeari/iotagent-lora

Using Docker-compose

This project contains an example to deploy the IoTA and all the requirement using docker-compose.

docker-compose -f docker/docker-compose.yml up

Configuration

Overview

All the configuration for the IoT Agent is stored in a single configuration file (typically installed in the root folder). Please refer to the Static configurationsection of user guide for further information.

Configuration with environment variables

Some of the more common variables can be configured using environment variables. The ones overriding general parameters in the config.iota set are described in the IoTA Library Configuration manual.