SwarmSense Installation Guide

SwarmSense is an IoT platform which helps you to build a fully featured system to add and manage your Internet Connected Devices with easy Whitelabel Setup. This guide will describe how to install SwarmSense IoT Platform on Ubuntu server machine.

All the following instruction are well tested with Ubuntu 16.04.

Hardware requirements

To run SwarmSense and it’s dependencies on a single node you will need at least 1Gb of RAM. An Ubuntu 16.04 machine with 4Gb RAM is a good choice. You can increase memory for scaling.

Installation

SwarmSense setup is really easy. It comes with one-click installer script which will take care of every dependency of the application.

Download swarmsense.tar.gz from the latest release of SwarmSense IoT platform from GitHub. You will get a zip file snms.zip of the application, upload it to the server. First of all, you have to install unzip:

$ apt-get update
$ apt-get install unzip

Now extract the zip file:

$ unzip snms.zip

It will create a folder named release. Installation script for the application setup.sh is under release/script directory. Run this file to start application installation:

$ cd release/script
$ sh setup.sh

Note: Run all the above commands with root privileges.

After running $ sh setup.sh it will install nginx, postfix, rabbitmq, postgres, influxdb etc.

While installing postfix it will prompt for installation type, please select Internet Site.

Here Postfix is used to send alerts and other system emails. You can also use other third-party email services. The only thing you have to change is the SMTP details in the admin section.

During the installation of the database, it will ask for database username and prefix for the database name. You can use default values if you don’t want to change.

It will also ask for hostname (domain) for installation. Enter your domain name like swarmsense.baseapp.com or swarmsense.com. Your backend server will be accessible at <hostname>/api endpoints like swarmsense.baseapp.com/api or swarmsense.com/api.

During the installation of the back-end, it will ask for the details for the first admin user. Please note that this user details will be further used to login to your application. This is your super admin user. It has all the access in the application.

After finishing the installation /etc/snms.conf configuration will be created. This file has all the application configurations. This file will be interpreted as a python file so all the variables will be written in python style.

Now you can browse the web UI application at the hostname you provided. Log in with the user that you created above.

All the application related files logs will be at /opt/snms directory.

Checkout SwarmSense documentation for more details.

Related Posts

Leave a comment