Internet of Things resource management service for OpenStack clouds.
Go to file
Nicola Peditto 3e5782eb1f Release 0.5.0:
- added support to wstun allow list
- added force renew rpc/api
- added DeviceRestSubmit allowed action
- added checks in create and enable webservice
- added ServicesStatus RPC/API
- added hard delete device procedures
- added support for LR "freedom" edition
- added checks if dns or webservice already exists
- check in device creation for duplicated device name
- updated nginx confs

Change-Id: Idb95e63cc4d732f69331ebb585ee576ae872ac5c
2021-11-03 18:13:10 +01:00
doc/source Applied cookiecutter template 2016-03-16 01:26:16 +01:00
etc Random Service port in a specific range. 2020-03-02 16:14:37 +01:00
iotronic Release 0.5.0: 2021-11-03 18:13:10 +01:00
utils Script for removing a board. 2019-05-29 18:52:04 +02:00
zuul.d Python version updated and fixed. 2021-01-15 12:22:58 +01:00
.gitignore Git ignore Updated 2018-06-22 14:56:08 +02:00
.gitreview OpenDev Migration Patch 2019-04-19 19:50:33 +00:00
CONTRIBUTING.rst Applied cookiecutter template 2016-03-16 01:26:16 +01:00
HACKING.rst Applied cookiecutter template 2016-03-16 01:26:16 +01:00
LICENSE Applied cookiecutter template 2016-03-16 01:26:16 +01:00
MANIFEST.in Applied cookiecutter template 2016-03-16 01:26:16 +01:00
README.rst Installation guide updated. 2019-06-24 12:33:15 +02:00
babel.cfg Applied cookiecutter template 2016-03-16 01:26:16 +01:00
requirements.txt New Serializer for autobahn. 2018-12-11 18:35:03 +01:00
setup.cfg Python version updated and fixed. 2021-01-15 12:22:58 +01:00
setup.py Applied cookiecutter template 2016-03-16 01:26:16 +01:00
test-requirements.txt Requirements Update 2018-07-06 14:58:31 +02:00
tox.ini Python version updated and fixed. 2021-01-15 12:22:58 +01:00

README.rst

IoTronic

IoTronic is an Internet of Things resource management service for OpenStack clouds.

IoTronic allows to manage Internet of Things resources as part of an OpenStack data center.

Contents:

Basic scenario

For this installation of the Iotronic Service we are considering a scenario with the following hosts and softwares:

  • Controller ( Ubuntu linux): Mysql, Keystone, Rabbitmq
  • Iotronic ( Ubuntu linux ): Iotronic-conductor, iotronic-wamp-agent, crossbar
  • Board: iotronic-lightining-rod

Controller host setup

According to the Openstack Documentation install the following softwares on the controller host:

  • SQL database
  • Message queue
  • Memcached
  • Keystone

Creation of the database

On the dbms create the iotronic db and configure the access for the user iotronic:

MariaDB [(none)]> CREATE DATABASE iotronic;
MariaDB [(none)]> GRANT ALL PRIVILEGES ON iotronic.* TO iotronic@'localhost' IDENTIFIED BY IOTRONIC_DBPASS;
MariaDB [(none)]> GRANT ALL PRIVILEGES ON iotronic.* TO iotronic@'%' IDENTIFIED BY IOTRONIC_DBPASS;

Add the user and the enpoints on Keystone:

openstack service create iot --name Iotronic
openstack user create --password-prompt iotronic
openstack role add --project service --user iotronic admin
openstack role create admin_iot_project
openstack role create manager_iot_project
openstack role create user_iot
openstack role add --project service --user iotronic admin_iot_project

openstack endpoint create --region RegionOne iot public http://IP_IOTRONIC:8812
openstack endpoint create --region RegionOne iot internal http://IP_IOTRONIC:8812
openstack endpoint create --region RegionOne iot admin http://1IP_IOTRONIC:8812

Configuring Iotronic Host

Crossbar

Install crossbar on the Iotronic host:

apt install python-pip python3-pip libsnappy-dev libssl-dev libffi-dev python-dev
pip3 install python-snappy crossbar

Configuration:

mkdir /etc/crossbar
nano /etc/crossbar/config.json

config.json:

{
   "version": 2,
   "controller": {
   },
   "workers": [
      {
         "type": "router",
         "realms": [
            {
               "name": "s4t",
               "roles": [
                  {
                     "name": "anonymous",
                     "permissions": [
                        {
                           "uri": "*",
                           "allow": {
                                "publish": true,
                                "subscribe": true,
                                "call": true,
                                "register": true
                            }
                        }
                     ]
                  }
               ]
            }
         ],
         "transports": [
            {
                "type": "websocket",
                "endpoint": {
                  "type": "tcp",
                  "port": 8181
                },
                "debug":true,
                "options":{
                  "enable_webstatus":true,
                  "fail_by_drop": true,
                  "open_handshake_timeout": 2500,
                  "close_handshake_timeout": 1000,
                  "auto_ping_interval": 10000,
                  "auto_ping_timeout": 5000,
                  "auto_ping_size": 4
                }
            }
         ]
      }
   ]
}

Create a systemd service file /etc/systemd/system/crossbar.service:

nano /etc/systemd/system/crossbar.service

crossbar.service:

[Unit]
Description=Crossbar.io
After=network.target

[Service]
Type=simple
User=root
Group=root
StandardInput=null
StandardOutput=journal
StandardError=journal
ExecStart=/usr/local/bin/crossbar start --cbdir=/etc/crossbar/
ExecStop=/usr/local/bin/crossbar stop --cbdir=/etc/crossbar/
Restart=on-abort
[Install]
WantedBy=multi-user.target

Iotronic Installation

Get the source:

git clone https://github.com/openstack/iotronic.git

add the user iotronic:

useradd -m -d /var/lib/iotronic iotronic

and Iotronic:

cd iotronic
pip3 install -r requirements.txt 
python3 setup.py install

create a log dir:

mkdir -p /var/log/iotronic
chown -R iotronic:iotronic /var/log/iotronic/

edit /etc/iotronic/iotronic.conf with the correct configuration:

nano /etc/iotronic/iotronic.conf 

There is just one wamp-agent and it must be set as the registration agent:

register_agent = True

populate the database:

iotronic-dbsync

API Service Configuration

Install apache and the other components:

sudo apt-get install apache2 python-setuptools libapache2-mod-wsgi-py3

create log directory:

touch /var/log/iotronic/iotronic-api_error.log
touch /var/log/iotronic/iotronic-api_access.log
chown -R iotronic:iotronic /var/log/iotronic/

copy the config apache2 file:

cp etc/apache2/iotronic.conf /etc/apache2/sites-available/iotronic.conf

enable the configuration:

a2ensite /etc/apache2/sites-available/iotronic.conf

restart apache:

systemctl restart apache2

Starting

On the wamp agent:

systemctl enable iotronic-wamp-agent
systemctl start iotronic-wamp-agent

On the conductor:

systemctl enable iotronic-conductor
systemctl start iotronic-conductor

Board Side

Follow the iotronic-lightning-rod README