SiteWhere provides many options for installation depending on user requirements. There are options for running SiteWhere locally or in various cloud environments.
Installing Locally on Linux
Installing SiteWhere locally with the default configuration requires three components: a SiteWhere server distribution, a MongoDB instance, and an MQTT broker. The following steps can be executed on a new Ubuntu 14.04 (or similar) instance. Similar commands should work on other Linux/Unix variants.
Update Components and Install Required Tools
Start by making sure the Ubuntu instance is running the latest versions of its included software. Also, the following steps will install the unzip command and a JDK.
Install MongoDB for Persistence
The default SiteWhere configuration uses MongoDB for persistence of device management and event data. Other persistence stores such as Apache HBase and InfluxDB may also be used. The commands below will install MongoDB with the default settings.
Install the HiveMQ MQTT Broker
The default SiteWhere configuration uses MQTT for receiving device event data and sending device commands. HiveMQ provides a free edition with a limited number of connections that works well for most situations.
HiveMQ is run as a background task. Press enter a to return to a command prompt.
Install a SiteWhere Server Release
These steps will download a SiteWhere distribution from the community website and install it locally.
Installing Locally on Windows
Installing SiteWhere locally with the default configuration requires three components: a SiteWhere server distribution, a MongoDB instance, and an MQTT broker. The following steps can be executed on any recent Windows release including Windows 7-10.
Install MongoDB by following the instructions here.
Install HiveMQ by following the instructions here.
Installing SiteWhere Server
Download the latest SiteWhere release from the community downloads page. Unzip the archive, then navigate to the bin folder and run startup.bat.
Running in the Cloud
Amazon EC2 and Microsoft Azure
Probably the easiest method of getting started with SiteWhere is to spin up a pre-configured cloud instance on your favorite cloud provider. SiteWhere images are currently available for Amazon EC2 and Microsoft Azure. The images include SiteWhere server with a MongoDB database which is populated with sample data. They also includes the free edition of HiveMQ MQTT broker and an installation of Apache Solr configured to handle SiteWhere analytics. Detailed instructions are available here.
SiteWhere is also available as a Docker image which may be downloaded from Docker Hub. The SiteWhere image may be executed on any cloud platform that implements a Docker engine.